@exaudeus/workrail 0.0.2-beta.0

package/dist/types/mcp-types.js

@@ -0,0 +1,27 @@
+"use strict";
+// MCP Protocol Type Definitions
+// Model Context Protocol (MCP) specification types
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MCPErrorCodes = void 0;
+// =============================================================================
+// MCP ERROR CODES
+// =============================================================================
+var MCPErrorCodes;
+(function (MCPErrorCodes) {
+    // Standard JSON-RPC 2.0 error codes
+    MCPErrorCodes[MCPErrorCodes["PARSE_ERROR"] = -32700] = "PARSE_ERROR";
+    MCPErrorCodes[MCPErrorCodes["INVALID_REQUEST"] = -32600] = "INVALID_REQUEST";
+    MCPErrorCodes[MCPErrorCodes["METHOD_NOT_FOUND"] = -32601] = "METHOD_NOT_FOUND";
+    MCPErrorCodes[MCPErrorCodes["INVALID_PARAMS"] = -32602] = "INVALID_PARAMS";
+    MCPErrorCodes[MCPErrorCodes["INTERNAL_ERROR"] = -32603] = "INTERNAL_ERROR";
+    // MCP-specific error codes (-32000 to -32099)
+    MCPErrorCodes[MCPErrorCodes["SERVER_ERROR"] = -32000] = "SERVER_ERROR";
+    MCPErrorCodes[MCPErrorCodes["WORKFLOW_NOT_FOUND"] = -32001] = "WORKFLOW_NOT_FOUND";
+    MCPErrorCodes[MCPErrorCodes["INVALID_WORKFLOW"] = -32002] = "INVALID_WORKFLOW";
+    MCPErrorCodes[MCPErrorCodes["STEP_NOT_FOUND"] = -32003] = "STEP_NOT_FOUND";
+    MCPErrorCodes[MCPErrorCodes["VALIDATION_ERROR"] = -32004] = "VALIDATION_ERROR";
+    MCPErrorCodes[MCPErrorCodes["STATE_ERROR"] = -32005] = "STATE_ERROR";
+    MCPErrorCodes[MCPErrorCodes["STORAGE_ERROR"] = -32006] = "STORAGE_ERROR";
+    MCPErrorCodes[MCPErrorCodes["SECURITY_ERROR"] = -32007] = "SECURITY_ERROR";
+})(MCPErrorCodes || (exports.MCPErrorCodes = MCPErrorCodes = {}));
+//# sourceMappingURL=mcp-types.js.map

package/dist/types/mcp-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-types.js","sourceRoot":"","sources":["../../src/types/mcp-types.ts"],"names":[],"mappings":";AAAA,gCAAgC;AAChC,mDAAmD;;;AAyGnD,gFAAgF;AAChF,kBAAkB;AAClB,gFAAgF;AAEhF,IAAY,aAiBX;AAjBD,WAAY,aAAa;IACvB,oCAAoC;IACpC,oEAAoB,CAAA;IACpB,4EAAwB,CAAA;IACxB,8EAAyB,CAAA;IACzB,0EAAuB,CAAA;IACvB,0EAAuB,CAAA;IAEvB,8CAA8C;IAC9C,sEAAqB,CAAA;IACrB,kFAA2B,CAAA;IAC3B,8EAAyB,CAAA;IACzB,0EAAuB,CAAA;IACvB,8EAAyB,CAAA;IACzB,oEAAoB,CAAA;IACpB,wEAAsB,CAAA;IACtB,0EAAuB,CAAA;AACzB,CAAC,EAjBW,aAAa,6BAAb,aAAa,QAiBxB"}

package/dist/types/server.d.ts

@@ -0,0 +1,5 @@
+export interface WorkflowLookupServer {
+    start(): Promise<void>;
+    stop(): Promise<void>;
+}
+//# sourceMappingURL=server.d.ts.map

package/dist/types/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/types/server.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,oBAAoB;IACnC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACvB"}

package/dist/types/server.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=server.js.map

package/dist/types/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../../src/types/server.ts"],"names":[],"mappings":""}

package/dist/types/storage.d.ts

@@ -0,0 +1,27 @@
+import { Workflow, WorkflowSummary } from './mcp-types';
+/**
+ * Generic interface for any workflow storage backend.
+ * The default implementation uses the local filesystem, but additional
+ * backends (e.g., in-memory, database, remote) can implement this contract.
+ */
+export interface IWorkflowStorage {
+    /**
+     * Load and return all workflows available in this storage backend.
+     */
+    loadAllWorkflows(): Promise<Workflow[]>;
+    /**
+     * Retrieve a single workflow by its unique identifier.
+     * @param id The workflow `id` field.
+     */
+    getWorkflowById(id: string): Promise<Workflow | null>;
+    /**
+     * Return lightweight summaries for all workflows (used by `workflow_list`).
+     */
+    listWorkflowSummaries(): Promise<WorkflowSummary[]>;
+    /**
+     * (Optional) Persist or update a workflow definition.
+     * Not used by the current read-only MVP but included for future parity.
+     */
+    save?(workflow: Workflow): Promise<void>;
+}
+//# sourceMappingURL=storage.d.ts.map

package/dist/types/storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../src/types/storage.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAExD;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,gBAAgB,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;IAExC;;;OAGG;IACH,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAAC;IAEtD;;OAEG;IACH,qBAAqB,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC;IAEpD;;;OAGG;IACH,IAAI,CAAC,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1C"}

package/dist/types/storage.js

@@ -0,0 +1,6 @@
+"use strict";
+// =============================================================================
+// WORKFLOW STORAGE INTERFACES
+// =============================================================================
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=storage.js.map

package/dist/types/storage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.js","sourceRoot":"","sources":["../../src/types/storage.ts"],"names":[],"mappings":";AAAA,gFAAgF;AAChF,8BAA8B;AAC9B,gFAAgF"}

package/dist/types/workflow-types.d.ts

@@ -0,0 +1,251 @@
+export interface Workflow {
+    id: string;
+    name: string;
+    description: string;
+    version: string;
+    preconditions?: string[];
+    clarificationPrompts?: string[];
+    steps: WorkflowStep[];
+    metaGuidance?: string[];
+}
+export interface WorkflowStep {
+    id: string;
+    title: string;
+    prompt: string;
+    guidance?: string[];
+    askForFiles?: boolean;
+    requireConfirmation?: boolean;
+    runCondition?: object;
+}
+export interface WorkflowValidationResult {
+    valid: boolean;
+    errors: WorkflowValidationError[];
+    warnings?: WorkflowValidationWarning[];
+}
+export interface WorkflowValidationError {
+    path: string;
+    message: string;
+    code: string;
+    field?: string;
+}
+export interface WorkflowValidationWarning {
+    path: string;
+    message: string;
+    code: string;
+    field?: string;
+}
+export interface WorkflowValidationRule {
+    type: 'required' | 'pattern' | 'length' | 'custom' | 'schema';
+    field: string;
+    message: string;
+    validator?: (value: any, context?: any) => boolean;
+    schema?: Record<string, any>;
+}
+export interface WorkflowExecution {
+    id: string;
+    workflowId: string;
+    status: WorkflowExecutionStatus;
+    state: WorkflowExecutionState;
+    startedAt: Date;
+    updatedAt: Date;
+    completedAt?: Date;
+    error?: WorkflowExecutionError;
+}
+export type WorkflowExecutionStatus = 'initialized' | 'running' | 'paused' | 'completed' | 'failed' | 'cancelled';
+export interface WorkflowExecutionState {
+    currentStep?: string;
+    completedSteps: string[];
+    context: Record<string, any>;
+    stepResults: Record<string, WorkflowStepResult>;
+    metadata: WorkflowExecutionMetadata;
+}
+export interface WorkflowStepResult {
+    stepId: string;
+    status: 'pending' | 'running' | 'completed' | 'failed' | 'skipped';
+    startedAt?: Date;
+    completedAt?: Date;
+    output?: string;
+    error?: string;
+    validationResult?: WorkflowValidationResult;
+}
+export interface WorkflowExecutionMetadata {
+    totalSteps: number;
+    completedSteps: number;
+    progress: number;
+    estimatedTimeRemaining?: number;
+    lastActivity: Date;
+}
+export interface WorkflowExecutionError {
+    code: string;
+    message: string;
+    stepId?: string;
+    details?: Record<string, any>;
+}
+export interface WorkflowGuidance {
+    prompt: string;
+    modelHint?: string;
+    requiresConfirmation?: boolean;
+    validationCriteria?: string[];
+    context?: Record<string, any>;
+    suggestions?: string[];
+}
+export interface WorkflowStepGuidance {
+    step: WorkflowStep;
+    guidance: WorkflowGuidance;
+    isComplete: boolean;
+    nextStep?: string;
+    progress: number;
+}
+export interface WorkflowStorage {
+    type: 'file' | 'database' | 'memory';
+    path?: string;
+    connectionString?: string;
+}
+export interface WorkflowMetadata {
+    id: string;
+    name: string;
+    description: string;
+    category: string;
+    version: string;
+    author?: string;
+    tags?: string[];
+    createdAt: Date;
+    updatedAt: Date;
+    usageCount: number;
+    rating?: number;
+    complexity: 'simple' | 'medium' | 'complex';
+    estimatedDuration: number;
+}
+export interface WorkflowSearchCriteria {
+    category?: string;
+    tags?: string[];
+    complexity?: 'simple' | 'medium' | 'complex';
+    maxDuration?: number;
+    author?: string;
+    rating?: number;
+    searchTerm?: string;
+}
+export type WorkflowCategory = 'development' | 'review' | 'documentation' | 'testing' | 'deployment' | 'maintenance' | 'debugging' | 'optimization' | 'security' | 'migration' | 'custom';
+export interface WorkflowTag {
+    name: string;
+    description: string;
+    color?: string;
+}
+export interface WorkflowVersion {
+    version: string;
+    changelog: string;
+    breakingChanges: boolean;
+    deprecated: boolean;
+    minServerVersion?: string;
+    maxServerVersion?: string;
+}
+export interface WorkflowVersionInfo {
+    currentVersion: string;
+    availableVersions: WorkflowVersion[];
+    updateAvailable: boolean;
+    latestVersion?: string;
+}
+export interface WorkflowTemplate {
+    id: string;
+    name: string;
+    description: string;
+    category: WorkflowCategory;
+    template: Workflow;
+    variables: WorkflowTemplateVariable[];
+    examples: WorkflowTemplateExample[];
+}
+export interface WorkflowTemplateVariable {
+    name: string;
+    description: string;
+    type: 'string' | 'number' | 'boolean' | 'array' | 'object';
+    required: boolean;
+    defaultValue?: any;
+    validation?: Record<string, any>;
+}
+export interface WorkflowTemplateExample {
+    name: string;
+    description: string;
+    variables: Record<string, any>;
+    result: Workflow;
+}
+export interface WorkflowAnalytics {
+    workflowId: string;
+    totalExecutions: number;
+    successfulExecutions: number;
+    failedExecutions: number;
+    averageExecutionTime: number;
+    averageStepsCompleted: number;
+    popularSteps: string[];
+    commonErrors: string[];
+    userSatisfaction: number;
+    lastExecuted: Date;
+}
+export interface WorkflowExecutionAnalytics {
+    executionId: string;
+    workflowId: string;
+    duration: number;
+    stepsCompleted: number;
+    totalSteps: number;
+    success: boolean;
+    error?: string;
+    userFeedback?: number;
+    performanceMetrics: WorkflowPerformanceMetrics;
+}
+export interface WorkflowPerformanceMetrics {
+    stepExecutionTimes: Record<string, number>;
+    memoryUsage: number;
+    cpuUsage: number;
+    networkRequests: number;
+    cacheHits: number;
+    cacheMisses: number;
+}
+export interface WorkflowPlugin {
+    id: string;
+    name: string;
+    version: string;
+    description: string;
+    author: string;
+    hooks: WorkflowPluginHook[];
+    commands: WorkflowPluginCommand[];
+    dependencies?: string[];
+}
+export interface WorkflowPluginHook {
+    name: string;
+    event: 'beforeStep' | 'afterStep' | 'beforeWorkflow' | 'afterWorkflow' | 'onError';
+    handler: (context: WorkflowPluginContext) => Promise<void>;
+}
+export interface WorkflowPluginCommand {
+    name: string;
+    description: string;
+    parameters: Record<string, any>;
+    handler: (params: Record<string, any>) => Promise<any>;
+}
+export interface WorkflowPluginContext {
+    workflowId: string;
+    executionId: string;
+    stepId?: string;
+    data: Record<string, any>;
+    state: WorkflowExecutionState;
+}
+export type WorkflowStepStatus = 'pending' | 'running' | 'completed' | 'failed' | 'skipped' | 'cancelled';
+export type WorkflowComplexity = 'simple' | 'medium' | 'complex';
+export interface WorkflowSummary {
+    id: string;
+    name: string;
+    description: string;
+    category: WorkflowCategory;
+    version: string;
+    complexity: WorkflowComplexity;
+    estimatedDuration: number;
+    tags: string[];
+    rating?: number;
+    usageCount: number;
+}
+export interface WorkflowSearchResult {
+    workflows: WorkflowSummary[];
+    total: number;
+    page: number;
+    pageSize: number;
+    filters: WorkflowSearchCriteria;
+}
+//# sourceMappingURL=workflow-types.d.ts.map

package/dist/types/workflow-types.d.ts.map

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

package/dist/types/workflow-types.js

@@ -0,0 +1,5 @@
+"use strict";
+// Workflow Schema Type Definitions
+// Based on JSON Schema Draft 7 specification
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=workflow-types.js.map

package/dist/types/workflow-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-types.js","sourceRoot":"","sources":["../../src/types/workflow-types.ts"],"names":[],"mappings":";AAAA,mCAAmC;AACnC,6CAA6C"}

package/dist/utils/condition-evaluator.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Safe condition evaluator for workflow step runCondition expressions.
+ * Supports a limited set of operators to prevent code injection.
+ */
+export interface ConditionContext {
+    [key: string]: any;
+}
+export interface Condition {
+    var?: string;
+    equals?: any;
+    not_equals?: any;
+    gt?: number;
+    gte?: number;
+    lt?: number;
+    lte?: number;
+    and?: Condition[];
+    or?: Condition[];
+    not?: Condition;
+}
+/**
+ * Evaluates a condition expression against a context.
+ * Returns true if the condition passes, false otherwise.
+ * If condition is null/undefined, returns true (step is eligible).
+ * If evaluation fails, returns false (step is skipped for safety).
+ */
+export declare function evaluateCondition(condition: Condition | null | undefined, context?: ConditionContext): boolean;
+/**
+ * Validates that a condition uses only supported operators.
+ * Throws an error if unsupported operators are found.
+ */
+export declare function validateCondition(condition: any): void;
+//# sourceMappingURL=condition-evaluator.d.ts.map

package/dist/utils/condition-evaluator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"condition-evaluator.d.ts","sourceRoot":"","sources":["../../src/utils/condition-evaluator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,gBAAgB;IAC/B,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED,MAAM,WAAW,SAAS;IACxB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,GAAG,CAAC;IACb,UAAU,CAAC,EAAE,GAAG,CAAC;IACjB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,SAAS,EAAE,CAAC;IAClB,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC;IACjB,GAAG,CAAC,EAAE,SAAS,CAAC;CACjB;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,SAAS,GAAG,IAAI,GAAG,SAAS,EACvC,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAkBT;AAsDD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,GAAG,GAAG,IAAI,CA0BtD"}

package/dist/utils/condition-evaluator.js

@@ -0,0 +1,105 @@
+"use strict";
+/**
+ * Safe condition evaluator for workflow step runCondition expressions.
+ * Supports a limited set of operators to prevent code injection.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.evaluateCondition = evaluateCondition;
+exports.validateCondition = validateCondition;
+/**
+ * Evaluates a condition expression against a context.
+ * Returns true if the condition passes, false otherwise.
+ * If condition is null/undefined, returns true (step is eligible).
+ * If evaluation fails, returns false (step is skipped for safety).
+ */
+function evaluateCondition(condition, context = {}) {
+    // No condition means step is always eligible
+    if (!condition || typeof condition !== 'object') {
+        return true;
+    }
+    // Empty object means no condition, so step is eligible
+    if (Object.keys(condition).length === 0) {
+        return true;
+    }
+    try {
+        return evaluateConditionUnsafe(condition, context);
+    }
+    catch (error) {
+        // Log error in production, but return false for safety
+        console.warn('Condition evaluation failed:', error);
+        return false;
+    }
+}
+function evaluateConditionUnsafe(condition, context) {
+    // Variable reference
+    if (condition.var !== undefined) {
+        const value = context[condition.var];
+        // Comparison operators
+        if (condition.equals !== undefined) {
+            return value === condition.equals;
+        }
+        if (condition.not_equals !== undefined) {
+            return value !== condition.not_equals;
+        }
+        if (condition.gt !== undefined) {
+            return typeof value === 'number' && value > condition.gt;
+        }
+        if (condition.gte !== undefined) {
+            return typeof value === 'number' && value >= condition.gte;
+        }
+        if (condition.lt !== undefined) {
+            return typeof value === 'number' && value < condition.lt;
+        }
+        if (condition.lte !== undefined) {
+            return typeof value === 'number' && value <= condition.lte;
+        }
+        // If only var is specified, check for truthiness
+        return !!value;
+    }
+    // Logical operators
+    if (condition.and !== undefined) {
+        if (!Array.isArray(condition.and)) {
+            throw new Error('and operator requires an array');
+        }
+        return condition.and.every(subCondition => evaluateConditionUnsafe(subCondition, context));
+    }
+    if (condition.or !== undefined) {
+        if (!Array.isArray(condition.or)) {
+            throw new Error('or operator requires an array');
+        }
+        return condition.or.some(subCondition => evaluateConditionUnsafe(subCondition, context));
+    }
+    if (condition.not !== undefined) {
+        return !evaluateConditionUnsafe(condition.not, context);
+    }
+    // Unknown condition format
+    throw new Error('Invalid condition format');
+}
+/**
+ * Validates that a condition uses only supported operators.
+ * Throws an error if unsupported operators are found.
+ */
+function validateCondition(condition) {
+    if (!condition || typeof condition !== 'object') {
+        return;
+    }
+    const supportedKeys = [
+        'var', 'equals', 'not_equals', 'gt', 'gte', 'lt', 'lte', 'and', 'or', 'not'
+    ];
+    const conditionKeys = Object.keys(condition);
+    const unsupportedKeys = conditionKeys.filter(key => !supportedKeys.includes(key));
+    if (unsupportedKeys.length > 0) {
+        throw new Error(`Unsupported condition operators: ${unsupportedKeys.join(', ')}`);
+    }
+    // Recursively validate nested conditions
+    if (condition.and && Array.isArray(condition.and)) {
+        condition.and.forEach(validateCondition);
+    }
+    if (condition.or && Array.isArray(condition.or)) {
+        condition.or.forEach(validateCondition);
+    }
+    if (condition.not) {
+        validateCondition(condition.not);
+    }
+}
+//# sourceMappingURL=condition-evaluator.js.map

package/dist/utils/condition-evaluator.js.map

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