@builder.io/dev-tools 1.9.21 → 1.9.23-dev.202508082028.12e70deb7

package/types/cli/code-tools.d.ts

@@ -59,6 +59,7 @@ export interface ToolContext extends Partial<FusionContext> {
         name?: string;
     }>;
     patchFusionConfig: (patch: Partial<FusionConfig>) => void;
+    passThrough: (toolCall: LLMToolCalls, signal: AbortSignal) => Promise<ToolResolution>;
     readFile: (filePath: string) => Promise<string | null>;
     writeFile: (filePath: string, content: string | Uint8Array) => Promise<boolean>;
     deleteFile: (filePath: string) => Promise<boolean>;

package/types/cli/codegen.d.ts

@@ -2,7 +2,7 @@ import type { DevToolsSys } from "../types";
 import { type Credentials } from "./credentials";
 import type { CodegenFeedback, CodeGenToolMap, CodegenTurn, CustomInstruction, FusionConfig, GenerateCompletionState, GenerateCompletionStep, GenerateCompletionStepGit, GenerateUserMessage, UserContext, WorkspaceConfiguration, WorkspaceFolder, LoadWholeSessionOptions, LoadWholeSessionResult, LoadHistoryResult, CodeGenMode, ApplyActionsResult } from "$/ai-utils";
 import prettier from "prettier";
-import { type FusionContext } from "./code-tools";
+import { type FusionContext, type ToolResolution } from "./code-tools";
 import EventEmitter from "node:events";
 import { type RunGitOptions } from "./utils/git";
 export interface SessionContext {
@@ -30,6 +30,7 @@ export interface CodeGenSessionOptionsBase {
     workingDirectory?: string;
     mcpServers?: boolean;
     enabledTools?: (keyof CodeGenToolMap)[];
+    modelOverride?: string;
 }
 export interface CodeGenSessionOptionsSession extends CodeGenSessionOptionsBase {
     sessionOrCompletionId?: string;
@@ -128,6 +129,7 @@ export declare class CodeGenSession {
     getSessionId(): string;
     getSpaceId(): string | undefined;
     revertToCommitHash(commitHash: string): Promise<void>;
+    resetToCommitHash(commitHash: string): Promise<void>;
     /**
      * Core function to restore the codebase to a state that matches a predicate.
      * This is the main function that handles both git-based and file-based restoration.
@@ -194,6 +196,13 @@ export declare class CodeGenSession {
     abortSetupCommand(): void;
     toolsRunning(): boolean;
     abortAllTools(): void;
+    /**
+     * Fulfil a pending tool call (usually AskUser or any passThrough tool)
+     * Exposed via websocket as `toolFullfilment` for the Builder UI to send back
+     * the user's response.
+     */
+    toolFullfilment(id: string, result: ToolResolution | string): boolean;
+    fulfillToolCall(id: string, result: ToolResolution): boolean;
     abortToolCall(id: string): boolean;
     abort(cleanCurrentMessage?: boolean): Promise<boolean>;
     stopEventLoop(): Promise<void>;

package/types/cli/io-service.d.ts

@@ -0,0 +1,86 @@
+import { type SelectOptions, type ConfirmOptions, type TextOptions } from "@clack/prompts";
+import { spinner } from "./spinner";
+import type { WebSocket } from "ws";
+export interface IOService {
+    log(str: string): void;
+    info(str: string): void;
+    warn(str: string): void;
+    error(str: string): void;
+    write(text: string): void;
+    writeMetadata(metadata: Record<string, any>): void;
+    confirm(options: ConfirmOptions): Promise<boolean | symbol>;
+    text(options: TextOptions): Promise<string | symbol>;
+    select<Value>(options: SelectOptions<Value>): Promise<Value | symbol>;
+    createSpinner(): ReturnType<typeof spinner>;
+    isInteractive(): boolean;
+    isTTY(): boolean;
+    exit(code: number): Promise<void>;
+}
+export declare class ConsoleIOService implements IOService {
+    log(str: string): void;
+    info(str: string): void;
+    warn(str: string): void;
+    error(str: string): void;
+    write(text: string): void;
+    writeMetadata(_: Record<string, any>): void;
+    confirm(options: ConfirmOptions): Promise<boolean | symbol>;
+    text(options: TextOptions): Promise<string | symbol>;
+    select<Value>(options: SelectOptions<Value>): Promise<Value | symbol>;
+    createSpinner(): ReturnType<typeof spinner>;
+    isInteractive(): boolean;
+    isTTY(): boolean;
+    exit(code: number): Promise<void>;
+}
+export interface BaseMessage {
+    type: string;
+    [key: string]: any;
+}
+export interface LogMessage extends BaseMessage {
+    type: "log";
+    level: "info" | "warn" | "error";
+    message: string;
+}
+export interface WriteMessage extends BaseMessage {
+    type: "write";
+    text: string;
+}
+export interface SpinnerMessage extends BaseMessage {
+    type: "spinner";
+    status: "start" | "stop";
+    message: string;
+    code?: number;
+}
+export interface PromptRequest extends BaseMessage {
+    type: "prompt";
+    promptType: "text" | "confirm" | "select";
+    options: any;
+    requestId: string;
+}
+export interface PromptResponse extends BaseMessage {
+    type: "prompt_response";
+    requestId: string;
+    value: any;
+    cancelled?: boolean;
+}
+export declare class WebSocketIOService implements IOService {
+    private ws;
+    private promptCallbacks;
+    private messageQueue;
+    private isProcessing;
+    constructor(ws: WebSocket);
+    private sendMessage;
+    private prompt;
+    log(...args: any[]): void;
+    info(...args: any[]): void;
+    warn(...args: any[]): void;
+    error(...args: any[]): void;
+    write(text: string): void;
+    writeMetadata(metadata: Record<string, any>): void;
+    confirm(options: ConfirmOptions): Promise<boolean | symbol>;
+    text(options: TextOptions): Promise<string | symbol>;
+    select<Value>(options: SelectOptions<Value>): Promise<Value | symbol>;
+    createSpinner(): ReturnType<typeof spinner>;
+    isInteractive(): boolean;
+    isTTY(): boolean;
+    exit(code: number): Promise<void>;
+}

package/types/cli/launch/install-jsx-plugin.d.ts

@@ -0,0 +1,7 @@
+import type { DevToolsSys } from "@builder.io/dev-tools/core";
+import { type InstallOutcome } from "./helpers";
+export declare const installJsxPlugin: (sys: DevToolsSys) => Promise<{
+    timestamp: string;
+    installOutcome: InstallOutcome;
+    error: string | undefined;
+}>;

package/types/cli/launch/logger.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Initialize logging by wrapping all console methods to write to logs file
+ */
+export declare function initializeLogging(): void;
+/**
+ * Reset console methods to their original state
+ */
+export declare function resetLogging(): void;
+/**
+ * Display intro message with logging
+ */
+export declare const intro: (message: string) => void;
+/**
+ * Wrapped clack logging methods with file logging
+ */
+export declare const log: {
+    info: (message: string) => void;
+    success: (message: string) => void;
+    error: (message: string) => void;
+    warn: (message: string) => void;
+    step: (message: string) => void;
+    message: (message?: string, { symbol }?: import("@clack/prompts").LogMessageOptions) => void;
+    warning: (message: string) => void;
+};
+/**
+ * Display outro message with logging
+ */
+export declare const outro: (message: string) => void;
+/**
+ * Reads logs with pagination
+ * @param nextToken Line number to start reading from (0-indexed)
+ * @param limit Number of lines to read
+ * @returns Object containing logs array and next token
+ */
+export declare const readLogs: (nextToken?: number, limit?: number) => {
+    logs: string[];
+    nextToken: number | null;
+};

package/types/cli/launch-init-v2.d.ts

@@ -0,0 +1,13 @@
+import type { DevToolsSys } from "@builder.io/dev-tools/core";
+import type { CLIArgs } from "./index";
+export interface InitArgs extends CLIArgs {
+    repoFullName?: string;
+    branchName?: string;
+    githubToken?: string;
+    installCommand?: string;
+    dockerImageType?: "fusion-starter" | "node";
+}
+export declare function runLaunchInitCommandV2({ args, sys, }: {
+    sys: DevToolsSys;
+    args: InitArgs;
+}): Promise<number>;

package/types/cli/launch-init.d.ts

@@ -0,0 +1,19 @@
+import type { DevToolsSys } from "@builder.io/dev-tools/core";
+import type { CLIArgs } from "./index";
+export interface InitArgs extends CLIArgs {
+    repoFullName?: string;
+    branchName?: string;
+    githubToken?: string;
+    installCommand?: string;
+    volumePath?: string;
+    /**
+     * Indicates the type of docker image the CLI is running on.
+     *
+     * @default "node"
+     */
+    dockerImageType?: "fusion-starter" | "node";
+}
+export declare function runLaunchInitCommand({ args, sys, }: {
+    sys: DevToolsSys;
+    args: InitArgs;
+}): Promise<number>;

package/types/cli/repo-indexing/component-indexing.d.ts

@@ -1,6 +1,6 @@
 import type { DevToolsSys } from "../../types";
 import type { Credentials } from "../credentials";
-import type { Component } from "./types";
+import type { Component, ComponentIssue } from "./types";
 import type { WorkspaceConfiguration } from "$/ai-utils";
 export declare const processComponent: (sys: DevToolsSys, credentials: Credentials, sessionId: string, component: Component, opts?: {
     designSystemId?: string | null;
@@ -10,5 +10,6 @@ export declare const processComponent: (sys: DevToolsSys, credentials: Credentia
     storeRepoIndexing?: boolean;
     workspaceConfig?: WorkspaceConfiguration;
     debug?: boolean;
+    onIssue?: (issue: ComponentIssue) => void;
 }) => Promise<void>;
 export declare const deprecateObsoleteComponents: (credentials: Credentials, localComponents: Component[], remoteComponents: Component[]) => Promise<void>;

package/types/cli/repo-indexing/repo-indexing.d.ts

@@ -1,8 +1,8 @@
 import type { DevToolsSys } from "../../types";
 import type { CLIArgs } from "../index";
 import { type Credentials } from "../credentials";
-import type { Component } from "./types";
-export declare const displayComponentLibrarySummary: (components: Component[], indexedComponents: Component[], startTime: number, numFailed: number | undefined, isForce: boolean | undefined, designSystemName: string) => void;
+import type { Component, ComponentIssue } from "./types";
+export declare const displayComponentLibrarySummary: (components: Component[], indexedComponents: Component[], startTime: number, numFailed: number | undefined, isForce: boolean | undefined, designSystemName: string, issues?: ComponentIssue[]) => void;
 export interface RepoIndexingDoc {
     name: string;
     content: string | {

package/types/cli/repo-indexing/types.d.ts

@@ -9,3 +9,8 @@ export interface Component {
     hash?: string;
     designSystemId?: string | null;
 }
+export interface ComponentIssue {
+    componentName: string;
+    error: string;
+    sessionId: string;
+}

package/types/cli/repo-indexing-utils.d.ts

@@ -0,0 +1,2 @@
+import type { DevToolsSys } from "../core";
+export declare const parseDesignSystemVersion: (sys: DevToolsSys, designSystemPackage: string) => Promise<string | null | undefined>;

package/types/cli/repo-indexing.d.ts

@@ -0,0 +1,17 @@
+import type { DevToolsSys } from "../types";
+import type { CLIArgs } from "./index";
+export interface RepoIndexingDoc {
+    name: string;
+    content: string | {
+        name: string;
+        description: string;
+        components: string[];
+        relevantFiles: string[];
+    }[];
+    createdDate: string;
+    description: string;
+    id: string;
+    ownerId: string;
+    userId: string;
+}
+export declare const runRepoIndexing: (sys: DevToolsSys, args: CLIArgs) => Promise<void>;

package/types/cli/repo-indexing.mock.d.ts

@@ -0,0 +1,5 @@
+export declare const mockDeps: {
+    getStoredComponentDocs: () => Promise<never[]>;
+    storeComponentDocs: () => Promise<{}>;
+    runCodeGen: () => Promise<string>;
+};

package/types/cli/utils/repo-indexing-group-prompts.d.ts

@@ -0,0 +1 @@
+export declare const REPO_INDEXING_GROUP_PROMPT: string;

package/types/common/ast/component-input-types.d.ts

@@ -17,7 +17,7 @@ export declare const NUMBER_TYPES: string[];
 export declare const BOOLEAN_TYPES: string[];
 export declare const ARRAY_TYPES: string[];
 export declare const OBJECT_TYPES: string[];
-export declare function getPrimitiveType(t: string): "number" | "string" | "boolean" | "object" | "array";
+export declare function getPrimitiveType(t: string): "string" | "object" | "number" | "boolean" | "array";
 export declare function removeQuotes(text: string): string;
 export declare const resolveType: (sys: DevToolsSys, checker: ts.TypeChecker, type: ts.Type) => string[] | undefined;
 export declare const typeToString: (sys: DevToolsSys, checker: ts.TypeChecker, type: ts.Type) => string;

package/types/common/ast/convert-values.d.ts

@@ -8,4 +8,4 @@ export declare function objectExpressionToObjectValue(sys: DevToolsSys, objectLi
 };
 export declare function convertArrayExpressionToJsArray(sys: DevToolsSys, arr: ts.ArrayLiteralExpression): any[];
 export declare function getTextOfPropertyName(sys: DevToolsSys, prop: ts.PropertyAssignment | ts.ObjectLiteralElementLike | undefined): string | undefined;
-export declare function valueToExpression(sys: DevToolsSys, val: any): ts.ObjectLiteralExpression | ts.Identifier | ts.StringLiteral | ts.NumericLiteral | ts.TrueLiteral | ts.FalseLiteral | ts.ArrayLiteralExpression;
+export declare function valueToExpression(sys: DevToolsSys, val: any): ts.ObjectLiteralExpression | ts.ArrayLiteralExpression | ts.Identifier | ts.StringLiteral | ts.NumericLiteral | ts.TrueLiteral | ts.FalseLiteral;

package/types/common/utils.d.ts

@@ -19,7 +19,7 @@ export declare function clone<T>(obj: T): T;
 export declare function shouldSkipFolder(sys: DevToolsSys, skipFolders: Set<string>, fileName: string): boolean;
 export declare function getPackageManager(): string;
 export declare function isWindows(): boolean;
-export declare function builderNpxPackage(): "\"@builder.io/dev-tools\"" | "builder.io";
+export declare function builderNpxPackage(): "builder.io" | "\"@builder.io/dev-tools\"";
 /**
  * Sanitizes a component name for use in filesystem paths by replacing invalid characters with underscores
  * @param name The component name to sanitize

package/types/core/adapters/vite/ensure-remix-config.d.ts

@@ -0,0 +1,6 @@
+import type { DevToolsSys } from "../..";
+import type { EnsureConfigResult } from "../../../types";
+/**
+ * Ensure the Remix Vite config has the necessary plugins and settings
+ */
+export declare function ensureRemixConfig(sys: DevToolsSys, configFilePath: string, configContent: string): Promise<EnsureConfigResult>;

package/types/core/adapters/vite/remix-utils.d.ts

@@ -0,0 +1,10 @@
+import type { DevToolsSys } from "../..";
+import type ts from "typescript";
+/**
+ * Check if the current project is using Remix framework
+ */
+export declare function isRemixFramework(sys: DevToolsSys): boolean;
+/**
+ * Update an object literal to include the external dependencies for Remix
+ */
+export declare function updateCommonJsLibrary(sys: DevToolsSys, config: ts.ObjectLiteralExpression): ts.ObjectLiteralExpression | null;

package/types/core/adapters/vite/vite-config-helpers.d.ts

@@ -0,0 +1,6 @@
+import type { DevToolsSys } from "../..";
+import type { EnsureConfigResult } from "../../../types";
+/**
+ * Update a Vite config file to include a plugin
+ */
+export declare function updateViteConfig(sys: DevToolsSys, configFilePath: string, configContent: string, pluginName: string, importPath: string): Promise<EnsureConfigResult>;