@elevasis/core 0.1.0

package/src/platform/registry/serialization.ts

@@ -0,0 +1,273 @@
+/**
+ * Registry Serialization Utilities
+ *
+ * Pre-serialization logic for ResourceRegistry.
+ * Converts resource definitions to JSON-safe structures at startup.
+ */
+
+import type { DeploymentSpec } from './resource-registry'
+import type { ResourceDefinition } from './types'
+import type {
+  SerializedOrganizationData,
+  SerializedAgentDefinition,
+  SerializedWorkflowDefinition,
+  CommandViewAgent,
+  CommandViewWorkflow,
+  CommandViewEdge
+} from './serialized-types'
+import { serializeDefinition } from '../../execution/engine/base/serialization'
+import { DOMAIN_MAP, type ResourceDomain } from './domains'
+import type { DomainDefinition } from './types'
+
+/**
+ * Serialize all organization resources
+ * Called once during ResourceRegistry construction
+ */
+export function serializeAllOrganizations(
+  registry: Record<string, DeploymentSpec>
+): Map<string, SerializedOrganizationData> {
+  const cache = new Map<string, SerializedOrganizationData>()
+  for (const [orgName, resources] of Object.entries(registry)) {
+    cache.set(orgName, serializeOrganization(resources))
+  }
+  return cache
+}
+
+/**
+ * Derive domain definitions from resource domains
+ * Collects all unique domain IDs used across resources and maps to definitions
+ */
+function deriveDomainDefinitions(resources: DeploymentSpec): DomainDefinition[] {
+  const domainIds = new Set<ResourceDomain>()
+
+  // Collect from all resource types
+  resources.workflows?.forEach((w) => w.config.domains?.forEach((d) => domainIds.add(d)))
+  resources.agents?.forEach((a) => a.config.domains?.forEach((d) => domainIds.add(d)))
+  resources.triggers?.forEach((t) => t.domains?.forEach((d) => domainIds.add(d)))
+  resources.integrations?.forEach((i) => i.domains?.forEach((d) => domainIds.add(d)))
+  resources.externalResources?.forEach((e) => e.domains?.forEach((d) => domainIds.add(d)))
+  resources.humanCheckpoints?.forEach((h) => h.domains?.forEach((d) => domainIds.add(d)))
+
+  // Look up definitions - guaranteed to exist due to ResourceDomain typing
+  return Array.from(domainIds).map((id) => DOMAIN_MAP[id])
+}
+
+/**
+ * Serialize single organization's resources
+ */
+export function serializeOrganization(resources: DeploymentSpec): SerializedOrganizationData {
+  // Serialize workflows
+  const workflowDefinitions = new Map<string, SerializedWorkflowDefinition>()
+  const workflowResources: ResourceDefinition[] = []
+  const commandViewWorkflows: CommandViewWorkflow[] = []
+
+  for (const workflow of resources.workflows ?? []) {
+    const resourceId = workflow.config.resourceId
+    const serialized = serializeDefinition(workflow) as SerializedWorkflowDefinition
+    workflowDefinitions.set(resourceId, serialized)
+
+    workflowResources.push({
+      resourceId,
+      name: workflow.config.name,
+      description: workflow.config.description,
+      version: workflow.config.version,
+      type: 'workflow',
+      status: workflow.config.status
+    })
+
+    commandViewWorkflows.push({
+      resourceId,
+      name: workflow.config.name,
+      description: workflow.config.description,
+      version: workflow.config.version,
+      type: 'workflow',
+      status: workflow.config.status,
+      domains: workflow.config.domains,
+      stepCount: Object.keys(workflow.steps).length,
+      entryPoint: workflow.entryPoint
+    })
+  }
+
+  // Serialize agents
+  const agentDefinitions = new Map<string, SerializedAgentDefinition>()
+  const agentResources: ResourceDefinition[] = []
+  const commandViewAgents: CommandViewAgent[] = []
+
+  for (const agent of resources.agents ?? []) {
+    const resourceId = agent.config.resourceId
+    const serialized = serializeDefinition(agent) as SerializedAgentDefinition
+    agentDefinitions.set(resourceId, serialized)
+
+    agentResources.push({
+      resourceId,
+      name: agent.config.name,
+      description: agent.config.description,
+      version: agent.config.version,
+      type: 'agent',
+      status: agent.config.status
+    })
+
+    commandViewAgents.push({
+      resourceId,
+      name: agent.config.name,
+      description: agent.config.description,
+      version: agent.config.version,
+      type: 'agent',
+      status: agent.config.status,
+      domains: agent.config.domains,
+      modelProvider: agent.modelConfig.provider,
+      modelId: agent.modelConfig.model,
+      toolCount: agent.tools.length,
+      hasKnowledgeMap: agent.knowledgeMap !== undefined,
+      hasMemory: agent.config.memoryPreferences !== undefined,
+      sessionCapable: agent.config.sessionCapable ?? false
+    })
+  }
+
+  // Build edges from triggers and relationships
+  const edges = buildEdges(resources)
+
+  // Pass-through manifest data (already JSON-safe)
+  const triggers = resources.triggers ?? []
+  const integrations = resources.integrations ?? []
+  const externalResources = resources.externalResources ?? []
+  const humanCheckpoints = resources.humanCheckpoints ?? []
+  const domainDefinitions = deriveDomainDefinitions(resources)
+
+  return {
+    version: resources.version,
+    resources: {
+      workflows: workflowResources,
+      agents: agentResources,
+      total: workflowResources.length + agentResources.length
+    },
+    definitions: {
+      workflows: workflowDefinitions,
+      agents: agentDefinitions
+    },
+    commandView: {
+      workflows: commandViewWorkflows,
+      agents: commandViewAgents,
+      triggers,
+      integrations,
+      externalResources,
+      humanCheckpoints,
+      edges,
+      domainDefinitions
+    },
+    triggers,
+    integrations,
+    externalResources,
+    humanCheckpoints,
+    relationships: resources.relationships
+  }
+}
+
+/**
+ * Build Command View edges from relationships
+ * NOTE: Trigger relationships are now declared in ResourceRelationships, not on TriggerDefinition
+ */
+export function buildEdges(resources: DeploymentSpec): CommandViewEdge[] {
+  const edges: CommandViewEdge[] = []
+  let edgeId = 0
+
+  // All relationship edges (triggers, agents, workflows can all declare relationships)
+  for (const [resourceId, declaration] of Object.entries(resources.relationships ?? {})) {
+    for (const agentId of declaration.triggers?.agents ?? []) {
+      edges.push({
+        id: `edge-${edgeId++}`,
+        source: resourceId,
+        target: agentId,
+        relationship: 'triggers'
+      })
+    }
+    for (const workflowId of declaration.triggers?.workflows ?? []) {
+      edges.push({
+        id: `edge-${edgeId++}`,
+        source: resourceId,
+        target: workflowId,
+        relationship: 'triggers'
+      })
+    }
+    for (const integrationId of declaration.uses?.integrations ?? []) {
+      edges.push({
+        id: `edge-${edgeId++}`,
+        source: resourceId,
+        target: integrationId,
+        relationship: 'uses'
+      })
+    }
+  }
+
+  // External Resource edges (forward-only)
+  for (const external of resources.externalResources ?? []) {
+    // External -> Internal
+    for (const workflowId of external.triggers?.workflows ?? []) {
+      edges.push({
+        id: `edge-${edgeId++}`,
+        source: external.resourceId,
+        target: workflowId,
+        relationship: 'triggers'
+      })
+    }
+    for (const agentId of external.triggers?.agents ?? []) {
+      edges.push({
+        id: `edge-${edgeId++}`,
+        source: external.resourceId,
+        target: agentId,
+        relationship: 'triggers'
+      })
+    }
+
+    // External -> Integration
+    for (const integrationId of external.uses?.integrations ?? []) {
+      edges.push({
+        id: `edge-${edgeId++}`,
+        source: external.resourceId,
+        target: integrationId,
+        relationship: 'uses'
+      })
+    }
+  }
+
+  // Human Checkpoint edges
+  for (const humanCheckpoint of resources.humanCheckpoints ?? []) {
+    // Agent/Workflow -> ApprovalPoint
+    for (const agentId of humanCheckpoint.requestedBy?.agents ?? []) {
+      edges.push({
+        id: `edge-${edgeId++}`,
+        source: agentId,
+        target: humanCheckpoint.resourceId,
+        relationship: 'approval'
+      })
+    }
+    for (const workflowId of humanCheckpoint.requestedBy?.workflows ?? []) {
+      edges.push({
+        id: `edge-${edgeId++}`,
+        source: workflowId,
+        target: humanCheckpoint.resourceId,
+        relationship: 'approval'
+      })
+    }
+
+    // ApprovalPoint -> Agent/Workflow
+    for (const agentId of humanCheckpoint.routesTo?.agents ?? []) {
+      edges.push({
+        id: `edge-${edgeId++}`,
+        source: humanCheckpoint.resourceId,
+        target: agentId,
+        relationship: 'triggers'
+      })
+    }
+    for (const workflowId of humanCheckpoint.routesTo?.workflows ?? []) {
+      edges.push({
+        id: `edge-${edgeId++}`,
+        source: humanCheckpoint.resourceId,
+        target: workflowId,
+        relationship: 'triggers'
+      })
+    }
+  }
+
+  return edges
+}

package/src/platform/registry/serialized-types.ts

@@ -0,0 +1,231 @@
+/**
+ * Serialized Registry Types
+ *
+ * Pre-computed JSON-safe types for API responses and Command View.
+ * Serialization happens once at API startup, enabling instant response times.
+ */
+
+import type { FormFieldType } from '../../forms/types'
+import { CommandViewData } from './command-view'
+import type {
+  ResourceDefinition,
+  TriggerDefinition,
+  IntegrationDefinition,
+  ResourceRelationships,
+  ExternalResourceDefinition,
+  HumanCheckpointDefinition
+} from './types'
+
+// ============================================================================
+// Serialized Interface Types (for Execution Runner UI)
+// ============================================================================
+
+/**
+ * Serialized form field for API responses
+ */
+export interface SerializedFormField {
+  name: string
+  label: string
+  type: FormFieldType
+  defaultValue?: unknown
+  required?: boolean
+  placeholder?: string
+  description?: string
+  options?: Array<{ label: string; value: string | number }>
+  min?: number
+  max?: number
+}
+
+/**
+ * Serialized form schema for API responses
+ */
+export interface SerializedFormSchema {
+  title?: string
+  description?: string
+  fields: SerializedFormField[]
+  layout?: 'vertical' | 'horizontal' | 'grid'
+}
+
+/**
+ * Serialized execution form schema for API responses
+ */
+export interface SerializedExecutionFormSchema extends SerializedFormSchema {
+  fieldMappings?: Record<string, string>
+  submitButton?: {
+    label?: string
+    loadingLabel?: string
+    confirmMessage?: string
+  }
+}
+
+/**
+ * Serialized schedule config for API responses
+ */
+export interface SerializedScheduleConfig {
+  enabled: boolean
+  defaultSchedule?: string
+  allowedPatterns?: string[]
+}
+
+/**
+ * Serialized webhook config for API responses
+ */
+export interface SerializedWebhookConfig {
+  enabled: boolean
+  payloadSchema?: unknown
+}
+
+/**
+ * Serialized execution interface for API responses
+ */
+export interface SerializedExecutionInterface {
+  form: SerializedExecutionFormSchema
+  schedule?: SerializedScheduleConfig
+  webhook?: SerializedWebhookConfig
+}
+
+// ============================================================================
+// Serialized Definition Types
+// ============================================================================
+
+/**
+ * Serialized agent definition (JSON-safe)
+ * Result of serializeDefinition(AgentDefinition)
+ */
+export interface SerializedAgentDefinition {
+  config: {
+    resourceId: string
+    name: string
+    description: string
+    version: string
+    type: 'agent'
+    status: 'dev' | 'prod'
+    /** Whether this resource is archived and should be excluded from registration and deployment */
+    archived?: boolean
+    systemPrompt: string
+    constraints?: {
+      maxIterations?: number
+      timeout?: number
+      maxSessionMemoryKeys?: number
+      maxMemoryTokens?: number
+    }
+    sessionCapable?: boolean
+    memoryPreferences?: string
+  }
+  modelConfig: {
+    provider: string
+    model: string
+    apiKey: string // Redacted: "sk-proj..."
+    temperature: number
+    maxOutputTokens: number
+    topP?: number
+    modelOptions?: Record<string, unknown>
+  }
+  contract: {
+    inputSchema: object // JSON Schema
+    outputSchema?: object // JSON Schema
+  }
+  tools: Array<{
+    name: string
+    description: string
+    inputSchema?: object // JSON Schema
+    outputSchema?: object // JSON Schema
+  }>
+  knowledgeMap?: {
+    nodeCount: number
+    nodes: Array<{
+      id: string
+      description: string
+      loaded: boolean
+      hasPrompt: boolean
+    }>
+  }
+  metricsConfig?: object
+  interface?: SerializedExecutionInterface
+}
+
+/**
+ * Serialized workflow definition (JSON-safe)
+ * Result of serializeDefinition(WorkflowDefinition)
+ */
+export interface SerializedWorkflowDefinition {
+  config: {
+    resourceId: string
+    name: string
+    description: string
+    version: string
+    type: 'workflow'
+    status: 'dev' | 'prod'
+    /** Whether this resource is archived and should be excluded from registration and deployment */
+    archived?: boolean
+  }
+  entryPoint: string
+  steps: Array<{
+    id: string
+    name: string
+    description: string
+    inputSchema?: object // JSON Schema
+    outputSchema?: object // JSON Schema
+    next: {
+      type: 'linear' | 'conditional'
+      target?: string
+      routes?: Array<{ target: string }>
+      default?: string
+    } | null
+  }>
+  contract: {
+    inputSchema: object // JSON Schema
+    outputSchema?: object // JSON Schema
+  }
+  metricsConfig?: object
+  interface?: SerializedExecutionInterface
+}
+
+// ============================================================================
+// Command View Types (re-exported from command-view.ts)
+// ============================================================================
+
+export type {
+  CommandViewAgent,
+  CommandViewWorkflow,
+  CommandViewNode,
+  CommandViewEdge,
+  CommandViewData,
+  RelationshipType
+} from './command-view'
+
+// ============================================================================
+// Serialized Organization Data
+// ============================================================================
+
+/**
+ * Complete pre-serialized organization data
+ * Computed once at startup, served instantly
+ */
+export interface SerializedOrganizationData {
+  /** Deployment version (semver) */
+  version: string
+
+  /** Basic resource lists (for /resources endpoint) */
+  resources: {
+    workflows: ResourceDefinition[]
+    agents: ResourceDefinition[]
+    total: number
+  }
+
+  /** Full serialized definitions (for /resources/:id/definition endpoint) */
+  definitions: {
+    workflows: Map<string, SerializedWorkflowDefinition>
+    agents: Map<string, SerializedAgentDefinition>
+  }
+
+  /** Command View data (for /command-view endpoint) */
+  commandView: CommandViewData
+
+  /** Pass-through manifest data (already JSON-safe) */
+  triggers: TriggerDefinition[]
+  integrations: IntegrationDefinition[]
+  externalResources: ExternalResourceDefinition[]
+  humanCheckpoints: HumanCheckpointDefinition[]
+  relationships: ResourceRelationships | undefined
+}

package/src/platform/registry/stats-types.ts

@@ -0,0 +1,66 @@
+import type { ExecutionStatus } from '../../execution/core/sse-executions'
+import type { TimeRange } from '../../operations/observability/types'
+
+/**
+ * @deprecated Use TimeRange from '@repo/core' directly. Kept as alias for backward compatibility.
+ */
+export type StatsTimeRange = TimeRange
+
+/** Stats returned by /command-view/stats (counts only, no error details) */
+export interface ResourceStats {
+  resourceId: string
+  totalRuns: number
+  successCount: number
+  failureCount: number // Used for badge: "X failed"
+  warningCount: number // Completed with warnings (counts toward success)
+  lastRunAt: string | null
+  // NO recentErrors or totalErrors - fetched on-demand via /resource-errors
+}
+
+/** Response from /command-view/resource-errors (on-demand) */
+export interface ResourceErrorsResponse {
+  resourceId: string
+  errors: ErrorSummary[]
+  totalErrors: number // Total count for "showing 10 of X" display
+  timeRange: StatsTimeRange
+}
+
+export interface ErrorSummary {
+  executionId: string
+  errorType: string
+  errorMessage: string
+  occurredAt: string
+}
+
+/** Single execution summary for Recent Executions list in command view */
+export interface CommandViewExecution {
+  executionId: string
+  status: ExecutionStatus
+  startedAt: string
+  completedAt: string | null
+  errorMessage: string | null // Only present if failed
+}
+
+/** Response from /command-view/resource-executions (on-demand) */
+export interface ResourceExecutionsResponse {
+  resourceId: string
+  executions: CommandViewExecution[]
+  totalExecutions: number // Total count for "showing 10 of X" display
+  timeRange: StatsTimeRange
+}
+
+export interface HumanCheckpointStats {
+  checkpointId: string
+  pendingCount: number
+  completedCount: number
+  expiredCount: number
+  lastDecisionAt: string | null
+}
+
+/** Response from /command-view/stats */
+export interface CommandViewStatsResponse {
+  resources: Record<string, ResourceStats>
+  humanCheckpoints: Record<string, HumanCheckpointStats>
+  timeRange: StatsTimeRange
+  generatedAt: string
+}