@builder.io/ai-utils 0.12.29 → 0.13.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@builder.io/ai-utils",
-  "version": "0.12.29",
+  "version": "0.13.1",
   "description": "Builder.io AI utils",
   "type": "module",
   "main": "src/index.js",

package/src/codegen.d.ts

@@ -28,6 +28,7 @@ export interface CustomInstruction {
     filePath?: string;
     glob?: string;
     description?: string;
+    allowedTools?: string[];
 }
 export interface CustomAgentInfo {
     name: string;
@@ -46,7 +47,7 @@ export interface CustomAgentDefinition {
 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;
 export type CompletionStopReason = "max_tokens" | "stop_sequence" | "tool_use" | "end_turn" | "content_filter" | "error" | "aborted" | "pause_turn" | "refusal" | "model_context_window_exceeded" | null;
-export interface ViewPathToolInput {
+export interface ReadToolInput {
     file_path: string;
     view_range?: [number, number];
     offset?: number | null;
@@ -189,8 +190,12 @@ export interface ExplorationMetadataToolInput {
 export interface ExitPlanModeToolInput {
     plan: string;
 }
+export interface ReadMcpResourceToolInput {
+    uri: string;
+    serverName?: string;
+}
 export interface CodeGenToolMap {
-    view_path: ViewPathToolInput;
+    view_path: ReadToolInput;
     glob_search: GlobSearchToolInput;
     grep_search: GrepSearchToolInput;
     get_rule: GetRuleToolInput;
@@ -203,7 +208,7 @@ export interface CodeGenToolMap {
     write_file: WriteFileInput;
     search_replace_file: SearchReplaceInput;
     find_media: FindMediaToolInput;
-    Read: ViewPathToolInput;
+    Read: ReadToolInput;
     Write: WriteFileInput;
     Edit: SearchReplaceInput;
     ReadRule: GetRuleToolInput;
@@ -229,12 +234,13 @@ export interface CodeGenToolMap {
     WebFetch: WebFetchToolInput;
     ExplorationMetadata: ExplorationMetadataToolInput;
     ExitPlanMode: ExitPlanModeToolInput;
+    ReadMcpResource: ReadMcpResourceToolInput;
 }
 export type CodeGenTools = keyof CodeGenToolMap;
 export type AllCodeGenTools = CodeGenTools | "web_search";
 export type SessionMode = "planning" | "normal" | "auto-planning";
 export type CodeGenMode = "quality" | "quality-v3" | "quality-v4" | "quality-v4-agent";
-export type BaseCodeGenPosition = "fusion" | "editor-ai" | "repo-indexing" | "cli" | "create-app-firebase" | "create-app-lovable" | "builder-code-panel";
+export type BaseCodeGenPosition = "fusion" | "editor-ai" | "repo-indexing" | "cli" | "create-app-firebase" | "create-app-lovable" | "builder-code-panel" | "dsi-mcp";
 export type CodeGenPosition = BaseCodeGenPosition | `${BaseCodeGenPosition}-agent`;
 export interface RepoIndexingConfig {
     designSystems: string[];
@@ -259,6 +265,7 @@ export interface CodeGenInputOptions {
     customAgents?: CustomAgentInfo[];
     systemPromptOverride?: string;
     userPrompt?: string;
+    systemRemainderPrompt?: string;
     ephemeralUserPrompt?: string;
     uiContextPrompt?: string;
     displayUserPrompt?: string;
@@ -744,6 +751,7 @@ export interface GenerateUserMessage {
 export interface UserInput {
     userMessage: GenerateUserMessage | undefined;
     userPrompt: string;
+    systemRemainderPrompt: string | undefined;
     attachments: Attachment[];
     files: ProjectFile[];
     searchResponse: CodebaseSearchResponse | null;

package/src/organization.d.ts

@@ -13,6 +13,12 @@ export interface BitbucketEnterprisePAT {
     host: string;
     botUsername: string;
 }
+export interface GitlabEnterprisePATValue {
+    token: string;
+    host: string;
+    botUsername: string;
+    secondaryHost?: string;
+}
 interface OrganizationSettings {
     attribution?: string[];
     visualEditorAiStyleInspirationURL?: string;
@@ -26,6 +32,7 @@ interface OrganizationSettings {
     isUserPluginIntegrationRequestGranted?: boolean;
     shopify?: boolean;
     githubEnterpriseSetupValue?: GithubEnterpriseSetupValue;
+    gitlabEnterprisePAT?: GitlabEnterprisePATValue;
     bitbucketEnterprisePAT?: BitbucketEnterprisePAT;
     useProxy?: boolean;
     fusionShareableUrlSuffix?: string;

package/src/projects.d.ts

@@ -278,8 +278,6 @@ export interface PartialBranchData {
 }
 export type EntityState = "active" | "deleted";
 interface BranchSharedData {
-    lockedFusionEnvironment?: FusionExecutionEnvironment;
-    id?: string;
     appName?: string | null;
     prNumber?: number | null;
     prUrl?: string | null;
@@ -298,8 +296,6 @@ interface BranchSharedData {
     createdBy?: string;
     isPublic?: boolean;
     isDefault?: boolean;
-    sessionId?: string;
-    createdAt?: number | null;
     friendlyName?: string;
     useHomeDir?: boolean;
     useCloudHomeDir?: boolean;
@@ -314,25 +310,34 @@ interface BranchSharedData {
     backup?: BranchBackup;
     metadata?: Record<string, unknown>;
     needsCleanup?: boolean;
-    /** The state of the branch. Use `isBranchDeleted()` helper for backwards-compatible checks. */
-    state?: EntityState;
     /** @deprecated Use `state` field instead. Kept for backwards compatibility. */
     deleted?: boolean;
     deletedAt?: string;
     deletedBy?: string;
-    updatedAt?: string;
-    commitMode?: CommitMode;
     kubePodName?: string | null;
     kubeNamespace?: string | null;
     kubePvcName?: string | null;
     kubeHostname?: string | null;
     checkoutBranch?: string | null;
 }
+/**
+ * fields that are required in the new branch format, but optional in the legacy branch format.
+ */
+interface RequiredBranchSharedData {
+    /** The state of the branch. Use `isBranchDeleted()` helper for backwards-compatible checks. */
+    state: EntityState;
+    lockedFusionEnvironment: FusionExecutionEnvironment;
+    id: string;
+    sessionId: string;
+    createdAt: number;
+    updatedAt: string;
+    commitMode: CommitMode;
+}
 /**
  * LegacyBranch represents branch data as stored in the nested project.branches field.
  * This type does NOT include projectId or legacyId as those don't exist in the legacy format.
  */
-export interface LegacyBranch extends BranchSharedData {
+export interface LegacyBranch extends BranchSharedData, Partial<RequiredBranchSharedData> {
     preRecoveryData?: Partial<LegacyBranch> & {
         recoveryDate: Date;
     };
@@ -341,10 +346,9 @@ export interface LegacyBranch extends BranchSharedData {
  * NewBranch represents branch data as stored in the standalone branches collection.
  * Extends LegacyBranch with required projectId, name, and optional legacyId fields.
  */
-export interface NewBranch extends BranchSharedData {
-    /** The project this branch belongs to */
+export interface NewBranch extends BranchSharedData, RequiredBranchSharedData {
+    ownerId: string;
     projectId: string;
-    /** The branch name (required in new collection) */
     name: string;
     /** Legacy ID for mapping to project.branches[branchName] format: ${projectId}-${branchName} */
     legacyId: string;
@@ -405,9 +409,10 @@ export interface Project {
         validateCommand?: string;
         proxyOrigin?: string;
         proxyDefaultOrigin?: string;
-        gitBranchNamingStrategy?: "ai-session" | "branch-name" | "custom" | "ask-user";
+        gitBranchNamingStrategy?: "ai-session" | "branch-name" | "custom";
         setupDependencies?: SetupDependency[];
         gitBranchNamingCustom?: string;
+        askUserForBranchName?: boolean;
         devServerCommand?: string;
         cpuKind?: CpuKind;
         cpus?: 1 | 2 | 4;
@@ -478,6 +483,12 @@ export interface Project {
     state?: EntityState;
     deletedAt?: string;
     deletedBy?: string;
+    /**
+     * When true, branches are stored in the standalone `branches` collection
+     * instead of embedded in project.branches field.
+     * Defaults to false for backwards compatibility with existing projects.
+     */
+    useBranchesCollection?: boolean;
 }
 /**
  * Get the state of a branch, checking `state` first and falling back to `deleted` for backwards compatibility.