@elevasis/core 0.7.0 → 0.8.0

package/src/execution/engine/workflow/__tests__/errors.test.ts

@@ -1,139 +1,139 @@
-import { describe, it, expect } from 'vitest'
-import { WorkflowStepError, WorkflowValidationError } from '../errors'
-import { ExecutionError } from '../../base/errors'
-
-describe('Workflow Errors', () => {
-  describe('WorkflowStepError', () => {
-    it('extends ExecutionError', () => {
-      const error = new WorkflowStepError('Step failed')
-      expect(error).toBeInstanceOf(ExecutionError)
-      expect(error).toBeInstanceOf(Error)
-    })
-
-    it('has critical severity', () => {
-      const error = new WorkflowStepError('Step failed')
-      expect(error.severity).toBe('critical')
-    })
-
-    it('has workflow category', () => {
-      const error = new WorkflowStepError('Step failed')
-      expect(error.category).toBe('workflow')
-    })
-
-    it('is not retryable by default', () => {
-      const error = new WorkflowStepError('Step failed')
-      expect(error.isRetryable()).toBe(false)
-    })
-
-    it('sets message correctly', () => {
-      const error = new WorkflowStepError('Step "send_email" failed: SMTP unavailable')
-      expect(error.message).toBe('Step "send_email" failed: SMTP unavailable')
-    })
-
-    it('sets name to WorkflowStepError', () => {
-      const error = new WorkflowStepError('Step failed')
-      expect(error.name).toBe('WorkflowStepError')
-    })
-
-    it('returns correct error type', () => {
-      const error = new WorkflowStepError('Step failed')
-      expect(error.name).toBe('WorkflowStepError')
-    })
-
-    it('stores context with workflow details', () => {
-      const context = {
-        workflowId: 'wf-123',
-        stepIndex: 2,
-        stepName: 'send_email',
-        attemptCount: 1
-      }
-      const error = new WorkflowStepError('Step failed', context)
-      expect(error.context).toEqual(context)
-    })
-
-    it('captures stack trace', () => {
-      const error = new WorkflowStepError('Step failed')
-      expect(error.stack).toBeDefined()
-      expect(error.stack).toContain('WorkflowStepError')
-    })
-  })
-
-  describe('WorkflowValidationError', () => {
-    it('extends ExecutionError', () => {
-      const error = new WorkflowValidationError('Validation failed')
-      expect(error).toBeInstanceOf(ExecutionError)
-      expect(error).toBeInstanceOf(Error)
-    })
-
-    it('has info severity', () => {
-      const error = new WorkflowValidationError('Validation failed')
-      expect(error.severity).toBe('info')
-    })
-
-    it('has validation category', () => {
-      const error = new WorkflowValidationError('Validation failed')
-      expect(error.category).toBe('validation')
-    })
-
-    it('is not retryable by default', () => {
-      const error = new WorkflowValidationError('Validation failed')
-      expect(error.isRetryable()).toBe(false)
-    })
-
-    it('sets message correctly', () => {
-      const error = new WorkflowValidationError('Invalid workflow: Missing approver')
-      expect(error.message).toBe('Invalid workflow: Missing approver')
-    })
-
-    it('sets name to WorkflowValidationError', () => {
-      const error = new WorkflowValidationError('Validation failed')
-      expect(error.name).toBe('WorkflowValidationError')
-    })
-
-    it('returns correct error type', () => {
-      const error = new WorkflowValidationError('Validation failed')
-      expect(error.name).toBe('WorkflowValidationError')
-    })
-
-    it('stores context with validation details', () => {
-      const context = {
-        workflowId: 'wf-123',
-        stepIndex: 3,
-        field: 'approver',
-        expectedType: 'string'
-      }
-      const error = new WorkflowValidationError('Validation failed', context)
-      expect(error.context).toEqual(context)
-    })
-
-    it('captures stack trace', () => {
-      const error = new WorkflowValidationError('Validation failed')
-      expect(error.stack).toBeDefined()
-      expect(error.stack).toContain('WorkflowValidationError')
-    })
-  })
-
-  describe('instanceof checks', () => {
-    it('WorkflowStepError maintains inheritance chain', () => {
-      const error = new WorkflowStepError('test')
-      expect(error instanceof WorkflowStepError).toBe(true)
-      expect(error instanceof ExecutionError).toBe(true)
-      expect(error instanceof Error).toBe(true)
-    })
-
-    it('WorkflowValidationError maintains inheritance chain', () => {
-      const error = new WorkflowValidationError('test')
-      expect(error instanceof WorkflowValidationError).toBe(true)
-      expect(error instanceof ExecutionError).toBe(true)
-      expect(error instanceof Error).toBe(true)
-    })
-
-    it('workflow errors are distinct types', () => {
-      const stepError = new WorkflowStepError('test')
-      const validationError = new WorkflowValidationError('test')
-
-      expect(stepError instanceof WorkflowValidationError).toBe(false)
-      expect(validationError instanceof WorkflowStepError).toBe(false)
-    })
-  })
-})
+import { describe, it, expect } from 'vitest'
+import { WorkflowStepError, WorkflowValidationError } from '../errors'
+import { ExecutionError } from '../../base/errors'
+
+describe('Workflow Errors', () => {
+  describe('WorkflowStepError', () => {
+    it('extends ExecutionError', () => {
+      const error = new WorkflowStepError('Step failed')
+      expect(error).toBeInstanceOf(ExecutionError)
+      expect(error).toBeInstanceOf(Error)
+    })
+
+    it('has critical severity', () => {
+      const error = new WorkflowStepError('Step failed')
+      expect(error.severity).toBe('critical')
+    })
+
+    it('has workflow category', () => {
+      const error = new WorkflowStepError('Step failed')
+      expect(error.category).toBe('workflow')
+    })
+
+    it('is not retryable by default', () => {
+      const error = new WorkflowStepError('Step failed')
+      expect(error.isRetryable()).toBe(false)
+    })
+
+    it('sets message correctly', () => {
+      const error = new WorkflowStepError('Step "send_email" failed: SMTP unavailable')
+      expect(error.message).toBe('Step "send_email" failed: SMTP unavailable')
+    })
+
+    it('sets name to WorkflowStepError', () => {
+      const error = new WorkflowStepError('Step failed')
+      expect(error.name).toBe('WorkflowStepError')
+    })
+
+    it('returns correct error type', () => {
+      const error = new WorkflowStepError('Step failed')
+      expect(error.name).toBe('WorkflowStepError')
+    })
+
+    it('stores context with workflow details', () => {
+      const context = {
+        workflowId: 'wf-123',
+        stepIndex: 2,
+        stepName: 'send_email',
+        attemptCount: 1
+      }
+      const error = new WorkflowStepError('Step failed', context)
+      expect(error.context).toEqual(context)
+    })
+
+    it('captures stack trace', () => {
+      const error = new WorkflowStepError('Step failed')
+      expect(error.stack).toBeDefined()
+      expect(error.stack).toContain('WorkflowStepError')
+    })
+  })
+
+  describe('WorkflowValidationError', () => {
+    it('extends ExecutionError', () => {
+      const error = new WorkflowValidationError('Validation failed')
+      expect(error).toBeInstanceOf(ExecutionError)
+      expect(error).toBeInstanceOf(Error)
+    })
+
+    it('has info severity', () => {
+      const error = new WorkflowValidationError('Validation failed')
+      expect(error.severity).toBe('info')
+    })
+
+    it('has validation category', () => {
+      const error = new WorkflowValidationError('Validation failed')
+      expect(error.category).toBe('validation')
+    })
+
+    it('is not retryable by default', () => {
+      const error = new WorkflowValidationError('Validation failed')
+      expect(error.isRetryable()).toBe(false)
+    })
+
+    it('sets message correctly', () => {
+      const error = new WorkflowValidationError('Invalid workflow: Missing approver')
+      expect(error.message).toBe('Invalid workflow: Missing approver')
+    })
+
+    it('sets name to WorkflowValidationError', () => {
+      const error = new WorkflowValidationError('Validation failed')
+      expect(error.name).toBe('WorkflowValidationError')
+    })
+
+    it('returns correct error type', () => {
+      const error = new WorkflowValidationError('Validation failed')
+      expect(error.name).toBe('WorkflowValidationError')
+    })
+
+    it('stores context with validation details', () => {
+      const context = {
+        workflowId: 'wf-123',
+        stepIndex: 3,
+        field: 'approver',
+        expectedType: 'string'
+      }
+      const error = new WorkflowValidationError('Validation failed', context)
+      expect(error.context).toEqual(context)
+    })
+
+    it('captures stack trace', () => {
+      const error = new WorkflowValidationError('Validation failed')
+      expect(error.stack).toBeDefined()
+      expect(error.stack).toContain('WorkflowValidationError')
+    })
+  })
+
+  describe('instanceof checks', () => {
+    it('WorkflowStepError maintains inheritance chain', () => {
+      const error = new WorkflowStepError('test')
+      expect(error instanceof WorkflowStepError).toBe(true)
+      expect(error instanceof ExecutionError).toBe(true)
+      expect(error instanceof Error).toBe(true)
+    })
+
+    it('WorkflowValidationError maintains inheritance chain', () => {
+      const error = new WorkflowValidationError('test')
+      expect(error instanceof WorkflowValidationError).toBe(true)
+      expect(error instanceof ExecutionError).toBe(true)
+      expect(error instanceof Error).toBe(true)
+    })
+
+    it('workflow errors are distinct types', () => {
+      const stepError = new WorkflowStepError('test')
+      const validationError = new WorkflowValidationError('test')
+
+      expect(stepError instanceof WorkflowValidationError).toBe(false)
+      expect(validationError instanceof WorkflowStepError).toBe(false)
+    })
+  })
+})

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

@@ -1,63 +1,63 @@
-/**
- * Workflow error classes
- * Errors specific to workflow execution
- */
-
-import { ExecutionError } from '../base/errors'
-
-/**
- * Thrown when a workflow step fails during execution
- *
- * Severity: error (step failure — errors always take precedence over warnings)
- * Category: workflow
- *
- * @example
- * ```typescript
- * throw new WorkflowStepError(
- *   'Step "send_email" failed: SMTP server unavailable',
- *   {
- *     workflowId: 'wf-123',
- *     stepIndex: 2,
- *     stepName: 'send_email',
- *     attemptCount: 1
- *   }
- * )
- * ```
- */
-export class WorkflowStepError extends ExecutionError {
-  readonly type = 'workflow_step_error' as const
-  readonly severity = 'critical' as const
-  readonly category = 'workflow' as const
-
-  constructor(message: string, context?: Record<string, unknown>) {
-    super(message, context)
-  }
-}
-
-/**
- * Thrown when workflow validation fails
- *
- * Severity: info (validation failure indicating user/developer configuration error)
- * Category: validation
- *
- * @example
- * ```typescript
- * throw new WorkflowValidationError(
- *   'Invalid workflow: Step "approval" has no approver configured',
- *   {
- *     workflowId: 'wf-123',
- *     stepIndex: 3,
- *     field: 'approver'
- *   }
- * )
- * ```
- */
-export class WorkflowValidationError extends ExecutionError {
-  readonly type = 'workflow_validation_error' as const
-  readonly severity = 'info' as const
-  readonly category = 'validation' as const
-
-  constructor(message: string, context?: Record<string, unknown>) {
-    super(message, context)
-  }
-}
+/**
+ * Workflow error classes
+ * Errors specific to workflow execution
+ */
+
+import { ExecutionError } from '../base/errors'
+
+/**
+ * Thrown when a workflow step fails during execution
+ *
+ * Severity: error (step failure — errors always take precedence over warnings)
+ * Category: workflow
+ *
+ * @example
+ * ```typescript
+ * throw new WorkflowStepError(
+ *   'Step "send_email" failed: SMTP server unavailable',
+ *   {
+ *     workflowId: 'wf-123',
+ *     stepIndex: 2,
+ *     stepName: 'send_email',
+ *     attemptCount: 1
+ *   }
+ * )
+ * ```
+ */
+export class WorkflowStepError extends ExecutionError {
+  readonly type = 'workflow_step_error' as const
+  readonly severity = 'critical' as const
+  readonly category = 'workflow' as const
+
+  constructor(message: string, context?: Record<string, unknown>) {
+    super(message, context)
+  }
+}
+
+/**
+ * Thrown when workflow validation fails
+ *
+ * Severity: info (validation failure indicating user/developer configuration error)
+ * Category: validation
+ *
+ * @example
+ * ```typescript
+ * throw new WorkflowValidationError(
+ *   'Invalid workflow: Step "approval" has no approver configured',
+ *   {
+ *     workflowId: 'wf-123',
+ *     stepIndex: 3,
+ *     field: 'approver'
+ *   }
+ * )
+ * ```
+ */
+export class WorkflowValidationError extends ExecutionError {
+  readonly type = 'workflow_validation_error' as const
+  readonly severity = 'info' as const
+  readonly category = 'validation' as const
+
+  constructor(message: string, context?: Record<string, unknown>) {
+    super(message, context)
+  }
+}

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

@@ -1,11 +1,11 @@
-/**
- * Workflow Step Helpers - Browser-safe exports
- *
- * NOTE: Server-only helper (llmCall) is exported from @repo/core/server
- * to prevent browser build failures (depends on server-only LLM adapters).
- *
- * This file exports only browser-safe types.
- */
-
-// Type-only exports (safe for browser - types are erased at runtime)
-export type { LLMCallOptions } from './server/llm-call'
+/**
+ * Workflow Step Helpers - Browser-safe exports
+ *
+ * NOTE: Server-only helper (llmCall) is exported from @repo/core/server
+ * to prevent browser build failures (depends on server-only LLM adapters).
+ *
+ * This file exports only browser-safe types.
+ */
+
+// Type-only exports (safe for browser - types are erased at runtime)
+export type { LLMCallOptions } from './server/llm-call'

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

@@ -1,8 +1,8 @@
-/**
- * Server-only Workflow Helpers
- *
- * These helpers use server-only adapters (createLLMAdapter)
- * and should only be imported from @repo/core/server
- */
-
-export { llmCall, type LLMCallOptions } from './llm-call'
+/**
+ * Server-only Workflow Helpers
+ *
+ * These helpers use server-only adapters (createLLMAdapter)
+ * and should only be imported from @repo/core/server
+ */
+
+export { llmCall, type LLMCallOptions } from './llm-call'

package/src/execution/engine/workflow/helpers/server/llm-call.ts

@@ -1,93 +1,93 @@
-/**
- * LLM Call Helper
- * Helper function for making LLM calls within workflow step handlers
- */
-
-import { createLLMAdapter } from '../../../llm/adapters/server/adapter-factory'
-import type { ModelConfig } from '../../../llm/model-info'
-import type { ExecutionContext } from '../../../base/types'
-import type { LLMMessage } from '../../../llm/types'
-
-export interface LLMCallOptions {
-  /** Model configuration (provider, model, API key) */
-  modelConfig: ModelConfig
-  /** Chat messages (system/user/assistant) */
-  messages: LLMMessage[]
-  /** JSON Schema for structured output */
-  responseSchema: Record<string, unknown>
-  /** Optional temperature override */
-  temperature?: number
-  /** Optional max output tokens override */
-  maxOutputTokens?: number
-  /** Optional step ID for observability context */
-  stepId?: string
-  /** Optional step name for observability context */
-  stepName?: string
-}
-
-/**
- * Make an LLM call within a workflow step handler
- *
- * Automatically integrates with observability tracking via ExecutionContext.
- * Tracks calls with `callType: 'workflow-step'` in AI usage metrics.
- *
- * @example
- * ```typescript
- * const summarizeStep: WorkflowStep = {
- *   id: 'summarize',
- *   name: 'Summarize Data',
- *   handler: async (input, context) => {
- *     const result = await llmCall(context, {
- *       modelConfig: {
- *         provider: 'openrouter',
- *         model: 'openrouter/anthropic/claude-sonnet-4.5',
- *         apiKey: process.env.OPENROUTER_API_KEY!
- *       },
- *       messages: [
- *         { role: 'system', content: 'You are a summarization expert.' },
- *         { role: 'user', content: `Summarize: ${input.data}` }
- *       ],
- *       responseSchema: {
- *         type: 'object',
- *         properties: { summary: { type: 'string' } },
- *         required: ['summary']
- *       },
- *       stepId: 'summarize',
- *       stepName: 'Summarize Data'
- *     })
- *
- *     return { summary: result.summary }
- *   },
- *   inputSchema: z.object({ data: z.string() }),
- *   outputSchema: z.object({ summary: z.string() }),
- *   next: { type: StepType.LINEAR, target: 'next-step' }
- * }
- * ```
- */
-export async function llmCall<T = unknown>(context: ExecutionContext, options: LLMCallOptions): Promise<T> {
-  const { modelConfig, messages, responseSchema, temperature, maxOutputTokens, stepId, stepName } = options
-
-  const adapter = createLLMAdapter(
-    {
-      ...modelConfig,
-      ...(temperature !== undefined && { temperature }),
-      ...(maxOutputTokens !== undefined && { maxOutputTokens })
-    },
-    context.aiUsageCollector,
-    'workflow-step',
-    {
-      type: 'workflow-step',
-      stepId: stepId ?? 'unknown',
-      stepName
-    }
-  )
-
-  const response = await adapter.generate<T>({
-    messages,
-    responseSchema,
-    temperature,
-    maxOutputTokens
-  })
-
-  return response.output
-}
+/**
+ * LLM Call Helper
+ * Helper function for making LLM calls within workflow step handlers
+ */
+
+import { createLLMAdapter } from '../../../llm/adapters/server/adapter-factory'
+import type { ModelConfig } from '../../../llm/model-info'
+import type { ExecutionContext } from '../../../base/types'
+import type { LLMMessage } from '../../../llm/types'
+
+export interface LLMCallOptions {
+  /** Model configuration (provider, model, API key) */
+  modelConfig: ModelConfig
+  /** Chat messages (system/user/assistant) */
+  messages: LLMMessage[]
+  /** JSON Schema for structured output */
+  responseSchema: Record<string, unknown>
+  /** Optional temperature override */
+  temperature?: number
+  /** Optional max output tokens override */
+  maxOutputTokens?: number
+  /** Optional step ID for observability context */
+  stepId?: string
+  /** Optional step name for observability context */
+  stepName?: string
+}
+
+/**
+ * Make an LLM call within a workflow step handler
+ *
+ * Automatically integrates with observability tracking via ExecutionContext.
+ * Tracks calls with `callType: 'workflow-step'` in AI usage metrics.
+ *
+ * @example
+ * ```typescript
+ * const summarizeStep: WorkflowStep = {
+ *   id: 'summarize',
+ *   name: 'Summarize Data',
+ *   handler: async (input, context) => {
+ *     const result = await llmCall(context, {
+ *       modelConfig: {
+ *         provider: 'openrouter',
+ *         model: 'openrouter/anthropic/claude-sonnet-4.5',
+ *         apiKey: process.env.OPENROUTER_API_KEY!
+ *       },
+ *       messages: [
+ *         { role: 'system', content: 'You are a summarization expert.' },
+ *         { role: 'user', content: `Summarize: ${input.data}` }
+ *       ],
+ *       responseSchema: {
+ *         type: 'object',
+ *         properties: { summary: { type: 'string' } },
+ *         required: ['summary']
+ *       },
+ *       stepId: 'summarize',
+ *       stepName: 'Summarize Data'
+ *     })
+ *
+ *     return { summary: result.summary }
+ *   },
+ *   inputSchema: z.object({ data: z.string() }),
+ *   outputSchema: z.object({ summary: z.string() }),
+ *   next: { type: StepType.LINEAR, target: 'next-step' }
+ * }
+ * ```
+ */
+export async function llmCall<T = unknown>(context: ExecutionContext, options: LLMCallOptions): Promise<T> {
+  const { modelConfig, messages, responseSchema, temperature, maxOutputTokens, stepId, stepName } = options
+
+  const adapter = createLLMAdapter(
+    {
+      ...modelConfig,
+      ...(temperature !== undefined && { temperature }),
+      ...(maxOutputTokens !== undefined && { maxOutputTokens })
+    },
+    context.aiUsageCollector,
+    'workflow-step',
+    {
+      type: 'workflow-step',
+      stepId: stepId ?? 'unknown',
+      stepName
+    }
+  )
+
+  const response = await adapter.generate<T>({
+    messages,
+    responseSchema,
+    temperature,
+    maxOutputTokens
+  })
+
+  return response.output
+}