@fractary/faber-mcp 1.1.0

package/dist/backends/local-files.js

@@ -0,0 +1,538 @@
+/**
+ * Local Files Backend for FABER Event Gateway
+ *
+ * Stores events as individual JSON files in the run's events directory.
+ * Uses atomic file operations for concurrent access safety.
+ */
+import * as fs from "node:fs";
+import * as path from "node:path";
+import * as crypto from "node:crypto";
+import { EventTypes, } from "../types.js";
+/**
+ * Maximum retry attempts for atomic operations
+ */
+const MAX_RETRIES = 10;
+const RETRY_DELAY_MS = 50;
+/**
+ * Error result factories for type-safe error handling
+ */
+function createEmitEventError(runId, type, error) {
+    return {
+        status: "error",
+        operation: "emit-event",
+        event_id: 0,
+        type: type === "unknown" ? "workflow_error" : type,
+        run_id: runId,
+        timestamp: new Date().toISOString(),
+        event_path: "",
+        error,
+    };
+}
+function createGetRunError(runId, error) {
+    return {
+        status: "error",
+        operation: "get-run",
+        run_id: runId,
+        metadata: null,
+        state: null,
+        error,
+    };
+}
+function createConsolidateError(runId, error) {
+    return {
+        status: "error",
+        operation: "consolidate-events",
+        run_id: runId,
+        events_consolidated: 0,
+        output_path: "",
+        size_bytes: 0,
+        error,
+    };
+}
+export class LocalFilesBackend {
+    basePath;
+    resolvedBasePath;
+    constructor(basePath) {
+        this.basePath = basePath;
+        // Resolve the base path once for path traversal protection
+        this.resolvedBasePath = path.resolve(basePath);
+    }
+    /**
+     * Validate run_id format - strict validation to prevent edge cases
+     * - org and project must start and end with alphanumeric
+     * - uuid must be valid format
+     */
+    validateRunId(runId) {
+        // Stricter regex: no leading/trailing underscores or hyphens in org/project
+        return /^[a-z0-9][a-z0-9_-]*[a-z0-9]\/[a-z0-9][a-z0-9_-]*[a-z0-9]\/[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}$/.test(runId) || /^[a-z0-9]\/[a-z0-9]\/[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}$/.test(runId);
+    }
+    /**
+     * Get the directory path for a run with path traversal protection
+     */
+    getRunDir(runId) {
+        const runDir = path.join(this.basePath, runId);
+        const resolvedRunDir = path.resolve(runDir);
+        // Path traversal protection: ensure resolved path is within base path
+        if (!resolvedRunDir.startsWith(this.resolvedBasePath + path.sep)) {
+            throw new Error(`Path traversal attempt detected: ${runId}`);
+        }
+        return runDir;
+    }
+    /**
+     * Get the events directory for a run
+     */
+    getEventsDir(runId) {
+        return path.join(this.getRunDir(runId), "events");
+    }
+    /**
+     * Generate ISO timestamp with milliseconds for consistency
+     */
+    getTimestamp() {
+        return new Date().toISOString();
+    }
+    /**
+     * Sleep helper for retry backoff
+     */
+    sleep(ms) {
+        return new Promise((resolve) => setTimeout(resolve, ms));
+    }
+    /**
+     * Get next event ID atomically using atomic rename pattern
+     *
+     * This approach is more reliable than file locking:
+     * 1. Read current ID
+     * 2. Write new ID to temp file with random suffix
+     * 3. Atomically rename temp file to target
+     * 4. If rename fails due to race, retry with exponential backoff
+     */
+    async getNextEventId(runId) {
+        const eventsDir = this.getEventsDir(runId);
+        const nextIdFile = path.join(eventsDir, ".next-id");
+        for (let attempt = 0; attempt < MAX_RETRIES; attempt++) {
+            try {
+                // Read current ID
+                let currentId = 1;
+                if (fs.existsSync(nextIdFile)) {
+                    const content = fs.readFileSync(nextIdFile, "utf-8").trim();
+                    currentId = parseInt(content, 10) || 1;
+                }
+                const nextId = currentId + 1;
+                // Write to temp file with unique suffix
+                const tempFile = `${nextIdFile}.${crypto.randomBytes(8).toString("hex")}`;
+                fs.writeFileSync(tempFile, String(nextId), { flag: "wx" });
+                try {
+                    // Atomic rename - this is the critical section
+                    fs.renameSync(tempFile, nextIdFile);
+                    return currentId;
+                }
+                catch (renameErr) {
+                    // Cleanup temp file if rename failed
+                    try {
+                        fs.unlinkSync(tempFile);
+                    }
+                    catch {
+                        // Ignore cleanup errors
+                    }
+                    // If rename failed, another process won - retry
+                    if (attempt < MAX_RETRIES - 1) {
+                        await this.sleep(RETRY_DELAY_MS * (attempt + 1));
+                        continue;
+                    }
+                    throw renameErr;
+                }
+            }
+            catch (err) {
+                if (err.code === "EEXIST" &&
+                    attempt < MAX_RETRIES - 1) {
+                    // Temp file already exists, retry
+                    await this.sleep(RETRY_DELAY_MS * (attempt + 1));
+                    continue;
+                }
+                throw err;
+            }
+        }
+        throw new Error(`Failed to acquire event ID after ${MAX_RETRIES} attempts`);
+    }
+    /**
+     * Update state.json atomically - CRITICAL operation
+     * Throws on failure to ensure state consistency
+     */
+    updateState(runDir, eventId, timestamp) {
+        const stateFile = path.join(runDir, "state.json");
+        if (!fs.existsSync(stateFile)) {
+            throw new Error(`State file not found: ${stateFile}`);
+        }
+        const state = JSON.parse(fs.readFileSync(stateFile, "utf-8"));
+        state.last_event_id = eventId;
+        state.updated_at = timestamp;
+        // Write to temp file first
+        const tempFile = `${stateFile}.${crypto.randomBytes(8).toString("hex")}`;
+        fs.writeFileSync(tempFile, JSON.stringify(state, null, 2));
+        // Atomic rename
+        try {
+            fs.renameSync(tempFile, stateFile);
+        }
+        catch (err) {
+            // Cleanup temp file
+            try {
+                fs.unlinkSync(tempFile);
+            }
+            catch {
+                // Ignore cleanup errors
+            }
+            throw new Error(`Failed to update state file: ${err.message}`);
+        }
+    }
+    /**
+     * Emit a workflow event
+     */
+    async emitEvent(eventData) {
+        const { run_id } = eventData;
+        // Validate run_id
+        if (!run_id || !this.validateRunId(run_id)) {
+            return createEmitEventError(run_id || "", eventData.type || "unknown", "Invalid or missing run_id");
+        }
+        // Validate event type
+        if (!eventData.type || !EventTypes.includes(eventData.type)) {
+            return createEmitEventError(run_id, "unknown", `Invalid event type: ${eventData.type}`);
+        }
+        // Get run directory with path traversal protection
+        let runDir;
+        try {
+            runDir = this.getRunDir(run_id);
+        }
+        catch (err) {
+            return createEmitEventError(run_id, eventData.type, err.message);
+        }
+        // Check run directory exists
+        if (!fs.existsSync(runDir)) {
+            return createEmitEventError(run_id, eventData.type, `Run directory not found: ${runDir}`);
+        }
+        // Get next event ID atomically
+        let eventId;
+        try {
+            eventId = await this.getNextEventId(run_id);
+        }
+        catch (err) {
+            return createEmitEventError(run_id, eventData.type, `Failed to get event ID: ${err.message}`);
+        }
+        const timestamp = this.getTimestamp();
+        // Build complete event
+        const event = {
+            event_id: eventId,
+            type: eventData.type,
+            timestamp,
+            run_id,
+            ...(eventData.phase && { phase: eventData.phase }),
+            ...(eventData.step && { step: eventData.step }),
+            ...(eventData.status && { status: eventData.status }),
+            user: eventData.user || process.env.USER || "unknown",
+            source: eventData.source || "mcp-gateway",
+            ...(eventData.message && { message: eventData.message }),
+            ...(eventData.duration_ms && { duration_ms: eventData.duration_ms }),
+            ...(eventData.metadata && { metadata: eventData.metadata }),
+            ...(eventData.artifacts && { artifacts: eventData.artifacts }),
+            ...(eventData.error && { error: eventData.error }),
+        };
+        // Write event file
+        const eventsDir = this.getEventsDir(run_id);
+        const eventFilename = `${String(eventId).padStart(3, "0")}-${eventData.type}.json`;
+        const eventPath = path.join(eventsDir, eventFilename);
+        fs.writeFileSync(eventPath, JSON.stringify(event, null, 2));
+        // Update state.json - CRITICAL: throws on failure
+        try {
+            this.updateState(runDir, eventId, timestamp);
+        }
+        catch (err) {
+            return createEmitEventError(run_id, eventData.type, `Event written but state update failed: ${err.message}`);
+        }
+        return {
+            status: "success",
+            operation: "emit-event",
+            event_id: eventId,
+            type: eventData.type,
+            run_id,
+            timestamp,
+            event_path: eventPath,
+        };
+    }
+    /**
+     * Get run state and metadata
+     */
+    async getRun(runId, includeEvents = false) {
+        if (!this.validateRunId(runId)) {
+            return createGetRunError(runId, "Invalid run_id format");
+        }
+        let runDir;
+        try {
+            runDir = this.getRunDir(runId);
+        }
+        catch (err) {
+            return createGetRunError(runId, err.message);
+        }
+        if (!fs.existsSync(runDir)) {
+            return createGetRunError(runId, "Run not found");
+        }
+        const metadataFile = path.join(runDir, "metadata.json");
+        const stateFile = path.join(runDir, "state.json");
+        try {
+            const metadata = JSON.parse(fs.readFileSync(metadataFile, "utf-8"));
+            const state = JSON.parse(fs.readFileSync(stateFile, "utf-8"));
+            const result = {
+                status: "success",
+                operation: "get-run",
+                run_id: runId,
+                metadata,
+                state,
+            };
+            if (includeEvents) {
+                const eventsDir = this.getEventsDir(runId);
+                if (fs.existsSync(eventsDir)) {
+                    const eventFiles = fs
+                        .readdirSync(eventsDir)
+                        .filter((f) => f.endsWith(".json"));
+                    result.event_count = eventFiles.length;
+                }
+                else {
+                    result.event_count = 0;
+                }
+            }
+            return result;
+        }
+        catch (err) {
+            return createGetRunError(runId, `Failed to read run data: ${err.message}`);
+        }
+    }
+    /**
+     * Get events for a run with streaming support for large event sets
+     * Uses a generator pattern to avoid loading all events into memory
+     */
+    async *getEventsStream(runId) {
+        if (!this.validateRunId(runId)) {
+            return;
+        }
+        let eventsDir;
+        try {
+            eventsDir = this.getEventsDir(runId);
+        }
+        catch {
+            return;
+        }
+        if (!fs.existsSync(eventsDir)) {
+            return;
+        }
+        const eventFiles = fs
+            .readdirSync(eventsDir)
+            .filter((f) => f.endsWith(".json"))
+            .sort();
+        for (const file of eventFiles) {
+            try {
+                const content = fs.readFileSync(path.join(eventsDir, file), "utf-8");
+                yield JSON.parse(content);
+            }
+            catch {
+                // Skip invalid event files
+                continue;
+            }
+        }
+    }
+    /**
+     * Get all events for a run (for backward compatibility)
+     * For large event sets, prefer getEventsStream
+     */
+    async getEvents(runId) {
+        const events = [];
+        for await (const event of this.getEventsStream(runId)) {
+            events.push(event);
+        }
+        return events;
+    }
+    /**
+     * List runs with optional filters
+     * Uses an index file for performance when available
+     */
+    async listRuns(filters) {
+        const { work_id, status, org, project, limit = 20 } = filters;
+        const runs = [];
+        // Check if base path exists
+        if (!fs.existsSync(this.basePath)) {
+            return {
+                status: "success",
+                operation: "list-runs",
+                runs: [],
+                total: 0,
+            };
+        }
+        // Check for index file (optimization for large run counts)
+        const indexFile = path.join(this.basePath, ".runs-index.json");
+        if (fs.existsSync(indexFile)) {
+            try {
+                const index = JSON.parse(fs.readFileSync(indexFile, "utf-8"));
+                let filtered = index;
+                if (org) {
+                    filtered = filtered.filter((r) => r.run_id.startsWith(`${org}/`));
+                }
+                if (project && org) {
+                    filtered = filtered.filter((r) => r.run_id.startsWith(`${org}/${project}/`));
+                }
+                if (work_id) {
+                    filtered = filtered.filter((r) => r.work_id === work_id);
+                }
+                if (status) {
+                    filtered = filtered.filter((r) => r.status === status);
+                }
+                return {
+                    status: "success",
+                    operation: "list-runs",
+                    runs: filtered.slice(0, limit),
+                    total: filtered.length,
+                };
+            }
+            catch {
+                // Fall through to directory traversal if index is invalid
+            }
+        }
+        // Directory traversal fallback
+        try {
+            const orgs = fs.readdirSync(this.basePath);
+            for (const orgName of orgs) {
+                // Skip hidden files and index
+                if (orgName.startsWith("."))
+                    continue;
+                if (org && orgName !== org)
+                    continue;
+                const orgDir = path.join(this.basePath, orgName);
+                if (!fs.statSync(orgDir).isDirectory())
+                    continue;
+                const projects = fs.readdirSync(orgDir);
+                for (const projectName of projects) {
+                    if (projectName.startsWith("."))
+                        continue;
+                    if (project && projectName !== project)
+                        continue;
+                    const projectDir = path.join(orgDir, projectName);
+                    if (!fs.statSync(projectDir).isDirectory())
+                        continue;
+                    const uuids = fs.readdirSync(projectDir);
+                    for (const uuid of uuids) {
+                        if (uuid.startsWith("."))
+                            continue;
+                        const runDir = path.join(projectDir, uuid);
+                        if (!fs.statSync(runDir).isDirectory())
+                            continue;
+                        const stateFile = path.join(runDir, "state.json");
+                        if (!fs.existsSync(stateFile))
+                            continue;
+                        try {
+                            const state = JSON.parse(fs.readFileSync(stateFile, "utf-8"));
+                            // Apply filters
+                            if (work_id && state.work_id !== work_id)
+                                continue;
+                            if (status && state.status !== status)
+                                continue;
+                            runs.push({
+                                run_id: `${orgName}/${projectName}/${uuid}`,
+                                work_id: state.work_id,
+                                status: state.status,
+                                created_at: state.started_at || state.updated_at,
+                                updated_at: state.updated_at,
+                                completed_at: state.completed_at,
+                                current_phase: state.current_phase,
+                            });
+                        }
+                        catch {
+                            // Skip invalid state files
+                            continue;
+                        }
+                    }
+                }
+            }
+        }
+        catch (err) {
+            return {
+                status: "error",
+                operation: "list-runs",
+                runs: [],
+                total: 0,
+                error: `Failed to list runs: ${err.message}`,
+            };
+        }
+        // Sort by created_at descending
+        runs.sort((a, b) => new Date(b.created_at).getTime() - new Date(a.created_at).getTime());
+        return {
+            status: "success",
+            operation: "list-runs",
+            runs: runs.slice(0, limit),
+            total: runs.length,
+        };
+    }
+    /**
+     * Consolidate events to JSONL format using streaming
+     * Avoids loading all events into memory
+     */
+    async consolidateEvents(runId) {
+        if (!this.validateRunId(runId)) {
+            return createConsolidateError(runId, "Invalid run_id format");
+        }
+        let runDir;
+        try {
+            runDir = this.getRunDir(runId);
+        }
+        catch (err) {
+            return createConsolidateError(runId, err.message);
+        }
+        if (!fs.existsSync(runDir)) {
+            return createConsolidateError(runId, "Run not found");
+        }
+        const outputPath = path.join(runDir, "events.jsonl");
+        const tempPath = `${outputPath}.${crypto.randomBytes(8).toString("hex")}`;
+        let eventCount = 0;
+        try {
+            // Use write stream for memory efficiency
+            const writeStream = fs.createWriteStream(tempPath);
+            for await (const event of this.getEventsStream(runId)) {
+                writeStream.write(JSON.stringify(event) + "\n");
+                eventCount++;
+            }
+            // Close the stream and wait for completion
+            await new Promise((resolve, reject) => {
+                writeStream.on("finish", resolve);
+                writeStream.on("error", reject);
+                writeStream.end();
+            });
+            // Atomic rename
+            fs.renameSync(tempPath, outputPath);
+            const stats = fs.statSync(outputPath);
+            return {
+                status: "success",
+                operation: "consolidate-events",
+                run_id: runId,
+                events_consolidated: eventCount,
+                output_path: outputPath,
+                size_bytes: stats.size,
+            };
+        }
+        catch (err) {
+            // Cleanup temp file on error
+            try {
+                fs.unlinkSync(tempPath);
+            }
+            catch {
+                // Ignore cleanup errors
+            }
+            return createConsolidateError(runId, `Failed to consolidate events: ${err.message}`);
+        }
+    }
+    /**
+     * Update the runs index for faster listing
+     * Should be called after run completion
+     */
+    async updateRunsIndex() {
+        const result = await this.listRuns({ limit: 10000 });
+        if (result.status === "success") {
+            const indexFile = path.join(this.basePath, ".runs-index.json");
+            fs.writeFileSync(indexFile, JSON.stringify(result.runs, null, 2));
+        }
+    }
+}
+//# sourceMappingURL=local-files.js.map

package/dist/backends/local-files.js.map

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

package/dist/backends/s3-archive.d.ts

@@ -0,0 +1,74 @@
+/**
+ * S3 Archive Backend for FABER Event Gateway
+ *
+ * Archives events to S3 for long-term storage and analysis.
+ * Supports consolidation to JSONL format for efficient storage.
+ */
+export interface S3Config {
+    bucket: string;
+    prefix: string;
+    region: string;
+    consolidateOnComplete: boolean;
+    cleanupLocalAfterArchive: boolean;
+}
+export interface ArchiveResult {
+    status: "success" | "error";
+    operation: "archive-to-s3";
+    run_id: string;
+    s3_path: string;
+    files_archived: string[];
+    size_bytes: number;
+    error?: string;
+}
+export declare class S3ArchiveBackend {
+    private config;
+    private localBasePath;
+    constructor(config: S3Config, localBasePath: string);
+    /**
+     * Execute AWS CLI command
+     */
+    private execAwsCli;
+    /**
+     * Get S3 path for a run
+     */
+    private getS3Path;
+    /**
+     * Get local run directory
+     */
+    private getLocalRunDir;
+    /**
+     * Archive a completed run to S3
+     */
+    archiveRun(runId: string): Promise<ArchiveResult>;
+    /**
+     * List archived runs in S3
+     */
+    listArchivedRuns(filters?: {
+        org?: string;
+        project?: string;
+        limit?: number;
+    }): Promise<{
+        status: "success" | "error";
+        runs: Array<{
+            run_id: string;
+            s3_path: string;
+            size_bytes: number;
+        }>;
+        error?: string;
+    }>;
+    /**
+     * Restore a run from S3 to local storage
+     */
+    restoreRun(runId: string): Promise<{
+        status: "success" | "error";
+        run_id: string;
+        local_path: string;
+        files_restored: string[];
+        error?: string;
+    }>;
+    /**
+     * Helper to list files recursively
+     */
+    private listFilesRecursive;
+}
+//# sourceMappingURL=s3-archive.d.ts.map

package/dist/backends/s3-archive.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"s3-archive.d.ts","sourceRoot":"","sources":["../../src/backends/s3-archive.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAYH,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,qBAAqB,EAAE,OAAO,CAAC;IAC/B,wBAAwB,EAAE,OAAO,CAAC;CACnC;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC;IAC5B,SAAS,EAAE,eAAe,CAAC;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,qBAAa,gBAAgB;IAEzB,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,aAAa;gBADb,MAAM,EAAE,QAAQ,EAChB,aAAa,EAAE,MAAM;IAG/B;;OAEG;YACW,UAAU;IA2BxB;;OAEG;IACH,OAAO,CAAC,SAAS;IAIjB;;OAEG;IACH,OAAO,CAAC,cAAc;IAItB;;OAEG;IACG,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAuJvD;;OAEG;IACG,gBAAgB,CAAC,OAAO,CAAC,EAAE;QAC/B,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,GAAG,OAAO,CAAC;QACV,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC;QAC5B,IAAI,EAAE,KAAK,CAAC;YAAE,MAAM,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAC;YAAC,UAAU,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QACrE,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;IAwEF;;OAEG;IACG,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;QACvC,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC;QAC5B,MAAM,EAAE,MAAM,CAAC;QACf,UAAU,EAAE,MAAM,CAAC;QACnB,cAAc,EAAE,MAAM,EAAE,CAAC;QACzB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;IA8EF;;OAEG;IACH,OAAO,CAAC,kBAAkB;CAe3B"}