@builder.io/ai-utils 0.67.0 → 0.68.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@builder.io/ai-utils",
-  "version": "0.67.0",
+  "version": "0.68.0",
   "description": "Builder.io AI utils",
   "files": [
     "src"

package/src/events.d.ts

@@ -528,7 +528,7 @@ export declare const ReviewSubmittedV1: {
     eventName: "review.submitted";
     version: "1";
 };
-export type BotMentionExternalPrV1 = FusionEventVariant<"bot.mention.external-pr", {
+export type BotMentionGitHubExternalPrV1 = FusionEventVariant<"bot.mention.external-pr", {
     projectId: string;
     repoFullName: string;
     prNumber: number;
@@ -554,10 +554,148 @@ export type BotMentionExternalPrV1 = FusionEventVariant<"bot.mention.external-pr
 }, {
     projectId: string;
 }, 1>;
-export declare const BotMentionExternalPrV1: {
+export declare const BotMentionGitHubExternalPrV1: {
     eventName: "bot.mention.external-pr";
     version: "1";
 };
+/**
+ * Common fields shared by all four bot-mention PR events.
+ *
+ * Extracting this base makes the future consolidation into a single
+ * `bot.mention.pr` event straightforward: the unified type will be
+ * `BaseBotMentionEventData & { provider: ..., ...providerSpecificOptionals }`.
+ */
+export type BaseBotMentionEventData = {
+    /** Fusion project ID resolved from PR metadata */
+    projectId: string;
+    /** Fusion branch name resolved from PR metadata */
+    branchName: string;
+    /** Raw comment body that triggered the bot mention */
+    comment: string;
+    commentLink?: string;
+    /** Dedup lock key — composite of comment ID and delivery ID */
+    commentIdStr: string;
+    userName?: string;
+    /** Provider-specific user ID as string (for credits / analytics) */
+    gitUserId?: string;
+    /** Commenter email when available from the provider (preferred for user resolution) */
+    userEmail?: string;
+    /** Original webhook delivery ID — passed through for logging */
+    webhookEventId: string;
+};
+/**
+ * Emitted when @builderio-bot is mentioned on a Fusion (internal) GitHub PR comment.
+ * Pre-flight checks (project existence, installation token, GitHub App rights) have
+ * already passed before this event is published. The heavy work — container
+ * provisioning and AI processing — is handled asynchronously by the subscriber.
+ */
+export type BotMentionGitHubInternalPrV1 = FusionEventVariant<"bot.mention.github-internal-pr", BaseBotMentionEventData & {
+    provider: "github";
+    repoFullName: string;
+    prNumber: number;
+    /** Numeric GitHub comment ID (for reaction / reply threading) */
+    commentNumericId?: number;
+    commentType: "issue" | "pr";
+    /** GitHub Enterprise hostname, if applicable */
+    hostname?: string;
+    /** For review comments: the comment being replied to */
+    inReplyToCommentId?: number;
+    /** For review comments: unified diff context */
+    diffHunk?: string;
+    /** For review comments: file path */
+    filePath?: string;
+    /** For review comments: first line of the comment range */
+    startLine?: number;
+    /** For review comments: last line of the comment range */
+    endLine?: number;
+    /** For review comments: reply target comment ID */
+    replyToCommentId?: number;
+}, {
+    projectId: string;
+}, 1>;
+export declare const BotMentionGitHubInternalPrV1: {
+    eventName: "bot.mention.github-internal-pr";
+    version: "1";
+};
+/**
+ * Emitted when @builderio-bot is mentioned on a GitLab MR comment.
+ * Pre-flight checks have already passed before this event is published.
+ * Container provisioning and AI processing happen asynchronously in the subscriber.
+ */
+export type BotMentionGitLabPrV1 = FusionEventVariant<"bot.mention.gitlab-pr", BaseBotMentionEventData & {
+    provider: "gitlab";
+    /** GitLab numeric project ID (needed to re-fetch token and post comments) */
+    gitlabProjectId: number;
+    /** GitLab MR IID */
+    mrId: number;
+    /**
+     * Thread discussion ID for threaded replies.
+     * GitLab sends this as a hex SHA string (e.g. "6a9c1750b37d..."),
+     * not a number — used only in URL interpolation.
+     */
+    discussionId?: string;
+    /** GitLab Enterprise hostname, if applicable */
+    hostname?: string;
+}, {
+    projectId: string;
+}, 1>;
+export declare const BotMentionGitLabPrV1: {
+    eventName: "bot.mention.gitlab-pr";
+    version: "1";
+};
+/**
+ * Emitted when @builderio-bot is mentioned on a Bitbucket PR comment.
+ * Pre-flight checks have already passed before this event is published.
+ */
+export type BotMentionBitbucketPrV1 = FusionEventVariant<"bot.mention.bitbucket-pr", BaseBotMentionEventData & {
+    provider: "bitbucket";
+    /** e.g. "workspace/repo" */
+    repositorySlug: string;
+    workspace?: string;
+    pullRequestId: number;
+    /** Numeric Bitbucket comment ID — used as parentCommentId for reply threading */
+    parentCommentId?: number;
+    /** PR browser URL (links.html.href from the pullrequest payload) */
+    pullRequestUrl?: string;
+    /** PR title from the pullrequest payload */
+    pullRequestTitle?: string;
+    /** PR description from the pullrequest payload */
+    pullRequestDescription?: string;
+}, {
+    projectId: string;
+}, 1>;
+export declare const BotMentionBitbucketPrV1: {
+    eventName: "bot.mention.bitbucket-pr";
+    version: "1";
+};
+/**
+ * Emitted when @builderio-bot is mentioned on an Azure DevOps PR comment.
+ * Pre-flight checks have already passed before this event is published.
+ */
+export type BotMentionAzurePrV1 = FusionEventVariant<"bot.mention.azure-pr", BaseBotMentionEventData & {
+    provider: "azure";
+    azureOrg: string;
+    azureProject: string;
+    pullRequestId: number;
+    /** Repository ID extracted from comment links */
+    repositoryId: string;
+    /** Thread link URL — used for reply threading and thread context */
+    threadLink: string;
+    /**
+     * The actual Azure DevOps REST URL of the pull request
+     * (event.resource.url or pullRequest.url from the webhook payload).
+     * Distinct from commentLink which is the comment resource URL.
+     */
+    pullRequestUrl?: string;
+    /** PR description from the pullrequest payload */
+    pullRequestDescription?: string;
+}, {
+    projectId: string;
+}, 1>;
+export declare const BotMentionAzurePrV1: {
+    eventName: "bot.mention.azure-pr";
+    version: "1";
+};
 export type ClientDevtoolsSessionStartedEvent = FusionEventVariant<"client.devtools.session.started", {
     sessionId?: string;
     sessionType?: string;
@@ -1030,7 +1168,7 @@ export declare const ClientDevtoolsToolResultV1: {
     eventName: "client.devtools.tool.result";
     version: "1";
 };
-export type FusionEvent = ClientDevtoolsSessionStartedEvent | ClientDevtoolsSessionIdleEventV1 | ClientDevtoolsToolCallRequestV1 | ClientDevtoolsToolCallV1 | ClientDevtoolsToolResultV1 | FusionProjectCreatedV1 | SetupAgentCompletedV1 | GitPrMergedV1 | GitPrCreatedV1 | GitPrClosedV1 | ForceSetupAgentV1 | ClawMessageSentV1 | CodegenCompletionV1 | CodegenUserPromptV1 | GitWebhooksRegisterV1 | FusionProjectSettingsUpdatedV1 | VideoRecordingCompletedV1 | TimelineRecordingReadyV1 | FusionBranchCreatedV1 | FusionContainerStartedV1 | FusionContainerFailedV1 | FusionBranchFailedV1 | BotMentionExternalPrV1 | ReviewSubmittedV1 | PrReviewRequestedV1 | FigmaDecodeJobV1 | ProjectSnapshotRefreshV1 | ProjectSnapshotCapturedV1 | ProjectSnapshotCreatedV1 | ProjectSnapshotFailedV1 | ProjectSnapshotReadyCheckV1 | ProjectSnapshotPodWatchV1;
+export type FusionEvent = ClientDevtoolsSessionStartedEvent | ClientDevtoolsSessionIdleEventV1 | ClientDevtoolsToolCallRequestV1 | ClientDevtoolsToolCallV1 | ClientDevtoolsToolResultV1 | FusionProjectCreatedV1 | SetupAgentCompletedV1 | GitPrMergedV1 | GitPrCreatedV1 | GitPrClosedV1 | ForceSetupAgentV1 | ClawMessageSentV1 | CodegenCompletionV1 | CodegenUserPromptV1 | GitWebhooksRegisterV1 | FusionProjectSettingsUpdatedV1 | VideoRecordingCompletedV1 | TimelineRecordingReadyV1 | FusionBranchCreatedV1 | FusionContainerStartedV1 | FusionContainerFailedV1 | FusionBranchFailedV1 | BotMentionGitHubExternalPrV1 | BotMentionGitHubInternalPrV1 | BotMentionGitLabPrV1 | BotMentionBitbucketPrV1 | BotMentionAzurePrV1 | ReviewSubmittedV1 | PrReviewRequestedV1 | FigmaDecodeJobV1 | ProjectSnapshotRefreshV1 | ProjectSnapshotCapturedV1 | ProjectSnapshotCreatedV1 | ProjectSnapshotFailedV1 | ProjectSnapshotReadyCheckV1 | ProjectSnapshotPodWatchV1;
 export interface ModelPermissionRequiredEvent {
     type: "assistant.model.permission.required";
     data: {

package/src/events.js

@@ -14,10 +14,26 @@ export const ReviewSubmittedV1 = {
     eventName: "review.submitted",
     version: "1",
 };
-export const BotMentionExternalPrV1 = {
+export const BotMentionGitHubExternalPrV1 = {
     eventName: "bot.mention.external-pr",
     version: "1",
 };
+export const BotMentionGitHubInternalPrV1 = {
+    eventName: "bot.mention.github-internal-pr",
+    version: "1",
+};
+export const BotMentionGitLabPrV1 = {
+    eventName: "bot.mention.gitlab-pr",
+    version: "1",
+};
+export const BotMentionBitbucketPrV1 = {
+    eventName: "bot.mention.bitbucket-pr",
+    version: "1",
+};
+export const BotMentionAzurePrV1 = {
+    eventName: "bot.mention.azure-pr",
+    version: "1",
+};
 export const ClientDevtoolsSessionStartedEvent = {
     eventName: "client.devtools.session.started",
     version: "1",