@builder.io/dev-tools 1.17.24-dev.202511131337.7305ffc47 → 1.17.24-dev.202511131623.844feace3

package/types/packages/dev-tools/cli/builder-add/interface.d.ts

@@ -1,22 +0,0 @@
-import type {
-	AddCliOptions,
-	FileNode,
-	FolderNode,
-	Snippet,
-	SyncInfo,
-} from "../../types";
-export declare function addCommand(
-	opts: AddCliOptions,
-): Promise<SyncInfo | undefined>;
-export declare function fetchSnippet(id: string): Promise<Snippet | null>;
-export declare function writeFiles(
-	appRootDir: string,
-	snippet: Snippet,
-	files: Array<FileNode | FolderNode>,
-	rootPath: string,
-	addSessionLink: boolean,
-): Promise<FileNode[]>;
-export declare function suggestRootPath(
-	appRootDir: string,
-	framework: string,
-): string;

package/types/packages/dev-tools/cli/builder-add/options.d.ts

@@ -1,2 +0,0 @@
-import type { AddCliOptions } from "../../types";
-export declare function getOptions(cwd: string, args: string[]): AddCliOptions;

package/types/packages/dev-tools/cli/code-file-utils.d.ts

@@ -1,20 +0,0 @@
-import type { DevToolsSys } from "../types";
-import type { Credentials } from "./credentials";
-import type { CodebaseSearchOptions, CodebaseSearchResponse } from "$/ai-utils";
-export declare function shouldIncludeFile(
-	inputFile: string,
-	ctx: {
-		foundFiles: string[];
-		allFiles: string[];
-		selectedFilePaths: Map<string, number>;
-		cwd: string;
-		appRootDir: string;
-		fallbackImportance: number | 0;
-	},
-): number | 0;
-export declare function searchCodeBase(
-	sys: DevToolsSys,
-	credentials: Credentials,
-	signal: AbortSignal | undefined,
-	body: CodebaseSearchOptions,
-): Promise<CodebaseSearchResponse | null>;

package/types/packages/dev-tools/cli/code-file-utils.unit.d.ts

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

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

@@ -1,131 +0,0 @@
-import type {
-	AccessResult,
-	CodeGenPosition,
-	CodeGenTools,
-	CodegenTurn,
-	ContentMessageItemToolResult,
-	FusionConfig,
-	GenerateCompletionStep,
-	Permission,
-	ProjectFile,
-	UserSource,
-	WorkspaceFolder,
-} from "$/ai-utils";
-import type { DevToolsSys } from "../core";
-import { type DevServerOrchestrator } from "./launch/dev-server-orchestrator";
-import type { CodeGenEventEmitter } from "./codegen";
-import type { Credentials } from "./credentials";
-export interface LLMToolCalls {
-	name: CodeGenTools;
-	input: Record<string, any>;
-	id: string;
-	abortController: AbortController;
-}
-export interface ToolResolution {
-	toolResult: string;
-	isError: boolean;
-	title?: string;
-}
-export interface FusionContext {
-	devServerOrchestrator?: DevServerOrchestrator;
-	git: boolean;
-	gitRemote?: string;
-	gitAutoInit?: boolean;
-}
-export interface ToolContext extends Partial<FusionContext> {
-	sys: DevToolsSys;
-	credentials: Credentials;
-	files: ProjectFile[];
-	user: UserSource;
-	position: CodeGenPosition;
-	emitter: CodeGenEventEmitter;
-	fusionConfig: FusionConfig | undefined;
-	canCollapseWorkspace: boolean;
-	signal: AbortSignal;
-	workingDirectory: string;
-	allowedCommands: RegExp[];
-	getAllFiles: (options: {
-		getDotFiles?: boolean;
-		pattern?: string;
-	}) => Promise<string[]>;
-	restore: (options: {
-		location: "before" | "after";
-		predicate: (turn: CodegenTurn | null, index: number) => boolean;
-		dryRun?: boolean;
-		revert?: boolean;
-		forceReplay?: boolean;
-		debug?: string;
-	}) => Promise<{
-		undone: string[] | null;
-		message: string;
-	}>;
-	bashWorkingDirectory: string;
-	filterText: (text: string) => string;
-	resolveWorkspacePath: (
-		path: string,
-		forceWorkspace: boolean,
-	) => {
-		resolvedPath: string;
-		workspaceFolder?: WorkspaceFolder;
-	};
-	absolutePathToWorkspaceUrl: (absolutePath: string) => string | undefined;
-	workspaceFolders: Array<{
-		path: string;
-		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<string | null>;
-	deleteFile: (filePath: string) => Promise<string | null>;
-	fileExists: (filePath: string) => Promise<{
-		absolutePath: string | undefined;
-		recommendedPath: string | undefined;
-		workspaceFolder: WorkspaceFolder | undefined;
-		virtual: boolean;
-	}>;
-	listDir: (dirPath: string) => Promise<string[]>;
-	evaluateAccess: (resource: string, permission: Permission) => AccessResult;
-	stat: (filePath: string) => Promise<{
-		isDirectory: () => boolean;
-		isFile: () => boolean;
-		size: number;
-	} | null>;
-}
-export declare function resolveToolCalls(
-	toolContext: ToolContext,
-	toolCalls: LLMToolCalls[],
-	existingToolResults: ContentMessageItemToolResult[] | undefined,
-	onStep: (step: GenerateCompletionStep) => void,
-): Promise<ContentMessageItemToolResult[]>;
-interface RipgrepMatch {
-	path: string;
-	lineNumber: number;
-	lineContent: string;
-}
-interface RipgrepResult {
-	matches: RipgrepMatch[];
-}
-export declare function runRipgrep(
-	sys: DevToolsSys,
-	bashWorkingDirectory: string,
-	pattern: string,
-	includeGlob?: string,
-	excludeGlob?: string,
-): Promise<RipgrepResult>;
-/**
- * Returns true if query is likely a string literal rather than a regex.
- * Returns false otherwise.
- * This is intended to ensure that queries such as "import {" do not get
- * interpreted as invalid regex values by ripgrep.
- * @param query - The query to check
- */
-export declare const isLikelyFixedString: (query: string) => boolean;
-export declare function newAbortError(): Error;
-export {};

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

@@ -1,17 +0,0 @@
-import type { DevToolsSys } from "../types";
-import type { CLIArgs } from "./index";
-import { type UserContext } from "$/ai-utils";
-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 checkProjectRoot(
-	sys: DevToolsSys,
-	interactive: boolean,
-): Promise<void>;
-export declare function getUserContext(sys: DevToolsSys): Promise<UserContext>;

package/types/packages/dev-tools/cli/codegen.d.ts

@@ -1,456 +0,0 @@
-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,
-	PrivacyMode,
-	CodeGenPosition,
-	BackupGitRepoResult,
-	PushChangesArgs,
-	CodegenApiResult,
-	CodegenApiTerminal,
-	ConfigureDevOrchestratorOpts,
-	ConfigureDevOrchestratorUpdates,
-	RepoMetrics,
-} from "$/ai-utils";
-import prettier from "prettier";
-import { type FusionContext, type ToolResolution } from "./code-tools";
-import EventEmitter from "node:events";
-import { type RunCommandOptions } from "./utils/git";
-export interface SessionContext {
-	sessionId: string;
-	turns: CodegenTurn[];
-	customInstructions: CustomInstruction[];
-	userContext: UserContext;
-	prettierConfig: prettier.Config | null;
-	state: GenerateCompletionState;
-	title: string | undefined;
-	beforeCommit: string | undefined;
-	createdUnixTime: number;
-	updatedUnixTime: number;
-	canLoadMore: boolean;
-}
-export interface CodeGenSessionOptionsBase {
-	sys: DevToolsSys;
-	credentials: Credentials;
-	position: CodeGenPosition;
-	maxTokens?: number;
-	mode: CodeGenMode;
-	privacyMode?: PrivacyMode;
-	builtInCustomInstructions?: CustomInstruction[];
-	fusionContext?: FusionContext;
-	fusionConfig?: FusionConfig;
-	workingDirectory?: string;
-	mcpServers?: boolean;
-	enabledTools?: (keyof CodeGenToolMap)[];
-	modelOverride?: string;
-}
-export interface CodeGenSessionOptionsSession
-	extends CodeGenSessionOptionsBase {
-	sessionOrCompletionId?: string;
-}
-export interface CodeGenSessionOptionsInitialUrl
-	extends CodeGenSessionOptionsBase {
-	initialUrl: string;
-}
-export type CodeGenSessionOptions =
-	| CodeGenSessionOptionsSession
-	| CodeGenSessionOptionsInitialUrl;
-export type CodeGenEventEmitter = EventEmitter<{
-	step: [GenerateCompletionStep];
-	idle: [];
-}>;
-export declare class CodeGenSession {
-	#private;
-	constructor(options: CodeGenSessionOptions);
-	get fusionConfig(): FusionConfig | undefined;
-	get gitEnabledFolder(): WorkspaceFolder | undefined;
-	get workingDirectory(): string;
-	setPrivacyMode(privacyMode: PrivacyMode | undefined): Promise<void>;
-	initializeSession(opts?: { skipSessionLoading?: boolean }): Promise<void>;
-	loadHistory(): Promise<LoadHistoryResult>;
-	loadWholeSession(
-		opts?: LoadWholeSessionOptions,
-	): Promise<LoadWholeSessionResult>;
-	loadMoreTurns(): Promise<CodegenTurn[]>;
-	setCustomInstructions(instructions: CustomInstruction[]): void;
-	pushRepoV2(repoInfo: {
-		repoFullName: string;
-		repoUrl: string;
-	}): Promise<CodegenApiResult>;
-	zipFolder(folderName: string): Promise<string>;
-	archiveProject(): Promise<string>;
-	isIdle(): boolean;
-	needsBackup(): Promise<boolean>;
-	uploadBackup(): Promise<
-		| BackupGitRepoResult
-		| {
-				success: false;
-				error: Error;
-		  }
-	>;
-	getCommitMode(): import("../../../dist/ai-utils").CommitMode;
-	pushChanges(opts: PushChangesArgs): Promise<CodegenApiResult>;
-	pullLatestFromRemote(): Promise<CodegenApiResult>;
-	abortMerge(emitStatus?: boolean): Promise<CodegenApiResult>;
-	syncChangesFromRemote(): Promise<CodegenApiResult>;
-	/**
-	 * Get the current commit hash
-	 */
-	getCurrentCommitHash(): Promise<string | undefined>;
-	getCurrentBranch(): Promise<string>;
-	/**
-	 * Get the feature branch name
-	 */
-	getFeatureBranch(): string;
-	/**
-	 * Get the AI branch name
-	 */
-	getAiBranch(): string;
-	git(args: string[], opts?: string | RunCommandOptions): Promise<string>;
-	setDebug(debug: boolean): void;
-	createTerminal(options?: {
-		terminalId?: string;
-		title?: string;
-		cwd?: string;
-		env?: Record<string, string | undefined>;
-		cols?: number;
-		rows?: number;
-		shell?: string;
-		createdBy?: string;
-	}): CodegenApiTerminal;
-	emitTerminals(): void;
-	updateTerminal({
-		terminalId,
-		cols,
-		rows,
-		title,
-	}: {
-		terminalId: string;
-		cols?: number;
-		rows?: number;
-		title?: string;
-	}): boolean;
-	writeTerminal({
-		terminalId,
-		data,
-	}: {
-		terminalId: string;
-		data: string;
-	}): boolean;
-	signalTerminal({
-		terminalId,
-		signal,
-	}: {
-		terminalId: string;
-		signal: "SIGINT" | "SIGTERM" | "SIGKILL";
-	}): boolean;
-	disposeTerminal({ terminalId }: { terminalId: string }): boolean;
-	subscribeTerminal({
-		terminalId,
-		onData,
-		onExit,
-	}: {
-		terminalId: string;
-		onData: (chunk: string) => void;
-		onExit?: (code?: number) => void;
-	}): boolean;
-	getAllFiles(options?: {
-		getDotFiles?: boolean;
-		globbyPattern?: string;
-		includePattern?: string;
-		gitignore?: boolean;
-	}): Promise<string[]>;
-	collectRepoMetrics(): Promise<RepoMetrics>;
-	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.
-	 *
-	 * @param predicate Function that takes a turn and its index and returns true if we should restore up to that turn
-	 * @param dryRun If true, only simulate the restoration without making changes
-	 * @returns Array of file paths that were changed
-	 */
-	restore({
-		location,
-		predicate,
-		revert,
-		dryRun,
-		forceReplay,
-		debug,
-	}: {
-		location: "before" | "after";
-		predicate: (turn: CodegenTurn | null, index: number) => boolean;
-		dryRun?: boolean;
-		revert?: boolean;
-		forceReplay?: boolean;
-		debug?: string;
-	}): Promise<{
-		undone: string[] | null;
-		message: string;
-	}>;
-	restoreFromCompletionId({
-		location,
-		completionId,
-		forceReplay,
-	}: {
-		location: "before" | "after";
-		completionId: string;
-		forceReplay?: boolean;
-	}): Promise<{
-		undone: string[] | null;
-		message: string;
-	}>;
-	restoreBeforeCompletionId(completionId: string): Promise<{
-		undone: string[] | null;
-		message: string;
-	}>;
-	/**
-	 * Undo all changes back to the last user message
-	 */
-	undoLastUserMessage(dryRun?: boolean): Promise<{
-		undone: string[] | null;
-		message: string;
-	}>;
-	getLastUserCompletionId(): string | undefined;
-	getLastCompletionId(): string | undefined;
-	getCurrentState(): GenerateCompletionState;
-	getLastApplyResultsTurn(): CodegenTurn | undefined;
-	getLastTurn(): CodegenTurn | undefined;
-	getNextUrl(): string | undefined;
-	getNextMessage(): {
-		shouldWait: boolean;
-		promise: Promise<GenerateUserMessage | undefined>;
-	};
-	sendFeedback(feedback: Partial<CodegenFeedback>): Promise<void>;
-	lastTurnHasChanges(): Promise<boolean>;
-	waitUntilState(
-		state: GenerateCompletionState,
-		timeout?: number,
-	): Promise<void>;
-	clearSession(): Promise<void>;
-	sendMessage(message: GenerateUserMessage, immediate?: boolean): Promise<void>;
-	getTurns(): CodegenTurn[];
-	getSessionContext(): SessionContext;
-	runSetupCommand(): Promise<
-		import("../../../dist/ai-utils").SetupCommandResult | undefined
-	>;
-	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;
-	acceptCode(): Promise<void>;
-	abort(cleanCurrentMessage?: boolean): Promise<boolean>;
-	stopEventLoop(): Promise<void>;
-	requestRefresh(): void;
-	configureDevOrchestrator(
-		opts: ConfigureDevOrchestratorOpts,
-	): Promise<ConfigureDevOrchestratorUpdates>;
-	close(uploadGitBackup?: boolean): Promise<void>;
-	emitGitStatus(): Promise<GenerateCompletionStepGit | null>;
-	manualCommit(options: { add: string; commitMessage: string }): Promise<void>;
-	connectToEventLoop(
-		shouldReplay: boolean,
-		onStep: (step: GenerateCompletionStep) => void,
-	): () => void;
-	waitUntilIdle(): Promise<void>;
-	waitForEventLoop(): Promise<void>;
-	commitWorkInProgress(
-		lastTurn: CodegenTurn,
-		changedFiles: string[],
-	): Promise<string | false | undefined>;
-	getChangesReport(): Promise<
-		| {
-				diff: string;
-				files: string[];
-		  }
-		| undefined
-	>;
-	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")
-	 * @param forceWorkspace If true, will try the first workspace as fallback when no workspace folder is found
-	 * @returns The actual file system path and the workspace folder it belongs to
-	 */
-	resolveWorkspacePath(
-		filePath: string,
-		forceWorkspace: boolean,
-	): {
-		resolvedPath: string;
-		workspaceFolder?: WorkspaceFolder;
-	};
-	/**
-	 * Converts an absolute file system path to a workspace URL
-	 * @param absolutePath The absolute file system path to convert
-	 * @returns The workspace URL if the path can be converted, undefined otherwise
-	 */
-	absolutePathToWorkspaceUrl(absolutePath: string): string | undefined;
-	/**
-	 * 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, skipAclCheck?: boolean): Promise<string | null>;
-	/**
-	 * 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<{
-		absolutePath: string | undefined;
-		recommendedPath: string | undefined;
-		workspaceFolder: WorkspaceFolder | undefined;
-		virtual: boolean;
-	}>;
-	/**
-	 * 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, skipAclCheck?: boolean): 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,
-		skipAclCheck?: boolean,
-	): Promise<string | null>;
-	/**
-	 * 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,
-		skipAclCheck?: boolean,
-	): Promise<{
-		isDirectory: () => boolean;
-		isFile: () => boolean;
-		size: number;
-	} | 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, skipAclCheck?: boolean): Promise<string | null>;
-	getLinesStats(): {
-		added: number;
-		removed: number;
-		net: number;
-	};
-	/**
-	 * Get git diff between current commit and remote branch
-	 * If remote current branch doesn't exist, gets diff between default branch and current branch
-	 * @param numberOfContextLines - Optional number of context lines to include in the diff
-	 * @param includeFilesOnly - If true, only return filePath and action properties
-	 * @param filePaths - Optional array of file paths to limit the diff to specific files
-	 */
-	getDiffFromRemote({
-		numberOfContextLines,
-		includeFilesOnly,
-		filePaths,
-	}: {
-		numberOfContextLines?: number;
-		includeFilesOnly?: boolean;
-		filePaths?: Array<string>;
-	}): Promise<ApplyActionsResult[]>;
-	/**
-	 * Get git diff based on the specified mode
-	 * @param mode - The diff mode: 'previous-commit', 'parent-branch', or 'remote'
-	 * @param numberOfContextLines - Optional number of context lines to include in the diff (e.g., 999 for -U999)
-	 * @param includeFilesOnly - If true, only return filePath and action properties
-	 * @param filePaths - Optional array of file paths to limit the diff to specific files
-	 */
-	getDiff({
-		mode,
-		numberOfContextLines,
-		includeFilesOnly,
-		filePaths,
-	}: {
-		mode: "remote-parent-branch" | "remote-current-branch";
-		numberOfContextLines?: number;
-		includeFilesOnly?: boolean;
-		filePaths?: Array<string>;
-	}): Promise<{
-		state: "error" | "success";
-		diff?: ApplyActionsResult[];
-		error?: Error;
-	}>;
-	private getDefaultBranch;
-	private getDiffFromParentBranch;
-}
-export declare function getUserContext(
-	sys: DevToolsSys,
-	gitWorkingDirectory?: string,
-): Promise<UserContext>;
-export declare function makeAsyncIterator<T>(): readonly [
-	AsyncGenerator<T, void, void>,
-	(event: T) => void,
-	() => void,
-];
-/**
- * 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;
-export declare class BashError extends Error {
-	readonly code: number | string | undefined;
-	readonly stdout: string;
-	readonly stderr: string;
-	readonly command: string;
-	constructor(
-		command: string,
-		code: number | string | undefined,
-		stdout: string,
-		stderr: string,
-		opts?: {
-			cause?: Error;
-		},
-	);
-}

package/types/packages/dev-tools/cli/constants.d.ts

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