@cursor/bdk 0.2.1

package/dist/internal/continuation-identity.js

@@ -0,0 +1,749 @@
+/**
+ * Continuation identity is a closed selector string. Omitted `continuation`
+ * on a channel constructor stays `/v1` (engine pack minting) so existing
+ * agents do not change: `githubChannel()` → `github.pr/v1`, `slackChannel()`
+ * → `slack.thread/v1`, `originChannel()` → `origin.pr/v1`,
+ * `deploymentsChannel()` → `deployments.none/v1`, `changeMonitorsChannel()`
+ * → `none/v1`, `issuesChannel()` → `none/v1`, `httpChannel()` →
+ * `none/v1`.
+ *
+ * Opt the whole agent into the v2 control plane with
+ * `defineAgent({ architecture: "v2" })`. That stamps `/v2` defaults from
+ * the channel kind and declared events (`github.pr/v2`, `github.issue/v2`,
+ * `github.none/v2`, `slack.thread/v2`, `origin.pr/v2`,
+ * `deployments.deployment/v2`, `change_monitors.checkpoint/v2`,
+ * `issues.issue/v2`, …) onto every channel that omitted a
+ * selector. An explicit per-channel selector still overrides. JSONPath
+ * and per-agent format strings are rejected.
+ */
+import { randomBytes } from "node:crypto";
+import { isSlackImChannel, slackThreadKey } from "./slack-thread-key.js";
+export const CONTINUATION_SELECTORS = [
+    "github.pr/v1",
+    "github.pr/v2",
+    "github.issue/v1",
+    "github.issue/v2",
+    "github.none/v2",
+    "slack.thread/v1",
+    "slack.thread/v2",
+    "slack.none/v2",
+    "origin.pr/v1",
+    "origin.pr/v2",
+    "origin.none/v2",
+    "gitlab.mr/v2",
+    "gitlab.none/v2",
+    "bitbucket.pr/v2",
+    "bitbucket.none/v2",
+    "deployments.none/v1",
+    "deployments.none/v2",
+    "deployments.deployment/v2",
+    "change_monitors.checkpoint/v2",
+    "issues.issue/v2",
+    "none/v1",
+    "none/v2",
+];
+export const BUILTINS = [
+    {
+        type: "pr",
+        kind: "github",
+        events: [
+            "pull_request",
+            "issue_comment",
+            "pull_request_review",
+            "pull_request_review_comment",
+            "check_suite",
+            "check_run",
+        ],
+        format: "github-pr:{fullName}#{number}",
+    },
+    {
+        type: "issue",
+        kind: "github",
+        events: ["issues", "issue_comment"],
+        format: "github-issue:{fullName}#{number}",
+    },
+    {
+        type: "thread",
+        kind: "slack",
+        events: ["message", "app_mention"],
+        format: "{channelId}:{threadTs}",
+    },
+    {
+        type: "origin-pr",
+        kind: "origin",
+        // Public webhook deliveries carry `pullRequest.number` + repository
+        // (`owner.slug` / `name`); keep in lockstep with the control plane's
+        // `conversation/origin.ts`.
+        events: [
+            "pull_request.created",
+            "pull_request.published",
+            "pull_request.head_ref.pushed",
+            "pull_request.base_ref.updated",
+            "pull_request.closed",
+            "pull_request.reopened",
+            "pull_request.merged",
+            "pull_request.comment.created",
+            "pull_request.review.submitted",
+            "pull_request.metadata.updated",
+        ],
+        format: "origin-pr:{fullName}#{number}",
+    },
+    {
+        type: "gitlab-mr",
+        kind: "gitlab",
+        // GitLab `object_kind`s that carry a merge request: `note` only when
+        // `noteable_type` is MergeRequest, `pipeline` only with `merge_request`.
+        events: ["merge_request", "note", "pipeline"],
+        format: "gitlab-mr:{fullName}!{number}",
+    },
+    {
+        type: "bitbucket-pr",
+        kind: "bitbucket",
+        // Cloud vocabulary; Data Center keys are normalized before the stamp.
+        events: [
+            "pullrequest:created",
+            "pullrequest:updated",
+            "pullrequest:approved",
+            "pullrequest:unapproved",
+            "pullrequest:changes_request_created",
+            "pullrequest:fulfilled",
+            "pullrequest:rejected",
+            "pullrequest:comment_created",
+        ],
+        format: "bitbucket-pr:{fullName}#{number}",
+    },
+    {
+        type: "deployment",
+        kind: "deployments",
+        // All three factory stream events carry `deploymentId`; keep in
+        // lockstep with the control plane's `conversation/deployments.ts`.
+        events: ["deployment.created", "deployment.succeeded", "deployment.failed"],
+        format: "deployments:{deploymentId}",
+    },
+    {
+        type: "change-monitor-checkpoint",
+        kind: "change_monitors",
+        events: ["checkpoint.created"],
+        format: "change_monitors:{checkpointName}",
+    },
+    {
+        type: "factory-issue",
+        kind: "issues",
+        events: ["issue.created"],
+        format: "issues:{issueName}",
+    },
+];
+export class V2EngineError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "V2EngineError";
+    }
+}
+const SELECTOR_FIELDS = {
+    "github.pr/v1": { version: 1, type: "pr", kind: "github" },
+    "github.pr/v2": { version: 2, type: "pr", kind: "github" },
+    "github.issue/v1": { version: 1, type: "issue", kind: "github" },
+    "github.issue/v2": { version: 2, type: "issue", kind: "github" },
+    "github.none/v2": { version: 2, type: "none", kind: "github" },
+    "slack.thread/v1": { version: 1, type: "thread", kind: "slack" },
+    "slack.thread/v2": { version: 2, type: "thread", kind: "slack" },
+    "slack.none/v2": { version: 2, type: "none", kind: "slack" },
+    "origin.pr/v1": { version: 1, type: "origin-pr", kind: "origin" },
+    "origin.pr/v2": { version: 2, type: "origin-pr", kind: "origin" },
+    "origin.none/v2": { version: 2, type: "none", kind: "origin" },
+    "gitlab.mr/v2": { version: 2, type: "gitlab-mr", kind: "gitlab" },
+    "gitlab.none/v2": { version: 2, type: "none", kind: "gitlab" },
+    "bitbucket.pr/v2": { version: 2, type: "bitbucket-pr", kind: "bitbucket" },
+    "bitbucket.none/v2": { version: 2, type: "none", kind: "bitbucket" },
+    "deployments.none/v1": { version: 1, type: "none", kind: "deployments" },
+    "deployments.none/v2": { version: 2, type: "none", kind: "deployments" },
+    "deployments.deployment/v2": {
+        version: 2,
+        type: "deployment",
+        kind: "deployments",
+    },
+    "change_monitors.checkpoint/v2": {
+        version: 2,
+        type: "change-monitor-checkpoint",
+        kind: "change_monitors",
+    },
+    "issues.issue/v2": {
+        version: 2,
+        type: "factory-issue",
+        kind: "issues",
+    },
+    "none/v1": { version: 1, type: "none", kind: "http" },
+    "none/v2": { version: 2, type: "none", kind: "http" },
+};
+function isContinuationSelector(value) {
+    return Object.hasOwn(SELECTOR_FIELDS, value);
+}
+export function defaultContinuationSelector(kind, version = "v1", eventTypes) {
+    if (version !== "v2") {
+        switch (kind) {
+            case "github":
+                return "github.pr/v1";
+            case "slack":
+                return "slack.thread/v1";
+            case "origin":
+                return "origin.pr/v1";
+            case "deployments":
+                return "deployments.none/v1";
+            default:
+                return "none/v1";
+        }
+    }
+    switch (kind) {
+        case "github":
+            return githubV2Default(eventTypes);
+        case "slack":
+            return "slack.thread/v2";
+        case "origin":
+            return membershipOrNone(eventTypes, "origin-pr", "origin.pr/v2", "origin.none/v2");
+        case "gitlab":
+            return membershipOrNone(eventTypes, "gitlab-mr", "gitlab.mr/v2", "gitlab.none/v2");
+        case "bitbucket":
+            return membershipOrNone(eventTypes, "bitbucket-pr", "bitbucket.pr/v2", "bitbucket.none/v2");
+        case "deployments":
+            return membershipOrNone(eventTypes, "deployment", "deployments.deployment/v2", "deployments.none/v2");
+        case "change_monitors":
+            return membershipOrNone(eventTypes, "change-monitor-checkpoint", "change_monitors.checkpoint/v2", "none/v2");
+        case "issues":
+            return membershipOrNone(eventTypes, "factory-issue", "issues.issue/v2", "none/v2");
+        default:
+            return "none/v2";
+    }
+}
+/** Typed selector when every declared event is in the type's membership. */
+function membershipOrNone(eventTypes, type, typed, none) {
+    var _a;
+    var _b;
+    const allowed = new Set((_b = (_a = builtinForType(type)) === null || _a === void 0 ? void 0 : _a.events) !== null && _b !== void 0 ? _b : []);
+    if ((eventTypes !== null && eventTypes !== void 0 ? eventTypes : []).some(event => !allowed.has(event))) {
+        return none;
+    }
+    return typed;
+}
+function githubV2Default(eventTypes) {
+    var _a, _b;
+    var _c, _d;
+    const events = eventTypes !== null && eventTypes !== void 0 ? eventTypes : [];
+    const issueEvents = new Set((_c = (_a = builtinForType("issue")) === null || _a === void 0 ? void 0 : _a.events) !== null && _c !== void 0 ? _c : []);
+    const prEvents = new Set((_d = (_b = builtinForType("pr")) === null || _b === void 0 ? void 0 : _b.events) !== null && _d !== void 0 ? _d : []);
+    if (events.length > 0 && events.every(event => issueEvents.has(event))) {
+        return "github.issue/v2";
+    }
+    if (events.some(event => !prEvents.has(event))) {
+        return "github.none/v2";
+    }
+    return "github.pr/v2";
+}
+const OMITTED_V2_TYPED_TYPE = {
+    github: "pr",
+    origin: "origin-pr",
+    deployments: "deployment",
+    change_monitors: "change-monitor-checkpoint",
+    issues: "factory-issue",
+};
+/** Typed membership used when an omitted `/v2` selector becomes type `none`. */
+export function omittedV2TypedType(kind) {
+    return OMITTED_V2_TYPED_TYPE[kind];
+}
+/**
+ * Omitted `/v2` default became type `none` because a declared event sits
+ * outside the kind's typed membership. Validate warns; handshake stays
+ * silent on omitted selectors (type `none` is always admitted).
+ */
+export function omittedV2MembershipDowngrade(kind, eventTypes) {
+    const events = eventTypes !== null && eventTypes !== void 0 ? eventTypes : [];
+    if (events.length === 0) {
+        return undefined;
+    }
+    const selector = defaultContinuationSelector(kind, "v2", events);
+    const parsed = parseContinuationSelector(selector);
+    if (parsed === undefined || parsed.type !== "none") {
+        return undefined;
+    }
+    const typedType = omittedV2TypedType(kind);
+    const typed = typedType === undefined ? undefined : builtinForType(typedType);
+    if (typed === undefined) {
+        return undefined;
+    }
+    const allowed = new Set(typed.events);
+    const unexpected = events.filter(event => !allowed.has(event));
+    if (unexpected.length === 0) {
+        return undefined;
+    }
+    return { selector, unexpected };
+}
+export function parseContinuationSelector(selector) {
+    if (!isContinuationSelector(selector)) {
+        return undefined;
+    }
+    return Object.assign({ selector }, SELECTOR_FIELDS[selector]);
+}
+function resolveContinuation(raw, kind) {
+    const selector = raw !== null && raw !== void 0 ? raw : defaultContinuationSelector(kind);
+    const parsed = parseContinuationSelector(selector);
+    if (parsed === undefined) {
+        throw new V2EngineError(`v2: invalid continuation selector ${JSON.stringify(selector)}`);
+    }
+    return parsed;
+}
+export function normalizeIdentity(raw, kind) {
+    return resolveContinuation(raw, kind).selector;
+}
+export function continuationSource(identity, kind) {
+    return resolveContinuation(identity, kind).version === 2 ? "control-plane" : "engine";
+}
+export function isV2DurableContinuationKey(key) {
+    return key.startsWith("cont:") || key.startsWith("evt:");
+}
+function newEvtKey() {
+    return `evt:${randomBytes(16).toString("hex")}`;
+}
+function builtinForType(type) {
+    return BUILTINS.find(builtin => builtin.type === type);
+}
+function formatConversationKey(type, fields) {
+    var _a, _b;
+    switch (type) {
+        case "pr":
+            return `github-pr:${fields.fullName}#${fields.number}`;
+        case "issue":
+            return `github-issue:${fields.fullName}#${fields.number}`;
+        case "origin-pr":
+            return `origin-pr:${fields.fullName}#${fields.number}`;
+        case "gitlab-mr":
+            return `gitlab-mr:${fields.fullName}!${fields.number}`;
+        case "bitbucket-pr":
+            return `bitbucket-pr:${fields.fullName}#${fields.number}`;
+        case "thread":
+            return slackThreadKey((_a = fields.channelId) !== null && _a !== void 0 ? _a : "", (_b = fields.threadTs) !== null && _b !== void 0 ? _b : "");
+        case "deployment":
+            return `deployments:${fields.deploymentId}`;
+        case "change-monitor-checkpoint":
+            return `change_monitors:${fields.checkpointName}`;
+        case "factory-issue":
+            return `issues:${fields.issueName}`;
+    }
+}
+export function mintClaim(claim) {
+    switch (claim.type) {
+        case "thread": {
+            const resource = claim.resource;
+            if (!("channelId" in resource && "threadTs" in resource)) {
+                throw new V2EngineError("v2: thread claim requires channelId and threadTs");
+            }
+            return `cont:${formatConversationKey("thread", resource)}`;
+        }
+        case "deployment": {
+            const resource = claim.resource;
+            if (!("deploymentId" in resource)) {
+                throw new V2EngineError("v2: deployment claim requires deploymentId");
+            }
+            return `cont:${formatConversationKey("deployment", resource)}`;
+        }
+        case "change-monitor-checkpoint": {
+            const resource = claim.resource;
+            if (!("checkpointName" in resource)) {
+                throw new V2EngineError("v2: change-monitor-checkpoint claim requires checkpointName");
+            }
+            return `cont:${formatConversationKey("change-monitor-checkpoint", resource)}`;
+        }
+        case "factory-issue": {
+            const resource = claim.resource;
+            if (!("issueName" in resource)) {
+                throw new V2EngineError("v2: factory-issue claim requires issueName");
+            }
+            return `cont:${formatConversationKey("factory-issue", resource)}`;
+        }
+        case "pr":
+        case "issue":
+        case "origin-pr":
+        case "gitlab-mr":
+        case "bitbucket-pr": {
+            const resource = claim.resource;
+            const fullName = "fullName" in resource
+                ? resource.fullName
+                : "owner" in resource
+                    ? `${resource.owner}/${resource.repo}`
+                    : undefined;
+            const number = "number" in resource ? resource.number : undefined;
+            if (fullName === undefined || number === undefined) {
+                throw new V2EngineError(`v2: ${claim.type} claim requires repository and number`);
+            }
+            // GitLab paths and Bitbucket project keys arrive in API-native casing;
+            // the webhook extractors lowercase them, so the claim must too or the
+            // two mint different keys for the same MR / PR.
+            const caseFolded = claim.type === "gitlab-mr" || claim.type === "bitbucket-pr"
+                ? fullName.toLowerCase()
+                : fullName;
+            return `cont:${formatConversationKey(claim.type, {
+                fullName: caseFolded,
+                number,
+            })}`;
+        }
+    }
+}
+export function handshakeContinuation(input) {
+    var _a;
+    if (input.identity === undefined) {
+        return { ok: true };
+    }
+    const parsed = parseContinuationSelector(input.identity);
+    if (parsed === undefined) {
+        return {
+            ok: false,
+            error: `v2: invalid continuation selector ${JSON.stringify(input.identity)}`,
+        };
+    }
+    if (parsed.version !== 2 || parsed.type === "none") {
+        return { ok: true };
+    }
+    if (input.kind !== undefined && parsed.kind !== "http" && input.kind !== parsed.kind) {
+        return {
+            ok: false,
+            error: `v2: continuation ${parsed.selector} does not match channel kind ${input.kind}`,
+        };
+    }
+    const builtin = builtinForType(parsed.type);
+    if (builtin === undefined) {
+        return {
+            ok: false,
+            error: `v2: unknown continuation type ${parsed.type}`,
+        };
+    }
+    const eventTypes = (_a = input.eventTypes) !== null && _a !== void 0 ? _a : [];
+    const allowed = new Set(builtin.events);
+    const unexpected = eventTypes.filter(event => !allowed.has(event));
+    if (unexpected.length > 0) {
+        return {
+            ok: false,
+            error: `v2: eventTypes ${unexpected.join(", ")} are not in the ${parsed.type} membership`,
+        };
+    }
+    return { ok: true };
+}
+/**
+ * CP/pack extract. Returns a `cont:` key when the payload binds the
+ * identity type; undefined on membership miss or missing number (caller
+ * stamps `evt:` and does not join the conversation index).
+ */
+export function extractContinuation(type, eventName, payload) {
+    const builtin = builtinForType(type);
+    if (builtin === undefined) {
+        return undefined;
+    }
+    if (!builtin.events.includes(eventName)) {
+        return undefined;
+    }
+    switch (type) {
+        case "pr":
+        case "issue":
+            return extractGitHub(type, eventName, payload);
+        case "thread":
+            return extractSlack(payload);
+        case "origin-pr":
+            return extractOrigin(payload);
+        case "gitlab-mr":
+            return extractGitlab(eventName, payload);
+        case "bitbucket-pr":
+            return extractBitbucket(payload);
+        case "deployment":
+            return extractNamedResource("deployment", "deploymentId", payload);
+        case "change-monitor-checkpoint":
+            return extractNamedResource("change-monitor-checkpoint", "checkpointName", payload, "checkpoint");
+        case "factory-issue":
+            return extractNamedResource("factory-issue", "issueName", payload, "issue");
+    }
+}
+/**
+ * CP mailbox stamp. Hosted `routeVerifiedIngressContinuation` and local
+ * `routeLocalIngressContinuation` call this; channel adapters must not.
+ * Membership miss or missing identity fields stamp `evt:` instead of
+ * joining the conversation index.
+ */
+export function stampMailboxContinuation(identity, eventName, payload, kind) {
+    const parsed = resolveContinuation(identity, kind);
+    if (parsed.version !== 2) {
+        throw new V2EngineError("v2: refusing to stamp a mailbox key for v1");
+    }
+    if (parsed.type === "none") {
+        return { key: newEvtKey() };
+    }
+    const extracted = extractContinuation(parsed.type, eventName, payload);
+    if (extracted === undefined) {
+        return { key: newEvtKey() };
+    }
+    return { key: extracted };
+}
+export function resolveV2Key(identity, options, kind) {
+    const parsed = resolveContinuation(identity, kind);
+    if (parsed.version !== 2) {
+        throw new V2EngineError("v2: resolveV2Key requires a /v2 selector");
+    }
+    if (options.continuationToken !== undefined) {
+        throw new V2EngineError("v2: do not pass continuationToken; use mailboxContinuation or claim");
+    }
+    if (options.claim !== undefined) {
+        if (parsed.type === "none") {
+            throw new V2EngineError("v2: type none cannot take a claim");
+        }
+        if (options.claim.type !== parsed.type) {
+            throw new V2EngineError(`v2: claim type ${options.claim.type} does not match identity type ${parsed.type}`);
+        }
+        return mintClaim(options.claim);
+    }
+    if (options.mailboxContinuation !== undefined) {
+        return options.mailboxContinuation.key;
+    }
+    if (parsed.type === "none") {
+        return newEvtKey();
+    }
+    throw new V2EngineError("v2: no CP key on mailbox and no claim; refusing to mint in the engine");
+}
+export function bindMailboxContinuationSend(send, mailbox) {
+    if (mailbox === undefined) {
+        return send;
+    }
+    return (message, options) => { var _a; return send(message, Object.assign(Object.assign({}, options), { mailboxContinuation: (_a = options === null || options === void 0 ? void 0 : options.mailboxContinuation) !== null && _a !== void 0 ? _a : mailbox })); };
+}
+function extractGitHub(type, eventName, payload) {
+    const record = asRecord(payload);
+    if (record === undefined) {
+        return undefined;
+    }
+    const fullName = githubFullName(record);
+    if (fullName === undefined) {
+        return undefined;
+    }
+    const bound = githubBoundConversation(eventName, record);
+    if (bound === undefined || bound.type !== type) {
+        return undefined;
+    }
+    return `cont:${formatConversationKey(type, {
+        fullName,
+        number: bound.number,
+    })}`;
+}
+function githubBoundConversation(eventName, payload) {
+    var _a, _b;
+    var _c;
+    switch (eventName) {
+        case "pull_request":
+        case "pull_request_review":
+        case "pull_request_review_comment":
+        case "pull_request_review_thread": {
+            const number = positiveInt((_a = asRecord(payload.pull_request)) === null || _a === void 0 ? void 0 : _a.number);
+            return number === undefined ? undefined : { type: "pr", number };
+        }
+        case "issues": {
+            const number = positiveInt((_b = asRecord(payload.issue)) === null || _b === void 0 ? void 0 : _b.number);
+            return number === undefined ? undefined : { type: "issue", number };
+        }
+        case "issue_comment": {
+            const issue = asRecord(payload.issue);
+            const number = positiveInt(issue === null || issue === void 0 ? void 0 : issue.number);
+            if (number === undefined) {
+                return undefined;
+            }
+            return (issue === null || issue === void 0 ? void 0 : issue.pull_request) !== undefined && issue.pull_request !== null
+                ? { type: "pr", number }
+                : { type: "issue", number };
+        }
+        case "check_suite": {
+            const number = firstPullRequestNumber(asRecord(payload.check_suite));
+            return number === undefined ? undefined : { type: "pr", number };
+        }
+        case "check_run": {
+            const checkRun = asRecord(payload.check_run);
+            const number = (_c = firstPullRequestNumber(checkRun)) !== null && _c !== void 0 ? _c : firstPullRequestNumber(asRecord(checkRun === null || checkRun === void 0 ? void 0 : checkRun.check_suite));
+            return number === undefined ? undefined : { type: "pr", number };
+        }
+        default:
+            return undefined;
+    }
+}
+function extractSlack(payload) {
+    var _a, _b, _c, _d, _e, _f, _g;
+    const record = asRecord(payload);
+    if (record === undefined) {
+        return undefined;
+    }
+    // Events-API deliveries are the full event_callback body, so the
+    // identity fields live under `event`. Top-level fields still win for
+    // pre-flattened payloads (Socket Mode local dev, tests). Keep in
+    // lockstep with the control-plane twin (SlackThreadExtractor).
+    const event = asRecord(record.event);
+    const channelId = (_c = (_b = (_a = nonEmpty(record.channelId)) !== null && _a !== void 0 ? _a : nonEmpty(record.channel_id)) !== null && _b !== void 0 ? _b : nonEmpty(record.channel)) !== null && _c !== void 0 ? _c : nonEmpty(event === null || event === void 0 ? void 0 : event.channel);
+    const threadTs = (_g = (_f = (_e = (_d = nonEmpty(record.threadTs)) !== null && _d !== void 0 ? _d : nonEmpty(record.thread_ts)) !== null && _e !== void 0 ? _e : nonEmpty(event === null || event === void 0 ? void 0 : event.thread_ts)) !== null && _f !== void 0 ? _f : nonEmpty(record.ts)) !== null && _g !== void 0 ? _g : nonEmpty(event === null || event === void 0 ? void 0 : event.ts);
+    if (channelId === undefined) {
+        return undefined;
+    }
+    if (!isSlackImChannel(channelId) && threadTs === undefined) {
+        return undefined;
+    }
+    return `cont:${slackThreadKey(channelId, threadTs !== null && threadTs !== void 0 ? threadTs : "")}`;
+}
+function extractOrigin(payload) {
+    var _a, _b;
+    var _c, _d, _e, _f;
+    const record = originExtractRecord(payload);
+    if (record === undefined) {
+        return undefined;
+    }
+    const inner = (_c = asRecord(record.pullRequest)) !== null && _c !== void 0 ? _c : asRecord(record.pull_request);
+    const number = positiveInt(inner === null || inner === void 0 ? void 0 : inner.number);
+    const repository = (_d = asRecord(record.repository)) !== null && _d !== void 0 ? _d : asRecord(inner === null || inner === void 0 ? void 0 : inner.repository);
+    const fullName = (_f = (_e = nonEmpty((_a = asRecord(repository)) === null || _a === void 0 ? void 0 : _a.fullName)) !== null && _e !== void 0 ? _e : nonEmpty((_b = asRecord(repository)) === null || _b === void 0 ? void 0 : _b.full_name)) !== null && _f !== void 0 ? _f : originFullName(repository);
+    if (number === undefined || fullName === undefined) {
+        return undefined;
+    }
+    return `cont:${formatConversationKey("origin-pr", { fullName, number })}`;
+}
+/**
+ * Mailbox stores the Origin delivery envelope; local/hosted CP extract
+ * also accepts the compact `{ pullRequest, repository }` shape.
+ */
+function originExtractRecord(payload) {
+    var _a;
+    const record = asRecord(payload);
+    if (record === undefined) {
+        return undefined;
+    }
+    const nested = asRecord((_a = asRecord(record.event)) === null || _a === void 0 ? void 0 : _a.payload);
+    if (nested !== undefined && asRecord(record.pullRequest) === undefined) {
+        return nested;
+    }
+    return record;
+}
+/**
+ * GitLab merge request identity: `project.path_with_namespace` (nested
+ * groups keep their slashes; lowercased like the scope key) plus the MR
+ * `iid`. `merge_request` reads `object_attributes.iid`; `note` binds only
+ * MR notes (`noteable_type: "MergeRequest"`); `pipeline` binds only when
+ * the payload carries a `merge_request`.
+ */
+function extractGitlab(eventName, payload) {
+    var _a, _b, _c, _d, _e, _f;
+    const record = asRecord(payload);
+    if (record === undefined) {
+        return undefined;
+    }
+    const fullName = (_b = nonEmpty((_a = asRecord(record.project)) === null || _a === void 0 ? void 0 : _a.path_with_namespace)) === null || _b === void 0 ? void 0 : _b.toLowerCase();
+    if (fullName === undefined) {
+        return undefined;
+    }
+    let number;
+    switch (eventName) {
+        case "merge_request":
+            number = positiveInt((_c = asRecord(record.object_attributes)) === null || _c === void 0 ? void 0 : _c.iid);
+            break;
+        case "note":
+            if (((_d = asRecord(record.object_attributes)) === null || _d === void 0 ? void 0 : _d.noteable_type) !== "MergeRequest") {
+                return undefined;
+            }
+            number = positiveInt((_e = asRecord(record.merge_request)) === null || _e === void 0 ? void 0 : _e.iid);
+            break;
+        case "pipeline":
+            number = positiveInt((_f = asRecord(record.merge_request)) === null || _f === void 0 ? void 0 : _f.iid);
+            break;
+        default:
+            return undefined;
+    }
+    if (number === undefined) {
+        return undefined;
+    }
+    return `cont:${formatConversationKey("gitlab-mr", { fullName, number })}`;
+}
+/**
+ * Bitbucket pull request identity from either dialect. Cloud payloads carry
+ * `repository.full_name` + `pullrequest.id`; Data Center payloads carry
+ * `pullRequest.id` and the repo under `pullRequest.toRef.repository`
+ * (`project.key/slug`). Lowercased so a Cloud/DC pair for one logical PR
+ * shares a key.
+ */
+function extractBitbucket(payload) {
+    var _a;
+    var _b, _c;
+    const record = asRecord(payload);
+    if (record === undefined) {
+        return undefined;
+    }
+    const pullRequest = (_b = asRecord(record.pullrequest)) !== null && _b !== void 0 ? _b : asRecord(record.pullRequest);
+    const number = positiveInt(pullRequest === null || pullRequest === void 0 ? void 0 : pullRequest.id);
+    const fullName = bitbucketFullName((_c = asRecord(record.repository)) !== null && _c !== void 0 ? _c : asRecord((_a = asRecord(pullRequest === null || pullRequest === void 0 ? void 0 : pullRequest.toRef)) === null || _a === void 0 ? void 0 : _a.repository));
+    if (number === undefined || fullName === undefined) {
+        return undefined;
+    }
+    return `cont:${formatConversationKey("bitbucket-pr", { fullName, number })}`;
+}
+function bitbucketFullName(repository) {
+    var _a;
+    if (repository === undefined) {
+        return undefined;
+    }
+    const cloud = nonEmpty(repository.full_name);
+    if (cloud !== undefined) {
+        return cloud.toLowerCase();
+    }
+    const projectKey = nonEmpty((_a = asRecord(repository.project)) === null || _a === void 0 ? void 0 : _a.key);
+    const slug = nonEmpty(repository.slug);
+    if (projectKey === undefined || slug === undefined) {
+        return undefined;
+    }
+    return `${projectKey}/${slug}`.toLowerCase();
+}
+function extractNamedResource(type, field, payload, wrapper) {
+    const record = asRecord(payload);
+    const source = wrapper === undefined ? record : asRecord(record === null || record === void 0 ? void 0 : record[wrapper]);
+    const value = nonEmpty(source === null || source === void 0 ? void 0 : source[wrapper === undefined ? field : "name"]);
+    if (value === undefined) {
+        return undefined;
+    }
+    return `cont:${formatConversationKey(type, { [field]: value })}`;
+}
+function githubFullName(payload) {
+    var _a;
+    const repository = asRecord(payload.repository);
+    return (_a = nonEmpty(repository === null || repository === void 0 ? void 0 : repository.full_name)) !== null && _a !== void 0 ? _a : originFullName(repository);
+}
+function originFullName(repository) {
+    var _a, _b, _c;
+    var _d, _e, _f;
+    if (repository === undefined) {
+        return undefined;
+    }
+    const owner = (_f = (_e = (_d = nonEmpty((_a = asRecord(repository.owner)) === null || _a === void 0 ? void 0 : _a.slug)) !== null && _d !== void 0 ? _d : nonEmpty(repository.owner)) !== null && _e !== void 0 ? _e : nonEmpty((_b = asRecord(repository.owner)) === null || _b === void 0 ? void 0 : _b.login)) !== null && _f !== void 0 ? _f : nonEmpty((_c = asRecord(repository.owner)) === null || _c === void 0 ? void 0 : _c.name);
+    const name = nonEmpty(repository.name);
+    if (owner === undefined || name === undefined) {
+        return undefined;
+    }
+    return `${owner}/${name}`;
+}
+function firstPullRequestNumber(record) {
+    var _a;
+    const pullRequests = record === null || record === void 0 ? void 0 : record.pull_requests;
+    if (!Array.isArray(pullRequests) || pullRequests.length === 0) {
+        return undefined;
+    }
+    return positiveInt((_a = asRecord(pullRequests[0])) === null || _a === void 0 ? void 0 : _a.number);
+}
+function asRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value)
+        ? value
+        : undefined;
+}
+function nonEmpty(value) {
+    return typeof value === "string" && value.trim() !== "" ? value.trim() : undefined;
+}
+function positiveInt(value) {
+    if (typeof value === "number" && Number.isInteger(value) && value > 0) {
+        return value;
+    }
+    if (typeof value === "string" && /^[1-9]\d*$/.test(value)) {
+        return Number(value);
+    }
+    return undefined;
+}