@marktoflow/core 2.0.0-alpha.12

package/dist/webhook.js

@@ -0,0 +1,261 @@
+/**
+ * Webhook receiver for marktoflow v2.0
+ *
+ * HTTP server for receiving webhook events from external services.
+ */
+import { createServer } from 'node:http';
+import { createHmac, timingSafeEqual } from 'node:crypto';
+// ============================================================================
+// Signature Verification
+// ============================================================================
+/**
+ * Verify a GitHub-style webhook signature.
+ * Format: sha256=<hex signature>
+ */
+export function verifyGitHubSignature(payload, signature, secret) {
+    if (!signature.startsWith('sha256=')) {
+        return false;
+    }
+    const expected = 'sha256=' + createHmac('sha256', secret).update(payload).digest('hex');
+    try {
+        return timingSafeEqual(Buffer.from(signature), Buffer.from(expected));
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Verify a generic HMAC-SHA256 signature.
+ */
+export function verifyHmacSignature(payload, signature, secret) {
+    const expected = createHmac('sha256', secret).update(payload).digest('hex');
+    try {
+        return timingSafeEqual(Buffer.from(signature), Buffer.from(expected));
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Verify a Slack webhook signature.
+ * Uses headers: x-slack-signature (v0=...) and x-slack-request-timestamp.
+ */
+export function verifySlackSignature(payload, signature, timestamp, secret) {
+    if (!signature.startsWith('v0='))
+        return false;
+    const base = `v0:${timestamp}:${payload}`;
+    const expected = 'v0=' + createHmac('sha256', secret).update(base).digest('hex');
+    try {
+        return timingSafeEqual(Buffer.from(signature), Buffer.from(expected));
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Generate a signature for testing.
+ */
+export function generateSignature(payload, secret) {
+    return 'sha256=' + createHmac('sha256', secret).update(payload).digest('hex');
+}
+// ============================================================================
+// WebhookReceiver Implementation
+// ============================================================================
+export class WebhookReceiver {
+    server = null;
+    endpoints = new Map();
+    handlers = new Map();
+    host;
+    port;
+    constructor(options = {}) {
+        this.host = options.host || '0.0.0.0';
+        this.port = options.port || 3000;
+    }
+    /**
+     * Register a webhook endpoint.
+     */
+    registerEndpoint(endpoint, handler) {
+        this.endpoints.set(endpoint.path, endpoint);
+        this.handlers.set(endpoint.path, handler);
+    }
+    /**
+     * Unregister a webhook endpoint.
+     */
+    unregisterEndpoint(path) {
+        this.handlers.delete(path);
+        return this.endpoints.delete(path);
+    }
+    /**
+     * Get all registered endpoints.
+     */
+    getEndpoints() {
+        return Array.from(this.endpoints.values());
+    }
+    /**
+     * Start the webhook server.
+     */
+    async start() {
+        return new Promise((resolve, reject) => {
+            this.server = createServer((req, res) => {
+                this.handleRequest(req, res).catch((error) => {
+                    console.error('Webhook handler error:', error);
+                    res.statusCode = 500;
+                    res.end('Internal Server Error');
+                });
+            });
+            this.server.on('error', reject);
+            this.server.listen(this.port, this.host, () => {
+                console.log(`Webhook receiver listening on ${this.host}:${this.port}`);
+                resolve();
+            });
+        });
+    }
+    /**
+     * Stop the webhook server.
+     */
+    async stop() {
+        return new Promise((resolve, reject) => {
+            if (!this.server) {
+                resolve();
+                return;
+            }
+            this.server.close((error) => {
+                if (error) {
+                    reject(error);
+                }
+                else {
+                    this.server = null;
+                    resolve();
+                }
+            });
+        });
+    }
+    /**
+     * Check if server is running.
+     */
+    isRunning() {
+        return this.server !== null;
+    }
+    /**
+     * Get the server URL.
+     */
+    getUrl() {
+        return `http://${this.host}:${this.port}`;
+    }
+    async handleRequest(req, res) {
+        const url = new URL(req.url || '/', `http://${req.headers.host}`);
+        const path = url.pathname;
+        const method = req.method || 'GET';
+        // Find matching endpoint
+        const endpoint = this.endpoints.get(path);
+        const handler = this.handlers.get(path);
+        if (!endpoint || !handler) {
+            res.statusCode = 404;
+            res.end('Not Found');
+            return;
+        }
+        if (!endpoint.enabled) {
+            res.statusCode = 503;
+            res.end('Endpoint Disabled');
+            return;
+        }
+        if (!endpoint.methods.includes(method)) {
+            res.statusCode = 405;
+            res.end('Method Not Allowed');
+            return;
+        }
+        // Read body
+        const body = await this.readBody(req);
+        // Verify signature if secret is configured
+        if (endpoint.secret) {
+            const signature = req.headers['x-hub-signature-256'] ||
+                req.headers['x-signature'];
+            if (!signature) {
+                res.statusCode = 401;
+                res.end('Missing Signature');
+                return;
+            }
+            const isValid = signature.startsWith('sha256=')
+                ? verifyGitHubSignature(body, signature, endpoint.secret)
+                : verifyHmacSignature(body, signature, endpoint.secret);
+            if (!isValid) {
+                res.statusCode = 401;
+                res.end('Invalid Signature');
+                return;
+            }
+        }
+        // Parse query parameters
+        const query = {};
+        url.searchParams.forEach((value, key) => {
+            query[key] = value;
+        });
+        // Create webhook event
+        const event = {
+            id: crypto.randomUUID(),
+            path,
+            method,
+            headers: this.flattenHeaders(req.headers),
+            body,
+            query,
+            receivedAt: new Date(),
+        };
+        // Call handler
+        try {
+            const response = await handler(event);
+            res.statusCode = response.status;
+            if (response.headers) {
+                for (const [key, value] of Object.entries(response.headers)) {
+                    res.setHeader(key, value);
+                }
+            }
+            res.end(response.body || '');
+        }
+        catch (error) {
+            console.error('Handler error:', error);
+            res.statusCode = 500;
+            res.end('Handler Error');
+        }
+    }
+    readBody(req) {
+        return new Promise((resolve, reject) => {
+            const chunks = [];
+            req.on('data', (chunk) => chunks.push(chunk));
+            req.on('end', () => resolve(Buffer.concat(chunks).toString('utf-8')));
+            req.on('error', reject);
+        });
+    }
+    flattenHeaders(headers) {
+        const result = {};
+        for (const [key, value] of Object.entries(headers)) {
+            if (value) {
+                result[key] = Array.isArray(value) ? value.join(', ') : value;
+            }
+        }
+        return result;
+    }
+}
+// ============================================================================
+// Helper Functions
+// ============================================================================
+export function createEndpoint(path, options = {}) {
+    return {
+        path,
+        secret: options.secret,
+        workflowId: options.workflowId,
+        methods: options.methods || ['POST'],
+        enabled: true,
+    };
+}
+export function parseWebhookBody(event) {
+    const contentType = event.headers['content-type'] || '';
+    if (contentType.includes('application/json')) {
+        try {
+            return JSON.parse(event.body);
+        }
+        catch {
+            return event.body;
+        }
+    }
+    return event.body;
+}
+//# sourceMappingURL=webhook.js.map

package/dist/webhook.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhook.js","sourceRoot":"","sources":["../src/webhook.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,YAAY,EAA2C,MAAM,WAAW,CAAC;AAClF,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAqC1D,+EAA+E;AAC/E,yBAAyB;AACzB,+EAA+E;AAE/E;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CACnC,OAAe,EACf,SAAiB,EACjB,MAAc;IAEd,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QACrC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,QAAQ,GAAG,SAAS,GAAG,UAAU,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAExF,IAAI,CAAC;QACH,OAAO,eAAe,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;IACxE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CACjC,OAAe,EACf,SAAiB,EACjB,MAAc;IAEd,MAAM,QAAQ,GAAG,UAAU,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAE5E,IAAI,CAAC;QACH,OAAO,eAAe,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;IACxE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAClC,OAAe,EACf,SAAiB,EACjB,SAAiB,EACjB,MAAc;IAEd,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAC/C,MAAM,IAAI,GAAG,MAAM,SAAS,IAAI,OAAO,EAAE,CAAC;IAC1C,MAAM,QAAQ,GAAG,KAAK,GAAG,UAAU,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACjF,IAAI,CAAC;QACH,OAAO,eAAe,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;IACxE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAAe,EAAE,MAAc;IAC/D,OAAO,SAAS,GAAG,UAAU,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAChF,CAAC;AAED,+EAA+E;AAC/E,iCAAiC;AACjC,+EAA+E;AAE/E,MAAM,OAAO,eAAe;IAClB,MAAM,GAAkB,IAAI,CAAC;IAC7B,SAAS,GAAiC,IAAI,GAAG,EAAE,CAAC;IACpD,QAAQ,GAAgC,IAAI,GAAG,EAAE,CAAC;IAClD,IAAI,CAAS;IACb,IAAI,CAAS;IAErB,YAAY,UAAkC,EAAE;QAC9C,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,SAAS,CAAC;QACtC,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,IAAI,CAAC;IACnC,CAAC;IAED;;OAEG;IACH,gBAAgB,CAAC,QAAyB,EAAE,OAAuB;QACjE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QAC5C,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAC5C,CAAC;IAED;;OAEG;IACH,kBAAkB,CAAC,IAAY;QAC7B,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAC3B,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACrC,CAAC;IAED;;OAEG;IACH,YAAY;QACV,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC;IAC7C,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,KAAK;QACT,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACrC,IAAI,CAAC,MAAM,GAAG,YAAY,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE;gBACtC,IAAI,CAAC,aAAa,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;oBAC3C,OAAO,CAAC,KAAK,CAAC,wBAAwB,EAAE,KAAK,CAAC,CAAC;oBAC/C,GAAG,CAAC,UAAU,GAAG,GAAG,CAAC;oBACrB,GAAG,CAAC,GAAG,CAAC,uBAAuB,CAAC,CAAC;gBACnC,CAAC,CAAC,CAAC;YACL,CAAC,CAAC,CAAC;YAEH,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;YAEhC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,GAAG,EAAE;gBAC5C,OAAO,CAAC,GAAG,CAAC,iCAAiC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;gBACvE,OAAO,EAAE,CAAC;YACZ,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,IAAI;QACR,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACrC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;gBACjB,OAAO,EAAE,CAAC;gBACV,OAAO;YACT,CAAC;YAED,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;gBAC1B,IAAI,KAAK,EAAE,CAAC;oBACV,MAAM,CAAC,KAAK,CAAC,CAAC;gBAChB,CAAC;qBAAM,CAAC;oBACN,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;oBACnB,OAAO,EAAE,CAAC;gBACZ,CAAC;YACH,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,SAAS;QACP,OAAO,IAAI,CAAC,MAAM,KAAK,IAAI,CAAC;IAC9B,CAAC;IAED;;OAEG;IACH,MAAM;QACJ,OAAO,UAAU,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;IAC5C,CAAC;IAEO,KAAK,CAAC,aAAa,CAAC,GAAoB,EAAE,GAAmB;QACnE,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,GAAG,IAAI,GAAG,EAAE,UAAU,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;QAClE,MAAM,IAAI,GAAG,GAAG,CAAC,QAAQ,CAAC;QAC1B,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,IAAI,KAAK,CAAC;QAEnC,yBAAyB;QACzB,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC1C,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAExC,IAAI,CAAC,QAAQ,IAAI,CAAC,OAAO,EAAE,CAAC;YAC1B,GAAG,CAAC,UAAU,GAAG,GAAG,CAAC;YACrB,GAAG,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;YACrB,OAAO;QACT,CAAC;QAED,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;YACtB,GAAG,CAAC,UAAU,GAAG,GAAG,CAAC;YACrB,GAAG,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC;YAC7B,OAAO;QACT,CAAC;QAED,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;YACvC,GAAG,CAAC,UAAU,GAAG,GAAG,CAAC;YACrB,GAAG,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;YAC9B,OAAO;QACT,CAAC;QAED,YAAY;QACZ,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;QAEtC,2CAA2C;QAC3C,IAAI,QAAQ,CAAC,MAAM,EAAE,CAAC;YACpB,MAAM,SAAS,GACZ,GAAG,CAAC,OAAO,CAAC,qBAAqB,CAAY;gBAC7C,GAAG,CAAC,OAAO,CAAC,aAAa,CAAY,CAAC;YAEzC,IAAI,CAAC,SAAS,EAAE,CAAC;gBACf,GAAG,CAAC,UAAU,GAAG,GAAG,CAAC;gBACrB,GAAG,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC;gBAC7B,OAAO;YACT,CAAC;YAED,MAAM,OAAO,GAAG,SAAS,CAAC,UAAU,CAAC,SAAS,CAAC;gBAC7C,CAAC,CAAC,qBAAqB,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC;gBACzD,CAAC,CAAC,mBAAmB,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;YAE1D,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,GAAG,CAAC,UAAU,GAAG,GAAG,CAAC;gBACrB,GAAG,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC;gBAC7B,OAAO;YACT,CAAC;QACH,CAAC;QAED,yBAAyB;QACzB,MAAM,KAAK,GAA2B,EAAE,CAAC;QACzC,GAAG,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;YACtC,KAAK,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QACrB,CAAC,CAAC,CAAC;QAEH,uBAAuB;QACvB,MAAM,KAAK,GAAiB;YAC1B,EAAE,EAAE,MAAM,CAAC,UAAU,EAAE;YACvB,IAAI;YACJ,MAAM;YACN,OAAO,EAAE,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,OAAO,CAAC;YACzC,IAAI;YACJ,KAAK;YACL,UAAU,EAAE,IAAI,IAAI,EAAE;SACvB,CAAC;QAEF,eAAe;QACf,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,KAAK,CAAC,CAAC;YAEtC,GAAG,CAAC,UAAU,GAAG,QAAQ,CAAC,MAAM,CAAC;YAEjC,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC;gBACrB,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;oBAC5D,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;gBAC5B,CAAC;YACH,CAAC;YAED,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;QAC/B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,gBAAgB,EAAE,KAAK,CAAC,CAAC;YACvC,GAAG,CAAC,UAAU,GAAG,GAAG,CAAC;YACrB,GAAG,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;QAC3B,CAAC;IACH,CAAC;IAEO,QAAQ,CAAC,GAAoB;QACnC,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACrC,MAAM,MAAM,GAAa,EAAE,CAAC;YAE5B,GAAG,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;YAC9C,GAAG,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;YACtE,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAC1B,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,cAAc,CAAC,OAAmC;QACxD,MAAM,MAAM,GAA2B,EAAE,CAAC;QAE1C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;YACnD,IAAI,KAAK,EAAE,CAAC;gBACV,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;YAChE,CAAC;QACH,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;CACF;AAED,+EAA+E;AAC/E,mBAAmB;AACnB,+EAA+E;AAE/E,MAAM,UAAU,cAAc,CAC5B,IAAY,EACZ,UAII,EAAE;IAEN,OAAO;QACL,IAAI;QACJ,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,UAAU,EAAE,OAAO,CAAC,UAAU;QAC9B,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,CAAC,MAAM,CAAC;QACpC,OAAO,EAAE,IAAI;KACd,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,KAAmB;IAClD,MAAM,WAAW,GAAG,KAAK,CAAC,OAAO,CAAC,cAAc,CAAC,IAAI,EAAE,CAAC;IAExD,IAAI,WAAW,CAAC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,CAAC;QAC7C,IAAI,CAAC;YACH,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAChC,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC,IAAI,CAAC;QACpB,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC;AACpB,CAAC"}

package/dist/workflow-tools.d.ts

@@ -0,0 +1,102 @@
+/**
+ * Built-in workflow tools for controlling workflow execution
+ *
+ * These actions are always available in workflows without needing to be declared.
+ */
+import { SDKInitializer } from './sdk-registry.js';
+/**
+ * Workflow tools client that provides workflow control actions
+ */
+export declare class WorkflowToolsClient {
+    /**
+     * Set workflow output variables
+     *
+     * This action sets the final output values of the workflow that can be accessed
+     * by the caller or displayed at the end of execution.
+     *
+     * @example
+     * ```yaml
+     * action: workflow.set_outputs
+     * inputs:
+     *   result: '{{ calculation_result }}'
+     *   status: 'success'
+     *   message: 'Workflow completed'
+     * ```
+     */
+    set_outputs(inputs: Record<string, unknown>): Promise<Record<string, unknown>>;
+    /**
+     * Sleep for a specified duration
+     *
+     * @example
+     * ```yaml
+     * action: workflow.sleep
+     * inputs:
+     *   duration: 5000  # milliseconds
+     * ```
+     */
+    sleep(inputs: {
+        duration: number;
+    }): Promise<{
+        slept: number;
+    }>;
+    /**
+     * Fail the workflow with an error message
+     *
+     * @example
+     * ```yaml
+     * action: workflow.fail
+     * inputs:
+     *   message: 'Validation failed'
+     *   code: 'VALIDATION_ERROR'
+     * ```
+     */
+    fail(inputs: {
+        message: string;
+        code?: string;
+    }): Promise<never>;
+    /**
+     * Log a message (alias for core.log)
+     *
+     * @example
+     * ```yaml
+     * action: workflow.log
+     * inputs:
+     *   message: 'Processing item {{ item_id }}'
+     *   level: 'info'
+     * ```
+     */
+    log(inputs: {
+        message: string;
+        level?: string;
+        metadata?: Record<string, unknown>;
+    }): Promise<{
+        logged: true;
+    }>;
+    /**
+     * Create a timestamp
+     *
+     * @example
+     * ```yaml
+     * action: workflow.timestamp
+     * inputs:
+     *   format: 'iso'  # 'iso', 'unix', or 'ms'
+     * output_variable: timestamp
+     * ```
+     */
+    timestamp(inputs?: {
+        format?: string;
+    }): Promise<{
+        timestamp: string | number;
+    }>;
+    /**
+     * No-op action (useful for testing or placeholders)
+     */
+    noop(): Promise<{
+        success: true;
+    }>;
+}
+/**
+ * Workflow SDK initializer
+ */
+export declare const WorkflowInitializer: SDKInitializer;
+//# sourceMappingURL=workflow-tools.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-tools.d.ts","sourceRoot":"","sources":["../src/workflow-tools.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAEnD;;GAEG;AACH,qBAAa,mBAAmB;IAC9B;;;;;;;;;;;;;;OAcG;IACG,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IASpF;;;;;;;;;OASG;IACG,KAAK,CAAC,MAAM,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAMrE;;;;;;;;;;OAUG;IACG,IAAI,CAAC,MAAM,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,KAAK,CAAC;IAQtE;;;;;;;;;;OAUG;IACG,GAAG,CAAC,MAAM,EAAE;QAChB,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACpC,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,IAAI,CAAA;KAAE,CAAC;IAiB7B;;;;;;;;;;OAUG;IACG,SAAS,CAAC,MAAM,GAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,OAAO,CAAC;QAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,CAAC;IAe1F;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC;QAAE,OAAO,EAAE,IAAI,CAAA;KAAE,CAAC;CAGzC;AAED;;GAEG;AACH,eAAO,MAAM,mBAAmB,EAAE,cAIjC,CAAC"}

package/dist/workflow-tools.js

@@ -0,0 +1,130 @@
+/**
+ * Built-in workflow tools for controlling workflow execution
+ *
+ * These actions are always available in workflows without needing to be declared.
+ */
+/**
+ * Workflow tools client that provides workflow control actions
+ */
+export class WorkflowToolsClient {
+    /**
+     * Set workflow output variables
+     *
+     * This action sets the final output values of the workflow that can be accessed
+     * by the caller or displayed at the end of execution.
+     *
+     * @example
+     * ```yaml
+     * action: workflow.set_outputs
+     * inputs:
+     *   result: '{{ calculation_result }}'
+     *   status: 'success'
+     *   message: 'Workflow completed'
+     * ```
+     */
+    async set_outputs(inputs) {
+        // The engine will capture this special return value and set it as workflow outputs
+        // This is a marker that tells the engine to update the workflow's output variables
+        return {
+            __workflow_outputs__: inputs,
+            ...inputs,
+        };
+    }
+    /**
+     * Sleep for a specified duration
+     *
+     * @example
+     * ```yaml
+     * action: workflow.sleep
+     * inputs:
+     *   duration: 5000  # milliseconds
+     * ```
+     */
+    async sleep(inputs) {
+        const duration = inputs.duration || 0;
+        await new Promise(resolve => setTimeout(resolve, duration));
+        return { slept: duration };
+    }
+    /**
+     * Fail the workflow with an error message
+     *
+     * @example
+     * ```yaml
+     * action: workflow.fail
+     * inputs:
+     *   message: 'Validation failed'
+     *   code: 'VALIDATION_ERROR'
+     * ```
+     */
+    async fail(inputs) {
+        const error = new Error(inputs.message);
+        if (inputs.code) {
+            error.code = inputs.code;
+        }
+        throw error;
+    }
+    /**
+     * Log a message (alias for core.log)
+     *
+     * @example
+     * ```yaml
+     * action: workflow.log
+     * inputs:
+     *   message: 'Processing item {{ item_id }}'
+     *   level: 'info'
+     * ```
+     */
+    async log(inputs) {
+        const level = inputs.level || 'info';
+        const message = inputs.message;
+        const metadata = inputs.metadata;
+        const logFn = level === 'error' || level === 'critical' ? console.error :
+            level === 'warning' ? console.warn : console.log;
+        if (metadata && Object.keys(metadata).length > 0) {
+            logFn(`[${level.toUpperCase()}] ${message}`, metadata);
+        }
+        else {
+            logFn(`[${level.toUpperCase()}] ${message}`);
+        }
+        return { logged: true };
+    }
+    /**
+     * Create a timestamp
+     *
+     * @example
+     * ```yaml
+     * action: workflow.timestamp
+     * inputs:
+     *   format: 'iso'  # 'iso', 'unix', or 'ms'
+     * output_variable: timestamp
+     * ```
+     */
+    async timestamp(inputs = {}) {
+        const format = inputs.format || 'iso';
+        switch (format) {
+            case 'iso':
+                return { timestamp: new Date().toISOString() };
+            case 'unix':
+                return { timestamp: Math.floor(Date.now() / 1000) };
+            case 'ms':
+                return { timestamp: Date.now() };
+            default:
+                return { timestamp: new Date().toISOString() };
+        }
+    }
+    /**
+     * No-op action (useful for testing or placeholders)
+     */
+    async noop() {
+        return { success: true };
+    }
+}
+/**
+ * Workflow SDK initializer
+ */
+export const WorkflowInitializer = {
+    async initialize(_module, _config) {
+        return new WorkflowToolsClient();
+    },
+};
+//# sourceMappingURL=workflow-tools.js.map

package/dist/workflow-tools.js.map

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

package/package.json

@@ -0,0 +1,62 @@
+{
+  "name": "@marktoflow/core",
+  "version": "2.0.0-alpha.12",
+  "description": "Core engine for marktoflow - parser, executor, state management",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/marktoflow/marktoflow.git",
+    "directory": "packages/core"
+  },
+  "homepage": "https://github.com/marktoflow/marktoflow#readme",
+  "bugs": {
+    "url": "https://github.com/marktoflow/marktoflow/issues"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "tsc --noEmit",
+    "clean": "rm -rf dist"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.25.3",
+    "amqplib": "^0.10.9",
+    "better-sqlite3": "11.10.0",
+    "chokidar": "^5.0.0",
+    "dotenv": "^16.4.5",
+    "ioredis": "^5.9.2",
+    "minimatch": "^10.1.1",
+    "prom-client": "^15.1.3",
+    "yaml": "^2.6.0",
+    "zod": "^3.24.0"
+  },
+  "devDependencies": {
+    "@types/amqplib": "^0.10.8",
+    "@types/better-sqlite3": "^7.6.0"
+  },
+  "peerDependencies": {
+    "typescript": "^5.0.0"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "keywords": [
+    "marktoflow",
+    "workflow",
+    "parser",
+    "automation",
+    "mcp"
+  ],
+  "author": "Scott Glover",
+  "license": "Apache-2.0"
+}