feat: refactor flows and agents imports for better organization and type safety

Author: hotlong

examples/app-crm/objectstack.config.ts

@@ -8,18 +8,16 @@ import * as apis from './src/apis';
 import * as actions from './src/actions';
 import * as dashboards from './src/dashboards';
 import * as reports from './src/reports';
-import * as flows from './src/flows';
-import * as agents from './src/agents';
+import { allFlows } from './src/flows';
+import { allAgents } from './src/agents';
 import * as ragPipelines from './src/rag';
 import * as profiles from './src/profiles';
 import * as apps from './src/apps';
-import * as interfaces from './src/interfaces';
 import * as translations from './src/translations';
 import { CrmSeedData } from './src/data';
 
 // ─── Sharing & Security (special: mixed single/array values) ───────
 import {
-  OrganizationDefaults,
   AccountTeamSharingRule, TerritorySharingRules,
   OpportunitySalesSharingRule,
   CaseEscalationSharingRule,
@@ -56,12 +54,11 @@ export default defineStack({
   actions: Object.values(actions),
   dashboards: Object.values(dashboards),
   reports: Object.values(reports),
-  flows: Object.values(flows) as any,
-  agents: Object.values(agents) as any,
+  flows: allFlows,
+  agents: allAgents,
   ragPipelines: Object.values(ragPipelines),
-  profiles: Object.values(profiles),
+  permissions: Object.values(profiles),
   apps: Object.values(apps),
-  interfaces: Object.values(interfaces),
 
   // Seed Data (top-level, registered as metadata)
   data: CrmSeedData,
@@ -77,13 +74,16 @@ export default defineStack({
   // I18n Translation Bundles (en, zh-CN, ja-JP, es-ES)
   translations: Object.values(translations),
 
-  // Sharing & security (requires explicit wiring)
+  // Sharing & security
   sharingRules: [
     AccountTeamSharingRule,
     OpportunitySalesSharingRule,
     CaseEscalationSharingRule,
     ...TerritorySharingRules,
   ],
-  roleHierarchy: RoleHierarchy,
-  organizationDefaults: OrganizationDefaults,
-} as any);
+  roles: RoleHierarchy.roles.map((r: { name: string; label: string; parentRole: string | null }) => ({
+    name: r.name,
+    label: r.label,
+    parent: r.parentRole ?? undefined,
+  })),
+});

examples/app-crm/src/agents/index.ts

@@ -1,5 +1,7 @@
 // Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.
 
+import type { Agent } from '@objectstack/spec/ai';
+
 /**
  * Agent Definitions Barrel
  */
@@ -8,3 +10,18 @@ export { LeadEnrichmentAgent } from './lead-enrichment.agent';
 export { RevenueIntelligenceAgent } from './revenue-intelligence.agent';
 export { SalesAssistantAgent } from './sales.agent';
 export { ServiceAgent } from './service.agent';
+
+import { EmailCampaignAgent } from './email-campaign.agent';
+import { LeadEnrichmentAgent } from './lead-enrichment.agent';
+import { RevenueIntelligenceAgent } from './revenue-intelligence.agent';
+import { SalesAssistantAgent } from './sales.agent';
+import { ServiceAgent } from './service.agent';
+
+/** All agent definitions as a typed array for defineStack() */
+export const allAgents: Agent[] = [
+  EmailCampaignAgent,
+  LeadEnrichmentAgent,
+  RevenueIntelligenceAgent,
+  SalesAssistantAgent,
+  ServiceAgent,
+];

examples/app-crm/src/flows/index.ts

@@ -1,5 +1,7 @@
 // Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.
 
+import type { Flow } from '@objectstack/spec/automation';
+
 /**
  * Flow Definitions Barrel
  */
@@ -8,3 +10,18 @@ export { CaseEscalationFlow } from './case-escalation.flow';
 export { LeadConversionFlow } from './lead-conversion.flow';
 export { OpportunityApprovalFlow } from './opportunity-approval.flow';
 export { QuoteGenerationFlow } from './quote-generation.flow';
+
+import { CampaignEnrollmentFlow } from './campaign-enrollment.flow';
+import { CaseEscalationFlow } from './case-escalation.flow';
+import { LeadConversionFlow } from './lead-conversion.flow';
+import { OpportunityApprovalFlow } from './opportunity-approval.flow';
+import { QuoteGenerationFlow } from './quote-generation.flow';
+
+/** All flow definitions as a typed array for defineStack() */
+export const allFlows: Flow[] = [
+  CampaignEnrollmentFlow,
+  CaseEscalationFlow,
+  LeadConversionFlow,
+  OpportunityApprovalFlow,
+  QuoteGenerationFlow,
+];

examples/app-crm/tsconfig.json

@@ -8,7 +8,7 @@
     "forceConsistentCasingInFileNames": true,
     "skipLibCheck": true,
     "outDir": "./dist",
-    "rootDir": "./src"
+    "rootDir": "."
   },
-  "include": ["src/**/*"]
+  "include": ["src/**/*", "objectstack.config.ts"]
 }

examples/app-host/objectstack.config.ts

@@ -24,8 +24,9 @@ const authPlugin = new AuthPlugin({
 
 export default defineStack({
   manifest: {
-    id: 'app-host',
-    name: 'app_host',
+    id: 'com.example.host',
+    namespace: 'host',
+    name: 'App Host',
     version: '1.0.0',
     description: 'Host application aggregating CRM, Todo and BI plugins',
     type: 'app',
@@ -91,8 +92,9 @@ export default defineStack({
  */
 export const PreviewHostExample = defineStack({
   manifest: {
-    id: 'app-host-preview',
-    name: 'app_host_preview',
+    id: 'com.example.host-preview',
+    namespace: 'host',
+    name: 'App Host Preview',
     version: '1.0.0',
     description: 'Host application in preview/demo mode — bypasses login, simulates admin user',
     type: 'app',

examples/app-todo/objectstack.config.ts

@@ -7,7 +7,7 @@ import * as objects from './src/objects';
 import * as actions from './src/actions';
 import * as dashboards from './src/dashboards';
 import * as reports from './src/reports';
-import * as flows from './src/flows';
+import { allFlows } from './src/flows';
 import * as apps from './src/apps';
 import * as translations from './src/translations';
 
@@ -59,7 +59,7 @@ export default defineStack({
   actions: Object.values(actions),
   dashboards: Object.values(dashboards),
   reports: Object.values(reports),
-  flows: Object.values(flows) as any,
+  flows: allFlows,
   apps: Object.values(apps),
 
   // I18n Configuration — per-locale file organization

examples/app-todo/src/flows/index.ts

@@ -1,5 +1,7 @@
 // Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.
 
+import type { Flow } from '@objectstack/spec/automation';
+
 /**
  * Flow Definitions Barrel
  */
@@ -9,3 +11,18 @@ export {
   TaskCompletionFlow,
   QuickAddTaskFlow,
 } from './task.flow';
+
+import {
+  TaskReminderFlow,
+  OverdueEscalationFlow,
+  TaskCompletionFlow,
+  QuickAddTaskFlow,
+} from './task.flow';
+
+/** All flow definitions as a typed array for defineStack() */
+export const allFlows: Flow[] = [
+  TaskReminderFlow,
+  OverdueEscalationFlow,
+  TaskCompletionFlow,
+  QuickAddTaskFlow,
+];

examples/app-todo/src/flows/task.flow.ts

@@ -1,7 +1,6 @@
 // Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.
 
-import type { Automation } from '@objectstack/spec';
-type Flow = Automation.Flow;
+import type { Flow } from '@objectstack/spec/automation';
 
 /** Task Reminder Flow — scheduled flow to send reminders for upcoming tasks */
 export const TaskReminderFlow: Flow = {

examples/app-todo/tsconfig.json

@@ -8,7 +8,7 @@
     "forceConsistentCasingInFileNames": true,
     "skipLibCheck": true,
     "outDir": "./dist",
-    "rootDir": "./src"
+    "rootDir": "."
   },
-  "include": ["src/**/*"]
+  "include": ["src/**/*", "objectstack.config.ts"]
 }