@elevasis/sdk 1.10.0 → 1.12.0

package/reference/scaffold/reference/contracts.md

@@ -1,3 +1,6 @@
+<!-- @generated by packages/sdk/scripts/copy-reference-docs.mjs -- DO NOT EDIT -->
+<!-- Regenerate: pnpm scaffold:sync -->
+
 <!-- @generated by scripts/monorepo/generate-scaffold-contracts.js — DO NOT EDIT -->
 <!-- Regenerate: pnpm scaffold:sync -->
 ---
@@ -45,22 +48,28 @@ export type OrganizationModelProjects = z.infer<typeof OrganizationModelProjects
 export type OrganizationModelFeature = z.infer<typeof FeatureSchema>
 ```
 
-### `OrganizationModelNavigation`
+### `NodeIdPath`
 
 ```typescript
-export type OrganizationModelNavigation = z.infer<typeof OrganizationModelNavigationSchema>
+export type NodeIdPath = z.infer<typeof NodeIdPathSchema>
 ```
 
-### `OrganizationModelSurface`
+### `NodeIdString`
 
 ```typescript
-export type OrganizationModelSurface = z.infer<typeof SurfaceDefinitionSchema>
+export type NodeIdString = z.infer<typeof NodeIdStringSchema>
+```
+
+### `OrganizationModelNavigation`
+
+```typescript
+export type OrganizationModelNavigation = z.infer<typeof OrganizationModelNavigationSchema>
 ```
 
-### `OrganizationModelResourceMapping`
+### `OrganizationModelSurface`
 
 ```typescript
-export type OrganizationModelResourceMapping = z.infer<typeof ResourceMappingSchema>
+export type OrganizationModelSurface = z.infer<typeof SurfaceDefinitionSchema>
 ```
 
 ### `OrganizationModelTechStackEntry`
@@ -174,69 +183,47 @@ 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
 
-### `FeatureNavLink`
+### `FeatureSidebarComponent`
 
 ```typescript
-export interface FeatureNavLink {
-  label: string
-  link: string
-  featureKey?: string
-  onClick?: () => void
-  links?: FeatureNavLink[]
-}
+export type FeatureSidebarComponent = ComponentType
 ```
 
-### `FeatureNavEntry`
+### `FeatureIconComponent`
 
 ```typescript
-export interface FeatureNavEntry {
-  label: string
-  icon: ComponentType
-  link?: string
-  featureKey?: string
-  requiresAdmin?: boolean
-  dataOnboardingTourId?: string
-  links?: FeatureNavLink[]
-}
+export type FeatureIconComponent = ComponentType<{ size?: number; stroke?: number }>
 ```
 
-### `FeatureSidebarComponent`
+### `FeatureSidebarWidthResolver`
 
 ```typescript
-export type FeatureSidebarComponent = ComponentType
+export type FeatureSidebarWidthResolver = number | ((context: { currentPath: string }) => number)
 ```
 
 ### `FeatureModule`
 
 ```typescript
 export interface FeatureModule {
-  /** Unique stable identifier for this feature (e.g. `'crm'`, `'projects'`). */
+  /** Unique stable identifier for this feature module. */
   key: string
-  /** Feature ID used for access-flag gating — must match the `id` of a feature in the organization model. */
+  /** Organization Model feature id this module presents. */
   featureId: string
-  /**
-   * Capability identifiers contributed by this feature.
-   * Merged into `ResolvedFeatureSemantics.capabilityIds` at resolution time.
-   * Not queried at runtime — kept for semantic graph completeness so that
-   * capability membership is fully represented in the resolved model even when
-   * a surface does not declare it directly.
-   */
+  /** Capability identifiers contributed by this feature module. */
   capabilityIds?: string[]
-  /** Top-level navigation entry rendered in the app shell when this feature is enabled. */
-  navEntry?: FeatureNavEntry
-  /** Sidebar component rendered when a matching subshell route is active. */
+  /** Icon used when this feature node appears in shell navigation. */
+  icon?: FeatureIconComponent
+  /** Sidebar component rendered when this feature's subtree route is active. */
   sidebar?: FeatureSidebarComponent
-  /** Route path prefixes that activate this feature's sidebar and subshell context. */
-  subshellRoutes?: string[]
-  /**
-   * Operations-only bridge surface connecting this feature to the organization graph.
-   * Ignored by all other features. Only one manifest in the registry should set this.
-   */
+  /** Optional shell sidebar width override. Defaults to 250px. */
+  sidebarWidth?: FeatureSidebarWidthResolver
+  /** Operations-only bridge connecting this feature to the organization graph node. */
   organizationGraph?: OrganizationGraphFeatureBridge
 }
 ```
@@ -255,8 +242,6 @@ export interface ResolvedFeatureAccess {
 ```typescript
 export interface ResolvedFeatureSemantics {
   capabilityIds: string[]
-  surfaceIds: string[]
-  surfaces: OrganizationModelSurface[]
 }
 ```
 
@@ -269,25 +254,11 @@ export interface ResolvedFeatureModule extends FeatureModule {
 }
 ```
 
-### `ShellNavPlacement`
-
-```typescript
-export type ShellNavPlacement = 'primary' | 'bottom'
-```
-
-### `ShellNavSource`
-
-```typescript
-export type ShellNavSource = 'app' | 'feature'
-```
-
-### `ResolvedShellNavItem`
+### `ResolvedShellFeature`
 
 ```typescript
-export interface ResolvedShellNavItem extends FeatureNavEntry {
-  placement: ShellNavPlacement
-  source: ShellNavSource
-  featureId?: string
+export interface ResolvedShellFeature extends OrganizationModelFeature {
+  iconComponent?: FeatureIconComponent
 }
 ```
 
@@ -295,16 +266,16 @@ export interface ResolvedShellNavItem extends FeatureNavEntry {
 
 ```typescript
 export interface ResolvedShellModel {
-  navItems: ResolvedShellNavItem[]
-}
-```
-
-### `AppShellOverrides`
-
-```typescript
-export interface AppShellOverrides {
-  primaryNavItems?: FeatureNavEntry[]
-  bottomNavItems?: FeatureNavEntry[]
+  features: readonly ResolvedShellFeature[]
+  findByPath: (path: string) => ResolvedShellFeature | undefined
+  findById: (id: string) => ResolvedShellFeature | undefined
+  childrenOf: (id: string) => ResolvedShellFeature[]
+  ancestorsOf: (id: string) => ResolvedShellFeature[]
+  parentOf: (id: string) => ResolvedShellFeature | undefined
+  topLevel: () => ResolvedShellFeature[]
+  uiPositionFor: (id: string) => OrganizationModelFeature['uiPosition'] | undefined
+  requiresAdminFor: (id: string) => boolean
+  devOnlyFor: (id: string) => boolean
 }
 ```
 
@@ -321,8 +292,7 @@ export interface ResolvedShellRouteMatch {
   status: ShellRouteMatchStatus
   path: string
   feature?: ResolvedFeatureModule
-  navItem?: ResolvedShellNavItem
-  navLink?: FeatureNavLink
+  node?: ResolvedShellFeature
 }
 ```
 
@@ -338,7 +308,7 @@ export interface ShellRuntime {
 
 ```typescript
 export interface OrganizationGraphFeatureBridge {
-  surfaceId: string
+  featureId: string
 }
 ```
 
@@ -347,10 +317,8 @@ export interface OrganizationGraphFeatureBridge {
 ```typescript
 export interface OrganizationGraphContextValue {
   available: boolean
-  surfaceId?: string
-  surfacePath?: string
-  surfaceType?: OrganizationModelSurface['surfaceType']
   featureId?: string
+  featurePath?: string
 }
 ```
 
@@ -360,7 +328,6 @@ export interface OrganizationGraphContextValue {
 export interface ElevasisFeaturesProviderProps {
   features: FeatureModule[]
   organizationModel?: OrganizationModel
-  appShellOverrides?: AppShellOverrides
   timeRange?: TimeRange
   operationsApiUrl?: string
   operationsSSEManager?: SSEConnectionManagerLike
@@ -397,26 +364,10 @@ export interface ElevasisFeaturesContextValue {
 ### `ResourceStatus`
 
 ```typescript
-/**
- * Resource Registry type definitions
- */
-
-import type { IntegrationType } from '../../execution/engine/tools/integration'
-import type { ResourceDomain } from './domains'
-
-// ============================================================================
-// 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`
@@ -425,13 +376,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`
@@ -440,17 +386,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`
@@ -459,7 +396,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
@@ -479,43 +416,11 @@ export interface ResourceDefinition {
   /** Environment/deployment status */
   status: ResourceStatus
 
-  /** Domain tags for filtering and organization */
-  domains?: ResourceDomain[]
-
-  /** 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
-}
-```
-
-### `DomainDefinition`
+  /** Graph links to Organization Model nodes */
+  links?: ResourceLink[]
 
-```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
-
-  /** Domain tags for filtering and organization */
-  domains?: ResourceDomain[]
+  /** Infrastructure category for filtering */
+  category?: ResourceCategory
 
   /** Whether the agent supports multi-turn sessions (agents only) */
   sessionCapable?: boolean
@@ -525,60 +430,16 @@ export interface ResourceDefinition {
 
   /** Whether this resource is archived and should be excluded from registration and deployment */
   archived?: boolean
-}
-
-// ============================================================================
-// Domain Definition Types
-// ============================================================================
-
-/**
- * Domain definition for Command View filtering
- *
- * Domains are organizational metadata for UI filtering/grouping.
- * No execution impact - purely for visualization.
- *
- * @example
- * {
- *   id: 'support',
- *   name: 'Customer Support',
- *   description: 'Ticket triage, knowledge base, escalations',
- *   color: 'green',
- *   icon: 'IconHeadset'
- * }
- */
-export interface DomainDefinition {
-  /** Unique identifier (e.g., 'support') */
-  id: string
-  /** Display name (e.g., 'Customer Support') */
-  name: string
-  /** Purpose description */
-  description: string
-  /** Optional Mantine color for UI (e.g., 'blue', 'green', 'orange') */
-  color?: string
-  /** Optional Tabler icon name (e.g., 'IconHeadset') */
-  icon?: string
 }
 ```
 
 ### `ResourceList`
 
 ```typescript
-/** Unique identifier (e.g., 'support') */
-  id: string
-  /** Display name (e.g., 'Customer Support') */
-  name: string
-  /** Purpose description */
-  description: string
-  /** Optional Mantine color for UI (e.g., 'blue', 'green', 'orange') */
-  color?: string
-  /** Optional Tabler icon name (e.g., 'IconHeadset') */
-  icon?: string
-}
-
-/**
- * Resource list for organization
- * Returns ResourceDefinition metadata (not full definitions)
- */
+/**
+ * Resource list for organization
+ * Returns ResourceDefinition metadata (not full definitions)
+ */
 export interface ResourceList {
   workflows: ResourceDefinition[]
   agents: ResourceDefinition[]
@@ -591,16 +452,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
@@ -616,17 +475,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
@@ -638,13 +487,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
@@ -656,50 +499,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, domains)
- * - 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`
@@ -712,7 +513,7 @@ export type TriggerConfig = WebhookTriggerConfig | ScheduleTriggerConfig | Event
  * scheduled cron jobs, platform events, or manual user actions.
  *
  * BREAKING CHANGES (2025-11-30):
- * - Now extends ResourceDefinition (inherits: resourceId, name, description, version, type, status, domains)
+ * - 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)
@@ -735,7 +536,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'
@@ -762,27 +563,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
  *
@@ -790,7 +570,7 @@ export interface TriggerDefinition extends ResourceDefinition {
  * stored here (queried at runtime from credentials table).
  *
  * BREAKING CHANGES (2025-11-30):
- * - Now extends ResourceDefinition (inherits: resourceId, name, description, version, type, status, domains)
+ * - Now extends ResourceDefinition (inherits: resourceId, name, description, version, type, status, links, category)
  * - Field renames: `id` -> `resourceId` (inherited)
  * - New required field: `status` (inherited) - organizations must add status to all integrations
  * - New required field: `version` (inherited) - organizations must add version to all integrations
@@ -807,7 +587,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'
@@ -822,15 +602,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
  *
@@ -842,7 +613,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?: {
@@ -862,20 +633,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
@@ -887,17 +644,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`
@@ -906,39 +654,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, domains)
- * - 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`
@@ -954,7 +671,7 @@ export type ExternalPlatform = 'n8n' | 'make' | 'zapier' | 'other'
  * no API integration with external platforms, no status syncing.
  *
  * BREAKING CHANGES (2025-11-30):
- * - Now extends ResourceDefinition (inherits: resourceId, name, description, version, type, status, domains)
+ * - 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
@@ -973,7 +690,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'
@@ -1010,37 +727,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
  *
@@ -1048,7 +734,7 @@ export interface ExternalResourceDefinition extends ResourceDefinition {
  * Tasks with matching command_queue_group are routed to this checkpoint.
  *
  * BREAKING CHANGES (2025-11-30):
- * - Now extends ResourceDefinition (inherits: resourceId, name, description, version, type, status, domains)
+ * - Now extends ResourceDefinition (inherits: resourceId, name, description, version, type, status, links, category)
  * - Field renames: `id` -> `resourceId` (inherited)
  * - description is now REQUIRED (was optional) - organizations must add description to all human checkpoints
  * - New required field: `version` (inherited) - organizations must add version to all human checkpoints
@@ -1065,7 +751,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'
@@ -1093,44 +779,30 @@ export interface HumanCheckpointDefinition extends ResourceDefinition {
 ### `DeploymentSpec`
 
 ```typescript
-/** Supabase Storage path: "{orgId}/{deploymentId}/bundle.js" */
-  storagePath: string
-  /** Deployment record ID */
-  deploymentId: string
-  /** OS temp path to bundle -- set after first download, used by worker threads */
-  cachedTempPath?: string
-  /** Platform tool name -> credential name mapping */
-  toolCredentials?: Record<string, string>
-  /** SDK version used to deploy this bundle */
-  sdkVersion?: string
-  /** Deployment version (semver) of the deployed bundle */
-  deploymentVersion?: string
-}
-
-/**
- * Organization-specific resource collection
- *
- * Complete manifest of all automation resources for an organization.
- * Used by ResourceRegistry for discovery and Command View for visualization.
+/**
+ * Organization-specific resource collection
+ *
+ * Complete manifest of all automation resources for an organization.
+ * Used by ResourceRegistry for discovery and Command View for visualization.
  */
-export interface DeploymentSpec {
-  /** Deployment version (semver) */
-  version: string
-  /** Workflow definitions */
-  workflows?: WorkflowDefinition[]
-  /** Agent definitions */
-  agents?: AgentDefinition[]
-
-  // Resource Manifest fields (optional for backwards compatibility)
-  /** Trigger definitions - entry points that initiate executions */
-  triggers?: TriggerDefinition[]
-  /** Integration definitions - external service connections */
-  integrations?: IntegrationDefinition[]
-  /** Explicit relationship declarations between resources */
-  relationships?: ResourceRelationships
-  /** External automation resources (n8n, Make, Zapier, etc.) */
-  externalResources?: ExternalResourceDefinition[]
-  /** Human checkpoint definitions - human decision points in automation */
-  humanCheckpoints?: HumanCheckpointDefinition[]
+export interface DeploymentSpec {
+  /** Deployment version (semver) */
+  version: string
+  /** Workflow definitions */
+  workflows?: WorkflowDefinition[]
+  /** Agent definitions */
+  agents?: AgentDefinition[]
+
+  // Resource Manifest fields (optional for backwards compatibility)
+  /** Trigger definitions - entry points that initiate executions */
+  triggers?: TriggerDefinition[]
+  /** Integration definitions - external service connections */
+  integrations?: IntegrationDefinition[]
+  /** Explicit relationship declarations between resources */
+  relationships?: ResourceRelationships
+  /** External automation resources (n8n, Make, Zapier, etc.) */
+  externalResources?: ExternalResourceDefinition[]
+  /** Human checkpoint definitions - human decision points in automation */
+  humanCheckpoints?: HumanCheckpointDefinition[]
 }
 ```