@builder.io/dev-tools 1.28.8-dev.202602231640.c42808f8a → 1.28.9-dev.202602241603.943fe65da

package/types/cli/backup.d.ts

@@ -18,6 +18,8 @@ interface BackupGitRepoOptions {
     debug: boolean;
     forcedFullBackup: boolean;
     canAbortMerge: boolean;
+    folderName?: string;
+    repoUrl?: string;
 }
 /**
  * Creates a backup of git repository changes made by the AI system.
@@ -31,7 +33,7 @@ interface BackupGitRepoOptions {
  * The aiBranch is where the AI creates commits as work progresses, while featureBranch
  * is the base branch where work started (usually "main").
  */
-export declare function backupGitRepo({ sys, credentials, projectId, branchName, repoPath, aiBranch, featureBranch, workspace, isConnectedToProvider, debug, forcedFullBackup, canAbortMerge, }: BackupGitRepoOptions): Promise<BackupGitRepoResult>;
+export declare function backupGitRepo({ sys, credentials, projectId, branchName, repoPath, aiBranch, featureBranch, workspace, isConnectedToProvider, debug, forcedFullBackup, canAbortMerge, folderName, repoUrl, }: BackupGitRepoOptions): Promise<BackupGitRepoResult>;
 type InitialCommitHashResult = {
     initialBranch: string;
     initialCommitHash: string | undefined;
@@ -55,7 +57,7 @@ type InitialCommitHashResult = {
  * For partial backups, we fetch the latest state of the chosen upstream branch from origin
  * to ensure the backup has the correct commit range reference.
  */
-export declare function getInitialCommitHash({ sys, repoPath, featureBranch, debug, workspace, isConnectedToProvider, forcedFullBackup, credentials, projectId, }: {
+export declare function getInitialCommitHash({ sys, repoPath, featureBranch, debug, workspace, isConnectedToProvider, forcedFullBackup, credentials, projectId, folderName, }: {
     sys: DevToolsSys;
     repoPath: string;
     featureBranch: string;
@@ -65,6 +67,7 @@ export declare function getInitialCommitHash({ sys, repoPath, featureBranch, deb
     forcedFullBackup: boolean;
     credentials: Credentials;
     projectId: string;
+    folderName?: string;
 }): Promise<InitialCommitHashResult>;
 /**
  * Requests a signed upload URL for git backup

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

@@ -19,6 +19,7 @@ export interface ToolResolution {
     title?: string;
 }
 export interface ToolContext {
+    debug: boolean;
     sys: DevToolsSys;
     credentials: Credentials;
     files: ProjectFile[];

package/types/cli/codegen-git-snapshot.test.d.ts

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

package/types/cli/codegen.d.ts

@@ -1,11 +1,12 @@
 import type { DevToolsSys } from "../types";
 import { type Credentials } from "./credentials";
-import type { CodegenFeedback, CodeGenToolMap, CodegenTurn, CustomInstruction, FusionConfig, GenerateCompletionState, GenerateCompletionStep, GenerateUserMessage, SessionMode, UserContext, UserSource, WorkspaceFolder, LoadWholeSessionOptions, LoadWholeSessionResult, LoadHistoryResult, CodeGenMode, ApplyActionsResult, PrivacyMode, CodeGenPosition, BackupGitRepoResult, SuggestedActionBuildError, PushChangesArgs, CodegenApiResult, CodegenApiTerminal, ConfigureDevOrchestratorOpts, ConfigureDevOrchestratorUpdates, RepoMetrics, FolderWatchEvent, MCPServerConfig, CodegenApiCreateTerminal, SyncChangesFromRemote, SearchFilesOptions, SearchFilesResult, SearchFileTreeOptions, SearchFileTreeResult, HttpServerState, ExplorationMetadataToolInput, CodegenAbortOptions, MessageUpdateOptions, GitRepoContext, SystemReminderObj, GitSnapshot } from "$/ai-utils";
+import type { CodegenFeedback, CodeGenToolMap, CodegenTurn, CustomInstruction, FusionConfig, GenerateCompletionState, GenerateCompletionStep, GenerateUserMessage, SessionMode, UserContext, UserSource, WorkspaceFolder, LoadWholeSessionOptions, LoadWholeSessionResult, LoadHistoryResult, CodeGenMode, ApplyActionsResult, PrivacyMode, CodeGenPosition, BackupGitRepoResult, SuggestedActionBuildError, PushChangesArgs, CodegenApiResult, CodegenApiTerminal, ConfigureDevOrchestratorOpts, ConfigureDevOrchestratorUpdates, RepoMetrics, FolderWatchEvent, MCPServerConfig, CodegenApiCreateTerminal, SyncChangesFromRemote, SearchFilesOptions, SearchFilesResult, SearchFileTreeOptions, SearchFileTreeResult, HttpServerState, ExplorationMetadataToolInput, CodegenAbortOptions, MessageUpdateOptions, GitRepoContext, SystemReminderObj, GitSnapshot, AutoPushMode } from "$/ai-utils";
 import { type ToolResolution } from "./code-tools";
 import { type SubAgent } from "./utils/agent-discovery";
 import EventEmitter from "node:events";
 import { type RunCommandOptions } from "./utils/git";
 import { type DevServerOrchestrator } from "./launch/dev-server-orchestrator";
+import { type MemorySummary } from "./utils/memory-sync";
 import type { FusionStatusMonitor } from "./launch/machine-health";
 export interface SyncChangesFromBranches {
     canPush: boolean;
@@ -98,9 +99,15 @@ export declare class CodeGenSession {
     getSessionMode(): SessionMode;
     switchSessionMode(newMode: SessionMode): Promise<void>;
     removeSystemReminder(tag: string): void;
+    /**
+     * Returns memories whose glob matches the given file path, excluding ones
+     * already injected this session. Marks returned memories as reminded.
+     */
+    getMemoriesForFile(filePath: string): MemorySummary[];
     queueSystemReminder(reminder: SystemReminderObj): {
         operation: string;
     };
+    setDefaultAutoPush(autoPush: AutoPushMode | undefined): void;
     setPrivacyMode(privacyMode: PrivacyMode | undefined): Promise<void>;
     initializeSession(opts?: {
         skipSessionLoading?: boolean;
@@ -395,12 +402,11 @@ export declare class CodeGenSession {
      *
      * @returns commit hash if committed, false if no changes or staged only
      */
-    commitWorkInProgress(defaultCommitMessage: string, changedFiles: string[]): Promise<null>;
+    commitWorkInProgress(defaultCommitMessage: string, changedFiles: string[]): Promise<void>;
     getChangesReport(): Promise<{
         diff: string;
         files: string[];
     } | undefined>;
-    isCleanWorkTree(repoPath?: string): 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")

package/types/cli/indexing.d.ts

@@ -0,0 +1,5 @@
+import type { DevToolsSys } from "../types";
+import type { CLIArgs } from "./index";
+import { type Credentials } from "./credentials";
+export declare const runCodeIndexing: (_sys: DevToolsSys, _args: CLIArgs) => Promise<void>;
+export declare const codeIndexing: (sys: DevToolsSys, credentials: Credentials) => Promise<void>;

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

@@ -0,0 +1,3 @@
+export declare const getKVHiddenComment: (key: string, value: string) => string;
+export declare const getPreviewUrl: (projectId: string, branchName: string) => string;
+export declare const getInitialDescription: (projectId: string, branchName: string) => string;

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/dev-server-url-parser.d.ts

@@ -0,0 +1,12 @@
+export interface DevServerUrlInfo {
+    url: string;
+    port: number;
+}
+/**
+ * Parse dev server output to extract URL and port information
+ *
+ * @param output - The command output string to parse
+ * @param customPatterns - Optional array of custom regex patterns to try first
+ * @returns Object with url and port, or null if no valid URL found
+ */
+export declare function parseDevServerOutput(output: string, customPatterns?: string[]): DevServerUrlInfo | null;

package/types/cli/utils/dev-server-url-parser.test.d.ts

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

package/types/cli/utils/git-snapshot.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Parse multi-repo snapshot: "folder1:hash1,folder2:hash2" → { folder1: "hash1", ... }
+ * Backward compat: "abc123" (no colon) → { [primaryFolderName]: "abc123" }
+ */
+export declare function parseGitSnapshot(snapshot: string | undefined, primaryFolderName?: string): Record<string, string>;
+/**
+ * Serialize commits: { folder1: "hash1", ... } → "folder1:hash1,folder2:hash2"
+ * For single-repo, returns the full format with folder name
+ */
+export declare function serializeGitSnapshot(commits: Record<string, string>): string;
+/**
+ * Get commit for specific folder from snapshot
+ * @param snapshot - The snapshot string to parse
+ * @param folderName - The folder name to look up
+ * @param primaryFolderName - The primary folder name for parsing old format (optional, defaults to "code")
+ */
+export declare function getCommitFromSnapshot(snapshot: string | undefined, folderName: string, primaryFolderName?: string): string | undefined;

package/types/cli/utils/git-snapshot.test.d.ts

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

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

@@ -0,0 +1,25 @@
+import type { DevToolsSys } from "../../core";
+import type { Credentials } from "../credentials";
+export interface MemorySummary {
+    id: string;
+    category: string;
+    memory: string;
+    when: string;
+    glob: string | null;
+    updatedAt: number;
+}
+/**
+ * Find memories whose glob pattern matches a given file path.
+ * Uses minimatch for glob matching, with a fallback to substring check for plain paths.
+ */
+export declare function matchMemoriesForFile(memories: MemorySummary[], filePath: string): MemorySummary[];
+/**
+ * Fetch all memories for the current project.
+ * Returns an empty array on error to avoid blocking session initialization.
+ */
+export declare function loadMemories(sys: DevToolsSys, credentials: Credentials, projectId: string, signal?: AbortSignal): Promise<MemorySummary[]>;
+/**
+ * Write memories to `.builder/memories/` as markdown files grouped by category.
+ * Errors are silently swallowed to avoid blocking session initialization.
+ */
+export declare function syncMemoriesToDisk(sys: DevToolsSys, memories: MemorySummary[], rootDir: string): Promise<void>;

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

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

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

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

package/types/scripts/analyze-projects.d.ts

@@ -0,0 +1,18 @@
+export declare function analyzeProjects(inputPath?: string): Promise<{
+    success: boolean;
+    error: string;
+    projectsCount?: undefined;
+    branchesCount?: undefined;
+    csvRowsCount?: undefined;
+    outputPath?: undefined;
+} | {
+    success: boolean;
+    projectsCount: number;
+    branchesCount: number;
+    csvRowsCount: number;
+    outputPath: string;
+    error?: undefined;
+}>;
+export declare function handleAnalyzeProjects(args: {
+    inputPath?: string;
+}): Promise<void>;

package/types/scripts/call-ensure-container.d.ts

@@ -0,0 +1,4 @@
+export declare function handleCallEnsureContainer(args: {
+    appName: string;
+    branchName: string;
+}): Promise<void>;

package/types/scripts/check-backup.d.ts

@@ -0,0 +1 @@
+export declare function handleCheckBackup(): Promise<void>;

package/types/scripts/cli.d.ts

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

package/types/scripts/download-projects.d.ts

@@ -0,0 +1,12 @@
+export declare function downloadProjects(): Promise<{
+    success: boolean;
+    count: number;
+    outputPath: string;
+    error?: undefined;
+} | {
+    success: boolean;
+    error: string;
+    count?: undefined;
+    outputPath?: undefined;
+}>;
+export declare function handleDownloadProjects(): Promise<void>;

package/types/scripts/utils/db.d.ts

@@ -0,0 +1,3 @@
+import admin from "firebase-admin";
+export declare const db: admin.firestore.Firestore;
+export declare const storage: admin.storage.Storage;

package/types/scripts/utils/ensure-container.d.ts

@@ -0,0 +1,7 @@
+export declare function ensureContainer(projectId: string, branchName: string): Promise<{
+    success: boolean;
+    error?: undefined;
+} | {
+    success: boolean;
+    error: any;
+}>;

package/types/scripts/utils/remove-machine-and-volume.d.ts

@@ -0,0 +1,5 @@
+export declare function forceRemoveMachineAndVolume({ projectId, branchName, shouldDeleteVolume, }: {
+    projectId: string;
+    branchName: string;
+    shouldDeleteVolume?: boolean;
+}): Promise<void>;