builder.io 1.6.56 → 1.6.58

package/types/_tests_/workspace.e2e.d.ts

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

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

@@ -31,9 +31,24 @@ export interface ToolContext extends Partial<FusionContext> {
     files: ProjectFile[];
     emitter: EventEmitter<{
         step: [GenerateCompletionStep];
+        idle: [];
     }>;
     signal: AbortSignal | undefined;
     workingDirectory: string;
+    resolveWorkspacePath: (path: string) => string;
+    workspaceFolders: Array<{
+        path: string;
+        name?: string;
+    }>;
+    readFile: (filePath: string) => Promise<string | null>;
+    writeFile: (filePath: string, content: string | Uint8Array) => Promise<boolean>;
+    deleteFile: (filePath: string) => Promise<boolean>;
+    fileExists: (filePath: string) => Promise<boolean>;
+    listDir: (dirPath: string) => Promise<string[]>;
+    stat: (filePath: string) => Promise<{
+        isDirectory: () => boolean;
+        isFile: () => boolean;
+    } | null>;
 }
 export declare function resolveToolCalls(toolContext: ToolContext, toolCalls: LLMToolCalls[]): Promise<ContentMessageItemToolResult[]>;
 interface RipgrepMatch {

package/types/cli/codegen.d.ts

@@ -31,6 +31,13 @@ export interface SessionContext {
     createdUnixTime: number;
     updatedUnixTime: number;
 }
+export interface WorkspaceFolder {
+    path: string;
+    name?: string;
+}
+export interface WorkspaceConfiguration {
+    folders: WorkspaceFolder[];
+}
 export interface CodeGenSessionOptionsBase {
     sys: DevToolsSys;
     credentials: Credentials;
@@ -40,6 +47,7 @@ export interface CodeGenSessionOptionsBase {
     builtInCustomInstructions?: CustomInstruction[];
     fusionContext?: FusionContext;
     workingDirectory?: string;
+    workspace?: WorkspaceConfiguration;
 }
 export interface CodeGenSessionOptionsSession extends CodeGenSessionOptionsBase {
     sessionOrCompletionId?: string;
@@ -134,16 +142,20 @@ export declare class CodeGenSession {
     getCurrentState(): GenerateCompletionState;
     getLastTurn(): CodegenTurn | undefined;
     getNextUrl(): string | undefined;
-    getNextMessage(): Promise<GenerateUserMessage>;
+    getNextMessage(): {
+        shouldWait: boolean;
+        promise: Promise<GenerateUserMessage | undefined>;
+    };
     sendFeedback(feedback: Partial<CodegenFeedback>): Promise<void>;
     lastTurnHasChanges(): Promise<boolean>;
     sendMessage(message: GenerateUserMessage, immediate?: boolean): Promise<void>;
     getTurns(): CodegenTurn[];
     getSessionContext(): SessionContext;
-    abort(): Promise<boolean>;
+    abort(cleanCurrentMessage?: boolean): Promise<boolean>;
     stopEventLoop(): Promise<void>;
     close(): Promise<void>;
-    connectToEventLoop(shouldReplay: boolean, onStep: (step: GenerateCompletionStep) => void): Promise<() => void>;
+    connectToEventLoop(shouldReplay: boolean, onStep: (step: GenerateCompletionStep) => void): () => void;
+    waitUntilIdle(): Promise<void>;
     waitForEventLoop(): Promise<void>;
     agentCompletion(userMessage: GenerateUserMessage, signal: AbortSignal | undefined, onStep: (step: GenerateCompletionStep) => void): Promise<void>;
     commitWorkInProgress(lastTurn: CodegenTurn): Promise<string | undefined>;
@@ -152,8 +164,80 @@ export declare class CodeGenSession {
      */
     hasChanges(): boolean;
     isCleanWorkTree(): Promise<boolean>;
+    /**
+     * Resolves a workspace file path to its actual file system path
+     * @param filePath A file path that may include a workspace prefix (e.g., "workspace1/path/to/file.js")
+     * @returns The actual file system path and the workspace folder it belongs to
+     */
+    resolveWorkspacePath(filePath: string): {
+        resolvedPath: string;
+        workspaceFolder?: WorkspaceFolder;
+    };
+    /**
+     * Converts an absolute path back to a workspace-relative path if applicable
+     * @param absolutePath An absolute file system path
+     * @returns The workspace-relative path with appropriate prefix
+     */
+    toWorkspaceRelativePath(absolutePath: string): string;
+    /**
+     * Reads a file from the workspace
+     * @param filePath A file path that may include a workspace prefix
+     * @returns The file content or null if the file doesn't exist
+     */
+    readFile(filePath: string): Promise<string | null>;
+    /**
+     * Reads a file from the workspace synchronously
+     * @param filePath A file path that may include a workspace prefix
+     * @returns The file content or null if the file doesn't exist
+     */
+    readFileSync(filePath: string): string | null;
+    /**
+     * Writes content to a file in the workspace
+     * @param filePath A file path that may include a workspace prefix
+     * @param content The content to write
+     * @returns True if the write was successful, false otherwise
+     */
+    writeFile(filePath: string, content: string | Uint8Array): Promise<boolean>;
+    /**
+     * Checks if a file exists in the workspace
+     * @param filePath A file path that may include a workspace prefix
+     * @returns True if the file exists, false otherwise
+     */
+    fileExists(filePath: string): Promise<boolean>;
+    /**
+     * Lists files in a directory in the workspace
+     * @param dirPath A directory path that may include a workspace prefix
+     * @returns Array of file names in the directory or empty array if directory doesn't exist
+     */
+    listDir(dirPath: string): Promise<string[]>;
+    /**
+     * Get stats for a file in the workspace
+     * @param filePath A file path that may include a workspace prefix
+     * @returns The file stats or null if the file doesn't exist
+     */
+    stat(filePath: string): Promise<{
+        isDirectory: () => boolean;
+        isFile: () => boolean;
+    } | null>;
+    /**
+     * Deletes a file from the workspace
+     * @param filePath A file path that may include a workspace prefix
+     * @returns True if the delete was successful, false otherwise
+     */
+    deleteFile(filePath: string): Promise<boolean>;
 }
 export declare function transformStream(body: ReadableStream<Uint8Array> | null): AsyncGenerator<string, void, unknown>;
 export declare function getUserContext(sys: DevToolsSys): Promise<UserContext>;
 export declare function makeAsyncIterator<T>(): readonly [AsyncGenerator<T, void, void>, (event: T) => void, () => void];
 export declare function isServerResponding(url: string, maxRetries?: number, retryDelay?: number): Promise<boolean>;
+/**
+ * Loads a workspace configuration from a JSON file
+ * @param sys DevToolsSys instance
+ * @param workspaceFile Path to the workspace JSON file
+ * @returns The workspace configuration and working directory
+ */
+export declare function loadWorkspace(sys: DevToolsSys, workspaceFile: string): Promise<{
+    workspace: WorkspaceConfiguration;
+    workingDirectory: string;
+}>;
+export declare function keepAlive(): () => void;

package/types/cli/index.d.ts

@@ -45,4 +45,6 @@ export interface CLIArgs {
     builderPublicKey?: string;
     /** Builder user ID, used for authentication. */
     builderUserId?: string;
+    /** Path to workspace configuration file */
+    workspace?: string;
 }

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

@@ -34,6 +34,7 @@ export type LaunchStatus = {
         error?: string | undefined;
         current?: string | undefined;
         expected?: string | undefined;
+        elapsedTime?: number;
     };
     gitUser?: {
         configured?: boolean;

package/types/cli/launch.d.ts

@@ -1,5 +1,6 @@
 import type { DevToolsSys } from "@builder.io/dev-tools/core";
 import type { CLIArgs } from "./index";
+import { type WorkspaceConfiguration } from "./codegen";
 import { type CommitMode } from "./code-tools";
 /**
  * Large random-ish port number that is unlikely to be used
@@ -48,6 +49,7 @@ export interface FusionConfig {
     projectId?: string;
     checkCommand?: string;
     workingDirectory: string;
+    workspace?: WorkspaceConfiguration | string;
     authenticateProxy: boolean;
     allowedCommands: string[];
     commitMode: CommitMode;