Merge pull request #941 from objectstack-ai/copilot/add-actions-field-to-objects

Author: hotlong

ROADMAP.md

@@ -1164,6 +1164,7 @@ The `FlowDesigner` is a canvas-based flow editor that bridges the gap between th
 - [x] **P1: Chart Widget Server-Side Aggregation** — Fixed chart widgets (bar/line/area/pie/donut/scatter) downloading all raw data and aggregating client-side. Added optional `aggregate()` method to `DataSource` interface (`AggregateParams`, `AggregateResult` types) enabling server-side grouping/aggregation via analytics API (e.g. `GET /api/v1/analytics/{resource}?category=…&metric=…&agg=…`). `ObjectChart` now prefers `dataSource.aggregate()` when available, falling back to `dataSource.find()` + client-side aggregation for backward compatibility. Implemented `aggregate()` in `ValueDataSource` (in-memory), `ApiDataSource` (HTTP), and `ObjectStackAdapter` (analytics API with client-side fallback). Only detail widgets (grid/table/list) continue to fetch full data. 9 new tests.
 - [x] **P1: Spec-Aligned CRM I18n** — Fixed CRM internationalization not taking effect on the console. Root cause: CRM metadata used plain string labels instead of spec-aligned `I18nLabel` objects. Fix: (1) Updated CRM app/dashboard/navigation metadata to use `I18nLabel` objects (`{ key, defaultValue }`) per spec. (2) Updated `NavigationItem` and `NavigationArea` types to support I18nLabel. (3) Added `resolveLabel()` helper in NavigationRenderer. (4) Updated `resolveI18nLabel()` to accept `t()` function for translation. (5) Added `loadLanguage` callback in I18nProvider for API-based translation loading. (6) Added `/api/v1/i18n/:lang` endpoint to mock server. Console contains zero CRM-specific code.
 - [x] **P0: Opportunity List View & ObjectDef Column Enrichment** — Fixed ObjectGrid not using objectDef field metadata for type-aware rendering when columns are `string[]` or `ListColumn[]` without full options. (1) Schema resolution always fetches full schema from DataSource for field type metadata. (2) String[] column path enriched with objectDef types, options (with colors), currency, precision for proper CurrencyCellRenderer, SelectCellRenderer (colored badges), PercentCellRenderer, DateCellRenderer. (3) ListColumn[] fieldMeta deep-merged with objectDef field properties (select options with colors, currency code, precision). (4) Opportunity view columns upgraded from bare `string[]` to `ListColumn[]` with explicit types, alignment, and summary aggregation. 9 new tests.
+- [x] **P1: Actions Merge into Object Definitions** — Fixed action buttons never showing in Console/Studio because example object definitions lacked `actions` field. Added `mergeActionsIntoObjects()` helper (mirrors existing `mergeViewsIntoObjects` pattern) to root config and console shared config. Uses longest-prefix name matching with explicit `objectName` fallback. Created todo task actions (6: complete, start, clone, defer, set_reminder, assign) and kitchen-sink showcase actions (3: change_status, assign_owner, archive). All CRM/Todo/Kitchen Sink objects now serve `actions` in metadata. Fixes #840.
 
 ### Ecosystem & Marketplace
 - Plugin marketplace website with search, ratings, and install count

apps/console/objectstack.shared.ts

@@ -67,6 +67,52 @@ function mergeViewsIntoObjects(objects: any[], configs: any[]): any[] {
   });
 }
 
+// ---------------------------------------------------------------------------
+// Merge stack-level actions into object definitions.
+// Actions declared at the stack level (actions[]) need to be merged into
+// individual object definitions so the runtime protocol (and Console/Studio)
+// can render action buttons directly from objectDef.actions.
+// Matching uses explicit objectName on the action, or longest object-name
+// prefix of the action name (e.g. "account_send_email" → "account").
+// ---------------------------------------------------------------------------
+function mergeActionsIntoObjects(objects: any[], configs: any[]): any[] {
+  const allActions: any[] = [];
+  for (const config of configs) {
+    if (Array.isArray(config.actions)) {
+      allActions.push(...config.actions);
+    }
+  }
+  if (allActions.length === 0) return objects;
+
+  // Sort object names longest-first so "order_item" matches before "order"
+  const objectNames = objects.map((o: any) => o.name as string)
+    .filter(Boolean)
+    .sort((a, b) => b.length - a.length);
+
+  const actionsByObject: Record<string, any[]> = {};
+  for (const action of allActions) {
+    let target: string | undefined = action.objectName;
+    if (!target) {
+      for (const name of objectNames) {
+        if (action.name.startsWith(name + '_')) {
+          target = name;
+          break;
+        }
+      }
+    }
+    if (target) {
+      if (!actionsByObject[target]) actionsByObject[target] = [];
+      actionsByObject[target].push(action);
+    }
+  }
+
+  return objects.map((obj: any) => {
+    const actions = actionsByObject[obj.name];
+    if (!actions) return obj;
+    return { ...obj, actions: [...(obj.actions || []), ...actions] };
+  });
+}
+
 const allConfigs = [crmConfig, todoConfig, kitchenSinkConfig];
 
 export const sharedConfig = {
@@ -81,12 +127,15 @@ export const sharedConfig = {
   // ============================================================================
   // Merged Stack Configuration (CRM + Todo + Kitchen Sink + Mock Metadata)
   // ============================================================================
-  objects: mergeViewsIntoObjects(
-    [
-      ...(crmConfig.objects || []),
-      ...(todoConfig.objects || []),
-      ...(kitchenSinkConfig.objects || []),
-    ],
+  objects: mergeActionsIntoObjects(
+    mergeViewsIntoObjects(
+      [
+        ...(crmConfig.objects || []),
+        ...(todoConfig.objects || []),
+        ...(kitchenSinkConfig.objects || []),
+      ],
+      allConfigs,
+    ),
     allConfigs,
   ),
   apps: [
@@ -143,10 +192,13 @@ export const sharedConfig = {
 };
 
 // defineStack() validates the config but strips non-standard properties like
-// listViews from objects. Re-merge listViews after validation so the runtime
-// protocol serves objects with their view definitions (calendar, kanban, etc.).
+// listViews and actions from objects. Re-merge after validation so the runtime
+// protocol serves objects with their view and action definitions.
 const validated = defineStack(sharedConfig as Parameters<typeof defineStack>[0]);
 export default {
   ...validated,
-  objects: mergeViewsIntoObjects(validated.objects || [], allConfigs),
+  objects: mergeActionsIntoObjects(
+    mergeViewsIntoObjects(validated.objects || [], allConfigs),
+    allConfigs,
+  ),
 };

examples/crm/src/actions/account.actions.ts

@@ -17,7 +17,8 @@ export const AccountActions = [
     label: 'Assign Owner',
     icon: 'user-plus',
     type: 'api' as const,
-    locations: ['record_header' as const, 'list_item' as const],
+    locations: ['record_header' as const, 'list_item' as const, 'list_toolbar' as const],
+    bulkEnabled: true,
     params: [
       { name: 'owner_id', label: 'New Owner', type: 'lookup' as const, required: true },
     ],

examples/crm/src/actions/contact.actions.ts

@@ -4,7 +4,8 @@ export const ContactActions = [
     label: 'Send Email',
     icon: 'mail',
     type: 'api' as const,
-    locations: ['record_header' as const, 'list_item' as const],
+    locations: ['record_header' as const, 'list_item' as const, 'list_toolbar' as const],
+    bulkEnabled: true,
     params: [
       { name: 'subject', label: 'Subject', type: 'text' as const, required: true },
       { name: 'body', label: 'Message', type: 'textarea' as const },
@@ -17,6 +18,7 @@ export const ContactActions = [
     icon: 'user-check',
     type: 'api' as const,
     locations: ['record_header' as const],
+    visible: "type !== 'Customer'",
     confirmText: 'Convert this contact to a customer?',
     refreshAfter: true,
     successMessage: 'Contact converted to customer',

examples/crm/src/actions/opportunity.actions.ts

@@ -4,7 +4,9 @@ export const OpportunityActions = [
     label: 'Change Stage',
     icon: 'arrow-right-circle',
     type: 'api' as const,
-    locations: ['record_header' as const, 'list_item' as const],
+    locations: ['record_header' as const, 'list_item' as const, 'list_toolbar' as const],
+    bulkEnabled: true,
+    visible: "stage !== 'closed_won' && stage !== 'closed_lost'",
     params: [
       {
         name: 'new_stage', label: 'New Stage', type: 'select' as const, required: true,
@@ -28,6 +30,7 @@ export const OpportunityActions = [
     type: 'api' as const,
     locations: ['record_header' as const],
     variant: 'primary' as const,
+    visible: "stage !== 'closed_won' && stage !== 'closed_lost'",
     confirmText: 'Mark this opportunity as Closed Won?',
     refreshAfter: true,
     successMessage: 'Opportunity marked as won!',
@@ -39,6 +42,7 @@ export const OpportunityActions = [
     type: 'api' as const,
     locations: ['record_more' as const],
     variant: 'danger' as const,
+    visible: "stage !== 'closed_won' && stage !== 'closed_lost'",
     params: [
       { name: 'loss_reason', label: 'Reason for Loss', type: 'text' as const, required: true },
     ],

examples/crm/src/actions/project.actions.ts

@@ -4,6 +4,7 @@ export const ProjectActions = [
     label: 'Change Status',
     icon: 'circle-check',
     type: 'api' as const,
+    objectName: 'project_task',
     locations: ['record_header' as const, 'list_item' as const],
     params: [
       {
@@ -24,6 +25,7 @@ export const ProjectActions = [
     label: 'Assign User',
     icon: 'user-plus',
     type: 'api' as const,
+    objectName: 'project_task',
     locations: ['record_header' as const, 'list_item' as const],
     params: [
       { name: 'assignee_id', label: 'Assignee', type: 'lookup' as const, required: true },

examples/kitchen-sink/objectstack.config.ts

@@ -3,6 +3,7 @@ import { App } from '@objectstack/spec/ui';
 import { KitchenSinkObject } from './src/objects/kitchen_sink.object';
 import { AccountObject } from './src/objects/account.object';
 import { ShowcaseObject } from './src/objects/showcase.object';
+import { ShowcaseActions } from './src/objects/showcase.actions';
 
 // Helper to create dates relative to today
 const daysFromNow = (days: number) => {
@@ -54,6 +55,9 @@ export default defineStack({
       },
     },
   ],
+  actions: [
+    ...ShowcaseActions,
+  ],
   apps: [
     App.create({
       name: 'analytics_app',

examples/kitchen-sink/src/objects/showcase.actions.ts

@@ -0,0 +1,51 @@
+export const ShowcaseActions = [
+  {
+    name: 'showcase_change_status',
+    label: 'Change Status',
+    icon: 'arrow-right-circle',
+    type: 'api' as const,
+    locations: ['record_header' as const, 'list_item' as const, 'list_toolbar' as const],
+    bulkEnabled: true,
+    visible: "status !== 'archived'",
+    params: [
+      {
+        name: 'new_status', label: 'New Status', type: 'select' as const, required: true,
+        options: [
+          { label: 'Draft', value: 'draft' },
+          { label: 'Active', value: 'active' },
+          { label: 'Review', value: 'review' },
+          { label: 'Completed', value: 'completed' },
+          { label: 'Archived', value: 'archived' },
+        ],
+      },
+    ],
+    refreshAfter: true,
+    successMessage: 'Status updated',
+  },
+  {
+    name: 'showcase_assign_owner',
+    label: 'Assign Owner',
+    icon: 'user-plus',
+    type: 'api' as const,
+    locations: ['record_header' as const, 'list_toolbar' as const],
+    bulkEnabled: true,
+    params: [
+      { name: 'owner_email', label: 'Owner Email', type: 'email' as const, required: true },
+      { name: 'notify', label: 'Send Notification', type: 'boolean' as const },
+    ],
+    refreshAfter: true,
+    successMessage: 'Owner assigned',
+  },
+  {
+    name: 'showcase_archive',
+    label: 'Archive',
+    icon: 'archive',
+    type: 'api' as const,
+    locations: ['record_more' as const],
+    variant: 'danger' as const,
+    visible: "status !== 'archived'",
+    confirmText: 'Are you sure you want to archive this item?',
+    refreshAfter: true,
+    successMessage: 'Item archived',
+  },
+];

examples/msw-todo/objectstack.config.ts

@@ -26,6 +26,45 @@ export const TaskObject = ObjectSchema.create({
   },
 });
 
+/**
+ * Task Actions — complete, toggle, and delete operations
+ */
+export const TaskActions = [
+  {
+    name: 'task_complete',
+    label: 'Mark Complete',
+    icon: 'check-circle-2',
+    type: 'api' as const,
+    locations: ['record_header' as const, 'list_item' as const, 'list_toolbar' as const],
+    visible: 'is_completed === false',
+    bulkEnabled: true,
+    refreshAfter: true,
+    successMessage: 'Task completed',
+  },
+  {
+    name: 'task_reopen',
+    label: 'Reopen Task',
+    icon: 'rotate-ccw',
+    type: 'api' as const,
+    locations: ['record_header' as const, 'list_item' as const],
+    visible: 'is_completed === true',
+    refreshAfter: true,
+    successMessage: 'Task reopened',
+  },
+  {
+    name: 'task_delete',
+    label: 'Delete Task',
+    icon: 'trash-2',
+    type: 'api' as const,
+    locations: ['record_more' as const, 'list_toolbar' as const],
+    variant: 'danger' as const,
+    bulkEnabled: true,
+    confirmText: 'Are you sure you want to delete this task?',
+    refreshAfter: true,
+    successMessage: 'Task deleted',
+  },
+];
+
 /**
  * App Configuration — Standard ObjectStackDefinition format
  */
@@ -47,6 +86,9 @@ export default defineStack({
       },
     },
   ],
+  actions: [
+    ...TaskActions,
+  ],
   apps: [
     App.create({
       name: 'task_app',

examples/todo/objectstack.config.ts

@@ -1,6 +1,7 @@
 import { defineStack } from '@objectstack/spec';
 import { App } from '@objectstack/spec/ui';
 import { TodoTask } from './src/domains/todo/task.object';
+import { TodoTaskActions } from './src/domains/todo/task.actions';
 
 // Helper to create dates relative to today
 const daysFromNow = (days: number) => {
@@ -55,6 +56,9 @@ export default defineStack({
       },
     },
   ],
+  actions: [
+    ...TodoTaskActions,
+  ],
   apps: [
     App.create({
       name: 'todo_app',