@exaudeus/workrail 0.0.2-beta.0

package/dist/validation/response-validator.js

@@ -0,0 +1,83 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.responseValidator = exports.ResponseValidator = exports.methodResultSchemas = void 0;
+const zod_1 = require("zod");
+const error_handler_1 = require("../core/error-handler");
+const idRegex = /^[A-Za-z0-9_-]+$/;
+// ---------------------------------------------------------------------------
+// Reusable fragments
+// ---------------------------------------------------------------------------
+const workflowSummarySchema = zod_1.z.object({
+    id: zod_1.z.string().regex(idRegex),
+    name: zod_1.z.string(),
+    description: zod_1.z.string(),
+    category: zod_1.z.string(),
+    version: zod_1.z.string()
+});
+const workflowStepSchema = zod_1.z.object({
+    id: zod_1.z.string().regex(idRegex),
+    title: zod_1.z.string(),
+    prompt: zod_1.z.string(),
+    askForFiles: zod_1.z.boolean().optional(),
+    requireConfirmation: zod_1.z.boolean().optional(),
+    runCondition: zod_1.z.object({}).optional()
+});
+const workflowSchema = zod_1.z.object({
+    id: zod_1.z.string().regex(idRegex),
+    name: zod_1.z.string(),
+    description: zod_1.z.string(),
+    version: zod_1.z.string(),
+    preconditions: zod_1.z.array(zod_1.z.string()).optional(),
+    clarificationPrompts: zod_1.z.array(zod_1.z.string()).optional(),
+    steps: zod_1.z.array(workflowStepSchema),
+    metaGuidance: zod_1.z.array(zod_1.z.string()).optional()
+});
+// ---------------------------------------------------------------------------
+// Method result schemas
+// ---------------------------------------------------------------------------
+exports.methodResultSchemas = {
+    // workflow_list → { workflows: WorkflowSummary[] }
+    workflow_list: zod_1.z.object({
+        workflows: zod_1.z.array(workflowSummarySchema)
+    }),
+    // workflow_get → Workflow object
+    workflow_get: workflowSchema,
+    // workflow_next → { step, guidance, isComplete }
+    workflow_next: zod_1.z.object({
+        step: workflowStepSchema.nullable(),
+        guidance: zod_1.z.object({
+            prompt: zod_1.z.string(),
+            modelHint: zod_1.z.string().optional(),
+            requiresConfirmation: zod_1.z.boolean().optional(),
+            validationCriteria: zod_1.z.array(zod_1.z.string()).optional()
+        }),
+        isComplete: zod_1.z.boolean()
+    }),
+    // workflow_validate → { valid, issues?, suggestions? }
+    workflow_validate: zod_1.z.object({
+        valid: zod_1.z.boolean(),
+        issues: zod_1.z.array(zod_1.z.string()).optional(),
+        suggestions: zod_1.z.array(zod_1.z.string()).optional()
+    })
+};
+// ---------------------------------------------------------------------------
+// Validator class
+// ---------------------------------------------------------------------------
+class ResponseValidator {
+    compiled;
+    constructor(schemas) {
+        this.compiled = schemas;
+    }
+    validate(method, result) {
+        const schema = this.compiled[method];
+        if (!schema)
+            return; // no schema means unchecked output
+        const parsed = schema.safeParse(result);
+        if (!parsed.success) {
+            throw new error_handler_1.ValidationError('Invalid response', undefined, parsed.error.format());
+        }
+    }
+}
+exports.ResponseValidator = ResponseValidator;
+exports.responseValidator = new ResponseValidator(exports.methodResultSchemas);
+//# sourceMappingURL=response-validator.js.map

package/dist/validation/response-validator.js.map

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

package/dist/validation/schemas.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Collection of per-method parameter schemas used for request validation.
+ * Using raw schema objects to keep typings simple.
+ */
+export declare const methodParamSchemas: Record<string, any>;
+//# sourceMappingURL=schemas.d.ts.map

package/dist/validation/schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../src/validation/schemas.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CA2ClD,CAAC"}

package/dist/validation/schemas.js

@@ -0,0 +1,52 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.methodParamSchemas = void 0;
+/**
+ * Collection of per-method parameter schemas used for request validation.
+ * Using raw schema objects to keep typings simple.
+ */
+exports.methodParamSchemas = {
+    workflow_list: {
+        type: 'object',
+        properties: {},
+        additionalProperties: false
+    },
+    workflow_get: {
+        type: 'object',
+        properties: {
+            id: { type: 'string', pattern: '^[A-Za-z0-9_-]+$' }
+        },
+        required: ['id'],
+        additionalProperties: false
+    },
+    workflow_next: {
+        type: 'object',
+        properties: {
+            workflowId: { type: 'string', pattern: '^[A-Za-z0-9_-]+$' },
+            completedSteps: {
+                type: 'array',
+                items: { type: 'string', pattern: '^[A-Za-z0-9_-]+$' },
+                nullable: true,
+                default: []
+            },
+            context: {
+                type: 'object',
+                description: 'Optional execution context for evaluating step conditions',
+                additionalProperties: true
+            }
+        },
+        required: ['workflowId'],
+        additionalProperties: false
+    },
+    workflow_validate: {
+        type: 'object',
+        properties: {
+            workflowId: { type: 'string', pattern: '^[A-Za-z0-9_-]+$' },
+            stepId: { type: 'string', pattern: '^[A-Za-z0-9_-]+$' },
+            output: { type: 'string', maxLength: 10000 }
+        },
+        required: ['workflowId', 'stepId', 'output'],
+        additionalProperties: false
+    }
+};
+//# sourceMappingURL=schemas.js.map

package/dist/validation/schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../../src/validation/schemas.ts"],"names":[],"mappings":";;;AAAA;;;GAGG;AACU,QAAA,kBAAkB,GAAwB;IACrD,aAAa,EAAE;QACb,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE,EAAE;QACd,oBAAoB,EAAE,KAAK;KAC5B;IACD,YAAY,EAAE;QACZ,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,kBAAkB,EAAE;SACpD;QACD,QAAQ,EAAE,CAAC,IAAI,CAAC;QAChB,oBAAoB,EAAE,KAAK;KAC5B;IACD,aAAa,EAAE;QACb,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,kBAAkB,EAAE;YAC3D,cAAc,EAAE;gBACd,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,kBAAkB,EAAE;gBACtD,QAAQ,EAAE,IAAI;gBACd,OAAO,EAAE,EAAE;aACZ;YACD,OAAO,EAAE;gBACP,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,2DAA2D;gBACxE,oBAAoB,EAAE,IAAI;aAC3B;SACF;QACD,QAAQ,EAAE,CAAC,YAAY,CAAC;QACxB,oBAAoB,EAAE,KAAK;KAC5B;IACD,iBAAiB,EAAE;QACjB,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,kBAAkB,EAAE;YAC3D,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,kBAAkB,EAAE;YACvD,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAE;SAC7C;QACD,QAAQ,EAAE,CAAC,YAAY,EAAE,QAAQ,EAAE,QAAQ,CAAC;QAC5C,oBAAoB,EAAE,KAAK;KAC5B;CACF,CAAC"}

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@exaudeus/workrail",
+  "version": "0.0.2-beta.0",
+  "description": "MCP server for structured workflow orchestration and step-by-step task guidance",
+  "license": "MIT",
+  "bin": {
+    "mcp-server-workflow-orchestration": "dist/mcp-server.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc && shx chmod +x dist/*.js",
+    "dev": "npm run build && node dist/mcp-server.js",
+    "test": "jest",
+    "test:performance": "jest --config jest.performance.config.cjs",
+    "prepare": "npm run build",
+    "watch": "tsc --watch"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^0.5.0",
+    "ajv": "^8.17.1",
+    "chalk": "^5.3.0",
+    "commander": "^14.0.0",
+    "dotenv": "^17.2.0",
+    "json-rpc-2.0": "^1.7.1",
+    "tsconfig-paths": "^4.2.0",
+    "tslib": "^2.8.1",
+    "zod": "^3.22.4"
+  },
+  "devDependencies": {
+    "@types/jest": "^29.5.5",
+    "@types/node": "^20.6.3",
+    "jest": "^29.7.0",
+    "shx": "^0.3.4",
+    "ts-jest": "^29.1.1",
+    "ts-node": "^10.9.1",
+    "typescript": "^5.2.2"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "workflow",
+    "orchestration",
+    "ai-assistant",
+    "task-management"
+  ]
+}