@builder.io/ai-utils 0.39.0 → 0.41.0

package/package.json

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

package/src/codegen.d.ts

@@ -60,6 +60,13 @@ export interface CustomAgentDefinition {
     filePath?: string;
     /** Default reasoning effort level for this agent type. Overrides the session default. */
     reasoning?: ReasoningEffort;
+    /**
+     * When true and the parent session has an explicit model override (e.g. set
+     * via org/project PR-reviewer settings), that model is used for this agent
+     * instead of the agent's own `model` / `roundRobinModels` defaults.
+     * Has no effect when no session-level model override is present.
+     */
+    inheritSessionModel?: boolean;
 }
 export type CodeGenFramework = "react" | "html" | "mitosis" | "react-native" | "angular" | "vue" | "svelte" | "qwik" | "solid" | "marko" | "swiftui" | "jetpack-compose" | "flutter";
 export type CodeGenStyleLibrary = "tailwind" | "tailwind-precise" | "emotion" | "styled-components" | "styled-jsx" | "react-native" | undefined;
@@ -190,9 +197,6 @@ export interface AgentToolInput {
     origin_channel_id?: string;
     attachmentUrls?: string[];
 }
-export interface ListDirToolInput {
-    path: string;
-}
 export interface RevertToolInput {
     checkpoint_id: string;
 }
@@ -691,7 +695,6 @@ export interface CodeGenToolMap {
     TodoRead: TodoReadToolInput;
     TodoWrite: TodoWriteToolInput;
     BuilderEdit: BuilderEditToolInput;
-    LS: ListDirToolInput;
     WebFetch: WebFetchToolInput;
     ExplorationMetadata: ExplorationMetadataToolInput;
     EnterPlanMode: EnterPlanModeToolInput;

package/src/events.d.ts

@@ -505,6 +505,36 @@ export declare const GitPrMergedV1: {
     eventName: "git.pr.merged";
     version: "1";
 };
+export type BotMentionExternalPrV1 = FusionEventVariant<"bot.mention.external-pr", {
+    projectId: string;
+    repoFullName: string;
+    prNumber: number;
+    comment: string;
+    commentLink?: string;
+    commentNumericId?: number;
+    commentIdStr: string;
+    deliveryId: string;
+    commentType: "issue" | "pr";
+    userName?: string;
+    gitUserId?: string;
+    hostname?: string;
+    prHeadRef?: string;
+    isFork?: boolean;
+    filePath?: string;
+    startLine?: number;
+    endLine?: number;
+    diffHunk?: string;
+    replyToCommentId?: number;
+    inReplyToCommentId?: number;
+    prTitle?: string;
+    authorAssociation?: string;
+}, {
+    projectId: string;
+}, 1>;
+export declare const BotMentionExternalPrV1: {
+    eventName: "bot.mention.external-pr";
+    version: "1";
+};
 export type ClientDevtoolsSessionStartedEvent = FusionEventVariant<"client.devtools.session.started", {
     sessionId?: string;
     sessionType?: string;
@@ -524,7 +554,10 @@ export type ClientDevtoolsSessionIdleEventV1 = FusionEventVariant<"client.devtoo
     branchName?: string;
     hasPlanToApply?: boolean;
     sessionMode?: string;
-}, {}, 1>;
+}, {
+    projectId?: string;
+    branchName?: string;
+}, 1>;
 export declare const ClientDevtoolsSessionIdleEventV1: {
     eventName: "client.devtools.session.idle";
     version: "1";
@@ -723,7 +756,7 @@ export interface SendMessageToOrgAgentInput {
      */
     autoCreateProject?: boolean;
 }
-export type FusionEvent = AiTaskCompletedEvent | AiTaskFailedEvent | ClientDevtoolsSessionStartedEvent | ClientDevtoolsSessionIdleEventV1 | FusionProjectCreatedV1 | SetupAgentCompletedV1 | GitPrMergedV1 | GitPrCreatedV1 | GitPrClosedV1 | ForceSetupAgentV1 | ClawMessageSentV1 | CodegenCompletionV1 | CodegenUserPromptV1 | GitWebhooksRegisterV1 | FusionProjectSettingsUpdatedV1 | VideoRecordingCompletedV1 | FusionBranchCreatedV1 | FusionBranchContainerStartedV1 | FusionBranchMessageSentV1 | FusionBranchFailedV1;
+export type FusionEvent = AiTaskCompletedEvent | AiTaskFailedEvent | ClientDevtoolsSessionStartedEvent | ClientDevtoolsSessionIdleEventV1 | FusionProjectCreatedV1 | SetupAgentCompletedV1 | GitPrMergedV1 | GitPrCreatedV1 | GitPrClosedV1 | ForceSetupAgentV1 | ClawMessageSentV1 | CodegenCompletionV1 | CodegenUserPromptV1 | GitWebhooksRegisterV1 | FusionProjectSettingsUpdatedV1 | VideoRecordingCompletedV1 | FusionBranchCreatedV1 | FusionBranchContainerStartedV1 | FusionBranchMessageSentV1 | FusionBranchFailedV1 | BotMentionExternalPrV1;
 export interface ModelPermissionRequiredEvent {
     type: "assistant.model.permission.required";
     data: {

package/src/events.js

@@ -18,6 +18,10 @@ export const GitPrMergedV1 = {
     eventName: "git.pr.merged",
     version: "1",
 };
+export const BotMentionExternalPrV1 = {
+    eventName: "bot.mention.external-pr",
+    version: "1",
+};
 export const ClientDevtoolsSessionStartedEvent = {
     eventName: "client.devtools.session.started",
     version: "1",

package/src/index.d.ts

@@ -10,5 +10,6 @@ export * from "./organization.js";
 export * from "./features.js";
 export * from "./vscode-tunnel.js";
 export * from "./claw.js";
+export * from "./kube-error.js";
 export * from "./connectivity/types.js";
 export { connectivityErrorCodeToLikelyCause, mapConnectivityErrorMessage, } from "./connectivity/error-codes.js";

package/src/index.js

@@ -10,5 +10,6 @@ export * from "./organization.js";
 export * from "./features.js";
 export * from "./vscode-tunnel.js";
 export * from "./claw.js";
+export * from "./kube-error.js";
 export * from "./connectivity/types.js";
 export { connectivityErrorCodeToLikelyCause, mapConnectivityErrorMessage, } from "./connectivity/error-codes.js";

package/src/kube-error.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Extract the HTTP status code from a Kubernetes client error.
+ * ApiException (v1.x) uses numeric `.code`, but raw network errors (e.g. ECONNREFUSED)
+ * set `.code` to a string. This helper ensures we always return a number.
+ */
+export declare function kubeErrorStatus(error: any): number;

package/src/kube-error.js

@@ -0,0 +1,13 @@
+/**
+ * Extract the HTTP status code from a Kubernetes client error.
+ * ApiException (v1.x) uses numeric `.code`, but raw network errors (e.g. ECONNREFUSED)
+ * set `.code` to a string. This helper ensures we always return a number.
+ */
+export function kubeErrorStatus(error) {
+    var _a;
+    if (typeof error.code === "number")
+        return error.code;
+    if (typeof ((_a = error.response) === null || _a === void 0 ? void 0 : _a.statusCode) === "number")
+        return error.response.statusCode;
+    return 0;
+}

package/src/organization.d.ts

@@ -54,6 +54,8 @@ export interface FallbackTokensPrivate {
         token: string;
     };
 }
+export type BackgroundAgentsWebhookEvent = "started" | "completed" | "error";
+export type BackgroundAgentsWebhookEvents = ["all"] | BackgroundAgentsWebhookEvent[];
 interface OrganizationSettings {
     attribution?: string[];
     visualEditorAiStyleInspirationURL?: string;
@@ -92,6 +94,10 @@ interface OrganizationSettings {
     ticketAssessmentPrompt?: string;
     ticketAssessmentModel?: string;
     ticketAssessmentDailyLimit?: number;
+    backgroundAgentsWebhook?: {
+        url?: string;
+        events?: BackgroundAgentsWebhookEvents;
+    };
 }
 interface RoleOptions {
     read?: boolean;

package/src/projects.d.ts

@@ -405,6 +405,8 @@ export interface BranchMetadata {
     description?: string;
     /** Whether the branch is a cloned branch */
     isClonedBranch?: boolean;
+    /** Data passed in via /agents/run api that we echo in webhook response **/
+    webhookContext?: Record<string, unknown>;
     [key: string]: unknown;
 }
 export type PRStatus = "open" | "closed" | "merged" | "draft" | "approved";
@@ -675,6 +677,11 @@ export interface Project {
         httpsServerHonorCipherOrder?: boolean;
         httpsServerRequestCert?: boolean;
         httpsServerRejectUnauthorized?: boolean;
+        /**
+         * When true, this project is the preferred project for its connected repository.
+         * Agents will pick this project when asked to do something with the connected repository.
+         */
+        isPreferredForRepo?: boolean;
     };
     screenshot: string | null;
     isExample?: boolean;
@@ -747,6 +754,7 @@ export interface OrganizationPrivate {
     createdAt: number;
     updatedAt: number;
     fallbackTokens?: FallbackTokensPrivate;
+    backgroundAgentsWebhookSecret?: string;
 }
 export interface CreateProjectOptions {
     name?: string;