@exaudeus/workrail 0.0.2-beta.0

package/dist/domain/index.d.ts

@@ -0,0 +1,3 @@
+export * from '../types/mcp-types';
+export * from '../types/storage';
+//# sourceMappingURL=index.d.ts.map

package/dist/domain/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/domain/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC"}

package/dist/domain/index.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("../types/mcp-types"), exports);
+tslib_1.__exportStar(require("../types/storage"), exports);
+//# sourceMappingURL=index.js.map

package/dist/domain/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/domain/index.ts"],"names":[],"mappings":";;;AAAA,6DAAmC;AACnC,2DAAiC"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export { createWorkflowLookupServer } from './infrastructure/rpc/server';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AA4BA,OAAO,EAAE,0BAA0B,EAAE,MAAM,6BAA6B,CAAC"}

package/dist/index.js

@@ -0,0 +1,30 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createWorkflowLookupServer = void 0;
+const container_1 = require("./container");
+async function main() {
+    try {
+        const { server } = (0, container_1.createAppContainer)();
+        await server.start();
+        console.log('Workflow Lookup MCP Server started successfully');
+        // Graceful shutdown on SIGINT/SIGTERM
+        const shutdown = async (signal) => {
+            console.log(`Received ${signal}, shutting down...`);
+            await server.stop();
+            process.exit(0);
+        };
+        process.on('SIGINT', () => shutdown('SIGINT'));
+        process.on('SIGTERM', () => shutdown('SIGTERM'));
+    }
+    catch (error) {
+        console.error('Failed to start server:', error);
+        process.exit(1);
+    }
+}
+if (require.main === module) {
+    main();
+}
+var server_1 = require("./infrastructure/rpc/server");
+Object.defineProperty(exports, "createWorkflowLookupServer", { enumerable: true, get: function () { return server_1.createWorkflowLookupServer; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;AAEA,2CAAiD;AAEjD,KAAK,UAAU,IAAI;IACjB,IAAI,CAAC;QACH,MAAM,EAAE,MAAM,EAAE,GAAG,IAAA,8BAAkB,GAAE,CAAC;QACxC,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;QACrB,OAAO,CAAC,GAAG,CAAC,iDAAiD,CAAC,CAAC;QAE/D,sCAAsC;QACtC,MAAM,QAAQ,GAAG,KAAK,EAAE,MAAc,EAAE,EAAE;YACxC,OAAO,CAAC,GAAG,CAAC,YAAY,MAAM,oBAAoB,CAAC,CAAC;YACpD,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;YACpB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC,CAAC;QACF,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC;QAC/C,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC;IACnD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,yBAAyB,EAAE,KAAK,CAAC,CAAC;QAChD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;IAC5B,IAAI,EAAE,CAAC;AACT,CAAC;AAED,sDAAyE;AAAhE,oHAAA,0BAA0B,OAAA"}

package/dist/infrastructure/index.d.ts

@@ -0,0 +1,3 @@
+export * from './storage';
+export * from './rpc';
+//# sourceMappingURL=index.d.ts.map

package/dist/infrastructure/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/infrastructure/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,OAAO,CAAC"}

package/dist/infrastructure/index.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./storage"), exports);
+tslib_1.__exportStar(require("./rpc"), exports);
+//# sourceMappingURL=index.js.map

package/dist/infrastructure/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/infrastructure/index.ts"],"names":[],"mappings":";;;AAAA,oDAA0B;AAC1B,gDAAsB"}

package/dist/infrastructure/rpc/handler.d.ts

@@ -0,0 +1,26 @@
+import { Readable, Writable } from 'stream';
+/**
+ * RpcHandler encapsulates pure JSON-RPC 2.0 stdin/stdout (or arbitrary stream) handling.
+ * It is transport-only: it parses newline-delimited JSON-RPC messages, delegates
+ * execution to an injected dispatcher, and writes responses. It knows nothing
+ * about domain logic.
+ */
+export declare class RpcHandler {
+    private readonly input;
+    private readonly output;
+    private readonly dispatch;
+    private running;
+    private buffer;
+    private listener;
+    constructor(dispatch: (method: string, params: any, id: string | number | null) => Promise<any>, options?: {
+        input?: Readable;
+        output?: Writable;
+    });
+    /** Attach listeners and begin processing */
+    start(): void;
+    /** Detach listeners to stop processing */
+    stop(): void;
+    private processLine;
+    private writeResponse;
+}
+//# sourceMappingURL=handler.d.ts.map

package/dist/infrastructure/rpc/handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/rpc/handler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AAI5C;;;;;GAKG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAW;IACjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAW;IAClC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAIP;IAElB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,MAAM,CAAM;IACpB,OAAO,CAAC,QAAQ,CAA0C;gBAGxD,QAAQ,EAAE,CACR,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,GAAG,EACX,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,KACvB,OAAO,CAAC,GAAG,CAAC,EACjB,OAAO,CAAC,EAAE;QACR,KAAK,CAAC,EAAE,QAAQ,CAAC;QACjB,MAAM,CAAC,EAAE,QAAQ,CAAC;KACnB;IAOH,4CAA4C;IAC5C,KAAK,IAAI,IAAI;IAmBb,0CAA0C;IAC1C,IAAI,IAAI,IAAI;YASE,WAAW;IAuCzB,OAAO,CAAC,aAAa;CAGtB"}

package/dist/infrastructure/rpc/handler.js

@@ -0,0 +1,91 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RpcHandler = void 0;
+const error_handler_1 = require("../../core/error-handler");
+/**
+ * RpcHandler encapsulates pure JSON-RPC 2.0 stdin/stdout (or arbitrary stream) handling.
+ * It is transport-only: it parses newline-delimited JSON-RPC messages, delegates
+ * execution to an injected dispatcher, and writes responses. It knows nothing
+ * about domain logic.
+ */
+class RpcHandler {
+    input;
+    output;
+    dispatch;
+    running = false;
+    buffer = '';
+    listener = null;
+    constructor(dispatch, options) {
+        this.dispatch = dispatch;
+        this.input = options?.input ?? process.stdin;
+        this.output = options?.output ?? process.stdout;
+    }
+    /** Attach listeners and begin processing */
+    start() {
+        if (this.running)
+            return;
+        this.listener = (chunk) => {
+            this.buffer += chunk.toString();
+            let newlineIndex;
+            while ((newlineIndex = this.buffer.indexOf('\n')) !== -1) {
+                const raw = this.buffer.slice(0, newlineIndex).trim();
+                this.buffer = this.buffer.slice(newlineIndex + 1);
+                if (!raw)
+                    continue;
+                this.processLine(raw);
+            }
+        };
+        this.input.on('data', this.listener);
+        this.running = true;
+    }
+    /** Detach listeners to stop processing */
+    stop() {
+        if (!this.running)
+            return;
+        if (this.listener) {
+            this.input.off('data', this.listener);
+            this.listener = null;
+        }
+        this.running = false;
+    }
+    async processLine(raw) {
+        const errorHandler = error_handler_1.ErrorHandler.getInstance();
+        let request;
+        try {
+            request = JSON.parse(raw);
+        }
+        catch {
+            const errorResponse = errorHandler.createParseError();
+            this.writeResponse(errorResponse);
+            return;
+        }
+        // Basic JSON-RPC 2.0 request validation
+        const validStructure = request &&
+            request.jsonrpc === '2.0' &&
+            typeof request.method === 'string' &&
+            (typeof request.id === 'string' || typeof request.id === 'number' || request.id === null);
+        if (!validStructure) {
+            const invalid = errorHandler.createInvalidRequestError(request?.id ?? null);
+            this.writeResponse(invalid);
+            return;
+        }
+        try {
+            const result = await this.dispatch(request.method, request.params, request.id);
+            const response = {
+                jsonrpc: '2.0',
+                id: request.id,
+                result,
+            };
+            this.writeResponse(response);
+        }
+        catch (err) {
+            const errorResponse = errorHandler.handleError(err, request.id);
+            this.writeResponse(errorResponse);
+        }
+    }
+    writeResponse(response) {
+        this.output.write(JSON.stringify(response) + '\n');
+    }
+}
+exports.RpcHandler = RpcHandler;
+//# sourceMappingURL=handler.js.map

package/dist/infrastructure/rpc/handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler.js","sourceRoot":"","sources":["../../../src/infrastructure/rpc/handler.ts"],"names":[],"mappings":";;;AACA,4DAAwD;AAGxD;;;;;GAKG;AACH,MAAa,UAAU;IACJ,KAAK,CAAW;IAChB,MAAM,CAAW;IACjB,QAAQ,CAIP;IAEV,OAAO,GAAG,KAAK,CAAC;IAChB,MAAM,GAAG,EAAE,CAAC;IACZ,QAAQ,GAAqC,IAAI,CAAC;IAE1D,YACE,QAIiB,EACjB,OAGC;QAED,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,KAAK,GAAG,OAAO,EAAE,KAAK,IAAI,OAAO,CAAC,KAAK,CAAC;QAC7C,IAAI,CAAC,MAAM,GAAG,OAAO,EAAE,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC;IAClD,CAAC;IAED,4CAA4C;IAC5C,KAAK;QACH,IAAI,IAAI,CAAC,OAAO;YAAE,OAAO;QAEzB,IAAI,CAAC,QAAQ,GAAG,CAAC,KAAa,EAAE,EAAE;YAChC,IAAI,CAAC,MAAM,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;YAEhC,IAAI,YAAoB,CAAC;YACzB,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;gBACzD,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC,IAAI,EAAE,CAAC;gBACtD,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,YAAY,GAAG,CAAC,CAAC,CAAC;gBAClD,IAAI,CAAC,GAAG;oBAAE,SAAS;gBACnB,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;YACxB,CAAC;QACH,CAAC,CAAC;QAEF,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;QACrC,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;IACtB,CAAC;IAED,0CAA0C;IAC1C,IAAI;QACF,IAAI,CAAC,IAAI,CAAC,OAAO;YAAE,OAAO;QAC1B,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClB,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;YACtC,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;QACvB,CAAC;QACD,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC;IACvB,CAAC;IAEO,KAAK,CAAC,WAAW,CAAC,GAAW;QACnC,MAAM,YAAY,GAAG,4BAAY,CAAC,WAAW,EAAE,CAAC;QAEhD,IAAI,OAAuB,CAAC;QAC5B,IAAI,CAAC;YACH,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC5B,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,aAAa,GAAG,YAAY,CAAC,gBAAgB,EAAE,CAAC;YACtD,IAAI,CAAC,aAAa,CAAC,aAAa,CAAC,CAAC;YAClC,OAAO;QACT,CAAC;QAED,wCAAwC;QACxC,MAAM,cAAc,GAClB,OAAO;YACP,OAAO,CAAC,OAAO,KAAK,KAAK;YACzB,OAAO,OAAO,CAAC,MAAM,KAAK,QAAQ;YAClC,CAAC,OAAO,OAAO,CAAC,EAAE,KAAK,QAAQ,IAAI,OAAO,OAAO,CAAC,EAAE,KAAK,QAAQ,IAAI,OAAO,CAAC,EAAE,KAAK,IAAI,CAAC,CAAC;QAE5F,IAAI,CAAC,cAAc,EAAE,CAAC;YACpB,MAAM,OAAO,GAAG,YAAY,CAAC,yBAAyB,CAAE,OAAe,EAAE,EAAE,IAAI,IAAI,CAAC,CAAC;YACrF,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;YAC5B,OAAO;QACT,CAAC;QAED,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC;YAC/E,MAAM,QAAQ,GAAoB;gBAChC,OAAO,EAAE,KAAK;gBACd,EAAE,EAAE,OAAO,CAAC,EAAE;gBACd,MAAM;aACP,CAAC;YACF,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;QAC/B,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,aAAa,GAAG,YAAY,CAAC,WAAW,CAAC,GAAY,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC;YACzE,IAAI,CAAC,aAAa,CAAC,aAAa,CAAC,CAAC;QACpC,CAAC;IACH,CAAC;IAEO,aAAa,CAAC,QAAyB;QAC7C,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC,CAAC;IACrD,CAAC;CACF;AArGD,gCAqGC"}

package/dist/infrastructure/rpc/index.d.ts

@@ -0,0 +1,2 @@
+export * from './server';
+//# sourceMappingURL=index.d.ts.map

package/dist/infrastructure/rpc/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/rpc/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC"}

package/dist/infrastructure/rpc/index.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./server"), exports);
+//# sourceMappingURL=index.js.map

package/dist/infrastructure/rpc/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/infrastructure/rpc/index.ts"],"names":[],"mappings":";;;AAAA,mDAAyB"}

package/dist/infrastructure/rpc/server.d.ts

@@ -0,0 +1,4 @@
+import { WorkflowLookupServer } from '../../types/server';
+import { WorkflowService } from '../../application/services/workflow-service';
+export declare function createWorkflowLookupServer(workflowService: WorkflowService): WorkflowLookupServer;
+//# sourceMappingURL=server.d.ts.map

package/dist/infrastructure/rpc/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/rpc/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,MAAM,6CAA6C,CAAC;AAK9E,wBAAgB,0BAA0B,CACxC,eAAe,EAAE,eAAe,GAC/B,oBAAoB,CAoCtB"}

package/dist/infrastructure/rpc/server.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createWorkflowLookupServer = createWorkflowLookupServer;
+const app_1 = require("../../application/app");
+const request_validator_1 = require("../../validation/request-validator");
+const handler_1 = require("./handler");
+function createWorkflowLookupServer(workflowService) {
+    let rpcHandler = null;
+    let running = false;
+    return {
+        start: async () => {
+            if (running)
+                return;
+            console.log('Initializing Workflow Lookup MCP Server...');
+            // Build mediator with current validator and services
+            const mediator = (0, app_1.buildWorkflowApplication)(workflowService, request_validator_1.requestValidator);
+            // Create RPC handler bound to mediator.execute
+            rpcHandler = new handler_1.RpcHandler((method, params, _id) => mediator.execute(method, params));
+            if (process.env['NODE_ENV'] !== 'test') {
+                rpcHandler.start();
+            }
+            running = true;
+            console.log('Server ready to accept JSON-RPC requests');
+        },
+        stop: async () => {
+            if (!running) {
+                console.log('Shutdown requested, but server is not running.');
+                return;
+            }
+            console.log('Shutting down Workflow Lookup MCP Server...');
+            if (rpcHandler) {
+                rpcHandler.stop();
+                rpcHandler = null;
+            }
+            running = false;
+            console.log('Server stopped');
+        }
+    };
+}
+//# sourceMappingURL=server.js.map

package/dist/infrastructure/rpc/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../../../src/infrastructure/rpc/server.ts"],"names":[],"mappings":";;AAMA,gEAsCC;AA1CD,+CAAiE;AACjE,0EAAsE;AACtE,uCAAuC;AAEvC,SAAgB,0BAA0B,CACxC,eAAgC;IAEhC,IAAI,UAAU,GAAsB,IAAI,CAAC;IACzC,IAAI,OAAO,GAAG,KAAK,CAAC;IAEpB,OAAO;QACL,KAAK,EAAE,KAAK,IAAI,EAAE;YAChB,IAAI,OAAO;gBAAE,OAAO;YACpB,OAAO,CAAC,GAAG,CAAC,4CAA4C,CAAC,CAAC;YAE1D,qDAAqD;YACrD,MAAM,QAAQ,GAAG,IAAA,8BAAwB,EAAC,eAAe,EAAE,oCAAgB,CAAC,CAAC;YAE7E,+CAA+C;YAC/C,UAAU,GAAG,IAAI,oBAAU,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;YAEvF,IAAI,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,KAAK,MAAM,EAAE,CAAC;gBACvC,UAAU,CAAC,KAAK,EAAE,CAAC;YACrB,CAAC;YAED,OAAO,GAAG,IAAI,CAAC;YACf,OAAO,CAAC,GAAG,CAAC,0CAA0C,CAAC,CAAC;QAC1D,CAAC;QACD,IAAI,EAAE,KAAK,IAAI,EAAE;YACf,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,OAAO,CAAC,GAAG,CAAC,gDAAgD,CAAC,CAAC;gBAC9D,OAAO;YACT,CAAC;YACD,OAAO,CAAC,GAAG,CAAC,6CAA6C,CAAC,CAAC;YAC3D,IAAI,UAAU,EAAE,CAAC;gBACf,UAAU,CAAC,IAAI,EAAE,CAAC;gBAClB,UAAU,GAAG,IAAI,CAAC;YACpB,CAAC;YACD,OAAO,GAAG,KAAK,CAAC;YAChB,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;QAChC,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/infrastructure/storage/caching-workflow-storage.d.ts

@@ -0,0 +1,22 @@
+import { IWorkflowStorage } from '../../types/storage';
+import { Workflow, WorkflowSummary } from '../../types/mcp-types';
+/**
+ * Decorator that adds simple in-memory TTL caching to any IWorkflowStorage.
+ */
+export declare class CachingWorkflowStorage implements IWorkflowStorage {
+    private readonly inner;
+    private readonly ttlMs;
+    private cache;
+    private stats;
+    constructor(inner: IWorkflowStorage, ttlMs: number);
+    getCacheStats(): {
+        hits: number;
+        misses: number;
+    };
+    private isFresh;
+    loadAllWorkflows(): Promise<Workflow[]>;
+    getWorkflowById(id: string): Promise<Workflow | null>;
+    listWorkflowSummaries(): Promise<WorkflowSummary[]>;
+    save?(workflow: Workflow): Promise<void>;
+}
+//# sourceMappingURL=caching-workflow-storage.d.ts.map

package/dist/infrastructure/storage/caching-workflow-storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"caching-workflow-storage.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/storage/caching-workflow-storage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAelE;;GAEG;AACH,qBAAa,sBAAuB,YAAW,gBAAgB;IAIjD,OAAO,CAAC,QAAQ,CAAC,KAAK;IAAoB,OAAO,CAAC,QAAQ,CAAC,KAAK;IAH5E,OAAO,CAAC,KAAK,CAAmC;IAChD,OAAO,CAAC,KAAK,CAA0B;gBAEV,KAAK,EAAE,gBAAgB,EAAmB,KAAK,EAAE,MAAM;IAE7E,aAAa;;;;IAIpB,OAAO,CAAC,OAAO;IAIT,gBAAgB,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;IAWvC,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC;IAMrD,qBAAqB,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC;IAWnD,IAAI,CAAC,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;CAK/C"}

package/dist/infrastructure/storage/caching-workflow-storage.js

@@ -0,0 +1,61 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CachingWorkflowStorage = void 0;
+const deepClone = (obj) => {
+    // Use structuredClone if available (Node 17+), otherwise fallback to JSON
+    if (typeof global.structuredClone === 'function') {
+        return global.structuredClone(obj);
+    }
+    return JSON.parse(JSON.stringify(obj));
+};
+/**
+ * Decorator that adds simple in-memory TTL caching to any IWorkflowStorage.
+ */
+class CachingWorkflowStorage {
+    inner;
+    ttlMs;
+    cache = null;
+    stats = { hits: 0, misses: 0 };
+    constructor(inner, ttlMs) {
+        this.inner = inner;
+        this.ttlMs = ttlMs;
+    }
+    getCacheStats() {
+        return { ...this.stats };
+    }
+    isFresh() {
+        return this.cache !== null && Date.now() - this.cache.timestamp < this.ttlMs;
+    }
+    async loadAllWorkflows() {
+        if (this.isFresh()) {
+            this.stats.hits += 1;
+            return deepClone(this.cache.value);
+        }
+        this.stats.misses += 1;
+        const workflows = await this.inner.loadAllWorkflows();
+        this.cache = { value: workflows, timestamp: Date.now() };
+        return deepClone(workflows);
+    }
+    async getWorkflowById(id) {
+        const workflows = await this.loadAllWorkflows();
+        const wf = workflows.find((wf) => wf.id === id);
+        return wf ? deepClone(wf) : null;
+    }
+    async listWorkflowSummaries() {
+        const workflows = await this.loadAllWorkflows();
+        return workflows.map((wf) => ({
+            id: wf.id,
+            name: wf.name,
+            description: wf.description,
+            category: 'default',
+            version: wf.version
+        }));
+    }
+    async save(workflow) {
+        if (typeof this.inner.save === 'function') {
+            return this.inner.save(workflow);
+        }
+    }
+}
+exports.CachingWorkflowStorage = CachingWorkflowStorage;
+//# sourceMappingURL=caching-workflow-storage.js.map

package/dist/infrastructure/storage/caching-workflow-storage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"caching-workflow-storage.js","sourceRoot":"","sources":["../../../src/infrastructure/storage/caching-workflow-storage.ts"],"names":[],"mappings":";;;AAGA,MAAM,SAAS,GAAG,CAAI,GAAM,EAAK,EAAE;IACjC,0EAA0E;IAC1E,IAAI,OAAQ,MAAc,CAAC,eAAe,KAAK,UAAU,EAAE,CAAC;QAC1D,OAAQ,MAAc,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC;IAC9C,CAAC;IACD,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC;AACzC,CAAC,CAAC;AAOF;;GAEG;AACH,MAAa,sBAAsB;IAIJ;IAA0C;IAH/D,KAAK,GAA8B,IAAI,CAAC;IACxC,KAAK,GAAG,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;IAEvC,YAA6B,KAAuB,EAAmB,KAAa;QAAvD,UAAK,GAAL,KAAK,CAAkB;QAAmB,UAAK,GAAL,KAAK,CAAQ;IAAG,CAAC;IAEjF,aAAa;QAClB,OAAO,EAAE,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC;IAC3B,CAAC;IAEO,OAAO;QACb,OAAO,IAAI,CAAC,KAAK,KAAK,IAAI,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC;IAC/E,CAAC;IAED,KAAK,CAAC,gBAAgB;QACpB,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC;YACnB,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,CAAC;YACrB,OAAO,SAAS,CAAC,IAAI,CAAC,KAAM,CAAC,KAAK,CAAC,CAAC;QACtC,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,MAAM,IAAI,CAAC,CAAC;QACvB,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,gBAAgB,EAAE,CAAC;QACtD,IAAI,CAAC,KAAK,GAAG,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;QACzD,OAAO,SAAS,CAAC,SAAS,CAAC,CAAC;IAC9B,CAAC;IAED,KAAK,CAAC,eAAe,CAAC,EAAU;QAC9B,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,gBAAgB,EAAE,CAAC;QAChD,MAAM,EAAE,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;QAChD,OAAO,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACnC,CAAC;IAED,KAAK,CAAC,qBAAqB;QACzB,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,gBAAgB,EAAE,CAAC;QAChD,OAAO,SAAS,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;YAC5B,EAAE,EAAE,EAAE,CAAC,EAAE;YACT,IAAI,EAAE,EAAE,CAAC,IAAI;YACb,WAAW,EAAE,EAAE,CAAC,WAAW;YAC3B,QAAQ,EAAE,SAAS;YACnB,OAAO,EAAE,EAAE,CAAC,OAAO;SACpB,CAAC,CAAC,CAAC;IACN,CAAC;IAED,KAAK,CAAC,IAAI,CAAE,QAAkB;QAC5B,IAAI,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;YAC1C,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACnC,CAAC;IACH,CAAC;CACF;AA/CD,wDA+CC"}

package/dist/infrastructure/storage/file-workflow-storage.d.ts

@@ -0,0 +1,56 @@
+import { IWorkflowStorage } from '../../types/storage';
+import { Workflow, WorkflowSummary } from '../../types/mcp-types';
+interface FileWorkflowStorageOptions {
+    /** Reject files larger than this size (bytes). Default 1_000_000 */
+    maxFileSizeBytes?: number;
+    /** Cache entry TTL in milliseconds. 0 to disable. Default 5000 */
+    cacheTTLms?: number;
+    /** Maximum cached workflows before evicting LRU. Default 100 */
+    cacheSize?: number;
+    /** Index cache TTL in milliseconds. Default 30000 (30 seconds) */
+    indexCacheTTLms?: number;
+}
+/**
+ * Optimized file-system based workflow storage with intelligent caching.
+ * Uses an index cache to avoid repeatedly scanning directories and
+ * reading files unnecessarily.
+ */
+export declare class FileWorkflowStorage implements IWorkflowStorage {
+    private readonly baseDirReal;
+    private readonly maxFileSize;
+    private readonly cacheTTL;
+    private readonly cacheLimit;
+    private readonly indexCacheTTL;
+    private readonly cache;
+    private workflowIndex;
+    private indexExpires;
+    constructor(directory: string, options?: FileWorkflowStorageOptions);
+    /**
+     * Build or refresh the workflow index by scanning the directory once
+     */
+    private buildWorkflowIndex;
+    /**
+     * Get the workflow index, building it if necessary
+     */
+    private getWorkflowIndex;
+    /**
+     * Load a specific workflow from file
+     */
+    private loadWorkflowFromFile;
+    /**
+     * Load *all* JSON files from the configured directory.
+     * NOTE: This method is expensive and should be avoided when possible.
+     * Use getWorkflowIndex() + loadWorkflowFromFile() for better performance.
+     */
+    loadAllWorkflows(): Promise<Workflow[]>;
+    getWorkflowById(id: string): Promise<Workflow | null>;
+    listWorkflowSummaries(): Promise<WorkflowSummary[]>;
+    save(): Promise<void>;
+}
+/**
+ * Helper factory that resolves the workflow directory according to the
+ * previous behaviour (env override → bundled workflows).
+ */
+export declare function createDefaultFileWorkflowStorage(): FileWorkflowStorage;
+export {};
+//# sourceMappingURL=file-workflow-storage.d.ts.map

package/dist/infrastructure/storage/file-workflow-storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-workflow-storage.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/storage/file-workflow-storage.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAyClE,UAAU,0BAA0B;IAClC,oEAAoE;IACpE,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,kEAAkE;IAClE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gEAAgE;IAChE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kEAAkE;IAClE,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;;;GAIG;AACH,qBAAa,mBAAoB,YAAW,gBAAgB;IAC1D,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAiC;IAGvD,OAAO,CAAC,aAAa,CAAgD;IACrE,OAAO,CAAC,YAAY,CAAa;gBAErB,SAAS,EAAE,MAAM,EAAE,OAAO,GAAE,0BAA+B;IAQvE;;OAEG;YACW,kBAAkB;IAgDhC;;OAEG;YACW,gBAAgB;IAc9B;;OAEG;YACW,oBAAoB;IAmBlC;;;;OAIG;IACU,gBAAgB,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;IAgBvC,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC;IA0CrD,qBAAqB,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC;IAMnD,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAInC;AAED;;;GAGG;AACH,wBAAgB,gCAAgC,IAAI,mBAAmB,CAYtE"}

package/dist/infrastructure/storage/file-workflow-storage.js

@@ -0,0 +1,206 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FileWorkflowStorage = void 0;
+exports.createDefaultFileWorkflowStorage = createDefaultFileWorkflowStorage;
+const tslib_1 = require("tslib");
+const promises_1 = tslib_1.__importDefault(require("fs/promises"));
+const fs_1 = require("fs");
+const path_1 = tslib_1.__importDefault(require("path"));
+const error_handler_1 = require("../../core/error-handler");
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function sanitizeId(id) {
+    if (id.includes('\u0000')) {
+        throw new error_handler_1.SecurityError('Null byte detected in identifier', 'sanitizeId');
+    }
+    const normalised = id.normalize('NFC');
+    const valid = /^[a-zA-Z0-9_-]+$/.test(normalised);
+    if (!valid) {
+        throw new error_handler_1.InvalidWorkflowError(id, 'Invalid characters in workflow id');
+    }
+    return normalised;
+}
+function assertWithinBase(resolvedPath, baseDir) {
+    if (!resolvedPath.startsWith(baseDir + path_1.default.sep) && resolvedPath !== baseDir) {
+        throw new error_handler_1.SecurityError('Path escapes storage sandbox', 'file-access');
+    }
+}
+/**
+ * Optimized file-system based workflow storage with intelligent caching.
+ * Uses an index cache to avoid repeatedly scanning directories and
+ * reading files unnecessarily.
+ */
+class FileWorkflowStorage {
+    baseDirReal;
+    maxFileSize;
+    cacheTTL;
+    cacheLimit;
+    indexCacheTTL;
+    cache = new Map();
+    // Index cache to avoid expensive directory scans
+    workflowIndex = null;
+    indexExpires = 0;
+    constructor(directory, options = {}) {
+        this.baseDirReal = path_1.default.resolve(directory);
+        this.maxFileSize = options.maxFileSizeBytes ?? 1_000_000; // 1 MB default
+        this.cacheTTL = options.cacheTTLms ?? 5000;
+        this.cacheLimit = options.cacheSize ?? 100;
+        this.indexCacheTTL = options.indexCacheTTLms ?? 30000; // 30 seconds
+    }
+    /**
+     * Build or refresh the workflow index by scanning the directory once
+     */
+    async buildWorkflowIndex() {
+        const dirEntries = await promises_1.default.readdir(this.baseDirReal);
+        const jsonFiles = dirEntries.filter((f) => f.endsWith('.json'));
+        const index = new Map();
+        for (const file of jsonFiles) {
+            const filePathRaw = path_1.default.resolve(this.baseDirReal, file);
+            assertWithinBase(filePathRaw, this.baseDirReal);
+            try {
+                const stats = (0, fs_1.statSync)(filePathRaw);
+                if (stats.size > this.maxFileSize) {
+                    console.warn(`[FileWorkflowStorage] Skipping oversized file: ${file}`);
+                    continue;
+                }
+                // Read just enough to get the workflow ID and summary info
+                const raw = await promises_1.default.readFile(filePathRaw, 'utf-8');
+                const data = JSON.parse(raw);
+                if (!data.id) {
+                    console.warn(`[FileWorkflowStorage] Skipping file without id: ${file}`);
+                    continue;
+                }
+                const entry = {
+                    id: data.id,
+                    filename: file,
+                    lastModified: stats.mtimeMs,
+                    summary: {
+                        id: data.id,
+                        name: data.name,
+                        description: data.description,
+                        category: 'default',
+                        version: data.version
+                    }
+                };
+                index.set(data.id, entry);
+            }
+            catch (err) {
+                console.warn(`[FileWorkflowStorage] Skipping invalid file: ${file}`, err);
+                continue;
+            }
+        }
+        return index;
+    }
+    /**
+     * Get the workflow index, building it if necessary
+     */
+    async getWorkflowIndex() {
+        const now = Date.now();
+        if (this.workflowIndex && this.indexExpires > now) {
+            return this.workflowIndex;
+        }
+        // Rebuild index
+        this.workflowIndex = await this.buildWorkflowIndex();
+        this.indexExpires = now + this.indexCacheTTL;
+        return this.workflowIndex;
+    }
+    /**
+     * Load a specific workflow from file
+     */
+    async loadWorkflowFromFile(filename) {
+        const filePath = path_1.default.resolve(this.baseDirReal, filename);
+        assertWithinBase(filePath, this.baseDirReal);
+        try {
+            const stats = (0, fs_1.statSync)(filePath);
+            if (stats.size > this.maxFileSize) {
+                throw new error_handler_1.SecurityError('Workflow file exceeds size limit', 'file-size');
+            }
+            const raw = await promises_1.default.readFile(filePath, 'utf-8');
+            const data = JSON.parse(raw);
+            return data;
+        }
+        catch (err) {
+            console.warn(`[FileWorkflowStorage] Failed to load workflow from ${filename}:`, err);
+            return null;
+        }
+    }
+    /**
+     * Load *all* JSON files from the configured directory.
+     * NOTE: This method is expensive and should be avoided when possible.
+     * Use getWorkflowIndex() + loadWorkflowFromFile() for better performance.
+     */
+    async loadAllWorkflows() {
+        const index = await this.getWorkflowIndex();
+        const workflows = [];
+        // Load workflows in parallel for better performance
+        const loadPromises = Array.from(index.values()).map(async (entry) => {
+            const workflow = await this.loadWorkflowFromFile(entry.filename);
+            if (workflow) {
+                workflows.push(workflow);
+            }
+        });
+        await Promise.all(loadPromises);
+        return workflows;
+    }
+    async getWorkflowById(id) {
+        const safeId = sanitizeId(id);
+        // Try cache first
+        const cached = this.cache.get(safeId);
+        if (cached && cached.expires > Date.now()) {
+            return cached.workflow;
+        }
+        // Check index for the workflow
+        const index = await this.getWorkflowIndex();
+        const indexEntry = index.get(safeId);
+        if (!indexEntry) {
+            return null; // Workflow doesn't exist
+        }
+        // Load the specific workflow file
+        const workflow = await this.loadWorkflowFromFile(indexEntry.filename);
+        if (!workflow) {
+            return null;
+        }
+        // Verify ID matches (security check)
+        if (workflow.id !== safeId) {
+            throw new error_handler_1.InvalidWorkflowError(safeId, 'ID mismatch between index and workflow.id');
+        }
+        // Cache the result
+        if (this.cacheTTL > 0) {
+            if (this.cache.size >= this.cacheLimit) {
+                // Evict oldest (first inserted)
+                const firstKey = this.cache.keys().next().value;
+                this.cache.delete(firstKey);
+            }
+            this.cache.set(safeId, { workflow, expires: Date.now() + this.cacheTTL });
+        }
+        return workflow;
+    }
+    async listWorkflowSummaries() {
+        // Use the index to get summaries without loading full workflows
+        const index = await this.getWorkflowIndex();
+        return Array.from(index.values()).map(entry => entry.summary);
+    }
+    async save() {
+        // No-op for now – file storage is read-only in this phase.
+        return Promise.resolve();
+    }
+}
+exports.FileWorkflowStorage = FileWorkflowStorage;
+/**
+ * Helper factory that resolves the workflow directory according to the
+ * previous behaviour (env override → bundled workflows).
+ */
+function createDefaultFileWorkflowStorage() {
+    const DEFAULT_WORKFLOW_DIR = path_1.default.resolve(__dirname, '../../../workflows');
+    const envPath = process.env['WORKFLOW_STORAGE_PATH'];
+    const resolved = envPath ? path_1.default.resolve(envPath) : null;
+    const directory = resolved && (0, fs_1.existsSync)(resolved) ? resolved : DEFAULT_WORKFLOW_DIR;
+    // Use optimized settings for better performance
+    return new FileWorkflowStorage(directory, {
+        cacheTTLms: 10000, // 10 second cache for individual workflows
+        cacheSize: 200, // Larger cache
+        indexCacheTTLms: 60000, // 1 minute index cache
+    });
+}
+//# sourceMappingURL=file-workflow-storage.js.map