@elevasis/core 0.7.0 → 0.8.0

package/src/execution/engine/workflow/index.ts

@@ -1,19 +1,19 @@
-/**
- * Workflow module exports
- */
-
-// Export workflow implementation
-export { Workflow } from './workflow'
-
-// Export workflow types
-export * from './types'
-
-// Export workflow logger types
-export * from './logging'
-
-// Export workflow errors
-export * from './errors'
-
-// Export workflow step helper types (browser-safe - types only)
-// NOTE: llmCall implementation is server-only - import from @repo/core/server
-export { type LLMCallOptions } from './helpers'
+/**
+ * Workflow module exports
+ */
+
+// Export workflow implementation
+export { Workflow } from './workflow'
+
+// Export workflow types
+export * from './types'
+
+// Export workflow logger types
+export * from './logging'
+
+// Export workflow errors
+export * from './errors'
+
+// Export workflow step helper types (browser-safe - types only)
+// NOTE: llmCall implementation is server-only - import from @repo/core/server
+export { type LLMCallOptions } from './helpers'

package/src/execution/engine/workflow/log-truncate.ts

@@ -1,26 +1,26 @@
-/** Max characters for string values in logged step input/output contexts */
-const LOG_STRING_TRUNCATE_LIMIT = 200
-
-/**
- * Deep-clone an object, truncating string values that exceed the limit.
- * Keeps the structure intact so the UI timeline can display field names and short previews.
- */
-export function truncateForLogging(value: unknown): unknown {
-  if (value === null || value === undefined) return value
-  if (typeof value === 'string') {
-    return value.length > LOG_STRING_TRUNCATE_LIMIT
-      ? value.slice(0, LOG_STRING_TRUNCATE_LIMIT) + `… [${value.length} chars]`
-      : value
-  }
-  if (Array.isArray(value)) {
-    return value.map(truncateForLogging)
-  }
-  if (typeof value === 'object') {
-    const result: Record<string, unknown> = {}
-    for (const [k, v] of Object.entries(value)) {
-      result[k] = truncateForLogging(v)
-    }
-    return result
-  }
-  return value
-}
+/** Max characters for string values in logged step input/output contexts */
+const LOG_STRING_TRUNCATE_LIMIT = 200
+
+/**
+ * Deep-clone an object, truncating string values that exceed the limit.
+ * Keeps the structure intact so the UI timeline can display field names and short previews.
+ */
+export function truncateForLogging(value: unknown): unknown {
+  if (value === null || value === undefined) return value
+  if (typeof value === 'string') {
+    return value.length > LOG_STRING_TRUNCATE_LIMIT
+      ? value.slice(0, LOG_STRING_TRUNCATE_LIMIT) + `… [${value.length} chars]`
+      : value
+  }
+  if (Array.isArray(value)) {
+    return value.map(truncateForLogging)
+  }
+  if (typeof value === 'object') {
+    const result: Record<string, unknown> = {}
+    for (const [k, v] of Object.entries(value)) {
+      result[k] = truncateForLogging(v)
+    }
+    return result
+  }
+  return value
+}

package/src/execution/engine/workflow/logging.ts

@@ -1,191 +1,191 @@
-/**
- * Workflow-specific logging types and utilities
- */
-
-import type { ExecutionLogLevel, ExecutionLogMessage } from '../base/logging'
-
-// Workflow start/end log context
-export interface WorkflowExecutionContext {
-  type: 'workflow'
-  contextType: 'workflow-execution'
-  executionId: string
-  workflowId: string
-  workflowName?: string
-  organizationId: string
-  executionPath?: string[]
-}
-
-// Workflow failure log context
-export interface WorkflowFailureContext {
-  type: 'workflow'
-  contextType: 'workflow-failure'
-  executionId: string
-  workflowId: string
-  error: string
-}
-
-// Step started log context
-export interface StepStartedContext {
-  type: 'workflow'
-  contextType: 'step-started'
-  stepId: string
-  stepStatus: 'started'
-  input: unknown
-  startTime: number // Explicit start timestamp for timeline
-}
-
-// Step completed log context
-export interface StepCompletedContext {
-  type: 'workflow'
-  contextType: 'step-completed'
-  stepId: string
-  stepStatus: 'completed'
-  output: unknown
-  duration: number
-  isTerminal: boolean
-  startTime: number // Explicit start timestamp for timeline
-  endTime: number // Explicit end timestamp for timeline
-}
-
-// Step failed log context
-export interface StepFailedContext {
-  type: 'workflow'
-  contextType: 'step-failed'
-  stepId: string
-  stepStatus: 'failed'
-  error: string
-  duration: number
-  startTime: number // Explicit start timestamp for timeline
-  endTime: number // Explicit end timestamp for timeline
-}
-
-// Conditional routing log context
-export interface ConditionalRouteContext {
-  type: 'workflow'
-  contextType: 'conditional-route'
-  stepId: string
-  target: string
-  error?: string
-}
-
-// Execution path log context
-export interface ExecutionPathContext {
-  type: 'workflow'
-  contextType: 'execution-path'
-  executionPath: string[]
-}
-
-// Union of step contexts with stepStatus field
-export type StepStatusContext = StepStartedContext | StepCompletedContext | StepFailedContext
-
-// Union of all workflow log contexts
-export type WorkflowLogContext =
-  | WorkflowExecutionContext
-  | WorkflowFailureContext
-  | StepStartedContext
-  | StepCompletedContext
-  | StepFailedContext
-  | ConditionalRouteContext
-  | ExecutionPathContext
-
-// Workflow execution log message (UI-specific interface)
-export interface WorkflowLogMessage {
-  level: ExecutionLogLevel
-  message: string
-  timestamp: number
-  context?: WorkflowLogContext
-}
-
-/**
- * Type guard helper functions for context discrimination
- */
-
-export function isWorkflowExecutionContext(ctx: WorkflowLogContext): ctx is WorkflowExecutionContext {
-  return ctx.contextType === 'workflow-execution'
-}
-
-export function isWorkflowFailureContext(ctx: WorkflowLogContext): ctx is WorkflowFailureContext {
-  return ctx.contextType === 'workflow-failure'
-}
-
-export function isStepStartedContext(ctx: WorkflowLogContext): ctx is StepStartedContext {
-  // Check new contextType field or fall back to old stepStatus pattern for backwards compatibility
-  return (
-    ctx.contextType === 'step-started' ||
-    ('stepStatus' in ctx && (ctx as StepStatusContext).stepStatus === 'started')
-  )
-}
-
-export function isStepCompletedContext(ctx: WorkflowLogContext): ctx is StepCompletedContext {
-  // Check new contextType field or fall back to old stepStatus pattern for backwards compatibility
-  return (
-    ctx.contextType === 'step-completed' ||
-    ('stepStatus' in ctx && (ctx as StepStatusContext).stepStatus === 'completed')
-  )
-}
-
-export function isStepFailedContext(ctx: WorkflowLogContext): ctx is StepFailedContext {
-  // Check new contextType field or fall back to old stepStatus pattern for backwards compatibility
-  return (
-    ctx.contextType === 'step-failed' ||
-    ('stepStatus' in ctx && (ctx as StepStatusContext).stepStatus === 'failed')
-  )
-}
-
-export function isConditionalRouteContext(ctx: WorkflowLogContext): ctx is ConditionalRouteContext {
-  // Check new contextType field or fall back to checking for target field for backwards compatibility
-  return ctx.contextType === 'conditional-route' || ('target' in ctx && 'stepId' in ctx && !('stepStatus' in ctx))
-}
-
-export function isExecutionPathContext(ctx: WorkflowLogContext): ctx is ExecutionPathContext {
-  return ctx.contextType === 'execution-path'
-}
-
-/**
- * Helper to check if context has step-related information
- */
-export function isStepContext(
-  ctx: WorkflowLogContext
-): ctx is StepStartedContext | StepCompletedContext | StepFailedContext | ConditionalRouteContext {
-  return (
-    ctx.contextType === 'step-started' ||
-    ctx.contextType === 'step-completed' ||
-    ctx.contextType === 'step-failed' ||
-    ctx.contextType === 'conditional-route'
-  )
-}
-
-/**
- * Convert ExecutionLogMessage to WorkflowLogMessage for workflow context
- * Returns null for non-workflow logs
- */
-export function toWorkflowLogMessage(log: ExecutionLogMessage): WorkflowLogMessage | null {
-  // Convert logs with workflow context
-  if (log.context?.type === 'workflow') {
-    return {
-      level: log.level,
-      message: log.message,
-      timestamp: log.timestamp,
-      context: log.context as WorkflowLogContext
-    }
-  }
-
-  // Convert user-level logs (no context or non-workflow context from step handlers)
-  // Cast is safe: LogEntry renders any context object as expandable JSON
-  return {
-    level: log.level,
-    message: log.message,
-    timestamp: log.timestamp,
-    context: log.context as WorkflowLogContext | undefined
-  }
-}
-
-/**
- * Convert array of ExecutionLogMessages to WorkflowLogMessages
- * Filters out non-workflow logs
- */
-export function toWorkflowLogMessages(logs: ExecutionLogMessage[]): WorkflowLogMessage[] {
-  return logs
-    .map(toWorkflowLogMessage)
-    .filter((log): log is WorkflowLogMessage => log !== null)
-}
+/**
+ * Workflow-specific logging types and utilities
+ */
+
+import type { ExecutionLogLevel, ExecutionLogMessage } from '../base/logging'
+
+// Workflow start/end log context
+export interface WorkflowExecutionContext {
+  type: 'workflow'
+  contextType: 'workflow-execution'
+  executionId: string
+  workflowId: string
+  workflowName?: string
+  organizationId: string
+  executionPath?: string[]
+}
+
+// Workflow failure log context
+export interface WorkflowFailureContext {
+  type: 'workflow'
+  contextType: 'workflow-failure'
+  executionId: string
+  workflowId: string
+  error: string
+}
+
+// Step started log context
+export interface StepStartedContext {
+  type: 'workflow'
+  contextType: 'step-started'
+  stepId: string
+  stepStatus: 'started'
+  input: unknown
+  startTime: number // Explicit start timestamp for timeline
+}
+
+// Step completed log context
+export interface StepCompletedContext {
+  type: 'workflow'
+  contextType: 'step-completed'
+  stepId: string
+  stepStatus: 'completed'
+  output: unknown
+  duration: number
+  isTerminal: boolean
+  startTime: number // Explicit start timestamp for timeline
+  endTime: number // Explicit end timestamp for timeline
+}
+
+// Step failed log context
+export interface StepFailedContext {
+  type: 'workflow'
+  contextType: 'step-failed'
+  stepId: string
+  stepStatus: 'failed'
+  error: string
+  duration: number
+  startTime: number // Explicit start timestamp for timeline
+  endTime: number // Explicit end timestamp for timeline
+}
+
+// Conditional routing log context
+export interface ConditionalRouteContext {
+  type: 'workflow'
+  contextType: 'conditional-route'
+  stepId: string
+  target: string
+  error?: string
+}
+
+// Execution path log context
+export interface ExecutionPathContext {
+  type: 'workflow'
+  contextType: 'execution-path'
+  executionPath: string[]
+}
+
+// Union of step contexts with stepStatus field
+export type StepStatusContext = StepStartedContext | StepCompletedContext | StepFailedContext
+
+// Union of all workflow log contexts
+export type WorkflowLogContext =
+  | WorkflowExecutionContext
+  | WorkflowFailureContext
+  | StepStartedContext
+  | StepCompletedContext
+  | StepFailedContext
+  | ConditionalRouteContext
+  | ExecutionPathContext
+
+// Workflow execution log message (UI-specific interface)
+export interface WorkflowLogMessage {
+  level: ExecutionLogLevel
+  message: string
+  timestamp: number
+  context?: WorkflowLogContext
+}
+
+/**
+ * Type guard helper functions for context discrimination
+ */
+
+export function isWorkflowExecutionContext(ctx: WorkflowLogContext): ctx is WorkflowExecutionContext {
+  return ctx.contextType === 'workflow-execution'
+}
+
+export function isWorkflowFailureContext(ctx: WorkflowLogContext): ctx is WorkflowFailureContext {
+  return ctx.contextType === 'workflow-failure'
+}
+
+export function isStepStartedContext(ctx: WorkflowLogContext): ctx is StepStartedContext {
+  // Check new contextType field or fall back to old stepStatus pattern for backwards compatibility
+  return (
+    ctx.contextType === 'step-started' ||
+    ('stepStatus' in ctx && (ctx as StepStatusContext).stepStatus === 'started')
+  )
+}
+
+export function isStepCompletedContext(ctx: WorkflowLogContext): ctx is StepCompletedContext {
+  // Check new contextType field or fall back to old stepStatus pattern for backwards compatibility
+  return (
+    ctx.contextType === 'step-completed' ||
+    ('stepStatus' in ctx && (ctx as StepStatusContext).stepStatus === 'completed')
+  )
+}
+
+export function isStepFailedContext(ctx: WorkflowLogContext): ctx is StepFailedContext {
+  // Check new contextType field or fall back to old stepStatus pattern for backwards compatibility
+  return (
+    ctx.contextType === 'step-failed' ||
+    ('stepStatus' in ctx && (ctx as StepStatusContext).stepStatus === 'failed')
+  )
+}
+
+export function isConditionalRouteContext(ctx: WorkflowLogContext): ctx is ConditionalRouteContext {
+  // Check new contextType field or fall back to checking for target field for backwards compatibility
+  return ctx.contextType === 'conditional-route' || ('target' in ctx && 'stepId' in ctx && !('stepStatus' in ctx))
+}
+
+export function isExecutionPathContext(ctx: WorkflowLogContext): ctx is ExecutionPathContext {
+  return ctx.contextType === 'execution-path'
+}
+
+/**
+ * Helper to check if context has step-related information
+ */
+export function isStepContext(
+  ctx: WorkflowLogContext
+): ctx is StepStartedContext | StepCompletedContext | StepFailedContext | ConditionalRouteContext {
+  return (
+    ctx.contextType === 'step-started' ||
+    ctx.contextType === 'step-completed' ||
+    ctx.contextType === 'step-failed' ||
+    ctx.contextType === 'conditional-route'
+  )
+}
+
+/**
+ * Convert ExecutionLogMessage to WorkflowLogMessage for workflow context
+ * Returns null for non-workflow logs
+ */
+export function toWorkflowLogMessage(log: ExecutionLogMessage): WorkflowLogMessage | null {
+  // Convert logs with workflow context
+  if (log.context?.type === 'workflow') {
+    return {
+      level: log.level,
+      message: log.message,
+      timestamp: log.timestamp,
+      context: log.context as WorkflowLogContext
+    }
+  }
+
+  // Convert user-level logs (no context or non-workflow context from step handlers)
+  // Cast is safe: LogEntry renders any context object as expandable JSON
+  return {
+    level: log.level,
+    message: log.message,
+    timestamp: log.timestamp,
+    context: log.context as WorkflowLogContext | undefined
+  }
+}
+
+/**
+ * Convert array of ExecutionLogMessages to WorkflowLogMessages
+ * Filters out non-workflow logs
+ */
+export function toWorkflowLogMessages(logs: ExecutionLogMessage[]): WorkflowLogMessage[] {
+  return logs
+    .map(toWorkflowLogMessage)
+    .filter((log): log is WorkflowLogMessage => log !== null)
+}