@builder.io/ai-utils 0.41.1 → 0.43.0

package/package.json

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

package/src/codegen.d.ts

@@ -57,6 +57,7 @@ export interface CustomAgentDefinition {
     mcpServers?: boolean;
     asyncSubAgents?: boolean;
     queueMode?: QueueMode;
+    softContextWindow?: number;
     filePath?: string;
     /** Default reasoning effort level for this agent type. Overrides the session default. */
     reasoning?: ReasoningEffort;
@@ -264,6 +265,25 @@ export interface ReportTestOutcomeToolInput {
     outcome: TestOutcome;
     summary: string;
     details?: string;
+    test_case_id?: string;
+    evidence_frame_count?: number;
+    failure_category?: TestCaseFailureCategory;
+    failure_detail?: string;
+    console_errors?: string;
+    network_failures?: string;
+    steps_attempted?: string;
+    urls_tested?: string[];
+}
+export type TestCaseFailureCategory = "env_issue" | "creds_missing" | "needs_user_input" | "server_not_ready" | "feature_not_reachable" | "timeout" | "assertion_failed" | "unexpected_error" | "not_applicable";
+export interface RegisterTestPlanToolInput {
+    mode: "quick" | "thorough";
+    test_cases: Array<{
+        id: string;
+        description: string;
+        expected_outcome: string;
+        priority: "critical" | "high" | "medium" | "low";
+        source?: string;
+    }>;
 }
 export type TimelineEventCategory = "navigation" | "interaction" | "assertion" | "error" | "milestone" | "code-change" | "observation";
 export interface TimelineEvent {
@@ -710,6 +730,7 @@ export interface CodeGenToolMap {
     ReportUIIssue: ReportUIIssueToolInput;
     ReportIssue: ReportIssueToolInput;
     ReportTestOutcome: ReportTestOutcomeToolInput;
+    RegisterTestPlan: RegisterTestPlanToolInput;
     VerifySetupCommand: VerifySetupCommandToolInput;
     VerifyDevCommand: VerifyDevCommandToolInput;
     VerifyDevServer: VerifyDevServerToolInput;
@@ -845,6 +866,10 @@ export interface CodeGenInputOptions {
      * @internal - Set by middleware, not by clients
      */
     branchAgentTypeChecked?: boolean;
+    /**
+     * The parent session ID, used to roll up sub-agent costs into the parent session's extraCost.
+     */
+    parentSessionId?: string;
     /** @deprecated */
     prevId?: string;
     /** @deprecated */
@@ -2340,6 +2365,7 @@ export interface LaunchInitializeSessionOptions {
     sessionId?: string;
     customInstructions?: CustomInstruction[];
     privacyMode?: PrivacyMode;
+    forceSessionReload?: boolean;
 }
 /**
  * Request for generating a commit message via LLM
@@ -2392,6 +2418,10 @@ export interface SessionData {
     description?: string;
     hasPlanToApply?: boolean;
     cost: number;
+    /** Cost from tools (e.g. WebSearch LLM calls) and sub-agent roll-ups. Total session cost = cost + extraCost. */
+    extraCost?: number;
+    /** If set, this session is a sub-agent of the given parent session. Used to avoid double-counting in aggregations. */
+    parentSessionId?: string;
     totalCompletions: number;
     numUserMessages: number;
     numNormalUserMessages: number;

package/src/events.d.ts

@@ -592,6 +592,8 @@ export type ClientDevtoolsSessionIdleEventV1 = FusionEventVariant<"client.devtoo
     branchName?: string;
     hasPlanToApply?: boolean;
     sessionMode?: string;
+    gifId?: string;
+    planContent?: string;
 }, {
     projectId?: string;
     branchName?: string;
@@ -717,7 +719,8 @@ export type FusionBranchCreatedV1 = FusionEventVariant<"fusion.branch.created",
     projectId: string;
     branchName: string;
     branchFriendlyName?: string;
-    actor: string;
+    createdBy: string;
+    actor?: string;
 }, {
     projectId: string;
     branchName: string;
@@ -726,7 +729,7 @@ export declare const FusionBranchCreatedV1: {
     eventName: "fusion.branch.created";
     version: "1";
 };
-export type FusionBranchContainerStartedV1 = FusionEventVariant<"fusion.branch.container-started", {
+export type FusionContainerStartedV1 = FusionEventVariant<"fusion.container.started", {
     projectId: string;
     branchName: string;
     url: string;
@@ -734,26 +737,26 @@ export type FusionBranchContainerStartedV1 = FusionEventVariant<"fusion.branch.c
     projectId: string;
     branchName: string;
 }, 1>;
-export declare const FusionBranchContainerStartedV1: {
-    eventName: "fusion.branch.container-started";
+export declare const FusionContainerStartedV1: {
+    eventName: "fusion.container.started";
     version: "1";
 };
-export type FusionBranchMessageSentV1 = FusionEventVariant<"fusion.branch.message-sent", {
+export type FusionContainerFailedV1 = FusionEventVariant<"fusion.container.failed", {
     projectId: string;
     branchName: string;
+    error: string;
 }, {
     projectId: string;
     branchName: string;
 }, 1>;
-export declare const FusionBranchMessageSentV1: {
-    eventName: "fusion.branch.message-sent";
+export declare const FusionContainerFailedV1: {
+    eventName: "fusion.container.failed";
     version: "1";
 };
 export type FusionBranchFailedV1 = FusionEventVariant<"fusion.branch.failed", {
     projectId: string;
     branchName?: string;
     error: string;
-    phase: string;
 }, {
     projectId: string;
     branchName?: string;
@@ -795,7 +798,76 @@ 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 | BotMentionExternalPrV1 | ReviewSubmittedV1;
+export type PrReviewRequestedV1 = FusionEventVariant<"pr.review.requested", {
+    repoFullName: string;
+    repoHtmlUrl?: string;
+    prNumber: number;
+    prTitle: string;
+    prDescription: string;
+    headRef: string;
+    headSha: string;
+    isDraft?: boolean;
+    forceRun?: boolean;
+    triggerSource?: string;
+    isSynchronize?: boolean;
+    isFork?: boolean;
+    forceBrowserTesting?: boolean;
+}, {}, 1>;
+export declare const PrReviewRequestedV1: {
+    eventName: "pr.review.requested";
+    version: "1";
+};
+export type ClientDevtoolsToolCallRequestV1 = FusionEventVariant<"client.devtools.tool.call-request", {
+    toolUseId: string;
+    toolName: string;
+    input?: unknown;
+    sessionId?: string;
+    projectId?: string;
+    branchName?: string;
+    messageValid?: boolean;
+}, {
+    toolName: string;
+    projectId?: string;
+    branchName?: string;
+}, 1>;
+export declare const ClientDevtoolsToolCallRequestV1: {
+    eventName: "client.devtools.tool.call-request";
+    version: "1";
+};
+export type ClientDevtoolsToolCallV1 = FusionEventVariant<"client.devtools.tool.call", {
+    toolUseId: string;
+    toolName: string;
+    content?: string;
+    sessionId?: string;
+    projectId?: string;
+    branchName?: string;
+}, {
+    toolName: string;
+    projectId?: string;
+    branchName?: string;
+}, 1>;
+export declare const ClientDevtoolsToolCallV1: {
+    eventName: "client.devtools.tool.call";
+    version: "1";
+};
+export type ClientDevtoolsToolResultV1 = FusionEventVariant<"client.devtools.tool.result", {
+    toolUseId: string;
+    toolName: string;
+    result?: unknown;
+    isError?: boolean;
+    sessionId?: string;
+    projectId?: string;
+    branchName?: string;
+}, {
+    toolName: string;
+    projectId?: string;
+    branchName?: string;
+}, 1>;
+export declare const ClientDevtoolsToolResultV1: {
+    eventName: "client.devtools.tool.result";
+    version: "1";
+};
+export type FusionEvent = AiTaskCompletedEvent | AiTaskFailedEvent | ClientDevtoolsSessionStartedEvent | ClientDevtoolsSessionIdleEventV1 | ClientDevtoolsToolCallRequestV1 | ClientDevtoolsToolCallV1 | ClientDevtoolsToolResultV1 | FusionProjectCreatedV1 | SetupAgentCompletedV1 | GitPrMergedV1 | GitPrCreatedV1 | GitPrClosedV1 | ForceSetupAgentV1 | ClawMessageSentV1 | CodegenCompletionV1 | CodegenUserPromptV1 | GitWebhooksRegisterV1 | FusionProjectSettingsUpdatedV1 | VideoRecordingCompletedV1 | FusionBranchCreatedV1 | FusionContainerStartedV1 | FusionContainerFailedV1 | FusionBranchFailedV1 | BotMentionExternalPrV1 | ReviewSubmittedV1 | PrReviewRequestedV1;
 export interface ModelPermissionRequiredEvent {
     type: "assistant.model.permission.required";
     data: {

package/src/events.js

@@ -70,12 +70,12 @@ export const FusionBranchCreatedV1 = {
     eventName: "fusion.branch.created",
     version: "1",
 };
-export const FusionBranchContainerStartedV1 = {
-    eventName: "fusion.branch.container-started",
+export const FusionContainerStartedV1 = {
+    eventName: "fusion.container.started",
     version: "1",
 };
-export const FusionBranchMessageSentV1 = {
-    eventName: "fusion.branch.message-sent",
+export const FusionContainerFailedV1 = {
+    eventName: "fusion.container.failed",
     version: "1",
 };
 export const FusionBranchFailedV1 = {
@@ -86,3 +86,19 @@ export const VideoRecordingCompletedV1 = {
     eventName: "video.recording.completed",
     version: "1",
 };
+export const PrReviewRequestedV1 = {
+    eventName: "pr.review.requested",
+    version: "1",
+};
+export const ClientDevtoolsToolCallRequestV1 = {
+    eventName: "client.devtools.tool.call-request",
+    version: "1",
+};
+export const ClientDevtoolsToolCallV1 = {
+    eventName: "client.devtools.tool.call",
+    version: "1",
+};
+export const ClientDevtoolsToolResultV1 = {
+    eventName: "client.devtools.tool.result",
+    version: "1",
+};

package/src/index.d.ts

@@ -12,4 +12,5 @@ export * from "./vscode-tunnel.js";
 export * from "./claw.js";
 export * from "./kube-error.js";
 export * from "./connectivity/types.js";
+export * from "./vpc-peering.js";
 export { connectivityErrorCodeToLikelyCause, mapConnectivityErrorMessage, } from "./connectivity/error-codes.js";

package/src/index.js

@@ -12,4 +12,5 @@ export * from "./vscode-tunnel.js";
 export * from "./claw.js";
 export * from "./kube-error.js";
 export * from "./connectivity/types.js";
+export * from "./vpc-peering.js";
 export { connectivityErrorCodeToLikelyCause, mapConnectivityErrorMessage, } from "./connectivity/error-codes.js";

package/src/organization.d.ts

@@ -101,6 +101,12 @@ interface OrganizationSettings {
     ticketAssessmentModel?: string;
     ticketAssessmentDailyLimit?: number;
     fusionWebhooks?: FusionWebhook[];
+    /** Default VPC peering ID for this space. References a document in the vpcPeerings collection.
+     *  Projects can override this with their own vpcPeering setting. */
+    defaultVpcPeering?: string;
+    controlModelAvailability?: boolean;
+    allowedAiModels?: string[];
+    autoModelOverride?: string;
 }
 interface RoleOptions {
     read?: boolean;

package/src/projects.d.ts

@@ -682,6 +682,9 @@ export interface Project {
          * Agents will pick this project when asked to do something with the connected repository.
          */
         isPreferredForRepo?: boolean;
+        /** VPC peering ID for this project. Overrides the space-level defaultVpcPeering.
+         *  References a document in the vpcPeerings collection. */
+        vpcPeering?: string;
     };
     screenshot: string | null;
     isExample?: boolean;

package/src/vpc-peering.d.ts

@@ -0,0 +1,24 @@
+export interface VpcPeering {
+    id: string;
+    ownerId: string;
+    cloud: "gcp";
+    gcpRegion: string;
+    gcpProjectId: string;
+    gcpNetworkName: string;
+    bridgeCidr: string;
+    customerDnsServers: string[];
+    importCustomRoutes: boolean;
+    proxyIp: string;
+    enabled: boolean;
+    createdAt: number;
+    updatedAt: number;
+}
+export interface CreateVpcPeeringParams {
+    cloud: "gcp";
+    gcpRegion: string;
+    gcpProjectId: string;
+    gcpNetworkName: string;
+    bridgeCidr: string;
+    customerDnsServers: string[];
+    importCustomRoutes?: boolean;
+}

package/src/vpc-peering.js

@@ -0,0 +1 @@
+export {};