firebase-tools 15.10.1 → 15.12.0

package/lib/agentSkills.js

@@ -0,0 +1,70 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.promptForAgentSkills = promptForAgentSkills;
+exports.installAgentSkills = installAgentSkills;
+const child_process_1 = require("child_process");
+const utils = require("./utils");
+const prompt = require("./prompt");
+const error_1 = require("./error");
+async function promptForAgentSkills() {
+    return prompt.confirm({
+        message: "Would you like to install agent skills for Firebase?",
+        default: true,
+    });
+}
+async function installAgentSkills(options) {
+    if (!utils.commandExistsSync("npx")) {
+        return;
+    }
+    const args = [
+        "-y",
+        "skills",
+        "add",
+        "firebase/agent-skills",
+        "--skill",
+        "*",
+        "-y",
+    ];
+    if (options.agentName) {
+        args.push("-a", options.agentName);
+    }
+    if (options.global) {
+        args.push("-g");
+    }
+    if (options.background) {
+        utils.logBullet("Installing Agent skills in the background...");
+        try {
+            const child = (0, child_process_1.spawn)("npx", args, {
+                cwd: options.cwd,
+                stdio: "ignore",
+                detached: true,
+                shell: process.platform === "win32",
+            });
+            child.unref();
+            utils.logSuccess("Agent skills installation started");
+        }
+        catch (err) {
+            utils.logWarning(`Could not start Agent skills installation: ${(0, error_1.getErrMsg)(err)}`);
+        }
+    }
+    else {
+        utils.logBullet("Adding Agent skills...");
+        try {
+            const result = (0, child_process_1.spawnSync)("npx", args, {
+                cwd: options.cwd,
+                stdio: "ignore",
+                shell: process.platform === "win32",
+            });
+            if (result.error) {
+                throw result.error;
+            }
+            if (result.status !== 0) {
+                throw new Error(`npx skills add exited with code ${result.status}`);
+            }
+            utils.logSuccess("Added Agent skills");
+        }
+        catch (err) {
+            utils.logWarning(`Could not add Agent skills: ${(0, error_1.getErrMsg)(err)}`);
+        }
+    }
+}

package/lib/api.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.storageOrigin = exports.runtimeconfigOrigin = exports.rulesOrigin = exports.resourceManagerOrigin = exports.crashlyticsApiOrigin = exports.messagingApiOrigin = exports.remoteConfigApiOrigin = exports.rtdbMetadataOrigin = exports.rtdbManagementOrigin = exports.realtimeOrigin = exports.extensionsTOSOrigin = exports.extensionsPublisherOrigin = exports.extensionsOrigin = exports.iamOrigin = exports.identityOrigin = exports.hostingOrigin = exports.googleOrigin = exports.pubsubOrigin = exports.cloudTasksOrigin = exports.cloudschedulerOrigin = exports.cloudbuildOrigin = exports.functionsDefaultRegion = exports.runOrigin = exports.functionsV2Origin = exports.functionsOrigin = exports.firestoreOrigin = exports.firestoreOriginOrEmulator = exports.firedataOrigin = exports.firebaseExtensionsRegistryOrigin = exports.firebaseApiOrigin = exports.eventarcOrigin = exports.dynamicLinksKey = exports.dynamicLinksOrigin = exports.consoleOrigin = exports.authManagementOrigin = exports.authOrigin = exports.apphostingGitHubAppInstallationURL = exports.apphostingP4SADomain = exports.apphostingOrigin = exports.appDistributionOrigin = exports.artifactRegistryDomain = exports.developerConnectP4SADomain = exports.developerConnectOrigin = exports.containerRegistryDomain = exports.cloudMonitoringOrigin = exports.cloudloggingOrigin = exports.cloudbillingOrigin = exports.clientSecret = exports.clientId = exports.authProxyOrigin = void 0;
-exports.developerKnowledgeOrigin = exports.cloudTestingOrigin = exports.appTestingOrigin = exports.cloudAiCompanionOrigin = exports.vertexAIOrigin = exports.cloudSQLAdminOrigin = exports.dataConnectLocalConnString = exports.dataconnectP4SADomain = exports.dataconnectOrigin = exports.githubClientSecret = exports.githubClientId = exports.computeOrigin = exports.secretManagerOrigin = exports.githubApiOrigin = exports.githubOrigin = exports.studioApiOrigin = exports.serviceUsageOrigin = exports.cloudRunApiOrigin = exports.hostingApiOrigin = exports.firebaseStorageOrigin = void 0;
+exports.developerKnowledgeOrigin = exports.cloudTestingOrigin = exports.appTestingOrigin = exports.cloudAiCompanionOrigin = exports.aiLogicProxyOrigin = exports.vertexAIOrigin = exports.cloudSQLAdminOrigin = exports.dataConnectLocalConnString = exports.dataconnectP4SADomain = exports.dataconnectOrigin = exports.githubClientSecret = exports.githubClientId = exports.computeOrigin = exports.secretManagerOrigin = exports.githubApiOrigin = exports.githubOrigin = exports.studioApiOrigin = exports.serviceUsageOrigin = exports.cloudRunApiOrigin = exports.hostingApiOrigin = exports.firebaseStorageOrigin = void 0;
 exports.getScopes = getScopes;
 exports.setScopes = setScopes;
 const constants_1 = require("./emulator/constants");
@@ -146,6 +146,8 @@ const cloudSQLAdminOrigin = () => utils.envOverride("CLOUD_SQL_URL", "https://sq
 exports.cloudSQLAdminOrigin = cloudSQLAdminOrigin;
 const vertexAIOrigin = () => utils.envOverride("VERTEX_AI_URL", "https://aiplatform.googleapis.com");
 exports.vertexAIOrigin = vertexAIOrigin;
+const aiLogicProxyOrigin = () => utils.envOverride("AI_LOGIC_PROXY_URL", "https://firebasevertexai.googleapis.com");
+exports.aiLogicProxyOrigin = aiLogicProxyOrigin;
 const cloudAiCompanionOrigin = () => utils.envOverride("CLOUD_AI_COMPANION_URL", "https://cloudaicompanion.googleapis.com");
 exports.cloudAiCompanionOrigin = cloudAiCompanionOrigin;
 const appTestingOrigin = () => utils.envOverride("FIREBASE_APP_TESTING_URL", "https://firebaseapptesting.googleapis.com");

package/lib/appdistribution/client.js

@@ -298,5 +298,22 @@ class AppDistributionClient {
             throw new error_1.FirebaseError(`Failed to upsert test cases ${(0, error_1.getErrMsg)(err)}`);
         }
     }
+    async getLatestRelease(appName) {
+        try {
+            const response = await this.appDistroV1Client.get(`/${appName}/releases`, {
+                queryParams: {
+                    pageSize: "1",
+                    orderBy: "createTime desc",
+                },
+            });
+            if (!response.body.releases?.length) {
+                return undefined;
+            }
+            return response.body.releases[0];
+        }
+        catch (err) {
+            throw new error_1.FirebaseError(`Failed to get latest release for app ${appName}: ${(0, error_1.getErrMsg)(err)}`);
+        }
+    }
 }
 exports.AppDistributionClient = AppDistributionClient;

package/lib/apphosting/backend.js

@@ -34,6 +34,8 @@ const ora = require("ora");
 const node_fetch_1 = require("node-fetch");
 const rollout_1 = require("./rollout");
 const fuzzy = require("fuzzy");
+const experiments_1 = require("../experiments");
+const DEFAULT_RUNTIME = "nodejs";
 const DEFAULT_COMPUTE_SERVICE_ACCOUNT_NAME = "firebase-app-hosting-compute";
 const apphostingPollerOptions = {
     apiOrigin: (0, api_1.apphostingOrigin)(),
@@ -64,7 +66,7 @@ async function awaitTlsReady(url) {
         }
     } while (!ready);
 }
-async function doSetup(projectId, nonInteractive, webAppName, backendId, serviceAccount, primaryRegion, rootDir) {
+async function doSetup(projectId, nonInteractive, webAppName, backendId, serviceAccount, primaryRegion, rootDir, runtime, automaticBaseImageUpdatesDisabled) {
     await ensureRequiredApisEnabled(projectId);
     await ensureAppHostingComputeServiceAccount(projectId, serviceAccount ? serviceAccount : null);
     let location = primaryRegion;
@@ -97,12 +99,27 @@ async function doSetup(projectId, nonInteractive, webAppName, backendId, service
     if (!location || !backendId) {
         throw new error_1.FirebaseError("Internal error: location or backendId is not defined.");
     }
+    if (runtime === undefined && (0, experiments_1.isEnabled)("abiu")) {
+        if (nonInteractive) {
+            runtime = DEFAULT_RUNTIME;
+        }
+        else {
+            runtime = await (0, prompt_1.select)({
+                message: "Which runtime do you want to use?",
+                choices: [
+                    { name: "Node.js (default)", value: DEFAULT_RUNTIME },
+                    { name: "Node.js 22", value: "nodejs22" },
+                ],
+                default: DEFAULT_RUNTIME,
+            });
+        }
+    }
     const webApp = await app_1.webApps.getOrCreateWebApp(projectId, webAppName ? webAppName : null, backendId);
     if (!webApp) {
         (0, utils_1.logWarning)(`Firebase web app not set`);
     }
     const createBackendSpinner = ora("Creating your new backend...").start();
-    const backend = await createBackend(projectId, location, backendId, serviceAccount ? serviceAccount : null, gitRepositoryLink, webApp?.id, rootDir);
+    const backend = await createBackend(projectId, location, backendId, serviceAccount ? serviceAccount : null, gitRepositoryLink, webApp?.id, rootDir, runtime, automaticBaseImageUpdatesDisabled);
     createBackendSpinner.succeed(`Successfully created backend!\n\t${backend.name}\n`);
     if (nonInteractive) {
         return;
@@ -227,7 +244,7 @@ async function promptNewBackendId(projectId, location) {
 function defaultComputeServiceAccountEmail(projectId) {
     return `${DEFAULT_COMPUTE_SERVICE_ACCOUNT_NAME}@${projectId}.iam.gserviceaccount.com`;
 }
-async function createBackend(projectId, location, backendId, serviceAccount, repository, webAppId, rootDir = "/") {
+async function createBackend(projectId, location, backendId, serviceAccount, repository, webAppId, rootDir = "/", runtime, automaticBaseImageUpdatesDisabled) {
     const defaultServiceAccount = defaultComputeServiceAccountEmail(projectId);
     const backendReqBody = {
         servingLocality: "GLOBAL_ACCESS",
@@ -240,6 +257,8 @@ async function createBackend(projectId, location, backendId, serviceAccount, rep
         labels: deploymentTool.labels(),
         serviceAccount: serviceAccount || defaultServiceAccount,
         appId: webAppId,
+        runtime: { value: runtime ?? "" },
+        automaticBaseImageUpdatesDisabled,
     };
     async function createBackendAndPoll() {
         const op = await apphosting.createBackend(projectId, location, backendReqBody, backendId);

package/lib/apptesting/parseTestFiles.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.parseTestFiles = parseTestFiles;
+exports.pluralizeTests = pluralizeTests;
 const fsutils_1 = require("../fsutils");
 const path_1 = require("path");
 const logger_1 = require("../logger");
@@ -77,26 +78,25 @@ function createFilter(pattern, context) {
 async function parseTestFilesRecursive(params) {
     const testDir = params.testDir;
     const targetUri = params.targetUri;
-    const items = (0, fsutils_1.listFiles)(testDir);
+    const filenames = (0, fsutils_1.listFiles)(testDir);
     const results = [];
-    for (const item of items) {
-        const path = (0, path_1.join)(testDir, item);
+    for (const filename of filenames) {
+        const path = (0, path_1.join)(testDir, filename);
         if ((0, fsutils_1.dirExistsSync)(path)) {
             results.push(...(await parseTestFilesRecursive({ testDir: path, targetUri })));
         }
-        else if ((0, fsutils_1.fileExistsSync)(path)) {
+        else if ((0, fsutils_1.fileExistsSync)(path) && (path.endsWith(".yaml") || path.endsWith(".yml"))) {
             try {
-                const file = await (0, utils_1.readFileFromDirectory)(testDir, item);
-                logger_1.logger.debug(`Read the file ${file.source}.`);
+                logger_1.logger.debug(`Reading ${path}.`);
+                const file = await (0, utils_1.readFileFromDirectory)(testDir, filename);
                 const parsedFile = (0, utils_1.wrappedSafeLoad)(file.source);
-                logger_1.logger.debug(`Parsed the file.`);
                 const tests = parsedFile.tests;
-                logger_1.logger.debug(`There are ${tests.length} tests.`);
                 const defaultConfig = parsedFile.defaultConfig;
                 if (!tests || !tests.length) {
                     logger_1.logger.debug(`No tests found in ${path}. Ignoring.`);
                     continue;
                 }
+                logger_1.logger.debug(`File contains ${pluralizeTests(tests.length)}.`);
                 const invocations = [];
                 for (const rawTestDef of tests) {
                     const invocation = toTestCaseInvocation(rawTestDef, targetUri, defaultConfig);
@@ -114,6 +114,9 @@ async function parseTestFilesRecursive(params) {
     }
     return results;
 }
+function pluralizeTests(numTests) {
+    return `${numTests} test${numTests === 1 ? "" : "s"}`;
+}
 function toTestCaseInvocation(testDef, targetUri, defaultConfig) {
     const steps = testDef.steps ?? [];
     const route = testDef.testConfig?.route ?? defaultConfig?.route ?? "";

package/lib/bin/mcp.js

@@ -3,6 +3,8 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.mcp = mcp;
 const path_1 = require("path");
+const promises_1 = require("fs/promises");
+const os_1 = require("os");
 const util_1 = require("util");
 const logger_1 = require("../logger");
 const index_1 = require("../mcp/index");
@@ -82,7 +84,9 @@ async function mcp() {
     if (earlyExit)
         return;
     (0, env_1.setFirebaseMcp)(true);
-    (0, logger_1.useFileLogger)();
+    const mcpLogDir = (0, path_1.join)((0, os_1.homedir)(), ".cache", "firebase");
+    await (0, promises_1.mkdir)(mcpLogDir, { recursive: true });
+    (0, logger_1.useFileLogger)((0, path_1.join)(mcpLogDir, "firebase-debug.log"));
     const activeFeatures = (values.only || "")
         .split(",")
         .map((f) => f.trim())

package/lib/commands/apphosting-backends-create.js

@@ -7,6 +7,7 @@ const projectUtils_1 = require("../projectUtils");
 const requireAuth_1 = require("../requireAuth");
 const backend_1 = require("../apphosting/backend");
 const apphosting_1 = require("../gcp/apphosting");
+const experiments = require("../experiments");
 const firedata_1 = require("../gcp/firedata");
 const requireTosAcceptance_1 = require("../requireTosAcceptance");
 exports.command = new command_1.Command("apphosting:backends:create")
@@ -15,7 +16,15 @@ exports.command = new command_1.Command("apphosting:backends:create")
     .option("--backend <backend>", "specify the name of the new backend. Required with --non-interactive.")
     .option("-s, --service-account <serviceAccount>", "specify the service account used to run the server", "")
     .option("--primary-region <primaryRegion>", "specify the primary region for the backend. Required with --non-interactive.")
-    .option("--root-dir <rootDir>", "specify the root directory for the backend.")
+    .option("--root-dir <rootDir>", "specify the root directory for the backend.");
+const abiuEnabled = experiments.isEnabled("abiu");
+if (abiuEnabled) {
+    exports.command
+        .option("--runtime [runtime]", "specify the runtime for the backend (e.g., nodejs, nodejs22)")
+        .option("--automatic-base-image-updates", "enable automatic base image updates")
+        .option("--no-automatic-base-image-updates", "disable automatic base image updates");
+}
+exports.command
     .before(requireAuth_1.requireAuth)
     .before(apphosting_1.ensureApiEnabled)
     .before((0, requireTosAcceptance_1.requireTosAcceptance)(firedata_1.APPHOSTING_TOS_ID))
@@ -24,5 +33,13 @@ exports.command = new command_1.Command("apphosting:backends:create")
     if (options.nonInteractive && (options.backend == null || options.primaryRegion == null)) {
         throw new error_1.FirebaseError(`--non-interactive option requires --backend and --primary-region`);
     }
-    await (0, backend_1.doSetup)(projectId, options.nonInteractive, options.app, options.backend, options.serviceAccount, options.primaryRegion, options.rootDir);
+    const abiuAllowed = experiments.isEnabled("abiu");
+    if (!abiuAllowed && (options.runtime || options.automaticBaseImageUpdates !== undefined)) {
+        throw new error_1.FirebaseError("The --runtime and --automatic-base-image-updates flags are only available when the 'abiu' experiment is enabled. To enable it, run 'firebase experiments:enable abiu'.");
+    }
+    const runtime = abiuAllowed && typeof options.runtime === "string" ? options.runtime : undefined;
+    const automaticBaseImageUpdatesDisabled = abiuAllowed
+        ? options.automaticBaseImageUpdates === false
+        : undefined;
+    return (0, backend_1.doSetup)(projectId, options.nonInteractive, options.app, options.backend, options.serviceAccount, options.primaryRegion, options.rootDir, runtime, automaticBaseImageUpdatesDisabled);
 });

package/lib/commands/apphosting-backends-list.js

@@ -9,8 +9,8 @@ const logger_1 = require("../logger");
 const projectUtils_1 = require("../projectUtils");
 const requireAuth_1 = require("../requireAuth");
 const apphosting = require("../gcp/apphosting");
+const experiments_1 = require("../experiments");
 const Table = require("cli-table3");
-const TABLE_HEAD = ["Backend", "Repository", "URL", "Primary Region", "Updated Date"];
 exports.command = new command_1.Command("apphosting:backends:list")
     .description("list Firebase App Hosting backends")
     .before(requireAuth_1.requireAuth)
@@ -29,19 +29,35 @@ exports.command = new command_1.Command("apphosting:backends:list")
     return backends;
 });
 function printBackendsTable(backends) {
+    const abiuEnabled = (0, experiments_1.isEnabled)("abiu");
+    const head = ["Backend", "Repository", "URL", "Primary Region"];
+    if (abiuEnabled) {
+        head.push("ABIU");
+        head.push("Runtime");
+    }
+    head.push("Updated Date");
     const table = new Table({
-        head: TABLE_HEAD,
+        head: head,
         style: { head: ["green"] },
     });
     for (const backend of backends) {
         const { location, id } = apphosting.parseBackendName(backend.name);
-        table.push([
+        const row = [
             id,
             backend.codebase?.repository?.split("/").pop() ?? "",
             backend.uri.startsWith("https:") ? backend.uri : "https://" + backend.uri,
             location,
-            (0, utils_1.datetimeString)(new Date(backend.updateTime)),
-        ]);
+        ];
+        if (abiuEnabled) {
+            let abiuStatus = "N/A";
+            if (backend.automaticBaseImageUpdatesDisabled !== undefined) {
+                abiuStatus = backend.automaticBaseImageUpdatesDisabled ? "Disabled" : "Enabled";
+            }
+            row.push(abiuStatus);
+            row.push(backend.runtime?.value ?? "N/A");
+        }
+        row.push((0, utils_1.datetimeString)(new Date(backend.updateTime)));
+        table.push(row);
     }
     logger_1.logger.info(table.toString());
 }

package/lib/commands/apptesting.js

@@ -20,7 +20,7 @@ const defaultDevices = [
         orientation: "portrait",
     },
 ];
-exports.command = new command_1.Command("apptesting:execute <release-binary-file>")
+exports.command = new command_1.Command("apptesting:execute [release-binary-file]")
     .description("Run mobile automated tests written in natural language driven by AI")
     .option("--app <app_id>", "The app id of your Firebase web app. Optional if the project contains exactly one web app.")
     .option("--test-file-pattern <pattern>", "Test file pattern. Only tests contained in files that match this pattern will be executed.")
@@ -39,17 +39,29 @@ exports.command = new command_1.Command("apptesting:execute <release-binary-file
     const tests = await (0, parseTestFiles_1.parseTestFiles)(testDir, undefined, options.testFilePattern, options.testNamePattern);
     const testDevices = (0, options_parser_util_1.parseTestDevices)(options.testDevices, options.testDevicesFile);
     if (!tests.length) {
-        throw new error_1.FirebaseError("No tests found");
+        throw new error_1.FirebaseError(`No tests found under test directory ${testDir}`);
     }
+    utils.logBullet(`Found ${(0, parseTestFiles_1.pluralizeTests)(tests.length)} to run under test directory ${testDir}`);
     const invokeSpinner = ora("Requesting test execution");
     const client = new client_1.AppDistributionClient();
     let releaseTests;
     let release;
     try {
-        release = await (0, distribution_1.upload)(client, appName, new distribution_1.Distribution(target));
+        if (target) {
+            release = await (0, distribution_1.upload)(client, appName, new distribution_1.Distribution(target));
+        }
+        else {
+            utils.logBullet("release-binary-file not provided, using the latest App Distribution release.");
+            const latestRelease = await client.getLatestRelease(appName);
+            if (!latestRelease) {
+                throw new error_1.FirebaseError(`No app binary found for ${appName}. Call apptesting:execute with a local app binary file, or upload a release to App Distribution.`);
+            }
+            release = latestRelease;
+            utils.logBullet(`Using release ${release.displayVersion} created at ${release.createTime}`);
+        }
         invokeSpinner.start();
         releaseTests = await invokeTests(client, release.name, tests, !testDevices.length ? defaultDevices : testDevices);
-        invokeSpinner.text = `${pluralizeTests(releaseTests.length)} started successfully!`;
+        invokeSpinner.text = `${(0, parseTestFiles_1.pluralizeTests)(releaseTests.length)} started successfully!`;
         invokeSpinner.succeed();
     }
     catch (ex) {
@@ -64,9 +76,6 @@ exports.command = new command_1.Command("apptesting:execute <release-binary-file
         utils.logBullet(`View detailed results in the Firebase Console:\n${release.firebaseConsoleUri}`);
     }
 });
-function pluralizeTests(numTests) {
-    return `${numTests} test${numTests === 1 ? "" : "s"}`;
-}
 async function invokeTests(client, releaseName, testDefs, devices) {
     try {
         const releaseTests = [];

package/lib/commands/functions-delete.js

@@ -75,6 +75,7 @@ exports.command = new command_1.Command("functions:delete [filters...]")
     try {
         const fab = new fabricator.Fabricator({
             functionExecutor,
+            runFunctionExecutor: functionExecutor,
             appEngineLocation,
             executor: new executor.QueueExecutor({}),
             sources: {},

package/lib/commands/functions-export.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.command = void 0;
+const command_1 = require("../command");
+const error_1 = require("../error");
+const iac = require("../functions/iac/export");
+const projectConfig_1 = require("../functions/projectConfig");
+const clc = require("colorette");
+const logger_1 = require("../logger");
+const EXPORTERS = {
+    internal: iac.getInternalIac,
+};
+exports.command = new command_1.Command("functions:export")
+    .description("export Cloud Functions code and configuration")
+    .option("--format <format>", `Format of the output. Can be ${Object.keys(EXPORTERS).join(", ")}.`)
+    .option("--codebase <codebase>", "Optional codebase to export. If not specified, exports the default or only codebase.")
+    .action(async (options) => {
+    if (!options.format || !Object.keys(EXPORTERS).includes(options.format)) {
+        throw new error_1.FirebaseError(`Must specify --format as ${Object.keys(EXPORTERS).join(", ")}.`);
+    }
+    const config = (0, projectConfig_1.normalizeAndValidate)(options.config?.src?.functions);
+    let codebaseConfig;
+    if (options.codebase) {
+        codebaseConfig = (0, projectConfig_1.configForCodebase)(config, options.codebase);
+    }
+    else if (config.length === 1) {
+        codebaseConfig = config[0];
+    }
+    else {
+        codebaseConfig = (0, projectConfig_1.configForCodebase)(config, "default");
+    }
+    if (!codebaseConfig.source) {
+        throw new error_1.FirebaseError("Codebase does not have a local source directory.");
+    }
+    const manifest = await EXPORTERS[options.format](options, codebaseConfig);
+    for (const [file, contents] of Object.entries(manifest)) {
+        logger_1.logger.info(`Manifest file: ${clc.bold(file)}`);
+        logger_1.logger.info(contents);
+    }
+});

package/lib/commands/index.js

@@ -141,6 +141,9 @@ function load(client) {
     client.functions.config.set = loadCommand("functions-config-set");
     client.functions.config.unset = loadCommand("functions-config-unset");
     client.functions.delete = loadCommand("functions-delete");
+    if (experiments.isEnabled("functionsiac")) {
+        client.functions.export = loadCommand("functions-export");
+    }
     client.functions.log = loadCommand("functions-log");
     client.functions.shell = loadCommand("functions-shell");
     client.functions.list = loadCommand("functions-list");

package/lib/commands/init.js

@@ -228,6 +228,7 @@ async function initAction(feature, options) {
     if (setup.features.includes("dataconnect") && setup.features.includes("dataconnect:sdk")) {
         setup.features = setup.features.filter((f) => f !== "dataconnect:sdk");
     }
+    setup.features.push("agentSkills");
     await (0, init_1.init)(setup, config, options);
     await postInitSaves(setup, config);
     if (setup.instructions.length) {

package/lib/commands/studio-export.js

@@ -8,12 +8,12 @@ const path = require("path");
 const error_1 = require("../error");
 const unzip_1 = require("../unzip");
 const fs = require("fs");
-exports.command = new command_1.Command("studio:export <path>")
+exports.command = new command_1.Command("studio:export [path]")
     .description("Bootstrap Firebase Studio apps for migration to Antigravity. Run on the unzipped folder from the Firebase Studio download, or directly on the downloaded zip file.")
     .option("--no-start-antigravity", "skip starting the Antigravity IDE after migration")
     .action(async (exportPath, options) => {
     if (!exportPath) {
-        throw new error_1.FirebaseError("Must specify a path for migration.", { exit: 1 });
+        throw new error_1.FirebaseError("Must specify the path to the Firebase Studio downloaded zip file or the unzipped folder path.", { exit: 1 });
     }
     let rootPath = path.resolve(exportPath);
     if (fs.existsSync(rootPath) && fs.statSync(rootPath).isFile() && rootPath.endsWith(".zip")) {

package/lib/deploy/apphosting/deploy.js

@@ -8,7 +8,8 @@ const gcs = require("../../gcp/storage");
 const getProjectNumber_1 = require("../../getProjectNumber");
 const projectUtils_1 = require("../../projectUtils");
 const utils_1 = require("../../utils");
-const util_1 = require("./util");
+const util = require("./util");
+const experiments = require("../../experiments");
 async function default_1(context, options) {
     if (Object.entries(context.backendConfigs).length === 0) {
         return;
@@ -52,24 +53,28 @@ async function default_1(context, options) {
     await Promise.all(Object.values(context.backendConfigs).map(async (cfg) => {
         const rootDir = options.projectRoot ?? process.cwd();
         let builtAppDir;
-        if (cfg.localBuild) {
+        const isLocalBuild = !!cfg.localBuild;
+        if (isLocalBuild) {
+            experiments.assertEnabled("apphostinglocalbuilds", "App Hosting local builds");
             builtAppDir = context.backendLocalBuilds[cfg.backendId].buildDir;
             if (!builtAppDir) {
                 throw new error_1.FirebaseError(`No local build dir found for ${cfg.backendId}`);
             }
         }
-        const zippedSourcePath = await (0, util_1.createArchive)(cfg, rootDir, builtAppDir);
-        (0, utils_1.logLabeledBullet)("apphosting", `Zipped ${cfg.localBuild ? "built app" : "source"} for backend ${cfg.backendId}`);
+        const zippedSourcePath = isLocalBuild
+            ? await util.createLocalBuildTarArchive(cfg, rootDir, builtAppDir)
+            : await util.createSourceDeployArchive(cfg, rootDir);
+        (0, utils_1.logLabeledBullet)("apphosting", `Zipped ${isLocalBuild ? "built app" : "source"} for backend ${cfg.backendId}`);
         const backendLocation = context.backendLocations[cfg.backendId];
         if (!backendLocation) {
             throw new error_1.FirebaseError(`Failed to find location for backend ${cfg.backendId}. Please contact support with the contents of your firebase-debug.log to report your issue.`);
         }
-        (0, utils_1.logLabeledBullet)("apphosting", `Uploading ${cfg.localBuild ? "built app" : "source"} for backend ${cfg.backendId}...`);
+        (0, utils_1.logLabeledBullet)("apphosting", `Uploading ${isLocalBuild ? "built app" : "source"} for backend ${cfg.backendId}...`);
         const bucketName = bucketsPerLocation[backendLocation];
         const { bucket, object } = await gcs.uploadObject({
             file: zippedSourcePath,
             stream: fs.createReadStream(zippedSourcePath),
-        }, bucketName);
+        }, bucketName, isLocalBuild ? gcs.ContentType.TAR : gcs.ContentType.ZIP);
         (0, utils_1.logLabeledBullet)("apphosting", `Uploaded at gs://${bucket}/${object}`);
         context.backendStorageUris[cfg.backendId] =
             `gs://${bucketName}/${path.basename(zippedSourcePath)}`;

package/lib/deploy/apphosting/prepare.js

@@ -6,11 +6,15 @@ const path = require("path");
 const backend_1 = require("../../apphosting/backend");
 const apphosting_1 = require("../../gcp/apphosting");
 const devConnect_1 = require("../../gcp/devConnect");
+const resourceManager_1 = require("../../gcp/resourceManager");
 const projectUtils_1 = require("../../projectUtils");
+const getProjectNumber_1 = require("../../getProjectNumber");
 const prompt_1 = require("../../prompt");
 const utils_1 = require("../../utils");
 const localbuilds_1 = require("../../apphosting/localbuilds");
 const error_1 = require("../../error");
+const experiments = require("../../experiments");
+const logger_1 = require("../../logger");
 async function default_1(context, options) {
     const projectId = (0, projectUtils_1.needProjectId)(options);
     await (0, apphosting_1.ensureApiEnabled)(options);
@@ -21,6 +25,10 @@ async function default_1(context, options) {
     context.backendStorageUris = {};
     context.backendLocalBuilds = {};
     const configs = getBackendConfigs(options);
+    if (configs.some((cfg) => cfg.localBuild) && experiments.isEnabled("apphostinglocalbuilds")) {
+        const projectNumber = await (0, getProjectNumber_1.getProjectNumber)(options);
+        await ensureAppHostingServiceAgentRoles(projectId, projectNumber);
+    }
     const { backends } = await (0, apphosting_1.listBackends)(projectId, "-");
     const foundBackends = [];
     const notFoundBackends = [];
@@ -112,6 +120,7 @@ async function default_1(context, options) {
         if (!cfg.localBuild) {
             continue;
         }
+        experiments.assertEnabled("apphostinglocalbuilds", "locally build App Hosting backends");
         (0, utils_1.logLabeledBullet)("apphosting", `Starting local build for backend ${cfg.backendId}`);
         try {
             const { outputFiles, annotations, buildConfig } = await (0, localbuilds_1.localBuild)(options.projectRoot || "./", "nextjs");
@@ -125,7 +134,8 @@ async function default_1(context, options) {
             };
         }
         catch (e) {
-            throw new error_1.FirebaseError(`Local Build for backend ${cfg.backendId} failed: ${e}`);
+            const errorMsg = e instanceof Error ? e.message : String(e);
+            throw new error_1.FirebaseError(`Local Build for backend ${cfg.backendId} failed: ${errorMsg}`);
         }
     }
 }
@@ -157,3 +167,13 @@ function getBackendConfigs(options) {
     }
     return backendConfigs.filter((cfg) => backendIds.includes(cfg.backendId));
 }
+async function ensureAppHostingServiceAgentRoles(projectId, projectNumber) {
+    const p4saEmail = (0, apphosting_1.serviceAgentEmail)(projectNumber);
+    try {
+        await (0, resourceManager_1.addServiceAccountToRoles)(projectId, p4saEmail, ["roles/storage.objectViewer"], true);
+    }
+    catch (err) {
+        logger_1.logger.debug(`Failed to grant storage.objectViewer to ${p4saEmail}: ${String(err)}`);
+        (0, utils_1.logLabeledWarning)("apphosting", `Unable to verify App Hosting service agent permissions for ${p4saEmail}. If you encounter a PERMISSION_DENIED error during rollout, please ensure the service agent has the "Storage Object Viewer" role.`);
+    }
+}

package/lib/deploy/apphosting/release.js

@@ -15,11 +15,6 @@ async function default_1(context, options) {
         (0, utils_1.logLabeledWarning)("apphosting", `Failed to find metadata for backend(s) ${backendIds.join(", ")}. Please contact support with the contents of your firebase-debug.log to report your issue.`);
         backendIds = backendIds.filter((id) => !missingBackends.includes(id));
     }
-    const localBuildBackends = backendIds.filter((id) => context.backendLocalBuilds[id]);
-    if (localBuildBackends.length > 0) {
-        (0, utils_1.logLabeledWarning)("apphosting", `Skipping backend(s) ${localBuildBackends.join(", ")}. Local Builds are not supported yet.`);
-        backendIds = backendIds.filter((id) => !localBuildBackends.includes(id));
-    }
     if (backendIds.length === 0) {
         return;
     }
@@ -29,10 +24,12 @@ async function default_1(context, options) {
         backendId,
         location: context.backendLocations[backendId],
         buildInput: {
+            config: context.backendLocalBuilds[backendId]?.buildConfig,
             source: {
                 archive: {
                     userStorageUri: context.backendStorageUris[backendId],
                     rootDirectory: context.backendConfigs[backendId].rootDir,
+                    locallyBuiltSource: !!context.backendLocalBuilds[backendId],
                 },
             },
         },