@overlordai/server 1.0.174 → 1.0.176

package/dist/connectors/connector-dispatch.service.js

@@ -0,0 +1,226 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var ConnectorDispatchService_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConnectorDispatchService = void 0;
+const common_1 = require("@nestjs/common");
+const connector_repository_1 = require("../database/repositories/connector.repository");
+const external_issue_link_repository_1 = require("../database/repositories/external-issue-link.repository");
+const task_creation_service_1 = require("../dispatcher/task-creation.service");
+const connector_registry_1 = require("./connector.registry");
+const task_repository_1 = require("../database/repositories/task.repository");
+const redis_service_1 = require("../redis/redis.service");
+const project_repository_1 = require("../database/repositories/project.repository");
+const design_context_service_1 = require("./design-context.service");
+const connector_constants_1 = require("./connector.constants");
+const EVENT_DEDUPE_TTL_SEC = 24 * 60 * 60; // 24h
+let ConnectorDispatchService = ConnectorDispatchService_1 = class ConnectorDispatchService {
+    constructor(connectorRepo, externalIssueLinkRepo, taskRepo, taskCreationService, connectorRegistry, redis, designContextService, projectRepo) {
+        this.connectorRepo = connectorRepo;
+        this.externalIssueLinkRepo = externalIssueLinkRepo;
+        this.taskRepo = taskRepo;
+        this.taskCreationService = taskCreationService;
+        this.connectorRegistry = connectorRegistry;
+        this.redis = redis;
+        this.designContextService = designContextService;
+        this.projectRepo = projectRepo;
+        this.logger = new common_1.Logger(ConnectorDispatchService_1.name);
+        /** In-process lock to prevent duplicate task creation from concurrent webhooks for the same issue. */
+        this.dispatchingIssues = new Set();
+    }
+    /**
+     * Process a webhook result and create a task if needed.
+     */
+    async dispatchFromConnector(result, instance) {
+        if (result.action !== 'create_task')
+            return;
+        // Check for duplicate: use eventId (comment ID, alert rule, etc.) when available
+        // to distinguish new events on the same issue from retries. Fall back to issue ID.
+        const issueDedupeKey = result.issueRef
+            ? `${result.issueRef.platform}:${result.issueRef.issueId}${result.eventId ? `:${result.eventId}` : ''}`
+            : null;
+        if (issueDedupeKey) {
+            // Check persistent dedup first: if this exact event was already
+            // successfully processed, skip immediately.
+            if (result.eventId) {
+                const redisKey = `connector_event:${issueDedupeKey}`;
+                const existing = await this.redis.getClient().get(redisKey);
+                if (existing) {
+                    this.logger.log({ issueId: result.issueRef.issueId, eventId: result.eventId }, 'External event already processed (Redis dedupe), skipping');
+                    return;
+                }
+            }
+            // In-process lock for concurrent requests within the same event loop tick
+            if (this.dispatchingIssues.has(issueDedupeKey)) {
+                this.logger.log({ issueId: result.issueRef.issueId }, 'External issue dispatch already in progress, skipping concurrent duplicate');
+                return;
+            }
+            this.dispatchingIssues.add(issueDedupeKey);
+        }
+        try {
+            return await this.dispatchWithLock(result, instance);
+        }
+        finally {
+            if (issueDedupeKey) {
+                this.dispatchingIssues.delete(issueDedupeKey);
+            }
+        }
+    }
+    async dispatchWithLock(result, instance) {
+        // Only deduplicate by issue ID when there is no event-specific identifier.
+        // When eventId is present (e.g. Jira comment ID), each new event on the
+        // same issue is a legitimate new request — the in-process lock already
+        // prevents retries of the same event.
+        if (result.issueRef && !result.eventId) {
+            const existingLinks = this.externalIssueLinkRepo.findByExternalIssue(result.issueRef.platform, result.issueRef.issueId, instance.id);
+            const activeLink = existingLinks.find((link) => {
+                const task = this.taskRepo.findById(link.taskId);
+                return !!task && connector_constants_1.ACTIVE_TASK_STATUSES.has(task.status);
+            });
+            if (activeLink) {
+                this.logger.log({ issueId: result.issueRef.issueId, taskId: activeLink.taskId }, 'External issue already linked to an active task, skipping duplicate');
+                return;
+            }
+        }
+        // Resolve project key from binding or result — always scoped to the
+        // receiving connector instance to avoid cross-instance misrouting.
+        const bindings = this.connectorRepo.findBindingsByInstanceId(instance.id);
+        let projectKey = result.projectKey;
+        // Validate explicit projectKey against bindings to prevent routing
+        // to a project not bound to this connector instance.
+        // Resolve alias to canonical key first (e.g. --project <alias> in comments).
+        if (projectKey) {
+            const canonical = this.projectRepo.findByAlias(projectKey)?.key ?? projectKey;
+            const isBound = bindings.some((b) => b.projectKey === canonical);
+            if (isBound) {
+                projectKey = canonical;
+            }
+            else {
+                this.logger.warn({ instanceId: instance.id, projectKey }, 'Explicit projectKey from webhook is not bound to this connector instance, ignoring');
+                projectKey = undefined;
+            }
+        }
+        if (!projectKey) {
+            // Try matching by external project key from the webhook payload
+            if (result.issueRef?.projectKey) {
+                const matchedBinding = bindings.find((b) => b.externalProjectKey === result.issueRef.projectKey);
+                if (matchedBinding) {
+                    projectKey = matchedBinding.projectKey;
+                }
+            }
+            // Fall back to default binding or sole binding
+            if (!projectKey) {
+                const defaultBinding = bindings.find((b) => b.isDefault);
+                if (defaultBinding) {
+                    projectKey = defaultBinding.projectKey;
+                }
+                else if (bindings.length === 1) {
+                    projectKey = bindings[0].projectKey;
+                }
+                else if (bindings.length > 1) {
+                    this.logger.warn({ instanceId: instance.id, platform: instance.platform, bindingCount: bindings.length }, 'Multiple bindings without a default — cannot resolve project key unambiguously, skipping task creation');
+                    return;
+                }
+            }
+        }
+        if (!projectKey) {
+            this.logger.warn({ instanceId: instance.id, platform: instance.platform }, 'Cannot resolve project key for connector webhook, skipping task creation');
+            return;
+        }
+        // Build externalRefs for configSnapshot
+        const externalRefs = result.issueRef
+            ? [{
+                    platform: result.issueRef.platform,
+                    issueId: result.issueRef.displayIssueId ?? result.issueRef.issueId,
+                    url: result.issueRef.issueUrl,
+                }]
+            : undefined;
+        // Figma: pre-fetch design context before task creation
+        const figmaFileKey = result.context?.extra?.figmaFileKey;
+        let figmaData = null;
+        if (figmaFileKey) {
+            try {
+                figmaData = await this.designContextService.fetch(figmaFileKey, result.context.extra.figmaNodeIds, projectKey, instance.id);
+            }
+            catch (err) {
+                this.logger.warn({ err, figmaFileKey }, 'Figma design context prefetch failed, creating task without design context');
+            }
+        }
+        const createdBy = instance.createdBy;
+        if (!createdBy) {
+            this.logger.warn({ instanceId: instance.id, platform: instance.platform }, 'Connector webhook cannot create a task without a connector owner');
+            return;
+        }
+        try {
+            const task = await this.taskCreationService.createTask({
+                description: result.description ?? 'Task from external connector',
+                projectKey,
+                developerId: result.developerId,
+            }, createdBy, undefined, undefined, externalRefs ? { externalRefs } : undefined, figmaData
+                ? (t) => {
+                    this.designContextService.store(t.id, figmaData.instance.id, figmaData.context, result.context?.extra?.figmaCommentId);
+                }
+                : undefined, figmaData
+                ? { instanceId: figmaData.instance.id, context: figmaData.context }
+                : undefined, result.issueRef
+                ? { instanceId: instance.id, ref: result.issueRef }
+                : undefined);
+            // Create external issue link
+            if (result.issueRef) {
+                this.externalIssueLinkRepo.create({
+                    taskId: task.id,
+                    connectorInstanceId: instance.id,
+                    connectorPlatform: result.issueRef.platform,
+                    externalIssueId: result.issueRef.issueId,
+                    externalIssueUrl: result.issueRef.issueUrl,
+                    externalProjectKey: result.issueRef.projectKey,
+                });
+            }
+            this.logger.log({ taskId: task.id, platform: instance.platform, issueId: result.issueRef?.issueId }, 'Created task from connector webhook');
+            // Mark event as processed AFTER successful task creation.
+            // This ensures failed dispatches can be retried by the external system.
+            if (result.eventId && result.issueRef) {
+                const redisKey = `connector_event:${result.issueRef.platform}:${result.issueRef.issueId}:${result.eventId}`;
+                this.redis.getClient().set(redisKey, '1', 'EX', EVENT_DEDUPE_TTL_SEC).catch((err) => {
+                    this.logger.warn({ err, redisKey }, 'Failed to set Redis dedup key');
+                });
+            }
+            // Fire-and-forget: post acknowledgement comment back to external system
+            if (result.issueRef) {
+                const connector = this.connectorRegistry.get(instance.platform);
+                if (connector) {
+                    connector
+                        .addComment(instance, result.issueRef.issueId, `Overlord Task #${task.id} has been created for this issue.`)
+                        .catch((err) => {
+                        this.logger.warn({ err, issueId: result.issueRef.issueId }, 'Failed to post acknowledgement comment');
+                    });
+                }
+            }
+        }
+        catch (err) {
+            this.logger.error({ err, platform: instance.platform }, 'Failed to create task from connector webhook');
+            throw err;
+        }
+    }
+};
+exports.ConnectorDispatchService = ConnectorDispatchService;
+exports.ConnectorDispatchService = ConnectorDispatchService = ConnectorDispatchService_1 = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [connector_repository_1.ConnectorRepository,
+        external_issue_link_repository_1.ExternalIssueLinkRepository,
+        task_repository_1.TaskRepository,
+        task_creation_service_1.TaskCreationService,
+        connector_registry_1.ConnectorRegistry,
+        redis_service_1.RedisService,
+        design_context_service_1.DesignContextService,
+        project_repository_1.ProjectRepository])
+], ConnectorDispatchService);
+//# sourceMappingURL=connector-dispatch.service.js.map

package/dist/connectors/connector-dispatch.service.js.map

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

package/dist/connectors/connector.constants.d.ts

@@ -0,0 +1,4 @@
+import { TaskStatus } from '@overlordai/protocol';
+/** Task statuses considered "active" for connector dedup and auto-review checks. */
+export declare const ACTIVE_TASK_STATUSES: Set<TaskStatus>;
+//# sourceMappingURL=connector.constants.d.ts.map

package/dist/connectors/connector.constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connector.constants.d.ts","sourceRoot":"","sources":["../../src/connectors/connector.constants.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAElD,oFAAoF;AACpF,eAAO,MAAM,oBAAoB,iBAK/B,CAAC"}

package/dist/connectors/connector.constants.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ACTIVE_TASK_STATUSES = void 0;
+const protocol_1 = require("@overlordai/protocol");
+/** Task statuses considered "active" for connector dedup and auto-review checks. */
+exports.ACTIVE_TASK_STATUSES = new Set([
+    protocol_1.TaskStatus.QUEUED,
+    protocol_1.TaskStatus.ASSIGNED,
+    protocol_1.TaskStatus.RUNNING,
+    protocol_1.TaskStatus.SUSPENDED,
+]);
+//# sourceMappingURL=connector.constants.js.map

package/dist/connectors/connector.constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connector.constants.js","sourceRoot":"","sources":["../../src/connectors/connector.constants.ts"],"names":[],"mappings":";;;AAAA,mDAAkD;AAElD,oFAAoF;AACvE,QAAA,oBAAoB,GAAG,IAAI,GAAG,CAAa;IACtD,qBAAU,CAAC,MAAM;IACjB,qBAAU,CAAC,QAAQ;IACnB,qBAAU,CAAC,OAAO;IAClB,qBAAU,CAAC,SAAS;CACrB,CAAC,CAAC"}

package/dist/connectors/connector.controller.d.ts

@@ -0,0 +1,20 @@
+import type { Request } from 'express';
+import { ConnectorRepository } from '../database/repositories/connector.repository';
+import { ConnectorRegistry } from './connector.registry';
+import { ConnectorDispatchService } from './connector-dispatch.service';
+import { CryptoService } from '../common/crypto.service';
+export declare class ConnectorController {
+    private readonly connectorRepo;
+    private readonly connectorRegistry;
+    private readonly dispatchService;
+    private readonly cryptoService;
+    private readonly logger;
+    constructor(connectorRepo: ConnectorRepository, connectorRegistry: ConnectorRegistry, dispatchService: ConnectorDispatchService, cryptoService: CryptoService);
+    handleWebhook(platform: string, instanceId: string, req: Request): Promise<{
+        ok: boolean;
+    }>;
+    private verifySignature;
+    /** Timing-safe string comparison that handles length mismatches without throwing. */
+    private safeCompare;
+}
+//# sourceMappingURL=connector.controller.d.ts.map

package/dist/connectors/connector.controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connector.controller.d.ts","sourceRoot":"","sources":["../../src/connectors/connector.controller.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,mBAAmB,EAAE,MAAM,+CAA+C,CAAC;AACpF,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,EAAE,wBAAwB,EAAE,MAAM,8BAA8B,CAAC;AACxE,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAGzD,qBACa,mBAAmB;IAI5B,OAAO,CAAC,QAAQ,CAAC,aAAa;IAC9B,OAAO,CAAC,QAAQ,CAAC,iBAAiB;IAClC,OAAO,CAAC,QAAQ,CAAC,eAAe;IAChC,OAAO,CAAC,QAAQ,CAAC,aAAa;IANhC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAwC;gBAG5C,aAAa,EAAE,mBAAmB,EAClC,iBAAiB,EAAE,iBAAiB,EACpC,eAAe,EAAE,wBAAwB,EACzC,aAAa,EAAE,aAAa;IAIzC,aAAa,CACE,QAAQ,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,EAChC,GAAG,EAAE,OAAO,GAClB,OAAO,CAAC;QAAE,EAAE,EAAE,OAAO,CAAA;KAAE,CAAC;IA4C3B,OAAO,CAAC,eAAe;IAqCvB,qFAAqF;IACrF,OAAO,CAAC,WAAW;CAMpB"}

package/dist/connectors/connector.controller.js

@@ -0,0 +1,166 @@
+"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 __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+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;
+    };
+})();
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+var ConnectorController_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConnectorController = void 0;
+const common_1 = require("@nestjs/common");
+const connector_repository_1 = require("../database/repositories/connector.repository");
+const connector_registry_1 = require("./connector.registry");
+const connector_dispatch_service_1 = require("./connector-dispatch.service");
+const crypto_service_1 = require("../common/crypto.service");
+const crypto = __importStar(require("node:crypto"));
+let ConnectorController = ConnectorController_1 = class ConnectorController {
+    constructor(connectorRepo, connectorRegistry, dispatchService, cryptoService) {
+        this.connectorRepo = connectorRepo;
+        this.connectorRegistry = connectorRegistry;
+        this.dispatchService = dispatchService;
+        this.cryptoService = cryptoService;
+        this.logger = new common_1.Logger(ConnectorController_1.name);
+    }
+    async handleWebhook(platform, instanceId, req) {
+        const id = parseInt(instanceId, 10);
+        if (isNaN(id)) {
+            throw new common_1.BadRequestException('Invalid connector instance ID');
+        }
+        const instance = this.connectorRepo.findInstanceById(id);
+        if (!instance || instance.platform !== platform) {
+            throw new common_1.NotFoundException(`Connector instance #${id} not found for platform '${platform}'`);
+        }
+        if (instance.status !== 'active') {
+            throw new common_1.ForbiddenException(`Connector instance #${id} is disabled`);
+        }
+        // Verify webhook signature if configured
+        if (instance.webhookSecret) {
+            const secret = this.cryptoService.decryptAes(instance.webhookSecret);
+            if (!this.verifySignature(req, secret, platform)) {
+                this.logger.warn({ id, platform }, 'Webhook signature verification failed');
+                throw new common_1.ForbiddenException('Webhook signature verification failed');
+            }
+        }
+        const connector = this.connectorRegistry.get(platform);
+        if (!connector) {
+            throw new common_1.NotFoundException(`No connector registered for platform '${platform}'`);
+        }
+        const webhookReq = {
+            body: req.body,
+            headers: req.headers,
+        };
+        // Process synchronously so failures surface as 5xx to the external
+        // system, allowing it to retry. Without this, dispatch failures
+        // (DB errors, project validation) are silently swallowed behind 200.
+        const result = await connector.handleWebhook(webhookReq, instance);
+        if (result) {
+            await this.dispatchService.dispatchFromConnector(result, instance);
+        }
+        return { ok: true };
+    }
+    verifySignature(req, secret, platform) {
+        try {
+            if (platform === 'jira') {
+                // Jira uses HMAC-SHA256 in x-hub-signature header
+                const signature = req.headers['x-hub-signature'];
+                if (!signature)
+                    return false;
+                const rawBody = req.rawBody;
+                if (!rawBody)
+                    return false;
+                const expected = 'sha256=' + crypto.createHmac('sha256', secret).update(rawBody).digest('hex');
+                return this.safeCompare(signature, expected);
+            }
+            if (platform === 'sentry') {
+                // Sentry uses HMAC-SHA256 in sentry-hook-signature header
+                const signature = req.headers['sentry-hook-signature'];
+                if (!signature)
+                    return false;
+                const rawBody = req.rawBody;
+                if (!rawBody)
+                    return false;
+                const expected = crypto.createHmac('sha256', secret).update(rawBody).digest('hex');
+                return this.safeCompare(signature, expected);
+            }
+            if (platform === 'figma') {
+                // Figma uses a passcode field in the webhook payload body
+                const payload = req.body;
+                const passcode = payload.passcode;
+                if (!passcode)
+                    return false;
+                return this.safeCompare(passcode, secret);
+            }
+            this.logger.warn({ platform }, 'No signature verification method for platform');
+            return false;
+        }
+        catch {
+            return false;
+        }
+    }
+    /** Timing-safe string comparison that handles length mismatches without throwing. */
+    safeCompare(a, b) {
+        const bufA = Buffer.from(a);
+        const bufB = Buffer.from(b);
+        if (bufA.length !== bufB.length)
+            return false;
+        return crypto.timingSafeEqual(bufA, bufB);
+    }
+};
+exports.ConnectorController = ConnectorController;
+__decorate([
+    (0, common_1.Post)(':platform/:instanceId'),
+    __param(0, (0, common_1.Param)('platform')),
+    __param(1, (0, common_1.Param)('instanceId')),
+    __param(2, (0, common_1.Req)()),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [String, String, Object]),
+    __metadata("design:returntype", Promise)
+], ConnectorController.prototype, "handleWebhook", null);
+exports.ConnectorController = ConnectorController = ConnectorController_1 = __decorate([
+    (0, common_1.Controller)('webhook/connector'),
+    __metadata("design:paramtypes", [connector_repository_1.ConnectorRepository,
+        connector_registry_1.ConnectorRegistry,
+        connector_dispatch_service_1.ConnectorDispatchService,
+        crypto_service_1.CryptoService])
+], ConnectorController);
+//# sourceMappingURL=connector.controller.js.map

package/dist/connectors/connector.controller.js.map

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

package/dist/connectors/connector.interface.d.ts

@@ -0,0 +1,61 @@
+import type { ConnectorPlatform } from '@overlordai/protocol';
+import type { ConnectorInstanceRow } from '../database/repositories/connector.repository';
+/** Context fetched from an external issue/alert. */
+export interface ExternalContext {
+    title: string;
+    description: string;
+    labels?: string[];
+    priority?: string;
+    status?: string;
+    url?: string;
+    /** Platform-specific extra data (e.g. stacktrace for Sentry). */
+    extra?: Record<string, unknown>;
+}
+/** Reference to an external issue. */
+export interface ExternalIssueRef {
+    platform: ConnectorPlatform;
+    /** Stable identifier used for follow-up API calls. */
+    issueId: string;
+    /** Optional human-friendly identifier shown in prompts and UI text. */
+    displayIssueId?: string;
+    issueUrl: string;
+    projectKey?: string;
+}
+/** Result of processing an inbound webhook. */
+export interface ConnectorWebhookResult {
+    action: 'create_task' | 'ignore';
+    /** Event-specific identifier for deduplication (e.g. Jira comment ID, Sentry event ID). */
+    eventId?: string;
+    issueRef?: ExternalIssueRef;
+    context?: ExternalContext;
+    projectKey?: string;
+    developerId?: number;
+    description?: string;
+}
+/** Incoming request shape for webhook handling. */
+export interface ConnectorWebhookRequest {
+    body: unknown;
+    headers: Record<string, string | string[] | undefined>;
+}
+/**
+ * IConnector — interface for external system integrations (Jira, Sentry, Linear, etc.).
+ *
+ * Unlike IMessageAdapter (chat platforms), connectors deal with issues, alerts,
+ * and status transitions rather than messages and chats.
+ */
+export interface IConnector {
+    readonly platform: ConnectorPlatform;
+    /** Parse an inbound webhook. Returns null to ignore the event. */
+    handleWebhook(req: ConnectorWebhookRequest, instance: ConnectorInstanceRow): Promise<ConnectorWebhookResult | null>;
+    /** Fetch full context for an external issue/alert by ID. */
+    fetchContext(instance: ConnectorInstanceRow, externalId: string): Promise<ExternalContext>;
+    /** Add a comment on an external issue. */
+    addComment(instance: ConnectorInstanceRow, externalId: string, comment: string): Promise<void>;
+    /** Transition the issue/alert status (e.g. resolve, close). */
+    transitionStatus(instance: ConnectorInstanceRow, externalId: string, targetStatus: string): Promise<void>;
+    /** Associate an MR URL with an external issue. */
+    linkMR(instance: ConnectorInstanceRow, externalId: string, mrUrl: string): Promise<void>;
+    /** Validate that the provided credentials are correct. */
+    validateCredentials(credentials: Record<string, string>, baseUrl?: string): Promise<boolean>;
+}
+//# sourceMappingURL=connector.interface.d.ts.map

package/dist/connectors/connector.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connector.interface.d.ts","sourceRoot":"","sources":["../../src/connectors/connector.interface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,+CAA+C,CAAC;AAE1F,oDAAoD;AACpD,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,iEAAiE;IACjE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAED,sCAAsC;AACtC,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,sDAAsD;IACtD,OAAO,EAAE,MAAM,CAAC;IAChB,uEAAuE;IACvE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,+CAA+C;AAC/C,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,aAAa,GAAG,QAAQ,CAAC;IACjC,2FAA2F;IAC3F,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IAC5B,OAAO,CAAC,EAAE,eAAe,CAAC;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,mDAAmD;AACnD,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,CAAC;CACxD;AAED;;;;;GAKG;AACH,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,CAAC;IAErC,kEAAkE;IAClE,aAAa,CAAC,GAAG,EAAE,uBAAuB,EAAE,QAAQ,EAAE,oBAAoB,GAAG,OAAO,CAAC,sBAAsB,GAAG,IAAI,CAAC,CAAC;IAEpH,4DAA4D;IAC5D,YAAY,CAAC,QAAQ,EAAE,oBAAoB,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IAE3F,0CAA0C;IAC1C,UAAU,CAAC,QAAQ,EAAE,oBAAoB,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE/F,+DAA+D;IAC/D,gBAAgB,CAAC,QAAQ,EAAE,oBAAoB,EAAE,UAAU,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE1G,kDAAkD;IAClD,MAAM,CAAC,QAAQ,EAAE,oBAAoB,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEzF,0DAA0D;IAC1D,mBAAmB,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAC9F"}

package/dist/connectors/connector.interface.js

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

package/dist/connectors/connector.interface.js.map

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

package/dist/connectors/connector.module.d.ts

@@ -0,0 +1,3 @@
+export declare class ConnectorModule {
+}
+//# sourceMappingURL=connector.module.d.ts.map

package/dist/connectors/connector.module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connector.module.d.ts","sourceRoot":"","sources":["../../src/connectors/connector.module.ts"],"names":[],"mappings":"AAcA,qBAsBa,eAAe;CAAG"}

package/dist/connectors/connector.module.js

@@ -0,0 +1,50 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConnectorModule = void 0;
+const common_1 = require("@nestjs/common");
+const dispatcher_module_1 = require("../dispatcher/dispatcher.module");
+const crypto_service_1 = require("../common/crypto.service");
+const connector_registry_1 = require("./connector.registry");
+const connector_controller_1 = require("./connector.controller");
+const connector_dispatch_service_1 = require("./connector-dispatch.service");
+const connector_closure_service_1 = require("./connector-closure.service");
+const issue_ref_resolver_service_1 = require("./issue-ref-resolver.service");
+const design_context_service_1 = require("./design-context.service");
+const design_review_trigger_service_1 = require("./design-review-trigger.service");
+const jira_connector_1 = require("./jira/jira.connector");
+const sentry_connector_1 = require("./sentry/sentry.connector");
+const figma_connector_1 = require("./figma/figma.connector");
+let ConnectorModule = class ConnectorModule {
+};
+exports.ConnectorModule = ConnectorModule;
+exports.ConnectorModule = ConnectorModule = __decorate([
+    (0, common_1.Module)({
+        imports: [(0, common_1.forwardRef)(() => dispatcher_module_1.DispatcherModule)],
+        controllers: [connector_controller_1.ConnectorController],
+        providers: [
+            crypto_service_1.CryptoService,
+            jira_connector_1.JiraConnector,
+            sentry_connector_1.SentryConnector,
+            figma_connector_1.FigmaConnector,
+            {
+                provide: connector_registry_1.CONNECTORS,
+                useFactory: (jira, sentry, figma) => [jira, sentry, figma],
+                inject: [jira_connector_1.JiraConnector, sentry_connector_1.SentryConnector, figma_connector_1.FigmaConnector],
+            },
+            connector_registry_1.ConnectorRegistry,
+            connector_dispatch_service_1.ConnectorDispatchService,
+            connector_closure_service_1.ConnectorClosureService,
+            issue_ref_resolver_service_1.IssueRefResolverService,
+            design_context_service_1.DesignContextService,
+            design_review_trigger_service_1.DesignReviewTriggerService,
+        ],
+        exports: [connector_registry_1.ConnectorRegistry, connector_dispatch_service_1.ConnectorDispatchService, issue_ref_resolver_service_1.IssueRefResolverService, design_context_service_1.DesignContextService],
+    })
+], ConnectorModule);
+//# sourceMappingURL=connector.module.js.map

package/dist/connectors/connector.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connector.module.js","sourceRoot":"","sources":["../../src/connectors/connector.module.ts"],"names":[],"mappings":";;;;;;;;;AAAA,2CAAoD;AACpD,uEAAmE;AACnE,6DAAyD;AACzD,6DAAqE;AACrE,iEAA6D;AAC7D,6EAAwE;AACxE,2EAAsE;AACtE,6EAAuE;AACvE,qEAAgE;AAChE,mFAA6E;AAC7E,0DAAsD;AACtD,gEAA4D;AAC5D,6DAAyD;AAwBlD,IAAM,eAAe,GAArB,MAAM,eAAe;CAAG,CAAA;AAAlB,0CAAe;0BAAf,eAAe;IAtB3B,IAAA,eAAM,EAAC;QACN,OAAO,EAAE,CAAC,IAAA,mBAAU,EAAC,GAAG,EAAE,CAAC,oCAAgB,CAAC,CAAC;QAC7C,WAAW,EAAE,CAAC,0CAAmB,CAAC;QAClC,SAAS,EAAE;YACT,8BAAa;YACb,8BAAa;YACb,kCAAe;YACf,gCAAc;YACd;gBACE,OAAO,EAAE,+BAAU;gBACnB,UAAU,EAAE,CAAC,IAAmB,EAAE,MAAuB,EAAE,KAAqB,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC;gBAC1G,MAAM,EAAE,CAAC,8BAAa,EAAE,kCAAe,EAAE,gCAAc,CAAC;aACzD;YACD,sCAAiB;YACjB,qDAAwB;YACxB,mDAAuB;YACvB,oDAAuB;YACvB,6CAAoB;YACpB,0DAA0B;SAC3B;QACD,OAAO,EAAE,CAAC,sCAAiB,EAAE,qDAAwB,EAAE,oDAAuB,EAAE,6CAAoB,CAAC;KACtG,CAAC;GACW,eAAe,CAAG"}

package/dist/connectors/connector.registry.d.ts

@@ -0,0 +1,15 @@
+import { OnModuleInit } from '@nestjs/common';
+import type { ConnectorPlatform } from '@overlordai/protocol';
+import type { IConnector } from './connector.interface';
+export declare const CONNECTORS: unique symbol;
+export declare class ConnectorRegistry implements OnModuleInit {
+    private readonly registered;
+    private readonly logger;
+    private readonly connectors;
+    constructor(registered?: IConnector[]);
+    onModuleInit(): void;
+    get(platform: ConnectorPlatform | string): IConnector | undefined;
+    getAll(): IConnector[];
+    platforms(): string[];
+}
+//# sourceMappingURL=connector.registry.d.ts.map

package/dist/connectors/connector.registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connector.registry.d.ts","sourceRoot":"","sources":["../../src/connectors/connector.registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,YAAY,EAAoB,MAAM,gBAAgB,CAAC;AACpF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAExD,eAAO,MAAM,UAAU,eAAuB,CAAC;AAE/C,qBACa,iBAAkB,YAAW,YAAY;IAKlB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAJ7D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAsC;IAC7D,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAiC;gBAGT,UAAU,GAAE,UAAU,EAAO;IAGhF,YAAY,IAAI,IAAI;IAOpB,GAAG,CAAC,QAAQ,EAAE,iBAAiB,GAAG,MAAM,GAAG,UAAU,GAAG,SAAS;IAIjE,MAAM,IAAI,UAAU,EAAE;IAItB,SAAS,IAAI,MAAM,EAAE;CAGtB"}