@builder.io/ai-utils 0.18.0 → 0.18.2

package/package.json

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

package/src/codegen.d.ts

@@ -211,6 +211,24 @@ export interface RecordFrameToolInput {
     title: string;
     frame: "last-image";
 }
+export interface AddQAReviewComment {
+    file_path: string;
+    line: number;
+    title: string;
+    body: string;
+    severity: "critical" | "warning" | "info";
+    debugInfo?: string;
+}
+export interface AddQAReviewToolInput {
+    summary: string;
+    comments?: AddQAReviewComment[];
+    gif_id: string;
+}
+export interface ReportUIIssueToolInput {
+    title: string;
+    description: string;
+    debugInfo?: string;
+}
 export interface CodeGenToolMap {
     view_path: ReadToolInput;
     glob_search: GlobSearchToolInput;
@@ -254,6 +272,8 @@ export interface CodeGenToolMap {
     ExitPlanMode: ExitPlanModeToolInput;
     ReadMcpResource: ReadMcpResourceToolInput;
     RecordFrame: RecordFrameToolInput;
+    AddQAReview: AddQAReviewToolInput;
+    ReportUIIssue: ReportUIIssueToolInput;
 }
 export type CodeGenTools = keyof CodeGenToolMap;
 export type AllCodeGenTools = CodeGenTools | "web_search";
@@ -656,6 +676,7 @@ export interface GenerateCompletionStepDevServerState {
 }
 export interface GenerateCompletionStepGit {
     type: "git";
+    folderName?: string;
     isSessionDirty: boolean;
     hasGeneratingPlaceholder: boolean;
     remoteBranchExists: boolean;
@@ -818,6 +839,8 @@ export interface GenerateUserMessage {
     enabledMCPs?: string[];
     sessionMode?: SessionMode;
     queue?: boolean;
+    /** Enable AddQAReview tool for QA PR review branches */
+    enableQAReviewTool?: boolean;
     /** @deprecated */
     repair?: boolean;
 }
@@ -1058,6 +1081,43 @@ export interface WorkspaceConfiguration {
     agentsMD?: string;
     folders: WorkspaceFolder[];
 }
+/**
+ * Runtime context for a git-enabled repository.
+ * Used to track multiple git working directories in codegen.
+ */
+export interface GitRepoContext {
+    /** Folder name from WorkspaceFolder */
+    folderName: string;
+    /** Absolute path to the repository */
+    path: string;
+    /** Feature branch name */
+    branchName: string;
+    /** Original repo URL */
+    repoUrl?: string;
+    /** Repo name (e.g., owner/repo) */
+    repoName?: string;
+    /**
+     * Initial commit when first checked
+     */
+    initialCommit?: string;
+}
+/**
+ * Result from a multi-repo git operation.
+ */
+export interface MultiRepoOperationResult<T = unknown> {
+    /** True if all repos succeeded */
+    success: boolean;
+    /** True if some succeeded and some failed */
+    partialSuccess: boolean;
+    /** Per-repo results */
+    results: Array<{
+        folderName: string;
+        success: boolean;
+        result?: T;
+        error?: Error;
+        message?: string;
+    }>;
+}
 export type Permission = "read" | "write" | "list";
 export interface AclEntry {
     action: "allow" | "deny";
@@ -1402,6 +1462,8 @@ export interface PushChangesOptions {
         repoFullName: string;
         repoUrl: string;
     };
+    /** If specified, only push changes for this folder (multi-repo support) */
+    folderName?: string;
 }
 export interface SyncChangesFromRemote {
     remoteBranches?: "both" | "main" | "ai";

package/src/completion.d.ts

@@ -1,158 +1,154 @@
-import type {
-	BuilderContent,
-	BuilderElement,
-	Component,
-} from "@builder.io/sdk";
+import type { BuilderContent, BuilderElement, Component } from "@builder.io/sdk";
 import type { Message, MessageParam, Attachment } from "./messages.js";
 import type { BuilderModel } from "./events.js";
 export type { BuilderContent, BuilderElement, Component };
 export interface CompletionOptions {
-	/**
-	 * How this assistant is being used. For example, "content-editor"
-	 * is used when the assistant is being used in the Builder.io content editor.
-	 */
-	assistantType?: string;
-	/**
-	 * LLM Model identifier to lookup which sdk and model to use.
-	 * If not provided the default model will be used.
-	 * Note: This is not the Builder.io data model.
-	 */
-	modelId?: string;
-	/**
-	 * The unique LOCAL identifier of the thread to submit the user message to.
-	 * This is used to identify the thread with our own id (openai assistant id is different)
-	 */
-	id: string;
-	/**
-	 * The unique OPENAI assistant id of the thread to submit the user message to.
-	 * If the assistantThreadId is not provided, a new thread will be created.
-	 */
-	assistantThreadId?: string;
-	/**
-	 * The message history of the conversation, user prompt then assistant response.
-	 * The messages are ordered from oldest to newest. The last message in the array
-	 * is the message that the user has just sent.
-	 */
-	messages: (MessageParam | Message)[];
-	/**
-	 * Which platform (framework) the the user has choosen to get help with.
-	 */
-	platformId?: string;
-	/**
-	 * The user id of the user sending the message.
-	 * This is used to track the user's progress in the conversation.
-	 * User id is stored in localStorage for this domain, its not the builder user id.
-	 */
-	userId: string;
-	/**
-	 * The state of the builder editor.
-	 */
-	builderState?: BuilderEditorState;
-	/**
-	 * Additional console logs
-	 */
-	debug?: boolean;
-	/**
-	 * Date.now() timestamp of when the assistant was started.
-	 * This is used to calculate the time taken between all events.
-	 */
-	startMs?: number;
-	/**
-	 * If events should be streamed back throughout the process.
-	 *
-	 * Setting to `false` will skip any intermediate processing and emitting
-	 * events while collecting LLM deltas, but will only emit the final result.
-	 *
-	 * Defaults to `true`.
-	 */
-	stream?: boolean;
-	/**
-	 * Provide a system prompt id to lookup a pre-defined system prompt
-	 * text sent to the LLM. Must be a pre-defined system prompt id!
-	 */
-	systemPromptIds?: {
-		"content-edit"?: string;
-	};
-	/**
-	 * Option on how this call should handle the conversation thread.
-	 *
-	 * `persist`:
-	 *  - When there is no CompletionOptions `id`, it'll create a new thread id
-	 *  - When given an existing `id`, it'll look up the past thread messages and prefix the messages
-	 *
-	 * `ephemeral`:
-	 *  - Creates a new conversation each time, ignoring any existing thread history
-	 *  - Will not save the conversation for future use
-	 *
-	 * Defaults to `persist`
-	 */
-	thread?: "persist" | "ephemeral";
-	attachments?: Attachment[];
+    /**
+     * How this assistant is being used. For example, "content-editor"
+     * is used when the assistant is being used in the Builder.io content editor.
+     */
+    assistantType?: string;
+    /**
+     * LLM Model identifier to lookup which sdk and model to use.
+     * If not provided the default model will be used.
+     * Note: This is not the Builder.io data model.
+     */
+    modelId?: string;
+    /**
+     * The unique LOCAL identifier of the thread to submit the user message to.
+     * This is used to identify the thread with our own id (openai assistant id is different)
+     */
+    id: string;
+    /**
+     * The unique OPENAI assistant id of the thread to submit the user message to.
+     * If the assistantThreadId is not provided, a new thread will be created.
+     */
+    assistantThreadId?: string;
+    /**
+     * The message history of the conversation, user prompt then assistant response.
+     * The messages are ordered from oldest to newest. The last message in the array
+     * is the message that the user has just sent.
+     */
+    messages: (MessageParam | Message)[];
+    /**
+     * Which platform (framework) the the user has choosen to get help with.
+     */
+    platformId?: string;
+    /**
+     * The user id of the user sending the message.
+     * This is used to track the user's progress in the conversation.
+     * User id is stored in localStorage for this domain, its not the builder user id.
+     */
+    userId: string;
+    /**
+     * The state of the builder editor.
+     */
+    builderState?: BuilderEditorState;
+    /**
+     * Additional console logs
+     */
+    debug?: boolean;
+    /**
+     * Date.now() timestamp of when the assistant was started.
+     * This is used to calculate the time taken between all events.
+     */
+    startMs?: number;
+    /**
+     * If events should be streamed back throughout the process.
+     *
+     * Setting to `false` will skip any intermediate processing and emitting
+     * events while collecting LLM deltas, but will only emit the final result.
+     *
+     * Defaults to `true`.
+     */
+    stream?: boolean;
+    /**
+     * Provide a system prompt id to lookup a pre-defined system prompt
+     * text sent to the LLM. Must be a pre-defined system prompt id!
+     */
+    systemPromptIds?: {
+        "content-edit"?: string;
+    };
+    /**
+     * Option on how this call should handle the conversation thread.
+     *
+     * `persist`:
+     *  - When there is no CompletionOptions `id`, it'll create a new thread id
+     *  - When given an existing `id`, it'll look up the past thread messages and prefix the messages
+     *
+     * `ephemeral`:
+     *  - Creates a new conversation each time, ignoring any existing thread history
+     *  - Will not save the conversation for future use
+     *
+     * Defaults to `persist`
+     */
+    thread?: "persist" | "ephemeral";
+    attachments?: Attachment[];
 }
 export interface BuilderEditorState {
-	/**
-	 * The active locale of the builder editor.
-	 */
-	activeLocale?: string;
-	/**
-	 * The locale of the provided builder content.
-	 */
-	contentLocale?: string;
-	/**
-	 * Top level Builder content. The data.blocks array contains the BuilderElement.
-	 */
-	content?: BuilderContent;
-	/**
-	 * Builder custom components.
-	 */
-	components?: Component[];
-	/**
-	 * Builder design tokens.
-	 */
-	designTokens?: Record<string, string>;
-	/**
-	 * Builder model. (not the LLM model)
-	 */
-	model?: BuilderModel;
-	/**
-	 * Other models in the Builder account
-	 */
-	otherModels?: BuilderModel[];
-	/**
-	 * The URL that the Builder content preview is pointing to.
-	 */
-	previewUrl?: string;
-	/**
-	 * Selected ids in the builder.
-	 */
-	selectedIds?: string[];
-	/**
-	 * Builder space id.
-	 */
-	spaceId?: string;
-	/**
-	 * Builder user id.
-	 */
-	userId?: string;
-	/**
-	 * Email of the user in the builder.
-	 */
-	userEmail?: string;
-	/**
-	 * User's jobs
-	 */
-	userJobs?: string[];
-	/**
-	 * Builder session id.
-	 */
-	sessionId?: string;
-	/**
-	 * Custom instructions that could be add into the prompt.
-	 */
-	customInstructions?: Record<string, string>;
-	styleInspirationURL?: string;
-	/**
-	 * All targeting attributes of the content.
-	 */
-	allTargetingAttributes?: Record<string, any>;
+    /**
+     * The active locale of the builder editor.
+     */
+    activeLocale?: string;
+    /**
+     * The locale of the provided builder content.
+     */
+    contentLocale?: string;
+    /**
+     * Top level Builder content. The data.blocks array contains the BuilderElement.
+     */
+    content?: BuilderContent;
+    /**
+     * Builder custom components.
+     */
+    components?: Component[];
+    /**
+     * Builder design tokens.
+     */
+    designTokens?: Record<string, string>;
+    /**
+     * Builder model. (not the LLM model)
+     */
+    model?: BuilderModel;
+    /**
+     * Other models in the Builder account
+     */
+    otherModels?: BuilderModel[];
+    /**
+     * The URL that the Builder content preview is pointing to.
+     */
+    previewUrl?: string;
+    /**
+     * Selected ids in the builder.
+     */
+    selectedIds?: string[];
+    /**
+     * Builder space id.
+     */
+    spaceId?: string;
+    /**
+     * Builder user id.
+     */
+    userId?: string;
+    /**
+     * Email of the user in the builder.
+     */
+    userEmail?: string;
+    /**
+     * User's jobs
+     */
+    userJobs?: string[];
+    /**
+     * Builder session id.
+     */
+    sessionId?: string;
+    /**
+     * Custom instructions that could be add into the prompt.
+     */
+    customInstructions?: Record<string, string>;
+    styleInspirationURL?: string;
+    /**
+     * All targeting attributes of the content.
+     */
+    allTargetingAttributes?: Record<string, any>;
 }