@elevasis/core 0.11.1 → 0.12.0

package/src/organization-model/domains/navigation.ts

@@ -3,7 +3,8 @@ import {
   OPERATIONS_COMMAND_VIEW_SURFACE_ID,
   PROJECTS_VIEW_CAPABILITY_ID,
   PROJECTS_FEATURE_ID,
-  PROJECTS_INDEX_SURFACE_ID
+  PROJECTS_INDEX_SURFACE_ID,
+  SETTINGS_ROLES_SURFACE_ID
 } from '../contracts'
 import { DescriptionSchema, IconNameSchema, LabelSchema, ModelIdSchema, PathSchema, ReferenceIdsSchema } from './shared'
 
@@ -91,18 +92,6 @@ export const DEFAULT_ORGANIZATION_MODEL_NAVIGATION: z.infer<typeof OrganizationM
       resourceIds: [],
       capabilityIds: [PROJECTS_VIEW_CAPABILITY_ID]
     },
-    {
-      id: 'operations.organization-graph',
-      label: 'Organization Graph',
-      path: '/operations/organization-graph',
-      surfaceType: 'graph',
-      enabled: true,
-      featureId: 'operations',
-      featureIds: ['operations'],
-      entityIds: [],
-      resourceIds: [],
-      capabilityIds: ['operations.organization-graph']
-    },
     {
       id: OPERATIONS_COMMAND_VIEW_SURFACE_ID,
       label: 'Command View',
@@ -272,33 +261,45 @@ export const DEFAULT_ORGANIZATION_MODEL_NAVIGATION: z.infer<typeof OrganizationM
       resourceIds: [],
       capabilityIds: []
     },
-    {
-      id: 'settings.appearance',
-      label: 'Appearance',
-      path: '/settings/appearance',
+    {
+      id: 'settings.appearance',
+      label: 'Appearance',
+      path: '/settings/appearance',
       surfaceType: 'settings',
       enabled: true,
       featureId: 'settings',
       featureIds: ['settings'],
       entityIds: [],
-      resourceIds: [],
-      capabilityIds: []
-    },
-    {
-      id: 'settings.organization',
-      label: 'Organization',
-      path: '/settings/organization',
+      resourceIds: [],
+      capabilityIds: []
+    },
+    {
+      id: SETTINGS_ROLES_SURFACE_ID,
+      label: 'My Roles',
+      path: '/settings/roles',
+      surfaceType: 'settings',
+      enabled: true,
+      featureId: 'settings',
+      featureIds: ['settings'],
+      entityIds: [],
+      resourceIds: [],
+      capabilityIds: []
+    },
+    {
+      id: 'settings.organization',
+      label: 'Organization',
+      path: '/settings/organization',
       surfaceType: 'settings',
       enabled: true,
       featureId: 'settings',
       featureIds: ['settings'],
       entityIds: [],
-      resourceIds: [],
-      capabilityIds: []
-    },
-    {
-      id: 'settings.credentials',
-      label: 'Credentials',
+      resourceIds: [],
+      capabilityIds: []
+    },
+    {
+      id: 'settings.credentials',
+      label: 'Credentials',
       path: '/settings/credentials',
       surfaceType: 'settings',
       enabled: true,
@@ -357,10 +358,9 @@ export const DEFAULT_ORGANIZATION_MODEL_NAVIGATION: z.infer<typeof OrganizationM
       label: 'Operations',
       placement: 'primary',
       surfaceIds: [
-        'operations.organization-graph',
         OPERATIONS_COMMAND_VIEW_SURFACE_ID,
         'operations.overview',
-        'operations.resources',
+        'operations.resources',
         'operations.command-queue',
         'operations.sessions',
         'operations.task-scheduler'
@@ -385,11 +385,12 @@ export const DEFAULT_ORGANIZATION_MODEL_NAVIGATION: z.infer<typeof OrganizationM
       label: 'Settings',
       placement: 'bottom',
       surfaceIds: [
-        'settings.account',
-        'settings.appearance',
-        'settings.organization',
-        'settings.credentials',
-        'settings.api-keys',
+        'settings.account',
+        'settings.appearance',
+        SETTINGS_ROLES_SURFACE_ID,
+        'settings.organization',
+        'settings.credentials',
+        'settings.api-keys',
         'settings.webhooks',
         'settings.deployments'
       ]

package/src/organization-model/foundation.ts

@@ -44,14 +44,13 @@ export function createFoundationOrganizationModel(override: DeepPartial<Organiza
     return feature
   }
 
-  const operationsGraphFeature = requireCoreFeature('operations.graph')
+  const operationsFeature = requireCoreFeature('operations')
   const projectsFeature = requireCoreFeature('projects')
   const leadGenFeature = requireCoreFeature('sales.lead-gen')
   const crmFeature = requireCoreFeature('sales.crm')
 
   const navigationSurfaces: FoundationNavigationSurface[] = [
-    { ...operationsGraphFeature, id: 'operations', path: '/operations', icon: 'operations', surfaceType: 'graph' },
-    { ...operationsGraphFeature, path: '/operations', icon: 'operations', surfaceType: 'graph' },
+    { ...operationsFeature, id: 'operations', path: '/operations', icon: 'operations', surfaceType: 'dashboard' },
     { ...projectsFeature, icon: 'projects', surfaceType: 'list' },
     { ...leadGenFeature, id: 'lead-gen', icon: 'lead-gen', surfaceType: 'list' },
     { ...crmFeature, id: 'crm', icon: 'crm', surfaceType: 'graph' },

package/src/organization-model/published.ts

@@ -11,11 +11,11 @@ export {
   OPERATIONS_FEATURE_ID,
   MONITORING_FEATURE_ID,
   SETTINGS_FEATURE_ID,
-  SEO_FEATURE_ID,
+  SEO_FEATURE_ID,
   SALES_PIPELINE_SURFACE_ID,
   PROSPECTING_LISTS_SURFACE_ID,
-  OPERATIONS_ORGANIZATION_GRAPH_SURFACE_ID,
-  OPERATIONS_COMMAND_VIEW_SURFACE_ID
+  OPERATIONS_COMMAND_VIEW_SURFACE_ID,
+  SETTINGS_ROLES_SURFACE_ID
 } from './contracts'
 export { DEFAULT_ORGANIZATION_MODEL } from './defaults'
 export {

package/src/platform/constants/versions.ts

@@ -1,3 +1,3 @@
 export const VERSION = {
-  CURRENT: '1.6.10'
+  CURRENT: '1.6.14'
 }

package/src/reference/_generated/contracts.md

@@ -180,7 +180,8 @@ export type OrganizationModelKeyResult = z.infer<typeof KeyResultSchema>
 ### `DeepPartial`
 
 ```typescript
-export type DeepPartial<T> = T extends Array<infer U> ? Array<DeepPartial<U>> : T extends object ? { [K in keyof T]?: DeepPartial<T[K]> } : T
+export type DeepPartial<T> =
+  T extends Array<infer U> ? Array<DeepPartial<U>> : T extends object ? { [K in keyof T]?: DeepPartial<T[K]> } : T
 ```
 
 ## Feature System
@@ -189,13 +190,12 @@ export type DeepPartial<T> = T extends Array<infer U> ? Array<DeepPartial<U>> :
 
 ```typescript
 export type FeatureSidebarComponent = ComponentType
-export type FeatureIconComponent = ComponentType<{ size?: number;
 ```
 
 ### `FeatureIconComponent`
 
 ```typescript
-export type FeatureIconComponent = ComponentType<{ size?: number;
+export type FeatureIconComponent = ComponentType<{ size?: number; stroke?: number }>
 ```
 
 ### `FeatureSidebarWidthResolver`
@@ -361,26 +361,10 @@ export interface ElevasisFeaturesContextValue {
 ### `ResourceStatus`
 
 ```typescript
-/**
- * Resource Registry type definitions
- */
-
-import type { IntegrationType } from '../../execution/engine/tools/integration'
-import type { ResourceCategory, ResourceLink } from './resource-link'
-
-// ============================================================================
-// Core Resource Type Definitions
-// ============================================================================
-
 /**
  * Environment/deployment status for resources
- */
-export type ResourceStatus = 'dev' | 'prod'
-
-/**
- * All resource types in the platform
- * Used as the discriminator field in ResourceDefinition
- */
+ */
+export type ResourceStatus = 'dev' | 'prod'
 ```
 
 ### `ResourceType`
@@ -389,13 +373,8 @@ export type ResourceStatus = 'dev' | 'prod'
 /**
  * All resource types in the platform
  * Used as the discriminator field in ResourceDefinition
- */
-export type ResourceType = 'agent' | 'workflow' | 'trigger' | 'integration' | 'external' | 'human'
-
-/**
- * Executable resource types (subset of ResourceType)
- * These resources can be directly executed by the execution engine
- */
+ */
+export type ResourceType = 'agent' | 'workflow' | 'trigger' | 'integration' | 'external' | 'human'
 ```
 
 ### `ExecutableResourceType`
@@ -404,17 +383,8 @@ export type ResourceType = 'agent' | 'workflow' | 'trigger' | 'integration' | 'e
 /**
  * Executable resource types (subset of ResourceType)
  * These resources can be directly executed by the execution engine
- */
-export type ExecutableResourceType = 'workflow' | 'agent'
-
-// ============================================================================
-// Base Resource Interface
-// ============================================================================
-
-/**
- * Base interface for ALL platform resources
- * Shared by both executable (agents, workflows) and non-executable (triggers, integrations, etc.) resources
- */
+ */
+export type ExecutableResourceType = 'workflow' | 'agent'
 ```
 
 ### `ResourceDefinition`
@@ -423,7 +393,7 @@ export type ExecutableResourceType = 'workflow' | 'agent'
 /**
  * Base interface for ALL platform resources
  * Shared by both executable (agents, workflows) and non-executable (triggers, integrations, etc.) resources
- */
+ */
 export interface ResourceDefinition {
   /** Unique resource identifier */
   resourceId: string
@@ -463,44 +433,10 @@ export interface ResourceDefinition {
 ### `ResourceList`
 
 ```typescript
-/** Unique resource identifier */
-  resourceId: string
-
-  /** Display name */
-  name: string
-
-  /** Purpose and functionality description */
-  description: string
-
-  /** Version for change tracking and evolution */
-  version: string
-
-  /** Resource type discriminator */
-  type: ResourceType
-
-  /** Environment/deployment status */
-  status: ResourceStatus
-
-  /** Graph links to Organization Model nodes */
-  links?: ResourceLink[]
-
-  /** Infrastructure category for filtering */
-  category?: ResourceCategory
-
-  /** Whether the agent supports multi-turn sessions (agents only) */
-  sessionCapable?: boolean
-
-  /** Whether the resource is local (monorepo) or remote (externally deployed) */
-  origin?: 'local' | 'remote'
-
-  /** Whether this resource is archived and should be excluded from registration and deployment */
-  archived?: boolean
-}
-
 /**
  * Resource list for organization
  * Returns ResourceDefinition metadata (not full definitions)
- */
+ */
 export interface ResourceList {
   workflows: ResourceDefinition[]
   agents: ResourceDefinition[]
@@ -513,16 +449,14 @@ export interface ResourceList {
 ### `WebhookProviderType`
 
 ```typescript
-/** Webhook provider identifiers */
-export type WebhookProviderType = 'cal-com' | 'stripe' | 'signature-api' | 'instantly' | 'apify' | 'test'
-
-/** Webhook trigger configuration */
+/** Webhook provider identifiers */
+export type WebhookProviderType = 'cal-com' | 'stripe' | 'signature-api' | 'instantly' | 'apify' | 'test'
 ```
 
 ### `WebhookTriggerConfig`
 
 ```typescript
-/** Webhook trigger configuration */
+/** Webhook trigger configuration */
 export interface WebhookTriggerConfig {
   /** Provider identifier */
   provider: WebhookProviderType
@@ -538,17 +472,7 @@ export interface WebhookTriggerConfig {
 ### `ScheduleTriggerConfig`
 
 ```typescript
-/** Provider identifier */
-  provider: WebhookProviderType
-  /** Event type for documentation (not used for matching - workflow handles routing) */
-  event?: string
-  /** Optional filtering (e.g., specific form ID for Fillout) */
-  filter?: Record<string, string>
-  /** References credential in credentials table for per-org webhook secrets */
-  credentialName?: string
-}
-
-/** Schedule trigger configuration */
+/** Schedule trigger configuration */
 export interface ScheduleTriggerConfig {
   /** Cron expression (e.g., '0 6 * * *') */
   cron: string
@@ -560,13 +484,7 @@ export interface ScheduleTriggerConfig {
 ### `EventTriggerConfig`
 
 ```typescript
-/** Cron expression (e.g., '0 6 * * *') */
-  cron: string
-  /** Optional timezone (default: UTC) */
-  timezone?: string
-}
-
-/** Event trigger configuration */
+/** Event trigger configuration */
 export interface EventTriggerConfig {
   /** Internal event type */
   eventType: string
@@ -578,50 +496,8 @@ export interface EventTriggerConfig {
 ### `TriggerConfig`
 
 ```typescript
-/** Internal event type */
-  eventType: string
-  /** Event source */
-  source?: string
-}
-
-/** Union of all trigger configs */
-export type TriggerConfig = WebhookTriggerConfig | ScheduleTriggerConfig | EventTriggerConfig
-
-// ============================================================================
-// Trigger Definition
-// ============================================================================
-
-/**
- * Trigger metadata - entry points that initiate resource execution
- *
- * Triggers represent how executions start: webhooks from external services,
- * scheduled cron jobs, platform events, or manual user actions.
- *
- * BREAKING CHANGES (2025-11-30):
- * - Now extends ResourceDefinition (inherits: resourceId, name, description, version, type, status, links, category)
- * - Field renames: `id` -> `resourceId` (inherited), `type` -> `triggerType`
- * - Relationship rename: `invokes` -> `triggers` (unified vocabulary)
- * - New required fields: `version` (inherited), `type: 'trigger'` (inherited)
- * - triggers object now includes `externalResources` option
- *
- * @example
- * // TriggerDefinition - metadata only
- * {
- *   resourceId: 'trigger-new-order',
- *   type: 'trigger',
- *   triggerType: 'webhook',
- *   name: 'New Order',
- *   description: 'Webhook from Shopify on new orders',
- *   version: '1.0.0',
- *   status: 'prod',
- *   webhookPath: '/webhooks/shopify/orders'
- * }
- *
- * // Relationships declared in ResourceRelationships (not on TriggerDefinition):
- * // relationships: {
- * //   'trigger-new-order': { triggers: { workflows: ['order-fulfillment-workflow'] } }
- * // }
- */
+/** Union of all trigger configs */
+export type TriggerConfig = WebhookTriggerConfig | ScheduleTriggerConfig | EventTriggerConfig
 ```
 
 ### `TriggerDefinition`
@@ -657,7 +533,7 @@ export type TriggerConfig = WebhookTriggerConfig | ScheduleTriggerConfig | Event
  * // relationships: {
  * //   'trigger-new-order': { triggers: { workflows: ['order-fulfillment-workflow'] } }
  * // }
- */
+ */
 export interface TriggerDefinition extends ResourceDefinition {
   /** Resource type discriminator (narrowed from base union) */
   type: 'trigger'
@@ -684,27 +560,6 @@ export interface TriggerDefinition extends ResourceDefinition {
 ### `IntegrationDefinition`
 
 ```typescript
-/** Resource type discriminator (narrowed from base union) */
-  type: 'trigger'
-
-  /** Trigger mechanism type (renamed from 'type' to avoid collision with base type discriminator) */
-  triggerType: 'webhook' | 'schedule' | 'manual' | 'event'
-
-  /** Type-specific configuration */
-  config?: TriggerConfig
-
-  // Legacy fields (deprecated, use config instead)
-  /** For webhook triggers: path like '/webhooks/shopify/orders' */
-  webhookPath?: string
-  /** For schedule triggers: cron expression like '0 6 * * *' */
-  schedule?: string
-  /** For event triggers: event type like 'low-stock-alert' */
-  eventType?: string
-
-  // NOTE: What this trigger starts is declared in ResourceRelationships, not here
-  // This prevents duplication - triggers are forward-declared in relationships
-}
-
 /**
  * Integration metadata - external service connections
  *
@@ -729,7 +584,7 @@ export interface TriggerDefinition extends ResourceDefinition {
  *   version: '1.0.0',
  *   status: 'prod'
  * }
- */
+ */
 export interface IntegrationDefinition extends ResourceDefinition {
   /** Resource type discriminator (narrowed from base union) */
   type: 'integration'
@@ -744,15 +599,6 @@ export interface IntegrationDefinition extends ResourceDefinition {
 ### `RelationshipDeclaration`
 
 ```typescript
-/** Resource type discriminator (narrowed from base union) */
-  type: 'integration'
-
-  /** Integration provider type */
-  provider: IntegrationType
-  /** References credentials table (e.g., 'shopify-prod', 'zendesk-api') */
-  credentialName: string
-}
-
 /**
  * Explicit resource relationship declaration
  *
@@ -764,7 +610,7 @@ export interface IntegrationDefinition extends ResourceDefinition {
  *   triggers: { workflows: ['order-fulfillment-workflow'] },
  *   uses: { integrations: ['integration-shopify-prod', 'integration-postgres'] }
  * }
- */
+ */
 export interface RelationshipDeclaration {
   /** Resources this resource triggers */
   triggers?: {
@@ -784,20 +630,6 @@ export interface RelationshipDeclaration {
 ### `ResourceRelationships`
 
 ```typescript
-/** Resources this resource triggers */
-  triggers?: {
-    /** Agent resourceIds this resource triggers */
-    agents?: string[]
-    /** Workflow resourceIds this resource triggers */
-    workflows?: string[]
-  }
-  /** Integrations this resource uses */
-  uses?: {
-    /** Integration IDs this resource uses */
-    integrations?: string[]
-  }
-}
-
 /**
  * Resource relationships map
  * Maps resourceId to its relationship declarations
@@ -809,17 +641,8 @@ export interface RelationshipDeclaration {
  *     uses: { integrations: ['integration-shopify-prod'] }
  *   }
  * }
- */
-export type ResourceRelationships = Record<string, RelationshipDeclaration>
-
-// ============================================================================
-// External Resource Types
-// ============================================================================
-
-/**
- * External platform type
- * Supported third-party automation platforms
- */
+ */
+export type ResourceRelationships = Record<string, RelationshipDeclaration>
 ```
 
 ### `ExternalPlatform`
@@ -828,39 +651,8 @@ export type ResourceRelationships = Record<string, RelationshipDeclaration>
 /**
  * External platform type
  * Supported third-party automation platforms
- */
-export type ExternalPlatform = 'n8n' | 'make' | 'zapier' | 'other'
-
-/**
- * External automation resource metadata
- *
- * Represents workflows/automations running on third-party platforms
- * (n8n, Make, Zapier, etc.) for visualization in Command View.
- *
- * NOTE: This is metadata ONLY for visualization. No execution logic,
- * no API integration with external platforms, no status syncing.
- *
- * BREAKING CHANGES (2025-11-30):
- * - Now extends ResourceDefinition (inherits: resourceId, name, description, version, type, status, links, category)
- * - Field renames: `id` -> `resourceId` (inherited)
- * - New required field: `version` (inherited) - organizations must add version to all external resources
- * - New required field: `type: 'external'` (inherited) - resource type discriminator
- * - REMOVED FIELD: `triggeredBy` - per relationship-consolidation design, all relationships are forward-only declarations
- *
- * @example
- * {
- *   resourceId: 'external-n8n-order-sync',
- *   type: 'external',
- *   version: '1.0.0',
- *   platform: 'n8n',
- *   name: 'Shopify Order Sync',
- *   description: 'Legacy n8n workflow for syncing Shopify orders',
- *   status: 'prod',
- *   platformUrl: 'https://n8n.client.com/workflow/123',
- *   triggers: { workflows: ['order-fulfillment-workflow'] },
- *   uses: { integrations: ['integration-shopify-prod'] }
- * }
- */
+ */
+export type ExternalPlatform = 'n8n' | 'make' | 'zapier' | 'other'
 ```
 
 ### `ExternalResourceDefinition`
@@ -895,7 +687,7 @@ export type ExternalPlatform = 'n8n' | 'make' | 'zapier' | 'other'
  *   triggers: { workflows: ['order-fulfillment-workflow'] },
  *   uses: { integrations: ['integration-shopify-prod'] }
  * }
- */
+ */
 export interface ExternalResourceDefinition extends ResourceDefinition {
   /** Resource type discriminator (narrowed from base union) */
   type: 'external'
@@ -932,37 +724,6 @@ export interface ExternalResourceDefinition extends ResourceDefinition {
 ### `HumanCheckpointDefinition`
 
 ```typescript
-/** Resource type discriminator (narrowed from base union) */
-  type: 'external'
-
-  /** Platform type */
-  platform: ExternalPlatform
-
-  // Optional platform-specific metadata
-  /** Link to external platform (e.g., n8n workflow editor URL) */
-  platformUrl?: string
-  /** Platform's internal ID/reference */
-  externalId?: string
-
-  /** What this external resource triggers (external -> internal) */
-  triggers?: {
-    /** Elevasis workflow resourceIds this external automation triggers */
-    workflows?: string[]
-    /** Elevasis agent resourceIds this external automation triggers */
-    agents?: string[]
-  }
-
-  /** Integrations this external resource uses (shared credentials) */
-  uses?: {
-    /** Integration IDs this external automation uses */
-    integrations?: string[]
-  }
-
-  // NOTE: triggeredBy field removed - per relationship-consolidation design,
-  // all relationships are forward-only declarations. Graph edges are built
-  // from forward declarations only.
-}
-
 /**
  * Human Checkpoint definition - human decision points in automation
  *
@@ -987,7 +748,7 @@ export interface ExternalResourceDefinition extends ResourceDefinition {
  *   requestedBy: { agents: ['order-processor-agent'] },
  *   routesTo: { agents: ['order-fulfillment-agent'] }
  * }
- */
+ */
 export interface HumanCheckpointDefinition extends ResourceDefinition {
   /** Resource type discriminator (narrowed from base union) */
   type: 'human'
@@ -1015,10 +776,6 @@ export interface HumanCheckpointDefinition extends ResourceDefinition {
 ### `DeploymentSpec`
 
 ```typescript
-/** Always undefined for system resources; present for API compatibility with RemoteOrgConfig consumers */
-  sdkVersion?: never
-}
-
 /**
  * Organization-specific resource collection
  *