web-ai-service 1.0.0

package/README.md

@@ -0,0 +1,287 @@
+# Web AI Service
+
+A TypeScript-based workflow engine that creates dynamic API endpoints from YAML workflow definitions. Build powerful API pipelines with LLM calls, custom code execution, and data transformations without writing server code.
+
+## Features
+
+- 🚀 **YAML-Based Configuration** - Define API endpoints declaratively
+- 🤖 **LLM Integration** - Built-in support for Gemini and Grok  
+- 📝 **Custom Code Nodes** - Execute TypeScript functions in your workflows
+- ⚡ **Parallel Execution** - Run multiple nodes concurrently with error strategies
+- 🔄 **Data Transformation** - Reduce, split, and map data with JSONPath
+- ✅ **Input Validation** - JSON Schema validation on request inputs
+- 🎯 **Type-Safe** - Full TypeScript support with strict typing
+- 🌐 **Auto-Routing** - Endpoint folders automatically become API routes
+
+---
+
+## Quick Start
+ 
+### 1. Installation
+
+You can install the engine globally or in your project:
+
+```bash
+npm install -g web-ai-service
+```
+
+Or just use `npx`:
+
+```bash
+npx web-ai-service
+```
+
+### 2. Setup (if running from source)
+
+```bash
+# Clone or navigate to your project directory
+cd API-Workflow
+
+# Install dependencies
+npm install
+
+# Copy environment template
+cp .env.example .env
+```
+
+### 2. Configuration
+
+Edit `.env` with your API keys:
+
+```bash
+PORT=3000
+GEMINI_API_KEY=your-gemini-api-key-here
+GROK_API_KEY=your-grok-api-key-here
+```
+
+### 3. Start the Server
+
+```bash
+# Development (with hot reload)
+npm run dev
+
+# Production
+npm run build && npm start
+```
+
+The server starts at `http://localhost:3000`.
+
+---
+
+## Project Structure
+
+```
+API-Workflow/
+├── engine/                   # Core workflow engine (framework code)
+│   ├── core/                 # Core execution logic
+│   ├── nodes/                # Node type executors
+│   ├── providers/            # LLM provider implementations
+│   ├── types/                # TypeScript type definitions
+│   └── utils/                # Utility functions
+│
+├── src/                      # User content (you edit this)
+│   ├── endpoints/            # Your API endpoints
+│   │   └── {endpoint-name}/  # One folder per endpoint route
+│   │       ├── POST.yaml     # Workflow definition (method = filename)
+│   │       ├── codes/        # Endpoint-specific code files
+│   │       └── prompts/      # Endpoint-specific prompt files
+│   │
+│   └── plugins/              # Shared code modules (via @code-plugins/*)
+│
+└── .env                      # API keys and configuration
+```
+
+### Key Concepts
+
+| Concept | Description |
+|---------|-------------|
+| **Endpoint** | A folder in `src/endpoints/` that becomes an API route (e.g., `summarize/` → `/summarize`) |
+| **Workflow** | A YAML file (e.g., `POST.yaml`) defining the request processing pipeline |
+| **Stage** | A sequential step in the workflow containing one or more nodes |
+| **Node** | An individual processing unit (LLM call, code execution, etc.) |
+
+---
+
+## Creating Your First Endpoint
+
+### Example: Text Summarization API
+
+**Goal**: Create `POST /summarize` that takes text and returns a summary.
+
+#### Step 1: Create the Endpoint Folder
+
+```bash
+mkdir -p src/endpoints/summarize/prompts
+```
+
+#### Step 2: Create the System Prompt
+
+Create `src/endpoints/summarize/prompts/summarizer-system.txt`:
+
+```text
+You are a concise summarization assistant. Summarize the provided text clearly.
+
+Guidelines:
+- Capture the main points and key information
+- Use clear, professional language
+- Keep the summary to 2-3 paragraphs
+```
+
+#### Step 3: Create the Workflow
+
+Create `src/endpoints/summarize/POST.yaml`:
+
+```yaml
+version: "1.0"
+
+stages:
+  - name: main
+    nodes:
+      summarize:
+        type: llm
+        input: $input
+        provider: gemini
+        model: gemini-2.0-flash-lite
+        temperature: 0.3
+        maxTokens: 1024
+        systemMessages:
+          - file: summarizer-system.txt
+            cache: true
+```
+
+#### Step 4: Test It
+
+```bash
+npm run dev
+
+curl -X POST http://localhost:3000/summarize \
+  -H "Content-Type: application/json" \
+  -d '{"text": "Your long text to summarize goes here..."}'
+```
+
+---
+
+## Adding Custom Code Nodes
+
+For custom processing logic, add TypeScript files to your endpoint's `codes/` folder.
+
+### Example: Validation + Processing
+
+Create `src/endpoints/summarize/codes/validate-input.ts`:
+
+```typescript
+import type { NodeOutput } from '@workflow/types';
+
+export default async function(input: unknown): Promise<NodeOutput> {
+  const body = input as { text?: string };
+  
+  if (!body.text || typeof body.text !== 'string') {
+    throw new Error('Missing required field: text');
+  }
+  
+  if (body.text.length < 10) {
+    throw new Error('Text must be at least 10 characters');
+  }
+  
+  return { type: 'string', value: body.text };
+}
+```
+
+Update `src/endpoints/summarize/POST.yaml`:
+
+```yaml
+version: "1.0"
+
+stages:
+  - name: entry
+    nodes:
+      validate:
+        type: code
+        input: $input
+        file: validate-input.ts
+
+  - name: summarization
+    nodes:
+      summarize:
+        type: llm
+        input: entry.validate
+        provider: gemini
+        model: gemini-2.0-flash-lite
+        temperature: 0.3
+        maxTokens: 1024
+        systemMessages:
+          - file: summarizer-system.txt
+            cache: true
+```
+
+---
+
+## Shared Plugins
+
+For reusable code across endpoints, add files to `src/plugins/` and import via `@code-plugins/*`:
+
+```typescript
+// In any code file
+import { myHelper } from '@code-plugins/my-shared-lib.js';
+```
+
+---
+
+## Node Types Reference
+
+| Type | Purpose | Key Properties |
+|------|---------|----------------|
+| `llm` | Call LLM provider | `provider`, `model`, `systemMessages`, `temperature`, `maxTokens` |
+| `code` | Execute TypeScript | `file` |
+| `reduce` | Combine outputs | `inputs`, `mapping` |
+| `split` | Divide output | `mapping` |
+| `passthrough` | Pass input unchanged | (none) |
+
+---
+
+## Available Commands
+
+| Command | Description |
+|---------|-------------|
+| `npm run dev` | Start development server with hot reload |
+| `npm run create-endpoint` | Scaffold a new API endpoint interactively |
+| `npm run build` | Compile TypeScript to JavaScript |
+| `npm start` | Start production server |
+| `npm run validate` | Validate all workflows |
+| `npm run scan-deps` | Scan and install code node dependencies |
+| `npm run lint` | Run ESLint |
+| `npm run format` | Format code with Prettier |
+
+---
+
+## Environment Variables
+
+| Variable | Default | Description |
+|----------|---------|-------------|
+| `PORT` | `3000` | Server port |
+| `GEMINI_API_KEY` | - | Gemini API key (required for Gemini) |
+| `GROK_API_KEY` | - | Grok API key (required for Grok) |
+| `LLM_TIMEOUT_MS` | `30000` | LLM call timeout |
+| `LOG_LEVEL` | `info` | Logging level (`debug`, `info`, `warn`, `error`) |
+
+---
+
+## Troubleshooting
+
+| Error | Solution |
+|-------|----------|
+| "Provider not found" | Check `provider` is `gemini` or `grok` and API key is set in `.env` |
+| "Code node file not found" | Verify file exists in `codes/` folder with correct filename |
+| "Cannot find module '@workflow/types'" | Run `npm run build` or restart TypeScript server |
+| LLM Timeout | Increase `LLM_TIMEOUT_MS` in `.env` or use a faster model |
+
+---
+
+## Documentation
+
+- [Full Specification](__dev_guide__/Dynamic-API-Service-SPEC.md) - Complete technical spec
+- [Development Notes](_dev_notes_/plan.md) - Implementation roadmap
+
+## License
+
+ISC

package/dist/engine/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/engine/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../engine/cli.ts"],"names":[],"mappings":""}

package/dist/engine/cli.js

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+import { main } from './index.js';
+main();
+//# sourceMappingURL=cli.js.map

package/dist/engine/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../../engine/cli.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAElC,IAAI,EAAE,CAAC"}

package/dist/engine/config/llm-costs.d.ts

@@ -0,0 +1,16 @@
+/**
+ * LLM Cost Configuration
+ * Costs are in USD per 1 million tokens
+ */
+export interface ModelCost {
+    inputCostPer1M: number;
+    outputCostPer1M: number;
+    cachedInputCostPer1M?: number;
+}
+export declare const defaultLLMCosts: Record<string, ModelCost>;
+/**
+ * Get cost for a specific model
+ * Falls back to 0 if model not found
+ */
+export declare function getModelCost(model: string): ModelCost;
+//# sourceMappingURL=llm-costs.d.ts.map

package/dist/engine/config/llm-costs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-costs.d.ts","sourceRoot":"","sources":["../../../engine/config/llm-costs.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,SAAS;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;IACxB,oBAAoB,CAAC,EAAE,MAAM,CAAC;CACjC;AAED,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAiBrD,CAAC;AAEF;;;GAGG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAerD"}

package/dist/engine/config/llm-costs.js

@@ -0,0 +1,38 @@
+/**
+ * LLM Cost Configuration
+ * Costs are in USD per 1 million tokens
+ */
+export const defaultLLMCosts = {
+    // Gemini 3 Preview Models
+    'gemini-3-pro-preview': { inputCostPer1M: 2.00, cachedInputCostPer1M: 0.20, outputCostPer1M: 12.00 },
+    'gemini-3-flash-preview': { inputCostPer1M: 0.50, cachedInputCostPer1M: 0.05, outputCostPer1M: 3.00 },
+    // Gemini 2.5 Models
+    'gemini-2.5-pro': { inputCostPer1M: 1.25, cachedInputCostPer1M: 0.125, outputCostPer1M: 10.00 }, // Corrected swapped values
+    'gemini-2.5-flash': { inputCostPer1M: 0.30, cachedInputCostPer1M: 0.03, outputCostPer1M: 2.50 },
+    'gemini-2.5-flash-lite': { inputCostPer1M: 0.10, cachedInputCostPer1M: 0.01, outputCostPer1M: 0.40 },
+    // Gemini 2.0 Models
+    'gemini-2.0-flash': { inputCostPer1M: 0.10, cachedInputCostPer1M: 0.025, outputCostPer1M: 0.40 },
+    'gemini-2.0-flash-lite': { inputCostPer1M: 0.075, cachedInputCostPer1M: 0.075, outputCostPer1M: 0.30 }, // User specified cached=input
+    // Grok Models
+    'grok-4-1-fast-reasoning': { inputCostPer1M: 0.20, cachedInputCostPer1M: 0.20, outputCostPer1M: 0.50 },
+    'grok-4-1-fast-non-reasoning': { inputCostPer1M: 0.20, cachedInputCostPer1M: 0.20, outputCostPer1M: 0.50 },
+};
+/**
+ * Get cost for a specific model
+ * Falls back to 0 if model not found
+ */
+export function getModelCost(model) {
+    // Exact match
+    if (defaultLLMCosts[model]) {
+        return defaultLLMCosts[model];
+    }
+    // Try finding matching prefix (e.g. gemini-1.5-flash-001 matches gemini-1.5-flash)
+    // This is a simple heuristic, might need refinement
+    const knownModels = Object.keys(defaultLLMCosts);
+    const match = knownModels.find(m => model.startsWith(m));
+    if (match) {
+        return defaultLLMCosts[match];
+    }
+    return { inputCostPer1M: 0, outputCostPer1M: 0 };
+}
+//# sourceMappingURL=llm-costs.js.map

package/dist/engine/config/llm-costs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-costs.js","sourceRoot":"","sources":["../../../engine/config/llm-costs.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAQH,MAAM,CAAC,MAAM,eAAe,GAA8B;IACtD,0BAA0B;IAC1B,sBAAsB,EAAE,EAAE,cAAc,EAAE,IAAI,EAAE,oBAAoB,EAAE,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE;IACpG,wBAAwB,EAAE,EAAE,cAAc,EAAE,IAAI,EAAE,oBAAoB,EAAE,IAAI,EAAE,eAAe,EAAE,IAAI,EAAE;IAErG,oBAAoB;IACpB,gBAAgB,EAAE,EAAE,cAAc,EAAE,IAAI,EAAE,oBAAoB,EAAE,KAAK,EAAE,eAAe,EAAE,KAAK,EAAE,EAAE,2BAA2B;IAC5H,kBAAkB,EAAE,EAAE,cAAc,EAAE,IAAI,EAAE,oBAAoB,EAAE,IAAI,EAAE,eAAe,EAAE,IAAI,EAAE;IAC/F,uBAAuB,EAAE,EAAE,cAAc,EAAE,IAAI,EAAE,oBAAoB,EAAE,IAAI,EAAE,eAAe,EAAE,IAAI,EAAE;IAEpG,oBAAoB;IACpB,kBAAkB,EAAE,EAAE,cAAc,EAAE,IAAI,EAAE,oBAAoB,EAAE,KAAK,EAAE,eAAe,EAAE,IAAI,EAAE;IAChG,uBAAuB,EAAE,EAAE,cAAc,EAAE,KAAK,EAAE,oBAAoB,EAAE,KAAK,EAAE,eAAe,EAAE,IAAI,EAAE,EAAE,8BAA8B;IAEtI,cAAc;IACd,yBAAyB,EAAE,EAAE,cAAc,EAAE,IAAI,EAAE,oBAAoB,EAAE,IAAI,EAAE,eAAe,EAAE,IAAI,EAAE;IACtG,6BAA6B,EAAE,EAAE,cAAc,EAAE,IAAI,EAAE,oBAAoB,EAAE,IAAI,EAAE,eAAe,EAAE,IAAI,EAAE;CAC7G,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,KAAa;IACtC,cAAc;IACd,IAAI,eAAe,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,eAAe,CAAC,KAAK,CAAC,CAAC;IAClC,CAAC;IAED,mFAAmF;IACnF,oDAAoD;IACpD,MAAM,WAAW,GAAG,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IACjD,MAAM,KAAK,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;IACzD,IAAI,KAAK,EAAE,CAAC;QACR,OAAO,eAAe,CAAC,KAAK,CAAC,CAAC;IAClC,CAAC;IAED,OAAO,EAAE,cAAc,EAAE,CAAC,EAAE,eAAe,EAAE,CAAC,EAAE,CAAC;AACrD,CAAC"}

package/dist/engine/core/node-executor.d.ts

@@ -0,0 +1,8 @@
+import type { NodeDefinition, NodeOutput, ExecutionContext, WorkflowDefinition, StageDefinition } from '../types/index.js';
+/**
+ * Execute a single node within a stage
+ * Outputs are stored as stageName.nodeId to allow stage-scoped references
+ * Input is passed from stage at runtime (nodes: { nodeId: input })
+ */
+export declare function executeNode(node: NodeDefinition, inputRef: string, stage: StageDefinition, context: ExecutionContext, workflow: WorkflowDefinition): Promise<NodeOutput>;
+//# sourceMappingURL=node-executor.d.ts.map

package/dist/engine/core/node-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-executor.d.ts","sourceRoot":"","sources":["../../../engine/core/node-executor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACR,cAAc,EACd,UAAU,EACV,gBAAgB,EAChB,kBAAkB,EAClB,eAAe,EAClB,MAAM,mBAAmB,CAAC;AAU3B;;;;GAIG;AACH,wBAAsB,WAAW,CAC7B,IAAI,EAAE,cAAc,EACpB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,eAAe,EACtB,OAAO,EAAE,gBAAgB,EACzB,QAAQ,EAAE,kBAAkB,GAC7B,OAAO,CAAC,UAAU,CAAC,CA6FrB"}

package/dist/engine/core/node-executor.js

@@ -0,0 +1,150 @@
+import { executeCodeNode } from '../nodes/code-node.js';
+import { executeLLMNode } from '../nodes/llm-node.js';
+import { executeReduceNode } from '../nodes/reduce-node.js';
+import { executeSplitNode } from '../nodes/split-node.js';
+import { executePassthroughNode } from '../nodes/passthrough-node.js';
+import { executeEndpointNode } from '../nodes/endpoint-node.js';
+import logger from '../utils/logger.js';
+import { ErrorCode } from '../types/index.js';
+/**
+ * Execute a single node within a stage
+ * Outputs are stored as stageName.nodeId to allow stage-scoped references
+ * Input is passed from stage at runtime (nodes: { nodeId: input })
+ */
+export async function executeNode(node, inputRef, stage, context, workflow) {
+    const outputKey = `${stage.name}.${node.id}`;
+    const startTime = Date.now();
+    try {
+        let output;
+        switch (node.type) {
+            case 'code': {
+                const input = resolveInput(inputRef, context);
+                output = await executeCodeNode(node, input, context, workflow);
+                break;
+            }
+            case 'llm': {
+                const input = resolveInput(inputRef, context);
+                output = await executeLLMNode(node, input, workflow, context);
+                break;
+            }
+            case 'reduce': {
+                output = await executeReduceNode(node, context);
+                break;
+            }
+            case 'split': {
+                const input = resolveInput(inputRef, context);
+                const splitOutputs = await executeSplitNode(node, input);
+                // Store split outputs with stage prefix
+                const stageKey = `${stage.name}.${node.id}`;
+                context.splitOutputs.set(stageKey, splitOutputs);
+                // Return a placeholder output (split doesn't have a single output)
+                output = {
+                    type: 'json',
+                    value: Object.fromEntries(Array.from(splitOutputs.entries()).map(([key, val]) => [key, val.value])),
+                };
+                break;
+            }
+            case 'passthrough': {
+                const input = resolveInput(inputRef, context);
+                if (!input) {
+                    throw new Error(`${ErrorCode.NODE_NOT_FOUND}: Input '${inputRef}' not found`);
+                }
+                output = await executePassthroughNode(node, { type: 'json', value: input });
+                break;
+            }
+            case 'endpoint': {
+                const input = resolveInput(inputRef, context);
+                output = await executeEndpointNode(node, input, context);
+                break;
+            }
+            default:
+                throw new Error(`Unknown node type: ${node.type}`);
+        }
+        // Store output with stage-scoped key (no caching, always execute)
+        context.nodeOutputs.set(outputKey, output);
+        // Record timing with stage-scoped key
+        const duration = Date.now() - startTime;
+        context.timing.set(outputKey, duration);
+        logger.info('Node executed successfully', {
+            stage: stage.name,
+            nodeId: node.id,
+            outputKey,
+            type: node.type,
+            duration: `${duration}ms`,
+            outputType: output.type,
+        });
+        return output;
+    }
+    catch (error) {
+        const duration = Date.now() - startTime;
+        context.timing.set(outputKey, duration);
+        logger.error('Node execution failed', {
+            stage: stage.name,
+            nodeId: node.id,
+            type: node.type,
+            duration: `${duration}ms`,
+            error: error instanceof Error ? error.message : String(error),
+        });
+        throw error;
+    }
+}
+/**
+ * Resolve input value from context
+ * Supports: $input, $params.paramName, stageName.nodeId
+ */
+function resolveInput(inputRef, context) {
+    // Special case: $input refers to raw request body
+    if (inputRef === '$input') {
+        return context.input;
+    }
+    // Special case: $params.paramName refers to route parameters
+    if (inputRef.startsWith('$params.')) {
+        const paramName = inputRef.slice(8); // Remove '$params.'
+        const paramValue = context.params[paramName];
+        if (paramValue === undefined) {
+            throw new Error(`${ErrorCode.NODE_NOT_FOUND}: Route parameter '${paramName}' not found`);
+        }
+        return paramValue;
+    }
+    // Support $input.property access
+    if (inputRef.startsWith('$input.')) {
+        const key = inputRef.replace('$input.', '');
+        if (typeof context.input === 'object' && context.input !== null) {
+            return resolveObjectPath(context.input, key);
+        }
+        return undefined;
+    }
+    // Check for stage.node reference (e.g., "entry.summarize")
+    if (inputRef.includes('.')) {
+        const parts = inputRef.split('.');
+        // Handle split output reference (stageName.nodeId.outputName)
+        if (parts.length === 3) {
+            const [stageName, nodeId, outputName] = parts;
+            const stageKey = `${stageName}.${nodeId}`;
+            const splitOutputs = context.splitOutputs.get(stageKey);
+            if (splitOutputs) {
+                const splitOutput = splitOutputs.get(outputName);
+                if (splitOutput) {
+                    return splitOutput.value;
+                }
+            }
+            throw new Error(`${ErrorCode.NODE_NOT_FOUND}: Split output '${inputRef}' not found`);
+        }
+        // Standard stage.node reference (stageName.nodeId)
+        const nodeOutput = context.nodeOutputs.get(inputRef);
+        if (nodeOutput) {
+            return nodeOutput.value;
+        }
+        throw new Error(`${ErrorCode.NODE_NOT_FOUND}: Output '${inputRef}' not found. Input must be in format 'stageName.nodeId'`);
+    }
+    throw new Error(`${ErrorCode.NODE_NOT_FOUND}: Invalid input reference '${inputRef}'. Must be '$input' or 'stageName.nodeId'`);
+}
+/**
+ * Helper to resolve object path (e.g., "prop.subprop")
+ */
+function resolveObjectPath(obj, path) {
+    return path.split('.').reduce((prev, curr) => {
+        return prev ? prev[curr] : undefined;
+    }, obj);
+}
+//# sourceMappingURL=node-executor.js.map

package/dist/engine/core/node-executor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-executor.js","sourceRoot":"","sources":["../../../engine/core/node-executor.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAC;AACtE,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,MAAM,MAAM,oBAAoB,CAAC;AACxC,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAE9C;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC7B,IAAoB,EACpB,QAAgB,EAChB,KAAsB,EACtB,OAAyB,EACzB,QAA4B;IAE5B,MAAM,SAAS,GAAG,GAAG,KAAK,CAAC,IAAI,IAAI,IAAI,CAAC,EAAE,EAAE,CAAC;IAC7C,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAE7B,IAAI,CAAC;QACD,IAAI,MAAkB,CAAC;QAEvB,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC;YAChB,KAAK,MAAM,CAAC,CAAC,CAAC;gBACV,MAAM,KAAK,GAAG,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;gBAC9C,MAAM,GAAG,MAAM,eAAe,CAAC,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;gBAC/D,MAAM;YACV,CAAC;YAED,KAAK,KAAK,CAAC,CAAC,CAAC;gBACT,MAAM,KAAK,GAAG,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;gBAC9C,MAAM,GAAG,MAAM,cAAc,CAAC,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;gBAC9D,MAAM;YACV,CAAC;YAED,KAAK,QAAQ,CAAC,CAAC,CAAC;gBACZ,MAAM,GAAG,MAAM,iBAAiB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;gBAChD,MAAM;YACV,CAAC;YAED,KAAK,OAAO,CAAC,CAAC,CAAC;gBACX,MAAM,KAAK,GAAG,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;gBAC9C,MAAM,YAAY,GAAG,MAAM,gBAAgB,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;gBAEzD,wCAAwC;gBACxC,MAAM,QAAQ,GAAG,GAAG,KAAK,CAAC,IAAI,IAAI,IAAI,CAAC,EAAE,EAAE,CAAC;gBAC5C,OAAO,CAAC,YAAY,CAAC,GAAG,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;gBAEjD,mEAAmE;gBACnE,MAAM,GAAG;oBACL,IAAI,EAAE,MAAM;oBACZ,KAAK,EAAE,MAAM,CAAC,WAAW,CACrB,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC,CAC3E;iBACJ,CAAC;gBACF,MAAM;YACV,CAAC;YAED,KAAK,aAAa,CAAC,CAAC,CAAC;gBACjB,MAAM,KAAK,GAAG,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;gBAC9C,IAAI,CAAC,KAAK,EAAE,CAAC;oBACT,MAAM,IAAI,KAAK,CAAC,GAAG,SAAS,CAAC,cAAc,YAAY,QAAQ,aAAa,CAAC,CAAC;gBAClF,CAAC;gBACD,MAAM,GAAG,MAAM,sBAAsB,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;gBAC5E,MAAM;YACV,CAAC;YAED,KAAK,UAAU,CAAC,CAAC,CAAC;gBACd,MAAM,KAAK,GAAG,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;gBAC9C,MAAM,GAAG,MAAM,mBAAmB,CAAC,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;gBACzD,MAAM;YACV,CAAC;YAED;gBACI,MAAM,IAAI,KAAK,CAAC,sBAAuB,IAAuB,CAAC,IAAI,EAAE,CAAC,CAAC;QAC/E,CAAC;QAED,kEAAkE;QAClE,OAAO,CAAC,WAAW,CAAC,GAAG,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;QAE3C,sCAAsC;QACtC,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;QACxC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;QAExC,MAAM,CAAC,IAAI,CAAC,4BAA4B,EAAE;YACtC,KAAK,EAAE,KAAK,CAAC,IAAI;YACjB,MAAM,EAAE,IAAI,CAAC,EAAE;YACf,SAAS;YACT,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,QAAQ,EAAE,GAAG,QAAQ,IAAI;YACzB,UAAU,EAAE,MAAM,CAAC,IAAI;SAC1B,CAAC,CAAC;QAEH,OAAO,MAAM,CAAC;IAClB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACb,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;QACxC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;QAExC,MAAM,CAAC,KAAK,CAAC,uBAAuB,EAAE;YAClC,KAAK,EAAE,KAAK,CAAC,IAAI;YACjB,MAAM,EAAE,IAAI,CAAC,EAAE;YACf,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,QAAQ,EAAE,GAAG,QAAQ,IAAI;YACzB,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;SAChE,CAAC,CAAC;QAEH,MAAM,KAAK,CAAC;IAChB,CAAC;AACL,CAAC;AAED;;;GAGG;AACH,SAAS,YAAY,CAAC,QAAgB,EAAE,OAAyB;IAC7D,kDAAkD;IAClD,IAAI,QAAQ,KAAK,QAAQ,EAAE,CAAC;QACxB,OAAO,OAAO,CAAC,KAAK,CAAC;IACzB,CAAC;IAED,6DAA6D;IAC7D,IAAI,QAAQ,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAClC,MAAM,SAAS,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,oBAAoB;QACzD,MAAM,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QAC7C,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;YAC3B,MAAM,IAAI,KAAK,CACX,GAAG,SAAS,CAAC,cAAc,sBAAsB,SAAS,aAAa,CAC1E,CAAC;QACN,CAAC;QACD,OAAO,UAAU,CAAC;IACtB,CAAC;IAGD,iCAAiC;IACjC,IAAI,QAAQ,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QACjC,MAAM,GAAG,GAAG,QAAQ,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;QAC5C,IAAI,OAAO,OAAO,CAAC,KAAK,KAAK,QAAQ,IAAI,OAAO,CAAC,KAAK,KAAK,IAAI,EAAE,CAAC;YAC9D,OAAO,iBAAiB,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QACjD,CAAC;QACD,OAAO,SAAS,CAAC;IACrB,CAAC;IAED,2DAA2D;IAC3D,IAAI,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QACzB,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAElC,8DAA8D;QAC9D,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACrB,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,CAAC,GAAG,KAAK,CAAC;YAC9C,MAAM,QAAQ,GAAG,GAAG,SAAS,IAAI,MAAM,EAAE,CAAC;YAC1C,MAAM,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YAExD,IAAI,YAAY,EAAE,CAAC;gBACf,MAAM,WAAW,GAAG,YAAY,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;gBACjD,IAAI,WAAW,EAAE,CAAC;oBACd,OAAO,WAAW,CAAC,KAAK,CAAC;gBAC7B,CAAC;YACL,CAAC;YACD,MAAM,IAAI,KAAK,CACX,GAAG,SAAS,CAAC,cAAc,mBAAmB,QAAQ,aAAa,CACtE,CAAC;QACN,CAAC;QAED,mDAAmD;QACnD,MAAM,UAAU,GAAG,OAAO,CAAC,WAAW,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACrD,IAAI,UAAU,EAAE,CAAC;YACb,OAAO,UAAU,CAAC,KAAK,CAAC;QAC5B,CAAC;QAED,MAAM,IAAI,KAAK,CACX,GAAG,SAAS,CAAC,cAAc,aAAa,QAAQ,yDAAyD,CAC5G,CAAC;IACN,CAAC;IAED,MAAM,IAAI,KAAK,CACX,GAAG,SAAS,CAAC,cAAc,8BAA8B,QAAQ,2CAA2C,CAC/G,CAAC;AACN,CAAC;AAED;;GAEG;AACH,SAAS,iBAAiB,CAAC,GAAQ,EAAE,IAAY;IAC7C,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE;QACzC,OAAO,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACzC,CAAC,EAAE,GAAG,CAAC,CAAC;AACZ,CAAC"}

package/dist/engine/core/validator.d.ts

@@ -0,0 +1,6 @@
+import type { WorkflowDefinition, ValidationResult } from '../types/index.js';
+/**
+ * Validate a workflow definition
+ */
+export declare function validateWorkflow(workflow: WorkflowDefinition): Promise<ValidationResult>;
+//# sourceMappingURL=validator.d.ts.map

package/dist/engine/core/validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator.d.ts","sourceRoot":"","sources":["../../../engine/core/validator.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kBAAkB,EAAE,gBAAgB,EAAsC,MAAM,mBAAmB,CAAC;AAOlH;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,QAAQ,EAAE,kBAAkB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAwC9F"}