@siglo/monitor 0.0.0-stage → 1.0.1

package/dist/transports/websocket.js

@@ -0,0 +1,277 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WebSocketBroadcaster = void 0;
+const crypto = __importStar(require("crypto"));
+const core_1 = require("@siglo/core");
+const WS_MAGIC_STRING = '258EAFA5-E914-47DA-95CA-C5AB0DC85B11';
+class WebSocketBroadcaster {
+    clients = new Set();
+    redaction;
+    onClientMessageCallback;
+    authenticateCallback;
+    allowRemoteResume;
+    maxPayloadBytes;
+    authorizeMessage;
+    constructor(options) {
+        this.redaction = options?.redaction;
+        this.maxPayloadBytes = options?.maxPayloadBytes && options.maxPayloadBytes > 0 ? options.maxPayloadBytes : 1048576;
+        this.authorizeMessage = options?.authorizeMessage;
+        this.onClientMessageCallback = options?.onClientMessage;
+        this.authenticateCallback = options?.authenticate;
+        this.allowRemoteResume = options?.allowRemoteResume !== undefined ? options.allowRemoteResume : true;
+    }
+    attach(server, path = '/ws') {
+        server.on('upgrade', (req, socket) => {
+            const pathname = req.url ? new URL(req.url, `http://${req.headers.host || 'localhost'}`).pathname : '';
+            if (pathname !== path) {
+                return;
+            }
+            // Auth verification if configured
+            if (this.authenticateCallback && !this.authenticateCallback(req)) {
+                socket.write('HTTP/1.1 401 Unauthorized\r\nConnection: close\r\n\r\n');
+                socket.destroy();
+                return;
+            }
+            const key = req.headers['sec-websocket-key'];
+            if (!key || typeof key !== 'string') {
+                socket.destroy();
+                return;
+            }
+            const acceptKey = crypto
+                .createHash('sha1')
+                .update(key + WS_MAGIC_STRING)
+                .digest('base64');
+            const responseHeaders = [
+                'HTTP/1.1 101 Switching Protocols',
+                'Upgrade: websocket',
+                'Connection: Upgrade',
+                `Sec-WebSocket-Accept: ${acceptKey}`,
+                '\r\n'
+            ].join('\r\n');
+            socket.write(responseHeaders);
+            const url = new URL(req.url || '/', `http://${req.headers.host || 'localhost'}`);
+            const namespace = url.searchParams.get('namespace') || undefined;
+            const client = {
+                id: Math.random().toString(36).substring(2, 11),
+                socket,
+                namespace
+            };
+            this.clients.add(client);
+            this.setupSocket(client, req);
+        });
+    }
+    setupSocket(client, req) {
+        let buffer = Buffer.alloc(0);
+        client.socket.on('data', (chunk) => {
+            buffer = Buffer.concat([buffer, chunk]);
+            while (buffer.length >= 2) {
+                const firstByte = buffer[0];
+                const secondByte = buffer[1];
+                const opcode = firstByte & 0x0f;
+                const isMasked = (secondByte & 0x80) === 0x80;
+                let payloadLength = secondByte & 0x7f;
+                let offset = 2;
+                if (payloadLength === 126) {
+                    if (buffer.length < 4)
+                        return;
+                    payloadLength = buffer.readUInt16BE(2);
+                    offset = 4;
+                }
+                else if (payloadLength === 127) {
+                    if (buffer.length < 10)
+                        return;
+                    payloadLength = Number(buffer.readBigUInt64BE(2));
+                    offset = 10;
+                }
+                // Reject oversized or unsupported frames before waiting for their payload.
+                if (!Number.isSafeInteger(payloadLength) || payloadLength > this.maxPayloadBytes ||
+                    !isMasked || !(firstByte & 0x80) || (firstByte & 0x70) ||
+                    ![0x01, 0x08, 0x09, 0x0a].includes(opcode) || (opcode >= 0x08 && payloadLength > 125)) {
+                    this.removeClient(client);
+                    client.socket.destroy();
+                    return;
+                }
+                let maskKey = null;
+                if (isMasked) {
+                    if (buffer.length < offset + 4)
+                        return;
+                    maskKey = buffer.subarray(offset, offset + 4);
+                    offset += 4;
+                }
+                if (buffer.length < offset + payloadLength) {
+                    return; // Wait for full frame
+                }
+                let payload = buffer.subarray(offset, offset + payloadLength);
+                buffer = buffer.subarray(offset + payloadLength);
+                let decodedPayload;
+                if (isMasked && maskKey) {
+                    decodedPayload = Buffer.alloc(payload.length);
+                    for (let i = 0; i < payload.length; i++) {
+                        decodedPayload[i] = payload[i] ^ maskKey[i % 4];
+                    }
+                }
+                else {
+                    decodedPayload = payload;
+                }
+                if (opcode === 0x08) {
+                    // Close frame
+                    this.removeClient(client);
+                    client.socket.end();
+                    return;
+                }
+                else if (opcode === 0x09) {
+                    // Ping -> reply with Pong
+                    this.sendPong(client.socket, decodedPayload);
+                }
+                else if (opcode === 0x01) {
+                    // Text frame
+                    const text = decodedPayload.toString('utf8');
+                    this.handleMessage(client, text, req);
+                }
+            }
+        });
+        client.socket.on('error', () => {
+            this.removeClient(client);
+        });
+        client.socket.on('close', () => {
+            this.removeClient(client);
+        });
+    }
+    handleMessage(client, text, req) {
+        try {
+            const parsed = JSON.parse(text);
+            if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed))
+                return;
+            if (this.authorizeMessage && !this.authorizeMessage(parsed, req))
+                return;
+            if (parsed.action === 'subscribe' && parsed.namespace) {
+                client.namespace = parsed.namespace;
+            }
+            else if (parsed.action === 'resume' && parsed.stackId && this.allowRemoteResume) {
+                // Delegated to onClientMessageCallback
+            }
+            if (this.onClientMessageCallback) {
+                this.onClientMessageCallback(parsed, client);
+            }
+        }
+        catch {
+            // Ignore non-json client payloads
+        }
+    }
+    sendPong(socket, payload) {
+        const frame = Buffer.concat([
+            Buffer.from([0x8a, payload.length]),
+            payload
+        ]);
+        try {
+            socket.write(frame);
+        }
+        catch {
+            // ignore
+        }
+    }
+    broadcast(event) {
+        if (!event)
+            return;
+        const sanitized = (0, core_1.redactEvent)(event, this.redaction);
+        const data = JSON.stringify(sanitized);
+        const frame = this.encodeTextFrame(data);
+        for (const client of Array.from(this.clients)) {
+            if (client.namespace && sanitized.namespace && client.namespace !== sanitized.namespace) {
+                continue;
+            }
+            try {
+                client.socket.write(frame);
+            }
+            catch {
+                this.removeClient(client);
+            }
+        }
+    }
+    send(client, message) {
+        const text = typeof message === "string" ? message : JSON.stringify(message);
+        const frame = this.encodeTextFrame(text);
+        try {
+            client.socket.write(frame);
+        }
+        catch {
+            this.removeClient(client);
+        }
+    }
+    encodeTextFrame(text) {
+        const payload = Buffer.from(text, 'utf8');
+        const length = payload.length;
+        if (length < 126) {
+            return Buffer.concat([
+                Buffer.from([0x81, length]),
+                payload
+            ]);
+        }
+        else if (length < 65536) {
+            const header = Buffer.alloc(4);
+            header[0] = 0x81;
+            header[1] = 126;
+            header.writeUInt16BE(length, 2);
+            return Buffer.concat([header, payload]);
+        }
+        else {
+            const header = Buffer.alloc(10);
+            header[0] = 0x81;
+            header[1] = 127;
+            header.writeBigUInt64BE(BigInt(length), 2);
+            return Buffer.concat([header, payload]);
+        }
+    }
+    removeClient(client) {
+        this.clients.delete(client);
+    }
+    getClientCount() {
+        return this.clients.size;
+    }
+    close() {
+        for (const client of Array.from(this.clients)) {
+            try {
+                client.socket.destroy();
+            }
+            catch {
+                // ignore
+            }
+        }
+        this.clients.clear();
+    }
+}
+exports.WebSocketBroadcaster = WebSocketBroadcaster;
+//# sourceMappingURL=websocket.js.map

package/dist/transports/websocket.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,131 @@
+import * as http from 'http';
+import { WorkflowEventEmitter, WorkflowExecutionEvent, RedactionOptions, EcosystemInspection } from '@siglo/core';
+export interface StepRunRecord {
+    stepId: string;
+    stepName: string;
+    status: 'PENDING' | 'RUNNING' | 'COMPLETED' | 'FAILED' | 'SKIPPED' | 'RETRYING' | 'SUSPENDED' | 'WAITING';
+    attempts: number;
+    maxAttempts?: number;
+    startTime?: number;
+    endTime?: number;
+    durationMs?: number;
+    waitState?: 'waiting' | 'resumed' | 'expired';
+    waitExpiresAt?: number;
+    outputSummary?: any;
+    inspections?: {
+        attempt: number;
+        timestamp: number;
+        data: EcosystemInspection;
+    }[];
+    error?: {
+        message: string;
+        code?: string;
+        stack?: string;
+    };
+}
+export interface ContextDiffRecord {
+    stepId: string;
+    field: string;
+    value: any;
+    timestamp: number;
+}
+export interface WorkflowRunRecord {
+    stackId: string;
+    flowName?: string;
+    version?: string;
+    namespace?: string;
+    status: 'RUNNING' | 'COMPLETED' | 'FAILED' | 'SUSPENDED';
+    startTime: number;
+    endTime?: number;
+    durationMs?: number;
+    ast?: any;
+    steps: Record<string, StepRunRecord>;
+    context: Record<string, any>;
+    contextDiffs: ContextDiffRecord[];
+    events: WorkflowExecutionEvent[];
+    error?: {
+        message: string;
+        stack?: string;
+    };
+    waitingForEvent?: string;
+}
+export interface MonitorServerAuthOptions {
+    /** General secret token/API key required for all requests if configured */
+    apiKey?: string;
+    /** Dedicated token or API key required to ingest events via POST /api/events */
+    ingestionKey?: string;
+    /** Dedicated token or API key required for control plane actions (/resume, /replay) */
+    adminKey?: string;
+    /** Custom auth validator callback */
+    validator?: (token: string, scope: 'read' | 'ingest' | 'control', req: http.IncomingMessage) => boolean;
+}
+export interface MonitorServerCorsOptions {
+    /**
+     * Allowed CORS origin(s).
+     * Set to false to disable CORS entirely.
+     * Can be a string, array of strings, or predicate function.
+     */
+    origin?: string | string[] | boolean | ((origin: string) => boolean);
+    credentials?: boolean;
+}
+export interface MonitorSecurityOptions {
+    /** List of field names to redact in context diffs and telemetry events (e.g. ['password', 'secret', 'token']) */
+    redactedKeys?: string[];
+    /** Custom masking function for sensitive values */
+    maskFn?: (key: string, value: any) => any;
+}
+export interface MonitorServerOptions {
+    port?: number;
+    host?: string;
+    emitter?: WorkflowEventEmitter;
+    store?: any;
+    redaction?: RedactionOptions;
+    namespaceFilter?: string;
+    flow?: any;
+    workflows?: any;
+    open?: boolean;
+    reuseExisting?: boolean;
+    /** Authentication settings (or string shorthand for apiKey) */
+    auth?: MonitorServerAuthOptions | string;
+    /** CORS origin configuration */
+    cors?: MonitorServerCorsOptions;
+    /** Maximum allowed JSON payload size in bytes (default: 1MB = 1048576) */
+    maxPayloadBytes?: number;
+    /** Fine-grained security and telemetry redaction settings */
+    security?: MonitorSecurityOptions;
+    /** Whether to allow interactive workflow resumption and replay via HTTP/WS (default: true) */
+    allowRemoteResume?: boolean;
+}
+export interface MonitorClientOptions {
+    url?: string;
+    port?: number;
+    host?: string;
+    batchSize?: number;
+    flushIntervalMs?: number;
+    redaction?: RedactionOptions;
+    namespace?: string;
+    /** Bearer token or API key for authenticating with the remote monitor server */
+    apiKey?: string;
+    authToken?: string;
+    /** Custom HTTP headers sent with event batches */
+    headers?: Record<string, string>;
+    /** Maximum number of events buffered in memory before dropping oldest (default: 1000) */
+    maxQueueSize?: number;
+}
+export interface MonitorClientInstance {
+    emitter: WorkflowEventEmitter;
+    monitor: (event: WorkflowExecutionEvent) => void;
+    sendEvent: (event: WorkflowExecutionEvent) => Promise<void>;
+    flush: () => Promise<void>;
+    close: () => Promise<void>;
+}
+export interface MonitorClientMessage {
+    action: 'resume' | 'replay' | 'subscribe' | 'ping' | 'event';
+    stackId?: string;
+    eventName?: string;
+    payload?: any;
+    namespace?: string;
+    stepId?: string;
+    event?: WorkflowExecutionEvent;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

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

package/dist/types.js.map

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

package/dist/ui/dashboard.d.ts

@@ -0,0 +1,2 @@
+export declare function getDashboardHtml(): string;
+//# sourceMappingURL=dashboard.d.ts.map

package/dist/ui/dashboard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dashboard.d.ts","sourceRoot":"","sources":["../../src/ui/dashboard.ts"],"names":[],"mappings":"AACA,wBAAgB,gBAAgB,IAAI,MAAM,CAqCzC"}