@objectstack/spec 3.0.7 → 3.0.8

package/dist/index.mjs

@@ -475,6 +475,8 @@ var FieldSchema = z.object({
   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"),
@@ -1053,7 +1055,13 @@ __export(data_exports, {
   ExternalFieldMappingSchema: () => ExternalFieldMappingSchema,
   ExternalLookupSchema: () => ExternalLookupSchema,
   FILTER_OPERATORS: () => FILTER_OPERATORS,
+  FeedActorSchema: () => FeedActorSchema,
+  FeedFilterMode: () => FeedFilterMode,
+  FeedItemSchema: () => FeedItemSchema,
+  FeedItemType: () => FeedItemType,
+  FeedVisibility: () => FeedVisibility,
   Field: () => Field,
+  FieldChangeEntrySchema: () => FieldChangeEntrySchema,
   FieldMappingSchema: () => FieldMappingSchema2,
   FieldNodeSchema: () => FieldNodeSchema,
   FieldOperatorsSchema: () => FieldOperatorsSchema,
@@ -1075,6 +1083,7 @@ __export(data_exports, {
   LOGICAL_OPERATORS: () => LOGICAL_OPERATORS,
   LocationCoordinatesSchema: () => LocationCoordinatesSchema,
   MappingSchema: () => MappingSchema,
+  MentionSchema: () => MentionSchema,
   MetricSchema: () => MetricSchema,
   NoSQLDataTypeMappingSchema: () => NoSQLDataTypeMappingSchema,
   NoSQLDatabaseTypeSchema: () => NoSQLDatabaseTypeSchema,
@@ -1085,6 +1094,7 @@ __export(data_exports, {
   NoSQLQueryOptionsSchema: () => NoSQLQueryOptionsSchema,
   NoSQLTransactionOptionsSchema: () => NoSQLTransactionOptionsSchema,
   NormalizedFilterSchema: () => NormalizedFilterSchema,
+  NotificationChannel: () => NotificationChannel,
   ObjectCapabilities: () => ObjectCapabilities,
   ObjectExtensionSchema: () => ObjectExtensionSchema,
   ObjectOwnershipEnum: () => ObjectOwnershipEnum,
@@ -1094,6 +1104,8 @@ __export(data_exports, {
   QueryFilterSchema: () => QueryFilterSchema,
   QuerySchema: () => QuerySchema,
   RangeOperatorSchema: () => RangeOperatorSchema,
+  ReactionSchema: () => ReactionSchema,
+  RecordSubscriptionSchema: () => RecordSubscriptionSchema,
   ReplicationConfigSchema: () => ReplicationConfigSchema,
   SQLDialectSchema: () => SQLDialectSchema,
   SQLDriverConfigSchema: () => SQLDriverConfigSchema,
@@ -1108,6 +1120,7 @@ __export(data_exports, {
   SpecialOperatorSchema: () => SpecialOperatorSchema,
   StateMachineValidationSchema: () => StateMachineValidationSchema,
   StringOperatorSchema: () => StringOperatorSchema,
+  SubscriptionEventType: () => SubscriptionEventType,
   TenancyConfigSchema: () => TenancyConfigSchema,
   TimeUpdateInterval: () => TimeUpdateInterval,
   TransformType: () => TransformType,
@@ -3568,6 +3581,113 @@ var AnalyticsQuerySchema = z.object({
   offset: z.number().optional(),
   timezone: z.string().optional().default("UTC")
 });
+var FeedItemType = z.enum([
+  "comment",
+  "field_change",
+  "task",
+  "event",
+  "email",
+  "call",
+  "note",
+  "file",
+  "record_create",
+  "record_delete",
+  "approval",
+  "sharing",
+  "system"
+]);
+var MentionSchema = z.object({
+  type: z.enum(["user", "team", "record"]).describe("Mention target type"),
+  id: z.string().describe("Target ID"),
+  name: z.string().describe("Display name for rendering"),
+  offset: z.number().int().min(0).describe("Character offset in body text"),
+  length: z.number().int().min(1).describe("Length of mention token in body text")
+});
+var FieldChangeEntrySchema = z.object({
+  field: z.string().describe("Field machine name"),
+  fieldLabel: z.string().optional().describe("Field display label"),
+  oldValue: z.unknown().optional().describe("Previous value"),
+  newValue: z.unknown().optional().describe("New value"),
+  oldDisplayValue: z.string().optional().describe("Human-readable old value"),
+  newDisplayValue: z.string().optional().describe("Human-readable new value")
+});
+var ReactionSchema = z.object({
+  emoji: z.string().describe('Emoji character or shortcode (e.g., "\u{1F44D}", ":thumbsup:")'),
+  userIds: z.array(z.string()).describe("Users who reacted"),
+  count: z.number().int().min(1).describe("Total reaction count")
+});
+var FeedActorSchema = 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"),
+  avatarUrl: z.string().url().optional().describe("Actor avatar URL"),
+  source: z.string().optional().describe('Source application (e.g., "Omni", "API", "Studio")')
+});
+var FeedVisibility = z.enum(["public", "internal", "private"]);
+var FeedItemSchema = z.object({
+  /** Unique identifier */
+  id: z.string().describe("Feed item ID"),
+  /** Feed item type */
+  type: FeedItemType.describe("Activity type"),
+  /** Target record reference */
+  object: z.string().describe('Object name (e.g., "account")'),
+  recordId: z.string().describe("Record ID this feed item belongs to"),
+  /** Actor (who performed the action) */
+  actor: FeedActorSchema.describe("Who performed this action"),
+  /** Content (for comments/notes) */
+  body: z.string().optional().describe("Rich text body (Markdown supported)"),
+  /** @Mentions */
+  mentions: z.array(MentionSchema).optional().describe("Mentioned users/teams/records"),
+  /** Field changes (for field_change type) */
+  changes: z.array(FieldChangeEntrySchema).optional().describe("Field-level changes"),
+  /** Reactions */
+  reactions: z.array(ReactionSchema).optional().describe("Emoji reactions on this item"),
+  /** 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"),
+  /** Visibility */
+  visibility: FeedVisibility.default("public").describe("Visibility: public (all users), internal (team only), private (author + mentioned)"),
+  /** Timestamps */
+  createdAt: z.string().datetime().describe("Creation timestamp"),
+  updatedAt: z.string().datetime().optional().describe("Last update timestamp"),
+  editedAt: z.string().datetime().optional().describe("When comment was last edited"),
+  isEdited: z.boolean().default(false).describe("Whether comment has been edited")
+});
+var FeedFilterMode = z.enum([
+  "all",
+  "comments_only",
+  "changes_only",
+  "tasks_only"
+]);
+var SubscriptionEventType = z.enum([
+  "comment",
+  "mention",
+  "field_change",
+  "task",
+  "approval",
+  "all"
+]);
+var NotificationChannel = z.enum([
+  "in_app",
+  "email",
+  "push",
+  "slack"
+]);
+var RecordSubscriptionSchema = z.object({
+  /** Target */
+  object: z.string().describe("Object name"),
+  recordId: z.string().describe("Record ID"),
+  /** Subscriber */
+  userId: z.string().describe("Subscribing user ID"),
+  /** Events to subscribe to */
+  events: z.array(SubscriptionEventType).default(["all"]).describe("Event types to receive notifications for"),
+  /** Notification channels */
+  channels: z.array(NotificationChannel).default(["in_app"]).describe("Notification delivery channels"),
+  /** Active */
+  active: z.boolean().default(true).describe("Whether the subscription is active"),
+  /** Timestamps */
+  createdAt: z.string().datetime().describe("Subscription creation timestamp")
+});
 
 // src/security/index.ts
 var security_exports = {};
@@ -4224,13 +4344,16 @@ var ui_exports = {};
 __export(ui_exports, {
   AIChatWindowProps: () => AIChatWindowProps,
   Action: () => Action,
+  ActionNavItemSchema: () => ActionNavItemSchema,
   ActionParamSchema: () => ActionParamSchema,
   ActionSchema: () => ActionSchema,
+  AddRecordConfigSchema: () => AddRecordConfigSchema,
   AnimationSchema: () => AnimationSchema,
   AnimationTriggerSchema: () => AnimationTriggerSchema,
   App: () => App,
   AppBrandingSchema: () => AppBrandingSchema,
   AppSchema: () => AppSchema,
+  AppearanceConfigSchema: () => AppearanceConfigSchema,
   AriaPropsSchema: () => AriaPropsSchema,
   BlankPageLayoutItemSchema: () => BlankPageLayoutItemSchema,
   BlankPageLayoutSchema: () => BlankPageLayoutSchema,
@@ -4295,6 +4418,7 @@ __export(ui_exports, {
   HttpRequestSchema: () => HttpRequestSchema,
   I18nLabelSchema: () => I18nLabelSchema,
   I18nObjectSchema: () => I18nObjectSchema,
+  InterfacePageConfigSchema: () => InterfacePageConfigSchema,
   KanbanConfigSchema: () => KanbanConfigSchema,
   KeyboardNavigationConfigSchema: () => KeyboardNavigationConfigSchema,
   KeyboardShortcutSchema: () => KeyboardShortcutSchema,
@@ -4303,6 +4427,7 @@ __export(ui_exports, {
   LocaleConfigSchema: () => LocaleConfigSchema,
   LongPressGestureConfigSchema: () => LongPressGestureConfigSchema,
   MotionConfigSchema: () => MotionConfigSchema,
+  NavigationAreaSchema: () => NavigationAreaSchema,
   NavigationConfigSchema: () => NavigationConfigSchema,
   NavigationItemSchema: () => NavigationItemSchema,
   NavigationModeSchema: () => NavigationModeSchema,
@@ -4335,6 +4460,7 @@ __export(ui_exports, {
   PinchGestureConfigSchema: () => PinchGestureConfigSchema,
   PluralRuleSchema: () => PluralRuleSchema,
   RecordActivityProps: () => RecordActivityProps,
+  RecordChatterProps: () => RecordChatterProps,
   RecordDetailsProps: () => RecordDetailsProps,
   RecordHighlightsProps: () => RecordHighlightsProps,
   RecordPathProps: () => RecordPathProps,
@@ -4344,6 +4470,7 @@ __export(ui_exports, {
   ReportChartSchema: () => ReportChartSchema,
   ReportColumnSchema: () => ReportColumnSchema,
   ReportGroupingSchema: () => ReportGroupingSchema,
+  ReportNavItemSchema: () => ReportNavItemSchema,
   ReportSchema: () => ReportSchema,
   ReportType: () => ReportType,
   ResponsiveConfigSchema: () => ResponsiveConfigSchema,
@@ -4365,9 +4492,12 @@ __export(ui_exports, {
   TransitionPresetSchema: () => TransitionPresetSchema,
   TypographySchema: () => TypographySchema,
   UrlNavItemSchema: () => UrlNavItemSchema,
+  UserActionsConfigSchema: () => UserActionsConfigSchema,
   ViewDataSchema: () => ViewDataSchema,
   ViewSchema: () => ViewSchema,
   ViewSharingSchema: () => ViewSharingSchema,
+  ViewTabSchema: () => ViewTabSchema,
+  VisualizationTypeSchema: () => VisualizationTypeSchema,
   WcagContrastLevel: () => WcagContrastLevel,
   WidgetActionTypeSchema: () => WidgetActionTypeSchema,
   WidgetColorVariantSchema: () => WidgetColorVariantSchema,
@@ -4641,12 +4771,18 @@ var BaseNavItemSchema = z.object({
   label: I18nLabelSchema.describe("Display proper label"),
   /** Icon name (Lucide) */
   icon: z.string().optional().describe("Icon name"),
+  /** Sort order within the same level (lower numbers appear first) */
+  order: z.number().optional().describe("Sort order within the same level (lower = first)"),
+  /** Badge text or count displayed on the navigation item (e.g. "3", "New") */
+  badge: z.union([z.string(), z.number()]).optional().describe("Badge text or count displayed on the item"),
   /** 
    * Visibility condition. 
    * Formula expression returning boolean. 
    * e.g. "user.is_admin || user.department == 'sales'"
    */
-  visible: z.string().optional().describe("Visibility formula condition")
+  visible: z.string().optional().describe("Visibility formula condition"),
+  /** Permissions required to see/access this navigation item */
+  requiredPermissions: z.array(z.string()).optional().describe("Permissions required to access this item")
 });
 var ObjectNavItemSchema = BaseNavItemSchema.extend({
   type: z.literal("object"),
@@ -4667,6 +4803,17 @@ var UrlNavItemSchema = BaseNavItemSchema.extend({
   url: z.string().describe("Target external URL"),
   target: z.enum(["_self", "_blank"]).default("_self").describe("Link target window")
 });
+var ReportNavItemSchema = BaseNavItemSchema.extend({
+  type: z.literal("report"),
+  reportName: z.string().describe("Target report name")
+});
+var ActionNavItemSchema = BaseNavItemSchema.extend({
+  type: z.literal("action"),
+  actionDef: z.object({
+    actionName: z.string().describe("Action machine name to execute"),
+    params: z.record(z.string(), z.unknown()).optional().describe("Parameters passed to the action")
+  }).describe("Action definition to execute when clicked")
+});
 var GroupNavItemSchema = BaseNavItemSchema.extend({
   type: z.literal("group"),
   expanded: z.boolean().default(false).describe("Default expansion state in sidebar")
@@ -4680,6 +4827,8 @@ var NavigationItemSchema = z.lazy(
     DashboardNavItemSchema,
     PageNavItemSchema,
     UrlNavItemSchema,
+    ReportNavItemSchema,
+    ActionNavItemSchema,
     GroupNavItemSchema.extend({
       children: z.array(NavigationItemSchema).describe("Child navigation items")
     })
@@ -4690,6 +4839,27 @@ var AppBrandingSchema = z.object({
   logo: z.string().optional().describe("Custom logo URL for this app"),
   favicon: z.string().optional().describe("Custom favicon URL for this app")
 });
+var NavigationAreaSchema = z.object({
+  /** Unique area identifier */
+  id: SnakeCaseIdentifierSchema.describe("Unique area identifier (lowercase snake_case)"),
+  /** Display label */
+  label: I18nLabelSchema.describe("Area display label"),
+  /** Icon name (Lucide) */
+  icon: z.string().optional().describe("Area icon name"),
+  /** Sort order among areas (lower = first) */
+  order: z.number().optional().describe("Sort order among areas (lower = first)"),
+  /** Area description */
+  description: I18nLabelSchema.optional().describe("Area description"),
+  /** 
+   * Visibility condition.
+   * Formula expression returning boolean.
+   */
+  visible: z.string().optional().describe("Visibility formula condition for this area"),
+  /** Permissions required to access this area */
+  requiredPermissions: z.array(z.string()).optional().describe("Permissions required to access this area"),
+  /** Navigation items within this area */
+  navigation: z.array(NavigationItemSchema).describe("Navigation items within this area")
+});
 var AppSchema = z.object({
   /** Machine name (id) */
   name: SnakeCaseIdentifierSchema.describe("App unique machine name (lowercase snake_case)"),
@@ -4711,8 +4881,25 @@ var AppSchema = z.object({
    * Full Navigation Tree — supports unlimited nesting depth.
    * Pages are referenced by name via `type: 'page'` items.
    * Groups can contain other groups for arbitrary sidebar depth.
+   * 
+   * For simple apps, use `navigation` directly.
+   * For enterprise apps with multiple business domains, use `areas` instead.
    */
   navigation: z.array(NavigationItemSchema).optional().describe("Full navigation tree for the app sidebar"),
+  /**
+   * Navigation Areas — partitions navigation by business domain.
+   * Each area defines an independent navigation tree (e.g. Sales, Service, Settings).
+   * When areas are defined, they take precedence over the top-level `navigation` array.
+   * 
+   * @example
+   * ```ts
+   * areas: [
+   *   { id: 'area_sales', label: 'Sales', icon: 'briefcase', order: 1, navigation: [...] },
+   *   { id: 'area_service', label: 'Service', icon: 'headset', order: 2, navigation: [...] },
+   * ]
+   * ```
+   */
+  areas: z.array(NavigationAreaSchema).optional().describe("Navigation areas for partitioning navigation by business domain"),
   /** 
    * App-level Home Page Override
    * ID of the navigation item to act as the landing page.
@@ -4854,6 +5041,44 @@ var RowColorConfigSchema = 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 = z.enum([
+  "grid",
+  "kanban",
+  "gallery",
+  "calendar",
+  "timeline",
+  "gantt",
+  "map"
+]).describe("Visualization type that users can switch to");
+var UserActionsConfigSchema = 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 = 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 = 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(z.unknown()).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 = 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 = 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)"),
@@ -4988,6 +5213,18 @@ var ListViewSchema = z.object({
   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(),
@@ -5486,6 +5723,27 @@ var RecordReviewConfigSchema = z.object({
   navigation: z.enum(["sequential", "random", "filtered"]).optional().default("sequential").describe("Record navigation mode"),
   showProgress: z.boolean().optional().default(true).describe("Show review progress indicator")
 });
+var InterfacePageConfigSchema = z.object({
+  /** Data binding */
+  source: z.string().optional().describe("Source object name for the page"),
+  levels: z.number().int().min(1).optional().describe("Number of hierarchy levels to display"),
+  filterBy: z.array(z.unknown()).optional().describe("Page-level filter criteria"),
+  /** Appearance */
+  appearance: AppearanceConfigSchema.optional().describe("Appearance and visualization configuration"),
+  /** User filters */
+  userFilters: z.object({
+    elements: z.array(z.enum(["grid", "gallery", "kanban"])).optional().describe("Visualization element types available in user filter bar"),
+    tabs: z.array(ViewTabSchema).optional().describe("User-configurable tabs")
+  }).optional().describe("User filter configuration"),
+  /** User actions */
+  userActions: UserActionsConfigSchema.optional().describe("User action toggles"),
+  /** Add record */
+  addRecord: AddRecordConfigSchema.optional().describe("Add record entry point configuration"),
+  /** Record count */
+  showRecordCount: z.boolean().optional().describe("Show record count at page bottom"),
+  /** Advanced */
+  allowPrinting: z.boolean().optional().describe("Allow users to print the page")
+}).describe("Interface-level page configuration (Airtable parity)");
 var PageSchema = z.object({
   name: SnakeCaseIdentifierSchema.describe("Page unique name (lowercase snake_case)"),
   label: I18nLabelSchema,
@@ -5509,6 +5767,8 @@ var PageSchema = z.object({
   /** Activation */
   isDefault: z.boolean().default(false),
   assignedProfiles: z.array(z.string()).optional(),
+  /** Interface Page Configuration (Airtable Interface parity) */
+  interfaceConfig: InterfacePageConfigSchema.optional().describe("Interface-level page configuration (for Airtable-style interface pages)"),
   /** ARIA accessibility attributes */
   aria: AriaPropsSchema.optional().describe("ARIA accessibility attributes")
 });
@@ -5849,9 +6109,42 @@ var RecordHighlightsProps = z.object({
   aria: AriaPropsSchema.optional().describe("ARIA accessibility attributes")
 });
 var RecordActivityProps = z.object({
-  types: z.array(z.enum(["task", "event", "email", "call", "note"])).optional().describe("Activity types to display"),
-  limit: z.number().int().positive().default(10).describe("Number of activities to show"),
+  /** Activity types to display (unified enum including comment, field_change, etc.) */
+  types: z.array(FeedItemType).optional().describe("Feed item types to show (default: all)"),
+  /** Default filter mode (Airtable-style dropdown) */
+  filterMode: FeedFilterMode.default("all").describe("Default activity filter"),
+  /** Allow user to switch filter modes */
+  showFilterToggle: z.boolean().default(true).describe("Show filter dropdown in panel header"),
+  /** Pagination */
+  limit: z.number().int().positive().default(20).describe("Number of items to load per page"),
+  /** Show completed activities */
   showCompleted: z.boolean().default(false).describe("Include completed activities"),
+  /** Merge field_change + comment in a unified timeline */
+  unifiedTimeline: z.boolean().default(true).describe("Mix field changes and comments in one timeline (Airtable style)"),
+  /** Show the comment input box at the bottom */
+  showCommentInput: z.boolean().default(true).describe('Show "Leave a comment" input at the bottom'),
+  /** Enable @mentions in comments */
+  enableMentions: z.boolean().default(true).describe("Enable @mentions in comments"),
+  /** Enable emoji reactions */
+  enableReactions: z.boolean().default(false).describe("Enable emoji reactions on feed items"),
+  /** Enable threaded replies */
+  enableThreading: z.boolean().default(false).describe("Enable threaded replies on comments"),
+  /** Show notification subscription toggle (bell icon) */
+  showSubscriptionToggle: z.boolean().default(true).describe("Show bell icon for record-level notification subscription"),
+  /** ARIA accessibility */
+  aria: AriaPropsSchema.optional().describe("ARIA accessibility attributes")
+});
+var RecordChatterProps = z.object({
+  /** Panel position */
+  position: z.enum(["sidebar", "inline", "drawer"]).default("sidebar").describe("Where to render the chatter panel"),
+  /** Panel width (for sidebar/drawer) */
+  width: z.union([z.string(), z.number()]).optional().describe('Panel width (e.g., "350px", "30%")'),
+  /** Collapsible */
+  collapsible: z.boolean().default(true).describe("Whether the panel can be collapsed"),
+  /** Default collapsed state */
+  defaultCollapsed: z.boolean().default(false).describe("Whether the panel starts collapsed"),
+  /** Feed configuration (delegates to RecordActivityProps) */
+  feed: RecordActivityProps.optional().describe("Embedded activity feed configuration"),
   /** ARIA accessibility */
   aria: AriaPropsSchema.optional().describe("ARIA accessibility attributes")
 });
@@ -5961,7 +6254,7 @@ var ComponentPropsMap = {
   "record:related_list": RecordRelatedListProps,
   "record:highlights": RecordHighlightsProps,
   "record:activity": RecordActivityProps,
-  "record:chatter": EmptyProps,
+  "record:chatter": RecordChatterProps,
   "record:path": RecordPathProps,
   // Navigation
   "app:launcher": EmptyProps,
@@ -6585,6 +6878,7 @@ __export(system_exports, {
   OpenTelemetryCompatibilitySchema: () => OpenTelemetryCompatibilitySchema,
   OtelExporterType: () => OtelExporterType,
   PCIDSSConfigSchema: () => PCIDSSConfigSchema,
+  PKG_CONVENTIONS: () => PKG_CONVENTIONS,
   PNCounterSchema: () => PNCounterSchema,
   PlanSchema: () => PlanSchema,
   PresignedUrlConfigSchema: () => PresignedUrlConfigSchema,
@@ -6632,10 +6926,13 @@ __export(system_exports, {
   StorageAclSchema: () => StorageAclSchema,
   StorageClassSchema: () => StorageClassSchema,
   StorageConnectionSchema: () => StorageConnectionSchema,
+  StorageNameMapping: () => StorageNameMapping,
   StorageProviderSchema: () => StorageProviderSchema,
   StorageScopeSchema: () => StorageScopeSchema,
   StructuredLogEntrySchema: () => StructuredLogEntrySchema,
   SuspiciousActivityRuleSchema: () => SuspiciousActivityRuleSchema,
+  SystemFieldName: () => SystemFieldName,
+  SystemObjectName: () => SystemObjectName,
   TASK_PRIORITY_VALUES: () => TASK_PRIORITY_VALUES,
   Task: () => Task,
   TaskExecutionResultSchema: () => TaskExecutionResultSchema,
@@ -11933,6 +12230,142 @@ var RegistryConfigSchema = z.object({
   })).optional().describe("Mirror registries for redundancy")
 });
 
+// src/system/constants/paths.ts
+var PKG_CONVENTIONS = {
+  /**
+   * Standard directories within ObjectStack packages.
+   * All packages MUST follow these conventions for the runtime to locate resources.
+   */
+  DIRS: {
+    /** 
+     * Location for schema definitions (Zod schemas, JSON schemas).
+     * Path: src/schemas
+     */
+    SCHEMA: "src/schemas",
+    /** 
+     * Location for server-side code and triggers.
+     * Path: src/server
+     */
+    SERVER: "src/server",
+    /** 
+     * Location for server-side trigger functions.
+     * Path: src/triggers
+     */
+    TRIGGERS: "src/triggers",
+    /** 
+     * Location for client-side code.
+     * Path: src/client
+     */
+    CLIENT: "src/client",
+    /** 
+     * Location for client-side page components.
+     * Path: src/client/pages
+     */
+    PAGES: "src/client/pages",
+    /** 
+     * Location for static assets (images, fonts, etc.).
+     * Path: assets
+     */
+    ASSETS: "assets"
+  },
+  /**
+   * Standard file names within ObjectStack packages.
+   */
+  FILES: {
+    /** 
+     * Package manifest configuration file.
+     * File: objectstack.config.ts
+     */
+    MANIFEST: "objectstack.config.ts",
+    /** 
+     * Main entry point for the package.
+     * File: src/index.ts
+     */
+    ENTRY: "src/index.ts"
+  }
+};
+
+// src/system/constants/system-names.ts
+var SystemObjectName = {
+  /** Authentication: user identity */
+  USER: "sys_user",
+  /** Authentication: active session */
+  SESSION: "sys_session",
+  /** Authentication: OAuth / credential account */
+  ACCOUNT: "sys_account",
+  /** Authentication: email / phone verification */
+  VERIFICATION: "sys_verification",
+  /** System metadata storage */
+  METADATA: "sys_metadata"
+};
+var SystemFieldName = {
+  /** Primary key */
+  ID: "id",
+  /** Record creation timestamp */
+  CREATED_AT: "created_at",
+  /** Record last-updated timestamp */
+  UPDATED_AT: "updated_at",
+  /** Record owner (lookup to user) */
+  OWNER_ID: "owner_id",
+  /** Tenant isolation key */
+  TENANT_ID: "tenant_id",
+  /** Foreign key to user on session / account objects */
+  USER_ID: "user_id",
+  /** Soft-delete timestamp */
+  DELETED_AT: "deleted_at"
+};
+var StorageNameMapping = {
+  /**
+   * Resolve the physical table name for an object.
+   * Falls back to `object.name` when `tableName` is not set.
+   *
+   * @param object - Object definition (at minimum `{ name: string; tableName?: string }`)
+   * @returns The physical table / collection name to use in storage operations.
+   */
+  resolveTableName(object) {
+    return object.tableName ?? object.name;
+  },
+  /**
+   * Resolve the physical column name for a field.
+   * Falls back to `fieldKey` when `columnName` is not set on the field.
+   *
+   * @param fieldKey - The protocol-level field key (snake_case identifier).
+   * @param field    - Field definition (at minimum `{ columnName?: string }`).
+   * @returns The physical column name to use in storage operations.
+   */
+  resolveColumnName(fieldKey, field) {
+    return field.columnName ?? fieldKey;
+  },
+  /**
+   * Build a complete field-key → column-name map for an entire object.
+   *
+   * @param fields - The fields record from an ObjectSchema.
+   * @returns A record mapping every protocol field key to its physical column name.
+   */
+  buildColumnMap(fields) {
+    const map = {};
+    for (const key of Object.keys(fields)) {
+      map[key] = fields[key].columnName ?? key;
+    }
+    return map;
+  },
+  /**
+   * Build a reverse column-name → field-key map for an entire object.
+   * Useful for translating storage-layer results back to protocol-level field keys.
+   *
+   * @param fields - The fields record from an ObjectSchema.
+   * @returns A record mapping every physical column name back to its protocol field key.
+   */
+  buildReverseColumnMap(fields) {
+    const map = {};
+    for (const key of Object.keys(fields)) {
+      const col = fields[key].columnName ?? key;
+      map[col] = key;
+    }
+    return map;
+  }
+};
+
 // src/kernel/index.ts
 var kernel_exports = {};
 __export(kernel_exports, {
@@ -24440,6 +24873,8 @@ var FeedbackLoopSchema = z.object({
 var api_exports = {};
 __export(api_exports, {
   AckMessageSchema: () => AckMessageSchema,
+  AddReactionRequestSchema: () => AddReactionRequestSchema,
+  AddReactionResponseSchema: () => AddReactionResponseSchema,
   AiChatRequestSchema: () => AiChatRequestSchema,
   AiChatResponseSchema: () => AiChatResponseSchema,
   AiInsightsRequestSchema: () => AiInsightsRequestSchema,
@@ -24515,6 +24950,8 @@ __export(api_exports, {
   ConflictResolutionStrategy: () => ConflictResolutionStrategy,
   CreateDataRequestSchema: () => CreateDataRequestSchema,
   CreateDataResponseSchema: () => CreateDataResponseSchema,
+  CreateFeedItemRequestSchema: () => CreateFeedItemRequestSchema,
+  CreateFeedItemResponseSchema: () => CreateFeedItemResponseSchema,
   CreateManyDataRequestSchema: () => CreateManyDataRequestSchema,
   CreateManyDataResponseSchema: () => CreateManyDataResponseSchema,
   CreateRequestSchema: () => CreateRequestSchema,
@@ -24543,6 +24980,8 @@ __export(api_exports, {
   DataLoaderConfigSchema: () => DataLoaderConfigSchema,
   DeleteDataRequestSchema: () => DeleteDataRequestSchema,
   DeleteDataResponseSchema: () => DeleteDataResponseSchema,
+  DeleteFeedItemRequestSchema: () => DeleteFeedItemRequestSchema,
+  DeleteFeedItemResponseSchema: () => DeleteFeedItemResponseSchema,
   DeleteManyDataRequestSchema: () => DeleteManyDataRequestSchema,
   DeleteManyDataResponseSchema: () => DeleteManyDataResponseSchema,
   DeleteManyRequestSchema: () => DeleteManyRequestSchema,
@@ -24581,6 +25020,12 @@ __export(api_exports, {
   FederationGatewaySchema: () => FederationGatewaySchema,
   FederationProvidesSchema: () => FederationProvidesSchema,
   FederationRequiresSchema: () => FederationRequiresSchema,
+  FeedApiContracts: () => FeedApiContracts,
+  FeedApiErrorCode: () => FeedApiErrorCode,
+  FeedItemPathParamsSchema: () => FeedItemPathParamsSchema,
+  FeedListFilterType: () => FeedListFilterType,
+  FeedPathParamsSchema: () => FeedPathParamsSchema,
+  FeedUnsubscribeRequestSchema: () => FeedUnsubscribeRequestSchema,
   FieldErrorSchema: () => FieldErrorSchema,
   FileUploadResponseSchema: () => FileUploadResponseSchema,
   FilterOperator: () => FilterOperator,
@@ -24595,6 +25040,8 @@ __export(api_exports, {
   GetDiscoveryResponseSchema: () => GetDiscoveryResponseSchema,
   GetEffectivePermissionsRequestSchema: () => GetEffectivePermissionsRequestSchema,
   GetEffectivePermissionsResponseSchema: () => GetEffectivePermissionsResponseSchema,
+  GetFeedRequestSchema: () => GetFeedRequestSchema,
+  GetFeedResponseSchema: () => GetFeedResponseSchema,
   GetFieldLabelsRequestSchema: () => GetFieldLabelsRequestSchema,
   GetFieldLabelsResponseSchema: () => GetFieldLabelsResponseSchema,
   GetLocalesRequestSchema: () => GetLocalesRequestSchema,
@@ -24738,6 +25185,8 @@ __export(api_exports, {
   RegisterDeviceRequestSchema: () => RegisterDeviceRequestSchema,
   RegisterDeviceResponseSchema: () => RegisterDeviceResponseSchema,
   RegisterRequestSchema: () => RegisterRequestSchema,
+  RemoveReactionRequestSchema: () => RemoveReactionRequestSchema,
+  RemoveReactionResponseSchema: () => RemoveReactionResponseSchema,
   RequestValidationConfigSchema: () => RequestValidationConfigSchema,
   ResponseEnvelopeConfigSchema: () => ResponseEnvelopeConfigSchema,
   RestApiConfig: () => RestApiConfig,
@@ -24772,6 +25221,8 @@ __export(api_exports, {
   StandardErrorCode: () => StandardErrorCode,
   SubgraphConfigSchema: () => SubgraphConfigSchema,
   SubscribeMessageSchema: () => SubscribeMessageSchema,
+  SubscribeRequestSchema: () => SubscribeRequestSchema,
+  SubscribeResponseSchema: () => SubscribeResponseSchema,
   SubscriptionEventSchema: () => SubscriptionEventSchema,
   SubscriptionSchema: () => SubscriptionSchema,
   TransportProtocol: () => TransportProtocol,
@@ -24781,8 +25232,11 @@ __export(api_exports, {
   UnregisterDeviceResponseSchema: () => UnregisterDeviceResponseSchema,
   UnsubscribeMessageSchema: () => UnsubscribeMessageSchema,
   UnsubscribeRequestSchema: () => UnsubscribeRequestSchema,
+  UnsubscribeResponseSchema: () => UnsubscribeResponseSchema,
   UpdateDataRequestSchema: () => UpdateDataRequestSchema,
   UpdateDataResponseSchema: () => UpdateDataResponseSchema,
+  UpdateFeedItemRequestSchema: () => UpdateFeedItemRequestSchema,
+  UpdateFeedItemResponseSchema: () => UpdateFeedItemResponseSchema,
   UpdateManyDataRequestSchema: () => UpdateManyDataRequestSchema,
   UpdateManyDataResponseSchema: () => UpdateManyDataResponseSchema,
   UpdateManyRequestSchema: () => UpdateManyRequestSchema,
@@ -30329,6 +30783,148 @@ var QueryAdapterConfigSchema = z.object({
   /** OData adapter configuration */
   odata: ODataQueryAdapterSchema.optional().describe("OData query adapter configuration")
 });
+var FeedPathParamsSchema = z.object({
+  object: z.string().describe('Object name (e.g., "account")'),
+  recordId: z.string().describe("Record ID")
+});
+var FeedItemPathParamsSchema = FeedPathParamsSchema.extend({
+  feedId: z.string().describe("Feed item ID")
+});
+var FeedListFilterType = z.enum([
+  "all",
+  "comments_only",
+  "changes_only",
+  "tasks_only"
+]);
+var GetFeedRequestSchema = FeedPathParamsSchema.extend({
+  type: FeedListFilterType.default("all").describe("Filter by feed item category"),
+  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 (opaque string from previous response)")
+});
+var GetFeedResponseSchema = BaseResponseSchema.extend({
+  data: z.object({
+    items: z.array(FeedItemSchema).describe("Feed items in reverse chronological order"),
+    total: z.number().int().optional().describe("Total feed items matching filter"),
+    nextCursor: z.string().optional().describe("Cursor for the next page"),
+    hasMore: z.boolean().describe("Whether more items are available")
+  })
+});
+var CreateFeedItemRequestSchema = FeedPathParamsSchema.extend({
+  type: FeedItemType.describe("Type of feed item to create"),
+  body: z.string().optional().describe("Rich text body (Markdown supported)"),
+  mentions: z.array(MentionSchema).optional().describe("Mentioned users, teams, or records"),
+  parentId: z.string().optional().describe("Parent feed item ID for threaded replies"),
+  visibility: FeedVisibility.default("public").describe("Visibility: public, internal, or private")
+});
+var CreateFeedItemResponseSchema = BaseResponseSchema.extend({
+  data: FeedItemSchema.describe("The created feed item")
+});
+var UpdateFeedItemRequestSchema = FeedItemPathParamsSchema.extend({
+  body: z.string().optional().describe("Updated rich text body"),
+  mentions: z.array(MentionSchema).optional().describe("Updated mentions"),
+  visibility: FeedVisibility.optional().describe("Updated visibility")
+});
+var UpdateFeedItemResponseSchema = BaseResponseSchema.extend({
+  data: FeedItemSchema.describe("The updated feed item")
+});
+var DeleteFeedItemRequestSchema = FeedItemPathParamsSchema;
+var DeleteFeedItemResponseSchema = BaseResponseSchema.extend({
+  data: z.object({
+    feedId: z.string().describe("ID of the deleted feed item")
+  })
+});
+var AddReactionRequestSchema = FeedItemPathParamsSchema.extend({
+  emoji: z.string().describe('Emoji character or shortcode (e.g., "\u{1F44D}", ":thumbsup:")')
+});
+var AddReactionResponseSchema = BaseResponseSchema.extend({
+  data: z.object({
+    reactions: z.array(ReactionSchema).describe("Updated reaction list for the feed item")
+  })
+});
+var RemoveReactionRequestSchema = FeedItemPathParamsSchema.extend({
+  emoji: z.string().describe("Emoji character or shortcode to remove")
+});
+var RemoveReactionResponseSchema = BaseResponseSchema.extend({
+  data: z.object({
+    reactions: z.array(ReactionSchema).describe("Updated reaction list for the feed item")
+  })
+});
+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")
+});
+var SubscribeResponseSchema = BaseResponseSchema.extend({
+  data: RecordSubscriptionSchema.describe("The created or updated subscription")
+});
+var FeedUnsubscribeRequestSchema = FeedPathParamsSchema;
+var UnsubscribeResponseSchema = BaseResponseSchema.extend({
+  data: z.object({
+    object: z.string().describe("Object name"),
+    recordId: z.string().describe("Record ID"),
+    unsubscribed: z.boolean().describe("Whether the user was unsubscribed")
+  })
+});
+var FeedApiErrorCode = z.enum([
+  "feed_item_not_found",
+  "feed_permission_denied",
+  "feed_item_not_editable",
+  "feed_invalid_parent",
+  "reaction_already_exists",
+  "reaction_not_found",
+  "subscription_already_exists",
+  "subscription_not_found",
+  "invalid_feed_type"
+]);
+var FeedApiContracts = {
+  listFeed: {
+    method: "GET",
+    path: "/api/data/:object/:recordId/feed",
+    input: GetFeedRequestSchema,
+    output: GetFeedResponseSchema
+  },
+  createFeedItem: {
+    method: "POST",
+    path: "/api/data/:object/:recordId/feed",
+    input: CreateFeedItemRequestSchema,
+    output: CreateFeedItemResponseSchema
+  },
+  updateFeedItem: {
+    method: "PUT",
+    path: "/api/data/:object/:recordId/feed/:feedId",
+    input: UpdateFeedItemRequestSchema,
+    output: UpdateFeedItemResponseSchema
+  },
+  deleteFeedItem: {
+    method: "DELETE",
+    path: "/api/data/:object/:recordId/feed/:feedId",
+    input: DeleteFeedItemRequestSchema,
+    output: DeleteFeedItemResponseSchema
+  },
+  addReaction: {
+    method: "POST",
+    path: "/api/data/:object/:recordId/feed/:feedId/reactions",
+    input: AddReactionRequestSchema,
+    output: AddReactionResponseSchema
+  },
+  removeReaction: {
+    method: "DELETE",
+    path: "/api/data/:object/:recordId/feed/:feedId/reactions/:emoji",
+    input: RemoveReactionRequestSchema,
+    output: RemoveReactionResponseSchema
+  },
+  subscribe: {
+    method: "POST",
+    path: "/api/data/:object/:recordId/subscribe",
+    input: SubscribeRequestSchema,
+    output: SubscribeResponseSchema
+  },
+  unsubscribe: {
+    method: "DELETE",
+    path: "/api/data/:object/:recordId/subscribe",
+    input: FeedUnsubscribeRequestSchema,
+    output: UnsubscribeResponseSchema
+  }
+};
 
 // src/automation/index.ts
 var automation_exports = {};