builder.io 1.6.19 → 1.6.22

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

@@ -0,0 +1,3 @@
+import type { DevToolsSys } from "../types";
+import type { DevToolsServer } from "../server";
+export declare function setupCodeServer(sys: DevToolsSys): Promise<DevToolsServer>;

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

@@ -0,0 +1,11 @@
+import type { CodeGenTools, ContentMessageItemToolResult, ProjectFile } from "$/ai-utils";
+import type { DevToolsSys } from "../core";
+export interface LLMToolCalls {
+    name: CodeGenTools;
+    input: Record<string, any>;
+    id: string;
+}
+export declare function resolveToolCalls(sys: DevToolsSys, toolCalls: LLMToolCalls[]): Promise<{
+    toolResults: ContentMessageItemToolResult[];
+    projectFiles: ProjectFile[];
+}>;

package/types/cli/code.d.ts

@@ -2,48 +2,60 @@ import type { DevToolsSys } from "../types";
 import type { CLIArgs } from "./index";
 import { type Credentials } from "./credentials";
 import { type Checkpoint } from "./incremental-tsc";
-import type { UserContext } from "$/ai-utils";
+import { type IOService } from "./io-service";
+import type { ContentMessageItemToolResult, CustomInstruction, ProjectFile, UserContext } from "$/ai-utils";
+import prettier from "prettier";
 interface UndoState {
     files: {
         path: string;
-        content: string | null;
+        content: Uint8Array | null;
     }[];
     isAgent: boolean;
     url: string | undefined;
+    toolResults: ContentMessageItemToolResult[];
 }
-interface SessionContext {
+interface CodeGenSearchResponse {
+    ranked: RankedResult[];
+    relevantPaths: string[];
+}
+interface RankedResult {
+    filePath: string;
+    startIndex: number;
+    endIndex: number;
+    score: number;
+    id: string;
+}
+type State = "initial-with-url" | "initial-without-url" | "success" | "success-just-text" | "abort" | "error";
+export interface SessionContext {
     sessionId: string;
     undoStates: UndoState[];
     selectedFilePaths: Map<string, number>;
+    customInstructions: CustomInstruction[];
+    userContext: UserContext;
+    prettierConfig: prettier.Config | null;
+    state: State;
+}
+export interface UserInput {
+    userPrompt: string;
+    sentiment: "positive" | "negative" | "undo";
+    files: ProjectFile[];
+    searchResponse: CodeGenSearchResponse | null;
+    rerankFiles?: number;
+    mostRelevantFile: string | null;
+    role: "user" | "agent";
 }
-type CodegenUsage = {
-    total: number;
-    fast: number;
-    quality: number;
-    limits: {
-        aiGeneration: number;
-        aiGenerationContextWindow: number;
-    };
-};
-export interface ArtifactItem {
-    type: "file" | "text" | "delta" | "done" | "diff" | "request_file" | "thinking" | "user" | "continue";
-    id?: string;
-    content: string;
-    filePath?: string;
-    artifactTitle?: string;
-    actionTitle?: string;
-    synthetic?: boolean;
-    incomplete?: boolean;
-    nextUrl?: string;
-    actions?: ArtifactItem[];
-    stopReason?: "end" | "limit" | "error" | "max_tokens";
-    usage?: CodegenUsage;
+export declare const runCodeCommand: (sys: DevToolsSys, subCommand: string, args: CLIArgs, io?: IOService) => Promise<void>;
+export declare const createSessionContext: (sys: DevToolsSys) => Promise<SessionContext>;
+export declare const runCodeGen: (sys: DevToolsSys, args: CLIArgs, io?: IOService) => Promise<void>;
+interface InteractiveAnswer {
+    command: "exit" | undefined;
+    userPrompt: string | undefined;
+    feedback: "positive" | "negative" | "undo" | undefined;
 }
-export declare const runCodeCommand: (sys: DevToolsSys, subCommand: string, args: CLIArgs) => Promise<void>;
-export declare const runCodeGen: (sys: DevToolsSys, args: CLIArgs) => Promise<undefined>;
-export declare function agentCompletion(sys: DevToolsSys, credentials: Credentials, args: CLIArgs, userContext: UserContext, sessionContext: SessionContext, userPrompt: string, initialUrl: string | undefined, relevantFile: string | null | undefined, wasBad: boolean, baselineCheckpoint: Checkpoint): Promise<Checkpoint>;
+export declare function getUserInput(sys: DevToolsSys, credentials: Credentials, args: CLIArgs, sessionContext: SessionContext, answer: InteractiveAnswer, signal: AbortSignal | undefined, io?: IOService): Promise<UserInput>;
+export declare function agentCompletion(sys: DevToolsSys, credentials: Credentials, args: CLIArgs, sessionContext: SessionContext, userInput: UserInput, url: string | undefined, baselineCheckpoint: Checkpoint, signal: AbortSignal | undefined, io?: IOService): Promise<Checkpoint>;
 export declare function createApp(userId: string, spaceId: string, privateKey: string, body: any): Promise<void>;
 export declare function transformStream(body: ReadableStream<Uint8Array> | null): AsyncGenerator<string, void, unknown>;
-export declare function checkProjectRoot(sys: DevToolsSys, interactive: boolean): Promise<undefined>;
+export declare function checkProjectRoot(sys: DevToolsSys, interactive: boolean, io?: IOService): Promise<void>;
 export declare function getUserContext(sys: DevToolsSys): Promise<UserContext>;
 export {};

package/types/cli/figma.d.ts

@@ -1,3 +1,4 @@
 import type { DevToolsSys } from "../types";
 import type { CLIArgs } from ".";
 export declare const runFigmaCommand: (sys: DevToolsSys, subCommand: string, args: CLIArgs) => Promise<void>;
+export declare function askToInstallBuilder(sys: DevToolsSys, args: CLIArgs): Promise<void>;

package/types/cli/index.d.ts

@@ -29,8 +29,8 @@ export interface CLIArgs {
     url?: string;
     /** Prompt text for non-interactive mode */
     prompt?: string;
-    /** Generation mode - either 'exact' for precise matches or 'creative' for more flexibility */
-    mode?: "precise" | "creative";
+    /** Generation mode */
+    mode?: "fast" | "quality" | "quality-v3";
     /** Working directory to run commands from */
     cwd?: string;
     /** Debug mode */

package/types/cli/indexing.d.ts

@@ -1,13 +1,5 @@
 import type { DevToolsSys } from "../types";
 import type { CLIArgs } from "./index";
 import { type Credentials } from "./credentials";
-export interface ArtifactItem {
-    type: "shell" | "file" | "text" | "delta" | "done";
-    id?: string;
-    content: string;
-    filePath?: string;
-    artifactTitle?: string;
-    incomplete?: boolean;
-}
 export declare const runCodeIndexing: (_sys: DevToolsSys, _args: CLIArgs) => Promise<void>;
 export declare const codeIndexing: (sys: DevToolsSys, credentials: Credentials) => 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/report/figma-report.d.ts

@@ -0,0 +1,3 @@
+import type { CLIArgs } from "..";
+import type { DevToolsSys } from "../../core";
+export declare const runFigmaReport: (sys: DevToolsSys, args: CLIArgs) => Promise<void>;

package/types/cli/sync-utils.d.ts

@@ -4,8 +4,9 @@ export declare function extractSignatureInfo(content: string): {
     sessionKey?: string;
     snippetId?: string;
 };
-export declare function getAllProjectFiles(basePath: string): Promise<string[]>;
+export declare function getAllProjectFiles(basePath: string, globPattern?: string): Promise<string[]>;
 export declare function findBuilderFiles(basePath: string, targetContentId: string, targetSessionKey: string): Promise<FileNode[]>;
+export declare function filterNonImportantFiles(files: string[]): string[];
 export declare function getIgnorePatterns(basePath: string): (path: string) => boolean;
 export declare function watchDirectory(basePath: string, syncInfo: SyncInfo, onChange: (updatedSyncInfo: SyncInfo) => void): () => Promise<void>;
 export declare function setupSyncServer(sys: DevToolsSys, initialSyncInfo?: SyncInfo): Promise<void>;

package/types/common/dotenv.d.ts

@@ -3,4 +3,4 @@ export declare function getDotEnvValue(sys: DevToolsSys, dotEnvFileNames: string
 export declare function setDotEnvValue(sys: DevToolsSys, dotEnvFileNames: string[], envKey: string, envValue: string): Promise<EnvInfo>;
 export declare function parseDotEnvFile(sys: DevToolsSys, envPath: string): Promise<Record<string, string> | null>;
 export declare function parseDotEnvContent(envContent: string): Record<string, string>;
-export declare function setDotEnvVar(sys: DevToolsSys, envPath: string, key: string, value: string): Promise<"create" | "update" | null>;
+export declare function setDotEnvVar(sys: DevToolsSys, envPath: string, key: string, value: string): Promise<"create" | "update" | "permission-error" | null>;

package/types/common/dotenv.test.d.ts

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

package/types/common/test-utils.d.ts

@@ -1,7 +1,9 @@
 import type { DevToolsSys } from "../types";
 import ts from "typescript";
 export declare function codeEqual(sys: DevToolsSys, n: ts.Node | null | undefined | string, expectCode: string, removeComments?: boolean): Promise<void>;
-export declare function createTestFsSys(rootDir: string): Promise<DevToolsSys>;
+export declare function createTestFsSys(rootDir: string, options?: {
+    readOnlyPermissions?: boolean;
+}): Promise<DevToolsSys>;
 export declare function createTestMemSys(rootDir?: string): Promise<DevToolsSys>;
 export declare function createRemixTestMemSys(rootDir?: string): Promise<DevToolsSys>;
 export declare function createAngularTestMemSys(rootDir?: string): Promise<DevToolsSys>;

package/types/server/builder-connect.d.ts

@@ -1,3 +1,6 @@
 import { type DevToolsServerContext, type ConnectedBuilder, type ValidatedBuilder, type SPACE_KIND_VALUES } from "../types";
-export declare function connectBuilder(ctx: DevToolsServerContext, publicApiKey: string, privateAuthKey: string, kind: SPACE_KIND_VALUES): Promise<ConnectedBuilder>;
+export declare function connectBuilder(ctx: DevToolsServerContext, publicApiKey: string, privateAuthKey: string, kind: SPACE_KIND_VALUES): Promise<ConnectedBuilder | {
+    success: boolean;
+    pathname: string;
+}>;
 export declare function validateBuilder(ctx: DevToolsServerContext): Promise<ValidatedBuilder>;