@generacy-ai/generacy 0.0.0-preview-20260304013206

package/dist/orchestrator/client.js

@@ -0,0 +1,288 @@
+/**
+ * REST client for orchestrator communication
+ */
+export class OrchestratorClient {
+    baseUrl;
+    timeout;
+    authToken;
+    customHeaders;
+    constructor(options) {
+        this.baseUrl = options.baseUrl.replace(/\/$/, ''); // Remove trailing slash
+        this.timeout = options.timeout ?? 30000;
+        this.authToken = options.authToken ?? process.env['ORCHESTRATOR_TOKEN'];
+        this.customHeaders = options.headers ?? {};
+    }
+    /**
+     * Make an HTTP request to the orchestrator
+     */
+    async request(method, path, body) {
+        const url = `${this.baseUrl}${path}`;
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), this.timeout);
+        try {
+            const headers = {
+                'Content-Type': 'application/json',
+                ...this.customHeaders,
+            };
+            if (this.authToken) {
+                headers['Authorization'] = `Bearer ${this.authToken}`;
+            }
+            const response = await fetch(url, {
+                method,
+                headers,
+                body: body ? JSON.stringify(body) : undefined,
+                signal: controller.signal,
+            });
+            if (!response.ok) {
+                let errorData;
+                try {
+                    const body = await response.json();
+                    // Server wraps errors as { error: { code, message } }
+                    const inner = (body['error'] ?? body);
+                    errorData = {
+                        code: inner.code ?? 'UNKNOWN_ERROR',
+                        message: inner.message ?? response.statusText,
+                        details: inner.details,
+                    };
+                }
+                catch {
+                    errorData = {
+                        code: 'UNKNOWN_ERROR',
+                        message: response.statusText,
+                    };
+                }
+                throw new OrchestratorClientError(errorData.message, errorData.code, response.status, errorData.details);
+            }
+            // Handle empty responses
+            const text = await response.text();
+            if (!text) {
+                return {};
+            }
+            return JSON.parse(text);
+        }
+        finally {
+            clearTimeout(timeoutId);
+        }
+    }
+    /**
+     * Register worker with orchestrator
+     */
+    async register(registration) {
+        return this.request('POST', '/api/workers/register', registration);
+    }
+    /**
+     * Unregister worker from orchestrator
+     */
+    async unregister(workerId) {
+        await this.request('DELETE', `/api/workers/${workerId}`);
+    }
+    /**
+     * Send heartbeat to orchestrator
+     */
+    async heartbeat(data) {
+        return this.request('POST', `/api/workers/${data.workerId}/heartbeat`, data);
+    }
+    /**
+     * Poll for available jobs
+     */
+    async pollForJob(workerId, capabilities) {
+        const params = new URLSearchParams();
+        params.set('workerId', workerId);
+        if (capabilities && capabilities.length > 0) {
+            params.set('capabilities', capabilities.join(','));
+        }
+        return this.request('GET', `/api/jobs/poll?${params.toString()}`);
+    }
+    /**
+     * Update job status
+     */
+    async updateJobStatus(jobId, status, metadata) {
+        await this.request('PUT', `/api/jobs/${jobId}/status`, { status, ...metadata });
+    }
+    /**
+     * Report job result
+     */
+    async reportJobResult(result) {
+        await this.request('POST', `/api/jobs/${result.jobId}/result`, result);
+    }
+    /**
+     * Get job details
+     */
+    async getJob(jobId) {
+        return this.request('GET', `/api/jobs/${jobId}`);
+    }
+    /**
+     * Cancel a job
+     */
+    async cancelJob(jobId, reason) {
+        await this.request('POST', `/api/jobs/${jobId}/cancel`, { reason });
+    }
+    /**
+     * Publish an event for a job
+     */
+    async publishEvent(jobId, event) {
+        return this.request('POST', `/api/jobs/${jobId}/events`, event);
+    }
+    /**
+     * Subscribe to SSE events for a specific job.
+     * Returns an AsyncIterable that yields parsed JobEvent objects.
+     * The stream can be cancelled via AbortSignal or by breaking out of the for-await loop.
+     */
+    async *subscribeEvents(jobId, options) {
+        const url = `${this.baseUrl}/api/jobs/${jobId}/events`;
+        const headers = {
+            ...this.customHeaders,
+        };
+        if (this.authToken) {
+            headers['Authorization'] = `Bearer ${this.authToken}`;
+        }
+        if (options?.lastEventId) {
+            headers['Last-Event-ID'] = options.lastEventId;
+        }
+        const response = await fetch(url, {
+            headers,
+            signal: options?.signal,
+        });
+        if (!response.ok) {
+            let errorData;
+            try {
+                errorData = await response.json();
+            }
+            catch {
+                errorData = {
+                    code: 'UNKNOWN_ERROR',
+                    message: response.statusText,
+                };
+            }
+            throw new OrchestratorClientError(errorData.message, errorData.code, response.status, errorData.details);
+        }
+        yield* this.parseSSEStream(response, options?.signal);
+    }
+    /**
+     * Subscribe to SSE events for all jobs, optionally filtered.
+     * Returns an AsyncIterable that yields parsed JobEvent objects.
+     * The stream can be cancelled via AbortSignal or by breaking out of the for-await loop.
+     */
+    async *subscribeAllEvents(options) {
+        // Build query string from filters
+        const params = new URLSearchParams();
+        if (options?.filters?.tags && options.filters.tags.length > 0) {
+            params.set('tags', options.filters.tags.join(','));
+        }
+        if (options?.filters?.workflow) {
+            params.set('workflow', options.filters.workflow);
+        }
+        if (options?.filters?.status && options.filters.status.length > 0) {
+            params.set('status', options.filters.status.join(','));
+        }
+        const queryString = params.toString();
+        const url = `${this.baseUrl}/api/events${queryString ? `?${queryString}` : ''}`;
+        const headers = {
+            ...this.customHeaders,
+        };
+        if (this.authToken) {
+            headers['Authorization'] = `Bearer ${this.authToken}`;
+        }
+        if (options?.lastEventId) {
+            headers['Last-Event-ID'] = options.lastEventId;
+        }
+        const response = await fetch(url, {
+            headers,
+            signal: options?.signal,
+        });
+        if (!response.ok) {
+            let errorData;
+            try {
+                errorData = await response.json();
+            }
+            catch {
+                errorData = {
+                    code: 'UNKNOWN_ERROR',
+                    message: response.statusText,
+                };
+            }
+            throw new OrchestratorClientError(errorData.message, errorData.code, response.status, errorData.details);
+        }
+        yield* this.parseSSEStream(response, options?.signal);
+    }
+    /**
+     * Parse an SSE response stream into JobEvent objects.
+     * Handles `event:`, `id:`, `data:` fields and skips comment lines (heartbeats).
+     */
+    async *parseSSEStream(response, signal) {
+        const body = response.body;
+        if (!body)
+            return;
+        const reader = body.getReader();
+        const decoder = new TextDecoder();
+        let buffer = '';
+        let currentData = '';
+        // event and id fields tracked for completeness but data carries the full JobEvent
+        let _currentEvent = '';
+        let _currentId = '';
+        try {
+            while (true) {
+                if (signal?.aborted)
+                    break;
+                const { done, value } = await reader.read();
+                if (done)
+                    break;
+                buffer += decoder.decode(value, { stream: true });
+                // Process complete lines
+                const lines = buffer.split('\n');
+                // Keep the last potentially incomplete line in the buffer
+                buffer = lines.pop() ?? '';
+                for (const line of lines) {
+                    if (line === '') {
+                        // Empty line = end of event block — dispatch if we have data
+                        if (currentData) {
+                            try {
+                                const event = JSON.parse(currentData);
+                                yield event;
+                            }
+                            catch {
+                                // Malformed data, skip
+                            }
+                        }
+                        // Reset fields for next event
+                        currentData = '';
+                        _currentEvent = '';
+                        _currentId = '';
+                    }
+                    else if (line.startsWith(':')) {
+                        // Comment line (e.g. heartbeat `: ping`) — skip
+                    }
+                    else if (line.startsWith('data:')) {
+                        currentData = line.slice(5).trimStart();
+                    }
+                    else if (line.startsWith('event:')) {
+                        _currentEvent = line.slice(6).trimStart();
+                    }
+                    else if (line.startsWith('id:')) {
+                        _currentId = line.slice(3).trimStart();
+                    }
+                    // Other fields (retry:, etc.) are ignored
+                }
+            }
+        }
+        finally {
+            reader.releaseLock();
+        }
+    }
+}
+/**
+ * Error class for orchestrator client errors
+ */
+export class OrchestratorClientError extends Error {
+    code;
+    statusCode;
+    details;
+    constructor(message, code, statusCode, details) {
+        super(message);
+        this.code = code;
+        this.statusCode = statusCode;
+        this.details = details;
+        this.name = 'OrchestratorClientError';
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/orchestrator/client.js.map

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

package/dist/orchestrator/event-bus.d.ts

@@ -0,0 +1,195 @@
+/**
+ * EventBus module for SSE event buffering and broadcasting.
+ */
+import type { ServerResponse } from 'node:http';
+import type { JobEvent, EventFilters } from './types.js';
+import type { JobQueue } from './job-queue.js';
+import type { LogBufferManager } from './log-buffer.js';
+/**
+ * A fixed-capacity circular buffer that evicts oldest items when full.
+ *
+ * Tracks a `baseIndex` representing the total number of items ever evicted,
+ * so callers can map external IDs (like monotonic counters) to buffer positions.
+ */
+export declare class RingBuffer<T> {
+    private readonly _capacity;
+    private readonly buffer;
+    private head;
+    private _size;
+    private _baseIndex;
+    constructor(capacity?: number);
+    /** Number of items currently in the buffer. */
+    get size(): number;
+    /** Maximum number of items the buffer can hold. */
+    get capacity(): number;
+    /**
+     * The number of items that have been evicted over the buffer's lifetime.
+     * An item inserted at logical index N is at buffer position (N - baseIndex).
+     */
+    get baseIndex(): number;
+    /**
+     * Push an item into the buffer. O(1).
+     * When the buffer is full the oldest item is evicted.
+     */
+    push(item: T): void;
+    /**
+     * Return all buffered items in insertion order.
+     */
+    getAll(): T[];
+    /**
+     * Return all items whose logical index is strictly greater than `startIndex`.
+     *
+     * Logical index = baseIndex + position-in-current-buffer.
+     * The first item currently in the buffer has logical index `baseIndex`,
+     * the second has `baseIndex + 1`, etc.
+     *
+     * If `startIndex` is before the buffer's range (i.e. already evicted),
+     * all buffered items are returned.
+     */
+    getAfterIndex(startIndex: number): T[];
+    /**
+     * Remove all items and reset state.
+     */
+    clear(): void;
+}
+/**
+ * Configuration options for the EventBus.
+ */
+export interface EventBusOptions {
+    /** Per-job ring buffer capacity (default: 1000) */
+    bufferSize?: number;
+    /** Milliseconds to keep buffers after a job reaches terminal state (default: 300000 / 5 min) */
+    gracePeriod?: number;
+    /** Milliseconds between SSE heartbeat pings (default: 30000 / 30s) */
+    heartbeatInterval?: number;
+    /** Job queue used for filter evaluation on global subscribers */
+    jobQueue: JobQueue;
+    /** Optional LogBufferManager for routing log:append events to a separate buffer */
+    logBufferManager?: LogBufferManager;
+    /** Optional logger */
+    logger?: {
+        info: (message: string, data?: Record<string, unknown>) => void;
+        warn: (message: string, data?: Record<string, unknown>) => void;
+        error: (message: string, data?: Record<string, unknown>) => void;
+    };
+}
+/**
+ * EventBus handles event buffering (per-job ring buffers) and broadcasting
+ * to SSE subscribers. It is the core publish/subscribe component for
+ * real-time job event streaming.
+ */
+export declare class EventBus {
+    /** Per-job ring buffers */
+    private readonly buffers;
+    /** Per-job monotonic ID counters */
+    private readonly counters;
+    /** Per-job SSE subscriber connections */
+    private readonly subscribers;
+    /** Global SSE subscriber connections with filters */
+    private readonly globalSubscribers;
+    /** Grace period cleanup timers for terminal jobs */
+    private readonly cleanupTimers;
+    private readonly bufferSize;
+    private readonly gracePeriod;
+    private readonly heartbeatInterval;
+    private readonly jobQueue;
+    private readonly logBufferManager?;
+    private readonly logger?;
+    private heartbeatTimer;
+    constructor(options: EventBusOptions);
+    /**
+     * Publish an event for a job.
+     *
+     * Assigns a monotonic string ID, buffers the event in the job's ring buffer,
+     * and broadcasts to all per-job and matching global subscribers.
+     *
+     * Global subscribers are filtered by looking up the job's current metadata
+     * from the job queue. Filters combine with AND logic:
+     * - `tags`: job must have at least one matching tag
+     * - `workflow`: job's workflow must match (string comparison)
+     * - `status`: job's current status must be in the filter list
+     */
+    publish(jobId: string, event: Omit<JobEvent, 'id'>): Promise<JobEvent>;
+    /**
+     * Subscribe to a single job's event stream.
+     *
+     * If `lastEventId` is provided, replays buffered events after that ID
+     * before switching to live mode. If the ID is not found in the buffer,
+     * all buffered events are replayed.
+     *
+     * Automatically unsubscribes when the response connection closes.
+     */
+    subscribe(jobId: string, res: ServerResponse, lastEventId?: string): void;
+    /**
+     * Subscribe to events from all jobs, optionally filtered.
+     *
+     * If `lastEventId` is provided (format `{jobId}:{counter}`), replays
+     * buffered events after that ID from the specified job's buffer, then
+     * replays all buffered events from other jobs' buffers (filtered).
+     *
+     * Filter matching is applied during replay: only events from jobs that
+     * match the subscriber's filters are sent.
+     */
+    subscribeAll(res: ServerResponse, filters: EventFilters, lastEventId?: string): Promise<void>;
+    /**
+     * Remove a response from all subscriber sets (per-job and global).
+     */
+    unsubscribe(res: ServerResponse): void;
+    /**
+     * Schedule cleanup of a job's buffers and subscriber data after the grace period.
+     */
+    scheduleCleanup(jobId: string): void;
+    /**
+     * Close all per-job SSE connections for a job.
+     * Sends `res.end()` to each subscriber and removes them from the set.
+     */
+    closeJobSubscribers(jobId: string): void;
+    /**
+     * Return all buffered events for a job (for replay-and-close on terminal jobs).
+     */
+    getBufferedEvents(jobId: string): JobEvent[];
+    /**
+     * Start the heartbeat interval that sends `: ping\n\n` to all active SSE connections.
+     */
+    startHeartbeat(): void;
+    /**
+     * Stop the heartbeat interval.
+     */
+    stopHeartbeat(): void;
+    /**
+     * Clean shutdown: stop heartbeat, clear all timers, close all connections, clear state.
+     */
+    destroy(): void;
+    /**
+     * Replay events from a specific job's buffer after a given counter value,
+     * applying filter matching. Returns true if the connection died during replay.
+     */
+    private replayJobBuffer;
+    /**
+     * Send a list of events to a global subscriber, applying filter matching.
+     * Returns true if the connection died during replay (subscriber was removed).
+     */
+    private replayEventsFiltered;
+    /**
+     * Check whether any global subscriber has at least one filter set.
+     * Used to skip the async job lookup when no filters are active.
+     */
+    private anySubscriberHasFilters;
+    /**
+     * Evaluate whether a job matches a subscriber's filters.
+     *
+     * All specified filters combine with AND logic:
+     * - `tags`: job must have at least one matching tag
+     * - `workflow`: job's workflow must match (string comparison)
+     * - `status`: job's current status must be in the filter list
+     *
+     * If no filters are set (all fields undefined/empty), the event always matches.
+     * If the job is null (not found), events are skipped for subscribers with filters.
+     */
+    private matchesFilters;
+    /**
+     * Internal helper to remove a ServerResponse from all subscriber sets.
+     */
+    private removeSubscriber;
+}
+//# sourceMappingURL=event-bus.d.ts.map

package/dist/orchestrator/event-bus.d.ts.map

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