@builder.io/dev-tools 1.18.11-dev.202511202319.621aec6ae → 1.18.11-dev.202511210323.98709336d

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;

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

@@ -1,69 +0,0 @@
-import type { DevToolsSys } from "../types";
-import type { CLIArgs } from "./index";
-import type { Feature } from "$/ai-utils";
-export interface CredentialsOptions {
-	forceSpaceId?: string;
-	builderPublicKey?: boolean;
-	builderPrivateKey?: boolean;
-	figmaAuth?: boolean;
-	force?: boolean;
-}
-export interface FigmaAuth {
-	access_token: string;
-	oauth: boolean;
-}
-export interface BuilderCodegenUsage {
-	total: number | undefined;
-	fast: number | undefined;
-	quality: number | undefined;
-	features?: Feature[];
-	limits?: {
-		aiGeneration: number;
-		aiGenerationContextWindow: number;
-	};
-}
-export interface BuilderAuth {
-	privateKey: string;
-	spaceId: string;
-	spaceName: string;
-	userId: string;
-}
-export declare const isCI: (args: CLIArgs) => boolean;
-export interface Credentials {
-	figmaAuth?: FigmaAuth;
-	builderPublicKey?: string;
-	builderPrivateKey?: string;
-	spaceName?: string;
-	userId?: string;
-	timestamp?: string;
-}
-export declare const readCredentials: (
-	sys: DevToolsSys,
-	args: CLIArgs,
-) => {
-	spaceName: string | undefined;
-	userId: string | undefined;
-	builderPublicKey: string | undefined;
-	builderPrivateKey: string | undefined;
-	figmaAuth: FigmaAuth | undefined;
-	timestamp: string | undefined;
-};
-export declare const getCredentials: (
-	sys: DevToolsSys,
-	args: CLIArgs,
-	opts: CredentialsOptions,
-) => Promise<Credentials>;
-export declare function getFigmaAuth(sys: DevToolsSys): Promise<FigmaAuth>;
-export declare function getBuilderCodegenUsage(
-	builderPublicKey: string,
-	builderPrivateKey: string,
-): Promise<BuilderCodegenUsage>;
-export declare function getBuilderAuth(
-	sys: DevToolsSys,
-	preferSpaceId?: string,
-): Promise<BuilderAuth>;
-export declare function storeCredentials(
-	sys: DevToolsSys,
-	credentials: Credentials,
-): void;
-export declare function clearCredentials(sys: DevToolsSys): boolean;

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

@@ -1,15 +0,0 @@
-import type { CLIArgs } from "./index";
-import type { DevToolsSys } from "../types";
-import type { FigmaBuilderLink } from "$/ai-utils";
-interface KVGetRequest {
-	privateKey: string;
-	spaceId: string;
-}
-export declare const runFigmaMigrate: (
-	sys: DevToolsSys,
-	args: CLIArgs,
-) => Promise<undefined>;
-export declare function getBuilderSpaceFigmaLinks(
-	kvReq: KVGetRequest,
-): Promise<FigmaBuilderLink[]>;
-export {};

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

@@ -1 +0,0 @@
-export declare function exit(code: number): Promise<never>;

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

@@ -1 +0,0 @@
-export declare const safeFetch: typeof globalThis.fetch;

package/types/packages/dev-tools/cli/figma-publish.d.ts

@@ -1,41 +0,0 @@
-import ts from "typescript";
-import type { DevTools, DevToolsSys } from "../types";
-import type { CLIArgs } from "./index";
-import type { FigmaBuilderLink, FigmaMapperFile } from "$/ai-utils";
-export declare const runFigmaPublish: (
-	sys: DevToolsSys,
-	args: CLIArgs,
-) => Promise<undefined>;
-export declare const FIGMA_CONNECT_CALL = "figmaMapping";
-export declare function findAllMappingFiles(
-	sys: DevToolsSys,
-): Promise<string[]>;
-export declare function setPublicKey(
-	sys: DevToolsSys,
-	publicKey: string,
-	devTools: DevTools | undefined,
-	ensureFigmaImportPage?: boolean,
-): Promise<
-	| {
-			success: boolean;
-			error: string;
-	  }
-	| {
-			success: boolean;
-			error?: undefined;
-	  }
->;
-export declare function findMappingsFromFiles({
-	sys,
-	mappingFiles,
-	typeCheck,
-}: {
-	mappingFiles: string[];
-	sys: DevToolsSys;
-	typeCheck?: boolean;
-}): Promise<{
-	mapperFiles: FigmaMapperFile[];
-	figmaBuilderLinks: FigmaBuilderLink[];
-	diagnostics: ts.Diagnostic[];
-	figmaLinksToResolve: string[];
-}>;

package/types/packages/dev-tools/cli/figma-publish.spec.d.ts

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

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

@@ -1,61 +0,0 @@
-import { type Credentials, type FigmaAuth } from "./credentials";
-import type { DevToolsSys } from "../types";
-import type { CLIArgs } from "./index";
-import type { FigmaBuilderLink, FigmaComponentInfo } from "$/ai-utils";
-type FigmaAPIOpts = {
-	auth: {
-		access_token: string;
-		oauth: boolean;
-	};
-	params?: Record<string, any>;
-};
-export declare const parseFigmaURL: (str: string) => {
-	fileID: string;
-	nodeId: string;
-} | null;
-export declare const figmaApi: <T = any>(
-	sys: DevToolsSys,
-	args: CLIArgs,
-	path: string,
-	{ auth, params }: FigmaAPIOpts,
-) => Promise<T>;
-export declare const getFigmaNodeData: (
-	sys: DevToolsSys,
-	args: CLIArgs,
-	auth: {
-		access_token: string;
-		oauth: boolean;
-	},
-	fileId: string,
-	nodeIds: string,
-	depth?: number | undefined,
-) => Promise<any>;
-export declare function getImportDataFromToken(
-	credentials: Credentials,
-	token: string,
-	verbose: boolean,
-): Promise<(readonly [string, FigmaComponentInfo])[]>;
-export declare function needsFigmaAuth(urls: string[]): boolean;
-export declare function getFigmaNodeDataFromURLs(
-	sys: DevToolsSys,
-	args: CLIArgs,
-	figmaAuth:
-		| {
-				access_token: string;
-				oauth: boolean;
-		  }
-		| undefined,
-	builderAuth: {
-		privateKey: string;
-		spaceId: string;
-	},
-	urls: string[],
-): Promise<(readonly [string, FigmaComponentInfo])[]>;
-export declare function inPlaceResolveFigmaURLs(
-	sys: DevToolsSys,
-	args: CLIArgs,
-	figmaAuth: FigmaAuth,
-	figmaBuilderLinks: FigmaBuilderLink[],
-	figmaLinksToResolve: string[],
-): Promise<void>;
-export {};

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

@@ -1,11 +0,0 @@
-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/packages/dev-tools/cli/generate.d.ts

@@ -1,19 +0,0 @@
-import type { ComponentInfo, ComponentRegistry, DevToolsSys } from "../types";
-import type { CLIArgs } from "./index";
-import { type FigmaComponentInfo, type UserContext } from "$/ai-utils";
-export declare const runFigmaGenerate: (
-	sys: DevToolsSys,
-	args: CLIArgs,
-) => Promise<undefined>;
-export interface MappingCodeV3 {
-	figmaNode?: FigmaComponentInfo;
-	registry?: ComponentRegistry;
-	userContext?: UserContext;
-	figmaUrl?: string;
-	docsUrl?: string;
-	registeredCmp?: ComponentInfo;
-	previousCompletion?: string;
-	userPrompt?: string;
-	token?: string;
-	pragma?: string;
-}

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

@@ -1 +0,0 @@
-export declare function printHelp(subcommand?: string): void;