@elevasis/core 0.1.0

package/src/platform/registry/command-view.ts

@@ -0,0 +1,180 @@
+/**
+ * Command View Types
+ *
+ * Unified type definitions for the Command View graph visualization.
+ * These types are used by both backend serialization and frontend rendering.
+ *
+ * Command View shows the resource graph: agents, workflows, triggers, integrations,
+ * external resources, and human checkpoints with their relationships.
+ */
+
+import type {
+  ResourceDefinition,
+  TriggerDefinition,
+  IntegrationDefinition,
+  ExternalResourceDefinition,
+  HumanCheckpointDefinition,
+  DomainDefinition
+} from './types'
+
+// ============================================================================
+// Node Types - Resources that appear in the graph
+// ============================================================================
+
+/**
+ * Extended agent metadata for Command View
+ * Includes model and capability information for graph display
+ */
+export interface CommandViewAgent extends ResourceDefinition {
+  type: 'agent'
+  modelProvider: string // e.g., 'anthropic', 'openai'
+  modelId: string // e.g., 'claude-sonnet-4-20250514'
+  toolCount: number
+  hasKnowledgeMap: boolean
+  hasMemory: boolean
+  sessionCapable: boolean // Explicit session capability declaration
+}
+
+/**
+ * Extended workflow metadata for Command View
+ * Includes step information for graph display
+ */
+export interface CommandViewWorkflow extends ResourceDefinition {
+  type: 'workflow'
+  stepCount: number
+  entryPoint: string
+}
+
+/**
+ * Node type categories for Command View
+ * Simplified categorization for UI rendering and layout
+ */
+export type CommandViewNodeType = 'agent' | 'workflow' | 'trigger' | 'integration' | 'external' | 'human'
+
+/**
+ * Union type for all node types in Command View
+ * Frontend can use this for type-safe node handling
+ */
+export type CommandViewNode =
+  | CommandViewAgent
+  | CommandViewWorkflow
+  | TriggerDefinition
+  | IntegrationDefinition
+  | ExternalResourceDefinition
+  | HumanCheckpointDefinition
+
+// ============================================================================
+// Edge Types - Relationships between resources
+// ============================================================================
+
+/**
+ * Relationship types between resources
+ *
+ * - triggers: Resource initiates/starts another resource (orange)
+ * - uses: Resource uses an integration (teal)
+ * - approval: Resource requires human approval (yellow)
+ */
+export type RelationshipType = 'triggers' | 'uses' | 'approval'
+
+/**
+ * Command View edge (relationship between resources)
+ */
+export interface CommandViewEdge {
+  id: string
+  source: string // Source node ID
+  target: string // Target node ID
+  relationship: RelationshipType
+  label?: string // Optional label for the edge
+}
+
+// ============================================================================
+// Graph Data Structure
+// ============================================================================
+
+/**
+ * Command View data structure
+ * Complete graph data for visualization
+ *
+ * Backend serializes this once at startup and serves it via /command-view endpoint.
+ * Frontend consumes this directly for graph rendering.
+ */
+export interface CommandViewData {
+  workflows: CommandViewWorkflow[]
+  agents: CommandViewAgent[]
+  triggers: TriggerDefinition[]
+  integrations: IntegrationDefinition[]
+  externalResources: ExternalResourceDefinition[]
+  humanCheckpoints: HumanCheckpointDefinition[]
+  edges: CommandViewEdge[]
+  domainDefinitions?: DomainDefinition[]
+}
+
+// ============================================================================
+// Type Guards
+// ============================================================================
+
+/**
+ * Check if a node is an agent
+ */
+export function isAgent(node: CommandViewNode): node is CommandViewAgent {
+  return 'type' in node && node.type === 'agent'
+}
+
+/**
+ * Check if a node is a workflow
+ */
+export function isWorkflow(node: CommandViewNode): node is CommandViewWorkflow {
+  return 'type' in node && node.type === 'workflow'
+}
+
+/**
+ * Check if a node is a trigger
+ */
+export function isTrigger(node: CommandViewNode): node is TriggerDefinition {
+  return 'type' in node && node.type === 'trigger'
+}
+
+/**
+ * Check if a node is an integration
+ */
+export function isIntegration(node: CommandViewNode): node is IntegrationDefinition {
+  return 'type' in node && node.type === 'integration'
+}
+
+/**
+ * Check if a node is an external resource
+ */
+export function isExternalResource(node: CommandViewNode): node is ExternalResourceDefinition {
+  return 'type' in node && node.type === 'external'
+}
+
+/**
+ * Check if a node is a human checkpoint
+ */
+export function isHumanCheckpoint(node: CommandViewNode): node is HumanCheckpointDefinition {
+  return 'type' in node && node.type === 'human'
+}
+
+// ============================================================================
+// Helper Functions
+// ============================================================================
+
+/**
+ * Get node ID - all resources now use unified resourceId field
+ */
+export function getNodeId(node: CommandViewNode): string {
+  return node.resourceId
+}
+
+/**
+ * Get node type for categorization
+ */
+export function getNodeType(node: CommandViewNode): CommandViewNodeType {
+  if (isAgent(node)) return 'agent'
+  if (isWorkflow(node)) return 'workflow'
+  if (isTrigger(node)) return 'trigger'
+  if (isIntegration(node)) return 'integration'
+  if (isExternalResource(node)) return 'external'
+  // isHumanCheckpoint is last fallback
+  return 'human'
+}

package/src/platform/registry/domains.ts

@@ -0,0 +1,165 @@
+/**
+ * Standard Domain Definitions
+ * Centralized domain constants and definitions for all organization resources.
+ */
+
+import type { DomainDefinition } from './types'
+
+// ============================================================================
+// Standard Domain IDs
+// ============================================================================
+
+export const DOMAINS = {
+  // Business domains
+  INBOUND_PIPELINE: 'inbound-pipeline',
+  LEAD_GEN_PIPELINE: 'lead-gen-pipeline',
+  SUPPORT: 'support',
+  CLIENT_SUPPORT: 'client-support',
+  DELIVERY: 'delivery',
+  OPERATIONS: 'operations',
+  FINANCE: 'finance',
+  EXECUTIVE: 'executive',
+  INSTANTLY: 'instantly',
+
+  // Technical domains
+  TESTING: 'testing',
+  INTERNAL: 'internal',
+  INTEGRATION: 'integration',
+  UTILITY: 'utility',
+  DIAGNOSTIC: 'diagnostic'
+} as const
+
+/**
+ * ResourceDomain - Strongly typed domain identifier
+ * Use this type for all domain references to ensure compile-time validation.
+ */
+export type ResourceDomain = (typeof DOMAINS)[keyof typeof DOMAINS]
+
+// ============================================================================
+// Domain Definitions
+// ============================================================================
+
+export const INBOUND_PIPELINE_DOMAIN: DomainDefinition = {
+  id: DOMAINS.INBOUND_PIPELINE,
+  name: 'Inbound Pipeline',
+  description: 'End-to-end inbound client acquisition from first reply to onboarding',
+  color: 'blue'
+}
+
+export const LEAD_GEN_PIPELINE_DOMAIN: DomainDefinition = {
+  id: DOMAINS.LEAD_GEN_PIPELINE,
+  name: 'Lead Gen Pipeline',
+  description: 'Lead scraping, enrichment, qualification, and personalization',
+  color: 'cyan'
+}
+
+export const SUPPORT_DOMAIN: DomainDefinition = {
+  id: DOMAINS.SUPPORT,
+  name: 'Customer Support',
+  description: 'Ticket triage, knowledge base, escalations',
+  color: 'green'
+}
+
+export const CLIENT_SUPPORT_DOMAIN: DomainDefinition = {
+  id: DOMAINS.CLIENT_SUPPORT,
+  name: 'Client Support',
+  description: 'Client change requests, bug reports, and feature requests',
+  color: 'teal'
+}
+
+export const DELIVERY_DOMAIN: DomainDefinition = {
+  id: DOMAINS.DELIVERY,
+  name: 'Client Delivery',
+  description: 'Project execution and milestone tracking',
+  color: 'orange'
+}
+
+export const OPERATIONS_DOMAIN: DomainDefinition = {
+  id: DOMAINS.OPERATIONS,
+  name: 'Operations',
+  description: 'Internal business operations and administration',
+  color: 'violet'
+}
+
+export const FINANCE_DOMAIN: DomainDefinition = {
+  id: DOMAINS.FINANCE,
+  name: 'Finance',
+  description: 'Billing, invoicing, and financial operations',
+  color: 'pink'
+}
+
+export const EXECUTIVE_DOMAIN: DomainDefinition = {
+  id: DOMAINS.EXECUTIVE,
+  name: 'Executive Operations',
+  description: 'High-level business orchestration and decision-making',
+  color: 'indigo'
+}
+
+export const TESTING_DOMAIN: DomainDefinition = {
+  id: DOMAINS.TESTING,
+  name: 'Testing',
+  description: 'Test resources and development workflows',
+  color: 'gray'
+}
+
+export const INTERNAL_DOMAIN: DomainDefinition = {
+  id: DOMAINS.INTERNAL,
+  name: 'Internal',
+  description: 'Internal platform resources',
+  color: 'dark'
+}
+
+export const INTEGRATION_DOMAIN: DomainDefinition = {
+  id: DOMAINS.INTEGRATION,
+  name: 'Integration',
+  description: 'External service integrations',
+  color: 'teal'
+}
+
+export const INSTANTLY_DOMAIN: DomainDefinition = {
+  id: DOMAINS.INSTANTLY,
+  name: 'Instantly Toolkit',
+  description: 'Instantly campaign creation, analytics, and optimization',
+  color: 'lime'
+}
+
+export const UTILITY_DOMAIN: DomainDefinition = {
+  id: DOMAINS.UTILITY,
+  name: 'Utility',
+  description: 'Utility workflows for maintenance and diagnostics',
+  color: 'grape'
+}
+
+export const DIAGNOSTIC_DOMAIN: DomainDefinition = {
+  id: DOMAINS.DIAGNOSTIC,
+  name: 'Diagnostic',
+  description: 'Diagnostic workflows for testing integrations and services',
+  color: 'yellow'
+}
+
+/**
+ * Domain lookup map for O(1) access during serialization
+ */
+export const DOMAIN_MAP: Record<ResourceDomain, DomainDefinition> = {
+  [DOMAINS.INBOUND_PIPELINE]: INBOUND_PIPELINE_DOMAIN,
+  [DOMAINS.LEAD_GEN_PIPELINE]: LEAD_GEN_PIPELINE_DOMAIN,
+  [DOMAINS.SUPPORT]: SUPPORT_DOMAIN,
+  [DOMAINS.CLIENT_SUPPORT]: CLIENT_SUPPORT_DOMAIN,
+  [DOMAINS.DELIVERY]: DELIVERY_DOMAIN,
+  [DOMAINS.OPERATIONS]: OPERATIONS_DOMAIN,
+  [DOMAINS.FINANCE]: FINANCE_DOMAIN,
+  [DOMAINS.EXECUTIVE]: EXECUTIVE_DOMAIN,
+  [DOMAINS.TESTING]: TESTING_DOMAIN,
+  [DOMAINS.INTERNAL]: INTERNAL_DOMAIN,
+  [DOMAINS.INSTANTLY]: INSTANTLY_DOMAIN,
+  [DOMAINS.INTEGRATION]: INTEGRATION_DOMAIN,
+  [DOMAINS.UTILITY]: UTILITY_DOMAIN,
+  [DOMAINS.DIAGNOSTIC]: DIAGNOSTIC_DOMAIN
+}
+
+/**
+ * Get domain definition by ID
+ */
+export function getDomainDefinition(id: ResourceDomain): DomainDefinition {
+  return DOMAIN_MAP[id]
+}

package/src/platform/registry/index.ts

@@ -0,0 +1,93 @@
+/**
+ * Resource Registry exports
+ */
+
+export * from './domains'
+
+export { RESERVED_RESOURCE_IDS, SYSTEM_RESOURCE_IDS, isReservedResourceId } from './reserved'
+
+export { ResourceRegistry } from './resource-registry'
+export type { DeploymentSpec, OrganizationRegistry, RemoteOrgConfig } from './resource-registry'
+
+// Validation utilities
+export {
+  validateDeploymentSpec,
+  validateRelationships,
+  validateExecutionInterface,
+  RegistryValidationError
+} from './validation'
+
+// Serialization utilities
+export { serializeAllOrganizations, serializeOrganization, buildEdges } from './serialization'
+
+// Types
+export type {
+  ResourceStatus,
+  ResourceType,
+  ExecutableResourceType,
+  ResourceDefinition,
+  ResourceList,
+  TriggerDefinition,
+  IntegrationDefinition,
+  RelationshipDeclaration,
+  ResourceRelationships,
+  ExternalPlatform,
+  ExternalResourceDefinition,
+  HumanCheckpointDefinition,
+  DomainDefinition,
+  WebhookProviderType,
+  WebhookTriggerConfig,
+  ScheduleTriggerConfig,
+  EventTriggerConfig,
+  TriggerConfig
+} from './types'
+
+// Serialized Types (for API responses)
+export type {
+  SerializedAgentDefinition,
+  SerializedWorkflowDefinition,
+  SerializedExecutionInterface,
+  SerializedExecutionFormSchema,
+  SerializedFormField,
+  SerializedFormSchema,
+  SerializedOrganizationData
+} from './serialized-types'
+
+// Command View Types (for graph visualization)
+export type {
+  CommandViewAgent,
+  CommandViewWorkflow,
+  CommandViewNode,
+  CommandViewNodeType,
+  CommandViewEdge,
+  CommandViewData,
+  RelationshipType
+} from './command-view'
+
+// Command View Utilities
+export {
+  isAgent,
+  isWorkflow,
+  isTrigger,
+  isIntegration,
+  isExternalResource,
+  isHumanCheckpoint,
+  getNodeId,
+  getNodeType
+} from './command-view'
+
+// Command View Stats types (moved from command-view/)
+export type {
+  StatsTimeRange,
+  ResourceStats,
+  ResourceErrorsResponse,
+  ErrorSummary,
+  CommandViewExecution,
+  ResourceExecutionsResponse,
+  HumanCheckpointStats,
+  CommandViewStatsResponse
+} from './stats-types'
+
+// Resource Metadata (icon names, colors)
+export type { ResourceDefinitionType, NodeColorType } from './resource-metadata'
+export { resourceTypeIconNames, resourceTypeColors, getResourceIconName, getResourceColor } from './resource-metadata'

package/src/platform/registry/reserved.ts

@@ -0,0 +1,24 @@
+/**
+ * Reserved Resource IDs
+ * Resource IDs reserved for built-in platform resources.
+ * External SDK deployments cannot use these IDs.
+ */
+
+/**
+ * Set of resource IDs reserved for built-in platform resources.
+ * These IDs cannot be used by external SDK deployments.
+ */
+export const RESERVED_RESOURCE_IDS = new Set(['command-center-assistant'])
+
+/**
+ * Array form of RESERVED_RESOURCE_IDS for Supabase query filtering.
+ * Supabase `.not('col', 'in', ...)` requires an array, not a Set.
+ */
+export const SYSTEM_RESOURCE_IDS = Array.from(RESERVED_RESOURCE_IDS)
+
+/**
+ * Check if a resource ID is reserved for platform use
+ */
+export function isReservedResourceId(resourceId: string): boolean {
+  return RESERVED_RESOURCE_IDS.has(resourceId)
+}

package/src/platform/registry/resource-metadata.ts

@@ -0,0 +1,59 @@
+/**
+ * Resource Type Metadata
+ *
+ * Centralized metadata for ResourceDefinition types including icon names and colors.
+ * Icon names reference @tabler/icons-react - UI layer maps these to actual components.
+ */
+
+import type { ResourceDefinition } from './types'
+
+/**
+ * All valid resource types from ResourceDefinition
+ * Derived from the base interface to ensure consistency
+ */
+export type ResourceDefinitionType = ResourceDefinition['type']
+
+/**
+ * Node color types for graph visualization
+ * Used by both @repo/core (metadata) and @repo/ui (components)
+ */
+export type NodeColorType = 'violet' | 'blue' | 'orange' | 'teal' | 'gray' | 'yellow'
+
+/**
+ * Tabler icon names for each resource type
+ * UI packages map these strings to actual icon components
+ */
+export const resourceTypeIconNames: Record<ResourceDefinitionType, string> = {
+  agent: 'IconBrain',
+  workflow: 'IconGitBranch',
+  trigger: 'IconBolt',
+  integration: 'IconPlug',
+  external: 'IconExternalLink',
+  human: 'IconUser'
+}
+
+/**
+ * Mantine color names for each resource type
+ */
+export const resourceTypeColors: Record<ResourceDefinitionType, NodeColorType> = {
+  agent: 'violet',
+  workflow: 'blue',
+  trigger: 'orange',
+  integration: 'teal',
+  external: 'gray',
+  human: 'yellow'
+}
+
+/**
+ * Get icon name for a resource type
+ */
+export function getResourceIconName(type: ResourceDefinitionType): string {
+  return resourceTypeIconNames[type]
+}
+
+/**
+ * Get color for a resource type
+ */
+export function getResourceColor(type: ResourceDefinitionType): NodeColorType {
+  return resourceTypeColors[type]
+}

package/src/platform/registry/resource-registry.command-queue-groups.test.ts

@@ -0,0 +1,129 @@
+/**
+ * Tests for Human Checkpoints in ResourceRegistry
+ */
+
+import { describe, it, expect, beforeEach } from 'vitest'
+import { ResourceRegistry } from './resource-registry'
+import type { DeploymentSpec } from './resource-registry'
+import type { HumanCheckpointDefinition } from './types'
+import type { AgentDefinition, WorkflowDefinition } from '../../execution/engine'
+
+// Mock agent
+const mockAgent: AgentDefinition = {
+  config: {
+    resourceId: 'test-agent',
+    name: 'Test Agent',
+    description: 'Test agent',
+    version: '1.0.0',
+    type: 'agent',
+    status: 'dev'
+  },
+  modelConfig: {
+    provider: 'openai',
+    model: 'gpt-5.4-mini',
+    apiKey: 'test-key',
+    temperature: 1
+  },
+  tools: [],
+  systemPrompt: 'Test prompt'
+}
+
+// Mock workflow
+const mockWorkflow: WorkflowDefinition = {
+  config: {
+    resourceId: 'test-workflow',
+    name: 'Test Workflow',
+    description: 'Test workflow',
+    version: '1.0.0',
+    type: 'workflow',
+    status: 'dev'
+  },
+  entryPoint: 'start',
+  steps: {}
+}
+
+describe('ResourceRegistry - Human Checkpoints', () => {
+  let registry: ResourceRegistry
+
+  beforeEach(() => {
+    const humanCheckpoint: HumanCheckpointDefinition = {
+      resourceId: 'test-approval',
+      type: 'human',
+      version: '1.0.0',
+      name: 'Test Approval',
+      description: 'Test human checkpoint',
+      status: 'dev',
+      requestedBy: {
+        agents: ['test-agent']
+      },
+      routesTo: {
+        workflows: ['test-workflow']
+      }
+    }
+
+    const resources: DeploymentSpec = {
+      agents: [mockAgent],
+      workflows: [mockWorkflow],
+      humanCheckpoints: [humanCheckpoint]
+    }
+
+    registry = new ResourceRegistry({
+      'test-org': resources
+    })
+  })
+
+  describe('getHumanCheckpoints', () => {
+    it('should return all human checkpoints for an organization', () => {
+      const humanCheckpoints = registry.getHumanCheckpoints('test-org')
+      expect(humanCheckpoints).toHaveLength(1)
+      expect(humanCheckpoints[0].resourceId).toBe('test-approval')
+    })
+
+    it('should return empty array for org without human checkpoints', () => {
+      const humanCheckpoints = registry.getHumanCheckpoints('non-existent-org')
+      expect(humanCheckpoints).toEqual([])
+    })
+  })
+
+  describe('getHumanCheckpoint', () => {
+    it('should return specific human checkpoint by ID', () => {
+      const humanCheckpoint = registry.getHumanCheckpoint('test-org', 'test-approval')
+      expect(humanCheckpoint).not.toBeNull()
+      expect(humanCheckpoint?.resourceId).toBe('test-approval')
+      expect(humanCheckpoint?.name).toBe('Test Approval')
+    })
+
+    it('should return null for non-existent human checkpoint', () => {
+      const humanCheckpoint = registry.getHumanCheckpoint('test-org', 'non-existent')
+      expect(humanCheckpoint).toBeNull()
+    })
+  })
+
+  describe('serializeOrganization', () => {
+    it('should include human checkpoints in command view data', () => {
+      const commandView = registry.getCommandViewData('test-org')
+      expect(commandView.humanCheckpoints).toHaveLength(1)
+      expect(commandView.humanCheckpoints[0].resourceId).toBe('test-approval')
+    })
+  })
+
+  describe('buildEdges', () => {
+    it('should create approval edges from requestedBy', () => {
+      const commandView = registry.getCommandViewData('test-org')
+      const approvalEdges = commandView.edges.filter((e) => e.relationship === 'approval')
+      expect(approvalEdges).toHaveLength(1)
+      expect(approvalEdges[0].source).toBe('test-agent')
+      expect(approvalEdges[0].target).toBe('test-approval')
+    })
+
+    it('should create triggers edges to routesTo', () => {
+      const commandView = registry.getCommandViewData('test-org')
+      const triggerEdges = commandView.edges.filter(
+        (e) => e.source === 'test-approval' && e.relationship === 'triggers'
+      )
+      expect(triggerEdges).toHaveLength(1)
+      expect(triggerEdges[0].source).toBe('test-approval')
+      expect(triggerEdges[0].target).toBe('test-workflow')
+    })
+  })
+})