@generacy-ai/orchestrator 0.0.0-preview-20260304013206

package/dist/services/queue-service.d.ts

@@ -0,0 +1,62 @@
+import type { CreateDecisionRequest, DecisionQueueItem, DecisionResponse, DecisionResponseRequest, DecisionPriority, QueueQuery } from '../types/index.js';
+/**
+ * Message router interface (facade over internal message router)
+ * This will be implemented by the actual MessageRouter from #5
+ */
+export interface MessageRouter {
+    getQueue(query?: QueueQuery): Promise<DecisionQueueItem[]>;
+    getDecision(id: string): Promise<DecisionQueueItem | null>;
+    createDecision(request: CreateDecisionRequest): Promise<DecisionQueueItem>;
+    respondToDecision(id: string, response: DecisionResponseRequest, respondedBy: string): Promise<DecisionResponse>;
+}
+/**
+ * In-memory queue store for development/testing
+ */
+export declare class InMemoryQueueStore implements MessageRouter {
+    private queue;
+    private responses;
+    getQueue(query?: QueueQuery): Promise<DecisionQueueItem[]>;
+    getDecision(id: string): Promise<DecisionQueueItem | null>;
+    createDecision(request: CreateDecisionRequest): Promise<DecisionQueueItem>;
+    respondToDecision(id: string, request: DecisionResponseRequest, respondedBy: string): Promise<DecisionResponse>;
+    /**
+     * Add a decision to the queue (for testing)
+     */
+    addDecision(decision: DecisionQueueItem): void;
+    /**
+     * Clear all decisions (for testing)
+     */
+    clear(): void;
+    /**
+     * Get queue size (for testing)
+     */
+    size(): number;
+}
+/**
+ * Queue service - facade over message router
+ */
+export declare class QueueService {
+    private router;
+    constructor(router: MessageRouter);
+    /**
+     * Get all pending decisions
+     */
+    getQueue(query?: QueueQuery): Promise<DecisionQueueItem[]>;
+    /**
+     * Create a new decision in the queue
+     */
+    createDecision(request: CreateDecisionRequest): Promise<DecisionQueueItem>;
+    /**
+     * Get a specific decision by ID
+     */
+    getDecision(id: string): Promise<DecisionQueueItem>;
+    /**
+     * Respond to a decision
+     */
+    respond(id: string, request: DecisionResponseRequest, respondedBy: string): Promise<DecisionResponse>;
+    /**
+     * Get count of pending decisions by priority
+     */
+    getQueueStats(): Promise<Record<DecisionPriority, number>>;
+}
+//# sourceMappingURL=queue-service.d.ts.map

package/dist/services/queue-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue-service.d.ts","sourceRoot":"","sources":["../../src/services/queue-service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,qBAAqB,EACrB,iBAAiB,EACjB,gBAAgB,EAChB,uBAAuB,EACvB,gBAAgB,EAChB,UAAU,EACX,MAAM,mBAAmB,CAAC;AAG3B;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,KAAK,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAAC;IAC3D,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAAC;IAC3D,cAAc,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAC3E,iBAAiB,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,uBAAuB,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;CAClH;AAED;;GAEG;AACH,qBAAa,kBAAmB,YAAW,aAAa;IACtD,OAAO,CAAC,KAAK,CAA6C;IAC1D,OAAO,CAAC,SAAS,CAA4C;IAEvD,QAAQ,CAAC,KAAK,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;IA6B1D,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC;IAI1D,cAAc,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAkB1E,iBAAiB,CACrB,EAAE,EAAE,MAAM,EACV,OAAO,EAAE,uBAAuB,EAChC,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,gBAAgB,CAAC;IA8B5B;;OAEG;IACH,WAAW,CAAC,QAAQ,EAAE,iBAAiB,GAAG,IAAI;IAI9C;;OAEG;IACH,KAAK,IAAI,IAAI;IAKb;;OAEG;IACH,IAAI,IAAI,MAAM;CAGf;AAED;;GAEG;AACH,qBAAa,YAAY;IACX,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,aAAa;IAEzC;;OAEG;IACG,QAAQ,CAAC,KAAK,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAIhE;;OAEG;IACG,cAAc,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAIhF;;OAEG;IACG,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAQzD;;OAEG;IACG,OAAO,CACX,EAAE,EAAE,MAAM,EACV,OAAO,EAAE,uBAAuB,EAChC,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,gBAAgB,CAAC;IAI5B;;OAEG;IACG,aAAa,IAAI,OAAO,CAAC,MAAM,CAAC,gBAAgB,EAAE,MAAM,CAAC,CAAC;CAcjE"}

package/dist/services/queue-service.js

@@ -0,0 +1,147 @@
+import { Errors } from '../middleware/error-handler.js';
+/**
+ * In-memory queue store for development/testing
+ */
+export class InMemoryQueueStore {
+    queue = new Map();
+    responses = new Map();
+    async getQueue(query) {
+        let items = Array.from(this.queue.values());
+        // Filter by priority
+        if (query?.priority) {
+            items = items.filter((item) => item.priority === query.priority);
+        }
+        // Filter by workflow
+        if (query?.workflowId) {
+            items = items.filter((item) => item.workflowId === query.workflowId);
+        }
+        // Sort by priority (blocking_now first) and creation date
+        const priorityOrder = {
+            blocking_now: 0,
+            blocking_soon: 1,
+            when_available: 2,
+        };
+        items.sort((a, b) => {
+            const priorityDiff = priorityOrder[a.priority] - priorityOrder[b.priority];
+            if (priorityDiff !== 0)
+                return priorityDiff;
+            return new Date(a.createdAt).getTime() - new Date(b.createdAt).getTime();
+        });
+        return items;
+    }
+    async getDecision(id) {
+        return this.queue.get(id) ?? null;
+    }
+    async createDecision(request) {
+        const item = {
+            id: crypto.randomUUID(),
+            workflowId: request.workflowId,
+            stepId: request.stepId,
+            type: request.type,
+            prompt: request.prompt,
+            options: request.options,
+            context: request.context,
+            priority: request.priority,
+            createdAt: new Date().toISOString(),
+            expiresAt: request.expiresAt ?? null,
+        };
+        this.queue.set(item.id, item);
+        return item;
+    }
+    async respondToDecision(id, request, respondedBy) {
+        const decision = this.queue.get(id);
+        if (!decision) {
+            throw Errors.notFound(`Decision ${id} not found`);
+        }
+        // Check if already responded
+        if (this.responses.has(id)) {
+            throw Errors.conflict(`Decision ${id} has already been responded to`);
+        }
+        // Check expiration
+        if (decision.expiresAt && new Date(decision.expiresAt) < new Date()) {
+            throw Errors.conflict(`Decision ${id} has expired`);
+        }
+        const response = {
+            id,
+            response: request.response,
+            comment: request.comment,
+            respondedBy,
+            respondedAt: new Date().toISOString(),
+        };
+        this.responses.set(id, response);
+        this.queue.delete(id);
+        return response;
+    }
+    /**
+     * Add a decision to the queue (for testing)
+     */
+    addDecision(decision) {
+        this.queue.set(decision.id, decision);
+    }
+    /**
+     * Clear all decisions (for testing)
+     */
+    clear() {
+        this.queue.clear();
+        this.responses.clear();
+    }
+    /**
+     * Get queue size (for testing)
+     */
+    size() {
+        return this.queue.size;
+    }
+}
+/**
+ * Queue service - facade over message router
+ */
+export class QueueService {
+    router;
+    constructor(router) {
+        this.router = router;
+    }
+    /**
+     * Get all pending decisions
+     */
+    async getQueue(query) {
+        return this.router.getQueue(query);
+    }
+    /**
+     * Create a new decision in the queue
+     */
+    async createDecision(request) {
+        return this.router.createDecision(request);
+    }
+    /**
+     * Get a specific decision by ID
+     */
+    async getDecision(id) {
+        const decision = await this.router.getDecision(id);
+        if (!decision) {
+            throw Errors.notFound(`Decision ${id} not found`);
+        }
+        return decision;
+    }
+    /**
+     * Respond to a decision
+     */
+    async respond(id, request, respondedBy) {
+        return this.router.respondToDecision(id, request, respondedBy);
+    }
+    /**
+     * Get count of pending decisions by priority
+     */
+    async getQueueStats() {
+        const items = await this.router.getQueue();
+        const stats = {
+            blocking_now: 0,
+            blocking_soon: 0,
+            when_available: 0,
+        };
+        for (const item of items) {
+            stats[item.priority]++;
+        }
+        return stats;
+    }
+}
+//# sourceMappingURL=queue-service.js.map

package/dist/services/queue-service.js.map

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

package/dist/services/redis-queue-adapter.d.ts

@@ -0,0 +1,35 @@
+import type { Redis } from 'ioredis';
+import type { QueueItem, QueueItemWithScore, QueueManager } from '../types/index.js';
+import type { DispatchConfig } from '../config/index.js';
+interface Logger {
+    info(msg: string): void;
+    info(obj: Record<string, unknown>, msg: string): void;
+    warn(msg: string): void;
+    warn(obj: Record<string, unknown>, msg: string): void;
+    error(msg: string): void;
+    error(obj: Record<string, unknown>, msg: string): void;
+    debug(msg: string): void;
+    debug(obj: Record<string, unknown>, msg: string): void;
+}
+/**
+ * Redis sorted-set backed queue adapter implementing QueueManager.
+ * Uses ZADD for priority ordering and a Lua script for atomic claim.
+ * Gracefully degrades on Redis errors (logs warnings, doesn't crash).
+ */
+export declare class RedisQueueAdapter implements QueueManager {
+    private readonly redis;
+    private readonly logger;
+    private readonly maxRetries;
+    private claimCommandDefined;
+    constructor(redis: Redis, logger: Logger, config?: Pick<DispatchConfig, 'maxRetries'>);
+    private ensureClaimCommand;
+    enqueue(item: QueueItem): Promise<void>;
+    claim(workerId: string): Promise<QueueItem | null>;
+    release(workerId: string, item: QueueItem): Promise<void>;
+    complete(workerId: string, item: QueueItem): Promise<void>;
+    getQueueDepth(): Promise<number>;
+    getQueueItems(offset: number, limit: number): Promise<QueueItemWithScore[]>;
+    getActiveWorkerCount(): Promise<number>;
+}
+export {};
+//# sourceMappingURL=redis-queue-adapter.d.ts.map

package/dist/services/redis-queue-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redis-queue-adapter.d.ts","sourceRoot":"","sources":["../../src/services/redis-queue-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,KAAK,EAAE,SAAS,EAAE,kBAAkB,EAAE,YAAY,EAAuB,MAAM,mBAAmB,CAAC;AAC1G,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AA6BzD,UAAU,MAAM;IACd,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACtD,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACtD,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,KAAK,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACvD,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,KAAK,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;CACxD;AAcD;;;;GAIG;AACH,qBAAa,iBAAkB,YAAW,YAAY;IACpD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAQ;IAC9B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,mBAAmB,CAAS;gBAExB,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,IAAI,CAAC,cAAc,EAAE,YAAY,CAAC;IAMrF,OAAO,CAAC,kBAAkB;IASpB,OAAO,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAsBvC,KAAK,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC;IA4ClD,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAmDzD,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAoB1D,aAAa,IAAI,OAAO,CAAC,MAAM,CAAC;IAShC,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAsC3E,oBAAoB,IAAI,OAAO,CAAC,MAAM,CAAC;CA2B9C"}

package/dist/services/redis-queue-adapter.js

@@ -0,0 +1,218 @@
+const PENDING_KEY = 'orchestrator:queue:pending';
+const CLAIMED_KEY_PREFIX = 'orchestrator:queue:claimed:';
+const HEARTBEAT_KEY_PREFIX = 'orchestrator:worker:';
+const DEAD_LETTER_KEY = 'orchestrator:queue:dead-letter';
+/**
+ * Lua script for atomic claim: ZPOPMIN + HSET claimed + SET heartbeat.
+ * KEYS[1] = pending sorted set
+ * KEYS[2] = claimed hash for this worker
+ * KEYS[3] = heartbeat key for this worker
+ * ARGV[1] = heartbeat TTL in seconds
+ *
+ * Returns the serialized item string, or nil if queue is empty.
+ */
+const CLAIM_SCRIPT = `
+local result = redis.call('ZPOPMIN', KEYS[1], 1)
+if #result == 0 then
+  return nil
+end
+local member = result[1]
+local parsed = cjson.decode(member)
+local itemKey = parsed.itemKey
+redis.call('HSET', KEYS[2], itemKey, member)
+redis.call('SET', KEYS[3], '1', 'EX', tonumber(ARGV[1]))
+return member
+`;
+function buildItemKey(item) {
+    return `${item.owner}/${item.repo}#${item.issueNumber}`;
+}
+function buildClaimedKey(workerId) {
+    return `${CLAIMED_KEY_PREFIX}${workerId}`;
+}
+function buildHeartbeatKey(workerId) {
+    return `${HEARTBEAT_KEY_PREFIX}${workerId}:heartbeat`;
+}
+/**
+ * Redis sorted-set backed queue adapter implementing QueueManager.
+ * Uses ZADD for priority ordering and a Lua script for atomic claim.
+ * Gracefully degrades on Redis errors (logs warnings, doesn't crash).
+ */
+export class RedisQueueAdapter {
+    redis;
+    logger;
+    maxRetries;
+    claimCommandDefined = false;
+    constructor(redis, logger, config) {
+        this.redis = redis;
+        this.logger = logger;
+        this.maxRetries = config?.maxRetries ?? 3;
+    }
+    ensureClaimCommand() {
+        if (this.claimCommandDefined)
+            return;
+        this.redis.defineCommand('claimItem', {
+            numberOfKeys: 3,
+            lua: CLAIM_SCRIPT,
+        });
+        this.claimCommandDefined = true;
+    }
+    async enqueue(item) {
+        const itemKey = buildItemKey(item);
+        const serialized = {
+            ...item,
+            attemptCount: 0,
+            itemKey,
+        };
+        try {
+            await this.redis.zadd(PENDING_KEY, item.priority, JSON.stringify(serialized));
+            this.logger.info({ owner: item.owner, repo: item.repo, issue: item.issueNumber, priority: item.priority }, 'Item enqueued to Redis sorted set');
+        }
+        catch (error) {
+            this.logger.warn({ err: error, itemKey }, 'Redis error in enqueue, item not added to queue');
+        }
+    }
+    async claim(workerId) {
+        this.ensureClaimCommand();
+        const pendingKey = PENDING_KEY;
+        const claimedKey = buildClaimedKey(workerId);
+        const heartbeatKey = buildHeartbeatKey(workerId);
+        const ttlSeconds = Math.ceil(30000 / 1000); // Default; actual TTL managed by dispatcher's heartbeat refresh
+        try {
+            const result = await this.redis.claimItem(pendingKey, claimedKey, heartbeatKey, ttlSeconds);
+            if (!result) {
+                return null;
+            }
+            const serialized = JSON.parse(result);
+            this.logger.info({ workerId, itemKey: serialized.itemKey, attempt: serialized.attemptCount }, 'Item claimed from queue');
+            return {
+                owner: serialized.owner,
+                repo: serialized.repo,
+                issueNumber: serialized.issueNumber,
+                workflowName: serialized.workflowName,
+                command: serialized.command,
+                priority: serialized.priority,
+                enqueuedAt: serialized.enqueuedAt,
+            };
+        }
+        catch (error) {
+            this.logger.warn({ err: error, workerId }, 'Redis error in claim, returning null');
+            return null;
+        }
+    }
+    async release(workerId, item) {
+        const itemKey = buildItemKey(item);
+        const claimedKey = buildClaimedKey(workerId);
+        const heartbeatKey = buildHeartbeatKey(workerId);
+        try {
+            // Get the claimed item to check attempt count
+            const claimedRaw = await this.redis.hget(claimedKey, itemKey);
+            let attemptCount = 0;
+            if (claimedRaw) {
+                const parsed = JSON.parse(claimedRaw);
+                attemptCount = parsed.attemptCount + 1;
+            }
+            // Clean up claimed hash and heartbeat
+            await this.redis.hdel(claimedKey, itemKey);
+            await this.redis.del(heartbeatKey);
+            if (attemptCount >= this.maxRetries) {
+                // Dead-letter: too many retries
+                const deadLetterItem = {
+                    ...item,
+                    attemptCount,
+                    itemKey,
+                };
+                await this.redis.zadd(DEAD_LETTER_KEY, Date.now(), JSON.stringify(deadLetterItem));
+                this.logger.warn({ workerId, itemKey, attemptCount, maxRetries: this.maxRetries }, 'Item dead-lettered after max retries');
+            }
+            else {
+                // Re-queue with original priority
+                const requeueItem = {
+                    ...item,
+                    attemptCount,
+                    itemKey,
+                };
+                await this.redis.zadd(PENDING_KEY, item.priority, JSON.stringify(requeueItem));
+                this.logger.info({ workerId, itemKey, attemptCount }, 'Item released back to pending queue');
+            }
+        }
+        catch (error) {
+            this.logger.warn({ err: error, workerId, itemKey }, 'Redis error in release');
+        }
+    }
+    async complete(workerId, item) {
+        const itemKey = buildItemKey(item);
+        const claimedKey = buildClaimedKey(workerId);
+        const heartbeatKey = buildHeartbeatKey(workerId);
+        try {
+            await this.redis.hdel(claimedKey, itemKey);
+            await this.redis.del(heartbeatKey);
+            this.logger.info({ workerId, itemKey }, 'Item completed and removed from claimed set');
+        }
+        catch (error) {
+            this.logger.warn({ err: error, workerId, itemKey }, 'Redis error in complete');
+        }
+    }
+    async getQueueDepth() {
+        try {
+            return await this.redis.zcard(PENDING_KEY);
+        }
+        catch (error) {
+            this.logger.warn({ err: error }, 'Redis error in getQueueDepth');
+            return 0;
+        }
+    }
+    async getQueueItems(offset, limit) {
+        try {
+            const results = await this.redis.zrange(PENDING_KEY, offset, offset + limit - 1, 'WITHSCORES');
+            const items = [];
+            // Results come as [member, score, member, score, ...]
+            for (let i = 0; i + 1 < results.length; i += 2) {
+                const member = results[i];
+                const scoreStr = results[i + 1];
+                if (!member || !scoreStr)
+                    continue;
+                const serialized = JSON.parse(member);
+                const score = parseFloat(scoreStr);
+                items.push({
+                    item: {
+                        owner: serialized.owner,
+                        repo: serialized.repo,
+                        issueNumber: serialized.issueNumber,
+                        workflowName: serialized.workflowName,
+                        command: serialized.command,
+                        priority: serialized.priority,
+                        enqueuedAt: serialized.enqueuedAt,
+                    },
+                    score,
+                });
+            }
+            return items;
+        }
+        catch (error) {
+            this.logger.warn({ err: error }, 'Redis error in getQueueItems');
+            return [];
+        }
+    }
+    async getActiveWorkerCount() {
+        try {
+            // Scan for all claimed hash keys and sum their lengths
+            const keys = [];
+            let cursor = '0';
+            do {
+                const [nextCursor, matchedKeys] = await this.redis.scan(cursor, 'MATCH', `${CLAIMED_KEY_PREFIX}*`, 'COUNT', 100);
+                cursor = nextCursor;
+                keys.push(...matchedKeys);
+            } while (cursor !== '0');
+            let count = 0;
+            for (const key of keys) {
+                count += await this.redis.hlen(key);
+            }
+            return count;
+        }
+        catch (error) {
+            this.logger.warn({ err: error }, 'Redis error in getActiveWorkerCount');
+            return 0;
+        }
+    }
+}
+//# sourceMappingURL=redis-queue-adapter.js.map

package/dist/services/redis-queue-adapter.js.map

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

package/dist/services/smee-receiver.d.ts

@@ -0,0 +1,87 @@
+/**
+ * Smee.io webhook receiver for GitHub events.
+ *
+ * Connects to a smee.io channel URL via Server-Sent Events (SSE) using
+ * the native fetch API. Receives GitHub webhook payloads forwarded by
+ * smee.io and feeds them into the LabelMonitorService for processing.
+ *
+ * This eliminates the need for polling when a smee channel is configured,
+ * providing near-instant label event detection with zero GitHub API calls.
+ */
+import type { LabelMonitorService } from './label-monitor-service.js';
+interface Logger {
+    info(msg: string): void;
+    info(obj: Record<string, unknown>, msg: string): void;
+    warn(msg: string): void;
+    warn(obj: Record<string, unknown>, msg: string): void;
+    error(msg: string): void;
+    error(obj: Record<string, unknown>, msg: string): void;
+}
+export interface SmeeReceiverOptions {
+    /** The smee.io channel URL */
+    channelUrl: string;
+    /** Set of "owner/repo" strings to filter events */
+    watchedRepos: Set<string>;
+    /**
+     * Base delay before reconnecting after disconnect (ms).
+     * Uses exponential backoff: 5s → 10s → 20s → 40s → 80s → 160s → 300s (capped).
+     * Resets to base delay on successful connection.
+     * @default 5000
+     */
+    baseReconnectDelayMs?: number;
+}
+/**
+ * Receives GitHub webhook events from a smee.io channel via SSE.
+ * Feeds label events directly into the LabelMonitorService.
+ */
+export declare class SmeeWebhookReceiver {
+    private readonly logger;
+    private readonly monitorService;
+    private static readonly BASE_RECONNECT_DELAY_MS;
+    private static readonly MAX_BACKOFF_MS;
+    private readonly channelUrl;
+    private readonly watchedRepos;
+    private readonly baseReconnectDelayMs;
+    private abortController;
+    private running;
+    private reconnectAttempt;
+    constructor(logger: Logger, monitorService: LabelMonitorService, options: SmeeReceiverOptions);
+    /**
+     * Start listening to the smee.io channel.
+     * Automatically reconnects on disconnect.
+     */
+    start(): Promise<void>;
+    /**
+     * Stop the receiver.
+     */
+    stop(): void;
+    /**
+     * Connect to the smee.io channel and process events.
+     */
+    private connect;
+    /**
+     * Parse and process a single SSE event block from smee.io.
+     *
+     * Smee.io SSE events have the format:
+     *   event: message
+     *   data: {"body": <webhook-payload>, "x-github-event": "issues", ...}
+     */
+    private processSSEEvent;
+    /**
+     * Get the current reconnect delay based on the number of attempts.
+     * Uses exponential backoff with the current attempt count.
+     */
+    private get reconnectDelayMs();
+    /**
+     * Calculate exponential backoff delay for reconnection attempts.
+     * Formula: BASE_RECONNECT_DELAY_MS * 2^attempt, capped at MAX_BACKOFF_MS.
+     * Progression: 5s → 10s → 20s → 40s → 80s → 160s → 300s (capped).
+     *
+     * @param attempt - The current reconnection attempt number (0-indexed)
+     * @returns Delay in milliseconds before next reconnection attempt
+     */
+    private calculateBackoffDelay;
+    private sleep;
+}
+export {};
+//# sourceMappingURL=smee-receiver.d.ts.map

package/dist/services/smee-receiver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"smee-receiver.d.ts","sourceRoot":"","sources":["../../src/services/smee-receiver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAGtE,UAAU,MAAM;IACd,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACtD,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACtD,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,KAAK,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;CACxD;AAED,MAAM,WAAW,mBAAmB;IAClC,8BAA8B;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,mDAAmD;IACnD,YAAY,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC1B;;;;;OAKG;IACH,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED;;;GAGG;AACH,qBAAa,mBAAmB;IAY5B,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,cAAc;IAZjC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,uBAAuB,CAAQ;IACvD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,cAAc,CAAU;IAEhD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAc;IAC3C,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAS;IAC9C,OAAO,CAAC,eAAe,CAAgC;IACvD,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,gBAAgB,CAAK;gBAGV,MAAM,EAAE,MAAM,EACd,cAAc,EAAE,mBAAmB,EACpD,OAAO,EAAE,mBAAmB;IAO9B;;;OAGG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IA0C5B;;OAEG;IACH,IAAI,IAAI,IAAI;IASZ;;OAEG;YACW,OAAO;IA0CrB;;;;;;OAMG;YACW,eAAe;IA2G7B;;;OAGG;IACH,OAAO,KAAK,gBAAgB,GAE3B;IAED;;;;;;;OAOG;IACH,OAAO,CAAC,qBAAqB;IAK7B,OAAO,CAAC,KAAK;CAcd"}