@marktoflow/core 2.0.0-alpha.12

package/dist/prompt-loader.js

@@ -0,0 +1,268 @@
+/**
+ * Prompt Loader for marktoflow v2.0
+ *
+ * Loads external prompt files with optional YAML frontmatter for variable definitions.
+ * Supports template variable resolution using {{ prompt.variable }} syntax.
+ */
+import { readFile } from 'node:fs/promises';
+import { resolve, dirname } from 'node:path';
+import { parse as parseYaml } from 'yaml';
+// ============================================================================
+// Prompt Loading
+// ============================================================================
+const FRONTMATTER_REGEX = /^---\n([\s\S]*?)\n---\n?/;
+/**
+ * Load a prompt file with optional YAML frontmatter.
+ */
+export async function loadPromptFile(promptPath, basePath) {
+    // Resolve path relative to base path if provided
+    const resolvedPath = basePath ? resolve(dirname(basePath), promptPath) : resolve(promptPath);
+    let content;
+    try {
+        content = await readFile(resolvedPath, 'utf-8');
+    }
+    catch (error) {
+        throw new Error(`Failed to load prompt file: ${resolvedPath}. ${error}`);
+    }
+    // Parse frontmatter if present
+    const frontmatterMatch = content.match(FRONTMATTER_REGEX);
+    let frontmatter = {};
+    let promptContent = content;
+    if (frontmatterMatch) {
+        try {
+            frontmatter = parseYaml(frontmatterMatch[1]);
+            promptContent = content.slice(frontmatterMatch[0].length).trim();
+        }
+        catch (error) {
+            throw new Error(`Invalid YAML frontmatter in prompt file: ${resolvedPath}. ${error}`);
+        }
+    }
+    // Extract variables
+    const variables = {};
+    const variablesRaw = frontmatter.variables;
+    if (variablesRaw) {
+        for (const [name, config] of Object.entries(variablesRaw)) {
+            if (typeof config === 'object' && config !== null) {
+                const varConfig = config;
+                variables[name] = {
+                    type: varConfig.type || 'string',
+                    required: varConfig.required,
+                    default: varConfig.default,
+                    description: varConfig.description,
+                };
+            }
+            else {
+                // Simple type definition
+                variables[name] = {
+                    type: config || 'string',
+                    required: undefined,
+                    default: undefined,
+                    description: undefined,
+                };
+            }
+        }
+    }
+    return {
+        name: frontmatter.name,
+        description: frontmatter.description,
+        variables,
+        content: promptContent,
+        rawContent: content,
+        filePath: resolvedPath,
+    };
+}
+// ============================================================================
+// Template Resolution
+// ============================================================================
+/**
+ * Resolve {{ prompt.variable }} templates in a prompt.
+ */
+export function resolvePromptTemplate(prompt, inputs, context) {
+    // Build resolved variables with defaults
+    const resolvedVars = {};
+    // Apply defaults first
+    for (const [name, config] of Object.entries(prompt.variables)) {
+        if (config.default !== undefined) {
+            resolvedVars[name] = config.default;
+        }
+    }
+    // Override with provided inputs
+    for (const [name, value] of Object.entries(inputs)) {
+        resolvedVars[name] = value;
+    }
+    // Resolve templates in prompt content
+    let content = prompt.content;
+    // Replace {{ prompt.variable }} patterns
+    content = content.replace(/\{\{\s*prompt\.([^}]+)\s*\}\}/g, (_, varPath) => {
+        const trimmedPath = varPath.trim();
+        const value = getNestedValue(resolvedVars, trimmedPath);
+        return serializeValue(value);
+    });
+    // Also resolve {{ variable }} patterns (for backward compatibility)
+    content = content.replace(/\{\{\s*([^}]+)\s*\}\}/g, (match, varPath) => {
+        const trimmedPath = varPath.trim();
+        // Skip if it doesn't look like a variable reference
+        if (trimmedPath.includes('.') && !trimmedPath.startsWith('prompt.')) {
+            // Try to resolve from context if available
+            if (context) {
+                const value = resolveFromContext(trimmedPath, context);
+                if (value !== undefined) {
+                    return serializeValue(value);
+                }
+            }
+        }
+        // Try to resolve from prompt inputs
+        const value = getNestedValue(resolvedVars, trimmedPath);
+        if (value !== undefined) {
+            return serializeValue(value);
+        }
+        // Leave unresolved templates as-is (they may be resolved later)
+        return match;
+    });
+    return {
+        content,
+        variables: resolvedVars,
+    };
+}
+/**
+ * Resolve a variable path from execution context.
+ */
+function resolveFromContext(path, context) {
+    // Handle inputs.* prefix
+    if (path.startsWith('inputs.')) {
+        const inputPath = path.slice(7);
+        return getNestedValue(context.inputs, inputPath);
+    }
+    // Check variables
+    const fromVars = getNestedValue(context.variables, path);
+    if (fromVars !== undefined) {
+        return fromVars;
+    }
+    return undefined;
+}
+// ============================================================================
+// Validation
+// ============================================================================
+/**
+ * Validate that all required prompt inputs are provided.
+ */
+export function validatePromptInputs(prompt, inputs) {
+    const errors = [];
+    const warnings = [];
+    for (const [name, config] of Object.entries(prompt.variables)) {
+        const value = inputs[name];
+        const hasValue = value !== undefined && value !== null;
+        // Check required
+        if (config.required && !hasValue && config.default === undefined) {
+            errors.push(`Missing required prompt variable: ${name}`);
+            continue;
+        }
+        // Type validation (if value is provided)
+        if (hasValue) {
+            const typeError = validateType(value, config.type, name);
+            if (typeError) {
+                errors.push(typeError);
+            }
+        }
+    }
+    // Warn about unused inputs
+    for (const name of Object.keys(inputs)) {
+        if (!prompt.variables[name]) {
+            warnings.push(`Unused prompt input: ${name}`);
+        }
+    }
+    return {
+        valid: errors.length === 0,
+        errors,
+        warnings,
+    };
+}
+/**
+ * Validate a value against an expected type.
+ */
+function validateType(value, type, name) {
+    switch (type) {
+        case 'string':
+            if (typeof value !== 'string') {
+                return `Expected string for ${name}, got ${typeof value}`;
+            }
+            break;
+        case 'number':
+            if (typeof value !== 'number') {
+                return `Expected number for ${name}, got ${typeof value}`;
+            }
+            break;
+        case 'boolean':
+            if (typeof value !== 'boolean') {
+                return `Expected boolean for ${name}, got ${typeof value}`;
+            }
+            break;
+        case 'array':
+            if (!Array.isArray(value)) {
+                return `Expected array for ${name}, got ${typeof value}`;
+            }
+            break;
+        case 'object':
+            if (typeof value !== 'object' || value === null || Array.isArray(value)) {
+                return `Expected object for ${name}, got ${Array.isArray(value) ? 'array' : typeof value}`;
+            }
+            break;
+    }
+    return null;
+}
+// ============================================================================
+// Helpers
+// ============================================================================
+/**
+ * Get a nested value from an object using dot notation.
+ */
+function getNestedValue(obj, path) {
+    if (obj === null || obj === undefined) {
+        return undefined;
+    }
+    const parts = path.split('.');
+    let current = obj;
+    for (const part of parts) {
+        if (current === null || current === undefined) {
+            return undefined;
+        }
+        if (typeof current === 'object') {
+            current = current[part];
+        }
+        else {
+            return undefined;
+        }
+    }
+    return current;
+}
+/**
+ * Serialize a value for template interpolation.
+ */
+function serializeValue(value) {
+    if (value === undefined || value === null) {
+        return '';
+    }
+    if (typeof value === 'string' || typeof value === 'number' || typeof value === 'boolean') {
+        return String(value);
+    }
+    try {
+        return JSON.stringify(value, null, 2);
+    }
+    catch {
+        return String(value);
+    }
+}
+/**
+ * Extract all variable references from a prompt template.
+ */
+export function extractPromptVariables(content) {
+    const variables = new Set();
+    // Extract {{ prompt.variable }} patterns
+    const promptVarRegex = /\{\{\s*prompt\.([^}]+)\s*\}\}/g;
+    let match;
+    while ((match = promptVarRegex.exec(content)) !== null) {
+        variables.add(match[1].trim());
+    }
+    return Array.from(variables);
+}
+//# sourceMappingURL=prompt-loader.js.map

package/dist/prompt-loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-loader.js","sourceRoot":"","sources":["../src/prompt-loader.ts"],"names":[],"mappings":"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"}

package/dist/queue.d.ts

@@ -0,0 +1,114 @@
+/**
+ * Message Queue Integration for marktoflow v2.0
+ *
+ * Supports Redis and RabbitMQ for distributed workflow execution.
+ */
+import { EventEmitter } from 'node:events';
+export declare enum MessagePriority {
+    LOW = 0,
+    NORMAL = 1,
+    HIGH = 2,
+    CRITICAL = 3
+}
+export declare enum MessageStatus {
+    PENDING = "pending",
+    PROCESSING = "processing",
+    COMPLETED = "completed",
+    FAILED = "failed",
+    DEAD_LETTER = "dead_letter"
+}
+export interface QueueMessage {
+    id: string;
+    workflowId: string;
+    payload: Record<string, unknown>;
+    priority: MessagePriority;
+    status: MessageStatus;
+    createdAt: Date;
+    processedAt?: Date;
+    attempts: number;
+    maxAttempts: number;
+    error?: string;
+    metadata: Record<string, unknown>;
+}
+export interface QueueConfig {
+    name: string;
+    maxSize?: number;
+    messageTtl?: number;
+    deadLetterQueue?: string;
+    retryDelay?: number;
+    visibilityTimeout?: number;
+}
+export type MessageHandler = (message: QueueMessage) => Promise<void>;
+export declare abstract class MessageQueue extends EventEmitter {
+    abstract connect(): Promise<void>;
+    abstract disconnect(): Promise<void>;
+    abstract publish(message: QueueMessage, queueName?: string): Promise<string>;
+    abstract consume(handler: MessageHandler, queueName?: string, batchSize?: number): Promise<void>;
+    abstract acknowledge(messageId: string): Promise<void>;
+    abstract reject(messageId: string, requeue?: boolean): Promise<void>;
+    abstract getQueueLength(queueName?: string): Promise<number>;
+    abstract purge(queueName?: string): Promise<number>;
+    abstract stop(): Promise<void>;
+}
+export declare class InMemoryQueue extends MessageQueue {
+    private queues;
+    private processing;
+    private deadLetter;
+    private running;
+    private config;
+    constructor(config?: QueueConfig);
+    connect(): Promise<void>;
+    disconnect(): Promise<void>;
+    private getQueue;
+    publish(message: QueueMessage, queueName?: string): Promise<string>;
+    consume(handler: MessageHandler, queueName?: string, batchSize?: number): Promise<void>;
+    acknowledge(messageId: string): Promise<void>;
+    reject(messageId: string, requeue?: boolean): Promise<void>;
+    getQueueLength(queueName?: string): Promise<number>;
+    purge(queueName?: string): Promise<number>;
+    stop(): Promise<void>;
+}
+export declare class RedisQueue extends MessageQueue {
+    private client;
+    private config;
+    private running;
+    private redisUrl;
+    constructor(redisUrl: string, config?: QueueConfig);
+    connect(): Promise<void>;
+    disconnect(): Promise<void>;
+    private queueKey;
+    private processingKey;
+    publish(message: QueueMessage, queueName?: string): Promise<string>;
+    consume(handler: MessageHandler, queueName?: string, batchSize?: number): Promise<void>;
+    acknowledge(messageId: string): Promise<void>;
+    reject(messageId: string, requeue?: boolean): Promise<void>;
+    getQueueLength(queueName?: string): Promise<number>;
+    purge(queueName?: string): Promise<number>;
+    stop(): Promise<void>;
+}
+export declare class RabbitMQQueue extends MessageQueue {
+    private connection;
+    private channel;
+    private config;
+    private amqpUrl;
+    private consumerTag;
+    constructor(amqpUrl: string, config?: QueueConfig);
+    connect(): Promise<void>;
+    disconnect(): Promise<void>;
+    publish(message: QueueMessage, queueName?: string): Promise<string>;
+    consume(handler: MessageHandler, queueName?: string, batchSize?: number): Promise<void>;
+    acknowledge(_messageId: string): Promise<void>;
+    reject(_messageId: string, _requeue?: boolean): Promise<void>;
+    getQueueLength(queueName?: string): Promise<number>;
+    purge(queueName?: string): Promise<number>;
+    stop(): Promise<void>;
+}
+export declare class WorkflowQueueManager {
+    private queue;
+    private workflowCallback?;
+    constructor(queue: MessageQueue, workflowCallback?: ((workflowId: string, inputs: Record<string, unknown>) => Promise<any>) | undefined);
+    enqueueWorkflow(workflowId: string, inputs?: Record<string, unknown>, priority?: MessagePriority, metadata?: Record<string, unknown>): Promise<string>;
+    startWorker(numWorkers?: number): Promise<void>;
+    stopWorker(): Promise<void>;
+}
+//# sourceMappingURL=queue.d.ts.map

package/dist/queue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue.d.ts","sourceRoot":"","sources":["../src/queue.ts"],"names":[],"mappings":"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"}