firebase-tools 14.15.1 → 14.16.0

package/lib/init/features/dataconnect/index.js

@@ -26,26 +26,25 @@ const CONNECTOR_YAML_TEMPLATE = (0, templates_1.readTemplateSync)("init/dataconn
 const SCHEMA_TEMPLATE = (0, templates_1.readTemplateSync)("init/dataconnect/schema.gql");
 const QUERIES_TEMPLATE = (0, templates_1.readTemplateSync)("init/dataconnect/queries.gql");
 const MUTATIONS_TEMPLATE = (0, templates_1.readTemplateSync)("init/dataconnect/mutations.gql");
-const emptyConnector = {
-    id: "example",
-    path: "./example",
-    files: [],
-};
-const defaultConnector = {
-    id: "example",
-    path: "./example",
-    files: [
-        {
-            path: "queries.gql",
-            content: QUERIES_TEMPLATE,
-        },
+const templateServiceInfo = {
+    schemaGql: [{ path: "schema.gql", content: SCHEMA_TEMPLATE }],
+    connectors: [
         {
-            path: "mutations.gql",
-            content: MUTATIONS_TEMPLATE,
+            id: "example",
+            path: "./example",
+            files: [
+                {
+                    path: "queries.gql",
+                    content: QUERIES_TEMPLATE,
+                },
+                {
+                    path: "mutations.gql",
+                    content: MUTATIONS_TEMPLATE,
+                },
+            ],
         },
     ],
 };
-const defaultSchema = { path: "schema.gql", content: SCHEMA_TEMPLATE };
 async function askQuestions(setup) {
     const info = {
         analyticsFlow: "cli",
@@ -54,6 +53,7 @@ async function askQuestions(setup) {
         locationId: "",
         cloudSqlInstanceId: "",
         cloudSqlDatabase: "",
+        shouldProvisionCSQL: false,
     };
     if (setup.projectId) {
         const hasBilling = await (0, cloudbilling_1.isBillingEnabled)(setup);
@@ -101,6 +101,7 @@ async function actuate(setup, config, options) {
         void (0, track_1.trackGA4)("dataconnect_init", {
             project_status: setup.projectId ? (setup.isBillingEnabled ? "blaze" : "spark") : "missing",
             flow: info.analyticsFlow,
+            provision_cloud_sql: String(info.shouldProvisionCSQL),
         });
     }
     if (info.appDescription) {
@@ -118,10 +119,11 @@ async function actuateWithInfo(setup, config, info, options) {
     const projectId = setup.projectId;
     if (!projectId) {
         info.analyticsFlow += "_save_template";
-        return await writeFiles(config, info, { schemaGql: [defaultSchema], connectors: [defaultConnector] }, options);
+        return await writeFiles(config, info, templateServiceInfo, options);
     }
-    const hasBilling = await (0, cloudbilling_1.isBillingEnabled)(setup);
-    if (hasBilling) {
+    await (0, ensureApis_1.ensureApis)(projectId, true);
+    const provisionCSQL = info.shouldProvisionCSQL && (await (0, cloudbilling_1.isBillingEnabled)(setup));
+    if (provisionCSQL) {
         await (0, provisionCloudSql_1.setupCloudSql)({
             projectId: projectId,
             location: info.locationId,
@@ -130,15 +132,18 @@ async function actuateWithInfo(setup, config, info, options) {
             requireGoogleMlIntegration: false,
         });
     }
+    const serviceName = `projects/${projectId}/locations/${info.locationId}/services/${info.serviceId}`;
     if (!info.appDescription) {
+        if (!info.serviceGql) {
+            await downloadService(info, serviceName);
+        }
         if (info.serviceGql) {
             info.analyticsFlow += "_save_downloaded";
             return await writeFiles(config, info, info.serviceGql, options);
         }
         info.analyticsFlow += "_save_template";
-        return await writeFiles(config, info, { schemaGql: [defaultSchema], connectors: [defaultConnector] }, options);
+        return await writeFiles(config, info, templateServiceInfo, options);
     }
-    const serviceName = `projects/${projectId}/locations/${info.locationId}/services/${info.serviceId}`;
     const serviceAlreadyExists = !(await (0, client_1.createService)(projectId, info.locationId, info.serviceId));
     const schemaGql = await (0, utils_1.promiseWithSpinner)(() => (0, fdcExperience_1.generateSchema)(info.appDescription, projectId), "Generating the Data Connect Schema...");
     const schemaFiles = [{ path: "schema.gql", content: schemaGql }];
@@ -148,7 +153,7 @@ async function actuateWithInfo(setup, config, info, options) {
         return await writeFiles(config, info, { schemaGql: schemaFiles, connectors: [] }, options);
     }
     await (0, utils_1.promiseWithSpinner)(async () => {
-        const [saveSchemaGql, waitForCloudSQLProvision] = schemasDeploySequence(projectId, info, schemaFiles, hasBilling);
+        const [saveSchemaGql, waitForCloudSQLProvision] = schemasDeploySequence(projectId, info, schemaFiles, provisionCSQL);
         await (0, client_1.upsertSchema)(saveSchemaGql);
         if (waitForCloudSQLProvision) {
             void (0, client_1.upsertSchema)(waitForCloudSQLProvision);
@@ -284,7 +289,6 @@ function subConnectorYamlValues(replacementValues) {
     return replaced;
 }
 async function promptForExistingServices(setup, info) {
-    var _a, _b, _c, _d, _e;
     if (!setup.projectId) {
         return;
     }
@@ -292,10 +296,7 @@ async function promptForExistingServices(setup, info) {
     if (!existingServices.length) {
         return;
     }
-    const existingServicesAndSchemas = await Promise.all(existingServices.map(async (s) => {
-        return { service: s, schema: await (0, client_1.getSchema)(s.name) };
-    }));
-    const choice = await chooseExistingService(existingServicesAndSchemas);
+    const choice = await chooseExistingService(existingServices);
     if (!choice) {
         const existingServiceIds = existingServices.map((s) => s.name.split("/").pop());
         info.serviceId = (0, utils_1.newUniqueId)(defaultServiceId(), existingServiceIds);
@@ -303,39 +304,50 @@ async function promptForExistingServices(setup, info) {
         return;
     }
     info.analyticsFlow += "_pick_existing_service";
-    const serviceName = (0, names_1.parseServiceName)(choice.service.name);
+    const serviceName = (0, names_1.parseServiceName)(choice.name);
     info.serviceId = serviceName.serviceId;
     info.locationId = serviceName.location;
+    await downloadService(info, choice.name);
+}
+async function downloadService(info, serviceName) {
+    var _a, _b, _c, _d, _e;
+    const schema = await (0, client_1.getSchema)(serviceName);
+    if (!schema) {
+        return;
+    }
     info.serviceGql = {
         schemaGql: [],
-        connectors: [emptyConnector],
+        connectors: [
+            {
+                id: "example",
+                path: "./example",
+                files: [],
+            },
+        ],
     };
-    if (choice.schema) {
-        const primaryDatasource = choice.schema.datasources.find((d) => d.postgresql);
-        if ((_b = (_a = primaryDatasource === null || primaryDatasource === void 0 ? void 0 : primaryDatasource.postgresql) === null || _a === void 0 ? void 0 : _a.cloudSql) === null || _b === void 0 ? void 0 : _b.instance) {
-            const instanceName = (0, names_1.parseCloudSQLInstanceName)(primaryDatasource.postgresql.cloudSql.instance);
-            info.cloudSqlInstanceId = instanceName.instanceId;
-        }
-        if ((_c = choice.schema.source.files) === null || _c === void 0 ? void 0 : _c.length) {
-            info.serviceGql.schemaGql = choice.schema.source.files;
-        }
-        info.cloudSqlDatabase = (_e = (_d = primaryDatasource === null || primaryDatasource === void 0 ? void 0 : primaryDatasource.postgresql) === null || _d === void 0 ? void 0 : _d.database) !== null && _e !== void 0 ? _e : "";
-        const connectors = await (0, client_1.listConnectors)(choice.service.name, [
-            "connectors.name",
-            "connectors.source.files",
-        ]);
-        if (connectors.length) {
-            info.serviceGql.connectors = connectors.map((c) => {
-                const id = c.name.split("/").pop();
-                return {
-                    id,
-                    path: connectors.length === 1 ? "./example" : `./${id}`,
-                    files: c.source.files || [],
-                };
-            });
-        }
+    const primaryDatasource = schema.datasources.find((d) => d.postgresql);
+    if ((_b = (_a = primaryDatasource === null || primaryDatasource === void 0 ? void 0 : primaryDatasource.postgresql) === null || _a === void 0 ? void 0 : _a.cloudSql) === null || _b === void 0 ? void 0 : _b.instance) {
+        const instanceName = (0, names_1.parseCloudSQLInstanceName)(primaryDatasource.postgresql.cloudSql.instance);
+        info.cloudSqlInstanceId = instanceName.instanceId;
+    }
+    if ((_c = schema.source.files) === null || _c === void 0 ? void 0 : _c.length) {
+        info.serviceGql.schemaGql = schema.source.files;
+    }
+    info.cloudSqlDatabase = (_e = (_d = primaryDatasource === null || primaryDatasource === void 0 ? void 0 : primaryDatasource.postgresql) === null || _d === void 0 ? void 0 : _d.database) !== null && _e !== void 0 ? _e : "";
+    const connectors = await (0, client_1.listConnectors)(serviceName, [
+        "connectors.name",
+        "connectors.source.files",
+    ]);
+    if (connectors.length) {
+        info.serviceGql.connectors = connectors.map((c) => {
+            const id = c.name.split("/").pop();
+            return {
+                id,
+                path: connectors.length === 1 ? "./example" : `./${id}`,
+                files: c.source.files || [],
+            };
+        });
     }
-    return;
 }
 async function chooseExistingService(existing) {
     const fdcConnector = (0, utils_1.envOverride)("FDC_CONNECTOR", "");
@@ -344,7 +356,7 @@ async function chooseExistingService(existing) {
     if (serviceEnvVar) {
         const [serviceLocationFromEnvVar, serviceIdFromEnvVar] = serviceEnvVar.split("/");
         const serviceFromEnvVar = existing.find((s) => {
-            const serviceName = (0, names_1.parseServiceName)(s.service.name);
+            const serviceName = (0, names_1.parseServiceName)(s.name);
             return (serviceName.serviceId === serviceIdFromEnvVar &&
                 serviceName.location === serviceLocationFromEnvVar);
         });
@@ -356,7 +368,7 @@ async function chooseExistingService(existing) {
         (0, utils_1.logWarning)(`Unable to pick up an existing service based on ${envVarName}=${serviceEnvVar}.`);
     }
     const choices = existing.map((s) => {
-        const serviceName = (0, names_1.parseServiceName)(s.service.name);
+        const serviceName = (0, names_1.parseServiceName)(s.name);
         return {
             name: `${serviceName.location}/${serviceName.serviceId}`,
             value: s,
@@ -414,6 +426,10 @@ async function promptForCloudSQL(setup, info) {
             choices,
             default: "us-central1",
         });
+        info.shouldProvisionCSQL = await (0, prompt_1.confirm)({
+            message: `Would you like to provision your Cloud SQL instance and database now?`,
+            default: true,
+        });
     }
     if (info.cloudSqlInstanceId !== "" && info.cloudSqlDatabase === "") {
         try {

package/lib/init/features/dataconnect/sdk.js

@@ -26,22 +26,30 @@ async function askQuestions(setup) {
     };
     info.apps = await chooseApp();
     if (!info.apps.length) {
-        const existingFilesAndDirs = (0, fsutils_1.listFiles)(cwd);
-        const webAppId = (0, utils_1.newUniqueId)("web-app", existingFilesAndDirs);
+        const npxMissingWarning = (0, utils_1.commandExistsSync)("npx")
+            ? ""
+            : clc.yellow(" (you need to install Node.js first)");
+        const flutterMissingWarning = (0, utils_1.commandExistsSync)("flutter")
+            ? ""
+            : clc.yellow(" (you need to install Flutter first)");
         const choice = await (0, prompt_1.select)({
             message: `Do you want to create an app template?`,
             choices: [
-                { name: "React", value: "react" },
-                { name: "Next.JS", value: "next" },
+                { name: `React${npxMissingWarning}`, value: "react" },
+                { name: `Next.JS${npxMissingWarning}`, value: "next" },
+                { name: `Flutter${flutterMissingWarning}`, value: "flutter" },
                 { name: "no", value: "no" },
             ],
         });
         switch (choice) {
             case "react":
-                await (0, create_app_1.createReactApp)(webAppId);
+                await (0, create_app_1.createReactApp)((0, utils_1.newUniqueId)("web-app", (0, fsutils_1.listFiles)(cwd)));
                 break;
             case "next":
-                await (0, create_app_1.createNextApp)(webAppId);
+                await (0, create_app_1.createNextApp)((0, utils_1.newUniqueId)("web-app", (0, fsutils_1.listFiles)(cwd)));
+                break;
+            case "flutter":
+                await (0, create_app_1.createFlutterApp)((0, utils_1.newUniqueId)("flutter_app", (0, fsutils_1.listFiles)(cwd)));
                 break;
             case "no":
                 break;
@@ -151,11 +159,15 @@ async function actuateWithInfo(setup, config, info) {
     config.writeProjectFile(path.relative(config.projectDir, connectorYamlPath), connectorYamlContents);
     (0, utils_1.logLabeledBullet)("dataconnect", `Installing the generated SDKs ...`);
     const account = (0, auth_1.getGlobalDefaultAccount)();
-    await dataconnectEmulator_1.DataConnectEmulator.generate({
-        configDir: connectorInfo.directory,
-        connectorId: connectorInfo.connectorYaml.connectorId,
-        account,
-    });
+    try {
+        await dataconnectEmulator_1.DataConnectEmulator.generate({
+            configDir: connectorInfo.directory,
+            account,
+        });
+    }
+    catch (e) {
+        (0, utils_1.logLabeledError)("dataconnect", `Failed to generate Data Connect SDKs\n${e === null || e === void 0 ? void 0 : e.message}`);
+    }
     (0, utils_1.logLabeledSuccess)("dataconnect", `Installed generated SDKs for ${clc.bold(apps.map((a) => (0, appFinder_1.appDescription)(a)).join(", "))}`);
     if (apps.some((a) => a.platform === types_1.Platform.IOS)) {
         (0, utils_1.logBullet)(clc.bold("Please follow the instructions here to add your generated sdk to your XCode project:\n\thttps://firebase.google.com/docs/data-connect/ios-sdk#set-client"));

package/lib/mcp/errors.js

@@ -4,18 +4,10 @@ exports.mcpGeminiError = exports.mcpAuthError = exports.NO_PROJECT_ERROR = void
 const util_1 = require("./util");
 exports.NO_PROJECT_ERROR = (0, util_1.mcpError)('No active project was found. Use the `firebase_update_environment` tool to set the project directory to an absolute folder location containing a firebase.json config file. Alternatively, change the MCP server config to add [...,"--dir","/absolute/path/to/project/directory"] in its command-line arguments.', "PRECONDITION_FAILED");
 function mcpAuthError(skipADC) {
-    const cmd = (0, util_1.commandExistsSync)("firebase") ? "firebase" : "npx -y firebase-tools";
     if (skipADC) {
-        return (0, util_1.mcpError)(`The user is not currently logged into the Firebase CLI, which is required to use this tool. Please instruct the user to execute this shell command to sign in.
-\`\`\`sh
-${cmd} login
-\`\`\``);
+        return (0, util_1.mcpError)(`The user is not currently logged into the Firebase CLI, which is required to use this tool. Please run the 'firebase_login' tool to log in.`);
     }
-    return (0, util_1.mcpError)(`The user is not currently logged into the Firebase CLI, which is required to use this tool. Please instruct the user to execute this shell command to sign in or to configure [Application Default Credentials][ADC] on their machine.
-\`\`\`sh
-${cmd} login
-\`\`\`
-
+    return (0, util_1.mcpError)(`The user is not currently logged into the Firebase CLI, which is required to use this tool. Please run the 'firebase_login' tool to log in, or instruct the user to configure [Application Default Credentials][ADC] on their machine.
 [ADC]: https://cloud.google.com/docs/authentication/application-default-credentials`);
 }
 exports.mcpAuthError = mcpAuthError;

package/lib/mcp/index.js

@@ -140,9 +140,6 @@ class FirebaseMcpServer {
             return this.emulatorHubClient;
         }
         const projectId = await this.getProjectId();
-        if (!projectId) {
-            return;
-        }
         this.emulatorHubClient = new hubClient_1.EmulatorHubClient(projectId);
         return this.emulatorHubClient;
     }
@@ -154,7 +151,7 @@ class FirebaseMcpServer {
         const emulators = await hubClient.getEmulators();
         const emulatorInfo = emulators[emulatorType];
         if (!emulatorInfo) {
-            throw Error("No Firestore Emulator found running. Make sure your project firebase.json file includes firestore and then rerun emulator using `firebase emulators:start` from your project directory.");
+            throw Error(`No ${emulatorType} Emulator found running. Make sure your project firebase.json file includes ${emulatorType} and then rerun emulator using \`firebase emulators:start\` from your project directory.`);
         }
         const host = emulatorInfo.host.includes(":") ? `[${emulatorInfo.host}]` : emulatorInfo.host;
         return `http://${host}:${emulatorInfo.port}`;

package/lib/mcp/prompts/core/deploy.js

@@ -83,7 +83,7 @@ Follow the steps below taking note of any user instructions provided above.
      Create \`firebase.json\ with an "apphosting" configuration, setting backendId to the app's name in package.json: \`{"apphosting": {"backendId": "<backendId>"}}\ 
   4b. If the app does NOT require SSR, configure Firebase Hosting:
     Create \`firebase.json\ with a "hosting" configuration. Add a \`{"hosting": {"predeploy": "<build_script>"}}\` config to build before deploying.
-5. Check if there is an active Firebase project for this environment (the \`firebase_get_environment\` tool may be helpful). If there is, proceed using that project. If there is not an active project, give the user two options: Use an existing Firebase project or Create a new one. Wait for their response before proceeding.
+5. Check if there is an active Firebase project for this environment (the \`firebase_get_environment\` tool may be helpful). If there is, provide the active project ID to the user and ask them if they want to proceed using that project. If there is not an active project, give the user two options: Provide an existing project ID or create a new project. Only use the list_projects tool on user request. Wait for their response before proceeding.
   5a. If the user chooses to use an existing Firebase project, the \`firebase_list_projects\` tool may be helpful. Set the selected project as the active project (the \`firebase_update_environment\` tool may be helpful).
   5b. If the user chooses to create a new project, use the \`firebase_create_project	\` tool. Then set the new project as the active project (the \`firebase_update_environment\` tool may be helpful).
 6. If firebase.json contains an "apphosting" configuration, check if a backend exists matching the provided backendId (the \`apphosting_list_backends\` tool may be helpful). 

package/lib/mcp/prompts/crashlytics/connect.js

@@ -0,0 +1,114 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.connect = void 0;
+const prompt_1 = require("../../prompt");
+exports.connect = (0, prompt_1.prompt)({
+    name: "connect",
+    omitPrefix: false,
+    description: "Access a Firebase application's Crashlytics data.",
+    annotations: {
+        title: "Access Crashlytics data",
+    },
+}, async (unused, { accountEmail }) => {
+    return [
+        {
+            role: "user",
+            content: {
+                type: "text",
+                text: `
+You are going to help a developer prioritize and fix issues in their
+mobile application by accessing their Firebase Crashlytics data.
+
+Active user: ${accountEmail || "<NONE>"}
+
+## Required first steps! Absolutely required! Incredibly important!
+
+  1. **Make sure the user is logged in. No Crashlytics tools will work if the user is not logged in.**
+    a. Use the \`firebase_get_environment\` tool to verify that the user is logged in,
+       and find the active Firebase project.
+    b. If the Firebase 'Active user' is set to <NONE>, instruct the user to run \`firebase login\` 
+       before continuing. 
+
+  2. **Get the app_id for the Firebase application.** 
+    a. If this is an Android app, read the mobilesdk_app_id value specified in the 
+       google-services.json file. If there are multiple files or multiple app ids in a 
+       single file, ask the user to choose one by providing a numbered list of all the package names.
+    b. If this is an iOS app, read the GOOGLE_APP_ID from GoogleService-Info.plist file. 
+       If there are multiple files or multiple app ids in single file, ask the user to 
+       choose one by providing a numbered list of all the bundle names.
+    c. If you can't find either of the above, just ask the user for the app id.
+
+## Next steps
+
+Once you have confirmed that the user is logged in to Firebase, and confirmed the
+id for the application that they want to access, then you can ask the user what actions
+they would like to perform. Here are some possibilities and instructions follow below:
+
+  1. Prioritize the most impactful stability issues
+  2. Diagnose and propose a fix for a crash
+
+## Instructions for Using Crashlytics Data
+
+### How to prioritize issues
+
+Follow these steps to fetch issues and prioritize them.
+
+  1. Use the 'crashlytics_list_top_issues' tool to fetch up to 20 issues.
+  2. Use the 'crashlytics_list_top_versions' tool to fetch the top versions for this app.
+  3. If the user instructions include statements about prioritization, use those instructions.
+  4. If the user instructions do not include statements about prioritization, 
+  then prioritize the returned issues using the following criteria:
+    4a. The app versions for the issue include the most recent version of the app.
+    4b. The number of users experiencing the issue across variants
+    4c. The volume of crashes
+  5. Return the top 5 issues, with a brief description each in a numerical list with the following format: 
+    1. Issue <issue id>
+        * <the issue title>
+        * <the issue subtitle>
+        * **Description:** <a discription of the issue based on information from the tool response>
+        * **Rationale:** <the reason this issue was prioritized in the way it was>
+
+### How to diagnose and fix issues
+
+Follow these steps to diagnose and fix issues.
+
+  1. Make sure you have a good understanding of the code structure and where different functionality exists
+  2. Use the 'crashlytics_get_issue_details' tool to get more context on the issue.
+  3. Use the 'crashlytics_get_sample_crash_for_issue' tool to get 3 example crashes for this issue.
+  4. Read the files that exist in the stack trace of the issue to understand the crash deeply.
+  5. Determine the root cause of the crash.
+  6. Write out a plan using the following criteria:
+    6a. Write out a description of the issue and including
+        * A brief description of the cause of the issue
+        * A determination of your level of confidence in the cause of the issue
+        * A determination of which library is at fault, this codebase or a dependent library
+        * A determination for how complex the fix will be
+    6b. The plan should include relevant files to change
+    6c. The plan should include a test plan to verify the fix
+    6d. Use the following format for the plan:
+
+    ## Cause
+    <A description of the root cause leading to the issue>
+      - **Fault**: <a determination of whether this code base is at fault or a dependent library is at fault>
+      - **Complexity**: <one of "simple", "moderately simple", "moderately hard", "hard", "oof, I don't know where to start">
+    
+    ## Fix
+    <A description of the fix for this issue and a break down of the changes.>
+      1. <Step 1>
+      2. <Step 2>
+
+    ## Test
+    <A plan for how to test that the issue has been fixed and protect against regressions>
+      1. <Test case 1>
+      2. <Test case 2>
+      
+  7. Present the plan to the user and get approval before making the change.
+  8. Fix the issue.
+    8a. Be mindful of API contracts and do not add fields to resources without a clear way to populate those fields
+    8b. If there is not enough information in the crash report to find a root cause, describe why you cannot fix the issue instead of making a guess.
+  9. Ask the developer if they would like you to test the fix for them.
+`.trim(),
+            },
+        },
+    ];
+});

package/lib/mcp/prompts/crashlytics/index.js

@@ -1,6 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.crashlyticsPrompts = void 0;
-const fix_issue_1 = require("./fix_issue");
-const prioritize_issues_1 = require("./prioritize_issues");
-exports.crashlyticsPrompts = [fix_issue_1.fix_issue, prioritize_issues_1.prioritize_issues];
+const connect_1 = require("./connect");
+exports.crashlyticsPrompts = [connect_1.connect];

package/lib/mcp/tools/auth/disable_user.js

@@ -24,7 +24,7 @@ exports.disable_user = (0, tool_1.tool)({
 }, async ({ uid, disabled }, { projectId }) => {
     const res = await (0, auth_1.disableUser)(projectId, uid, disabled);
     if (res) {
-        return (0, util_1.toContent)(`User ${uid} as been ${disabled ? "disabled" : "enabled"}`);
+        return (0, util_1.toContent)(`User ${uid} has been ${disabled ? "disabled" : "enabled"}`);
     }
     return (0, util_1.toContent)(`Failed to ${disabled ? "disable" : "enable"} user ${uid}`);
 });

package/lib/mcp/tools/auth/get_user.js

@@ -32,7 +32,14 @@ exports.get_user = (0, tool_1.tool)({
     },
 }, async ({ email, phone_number, uid }, { projectId }) => {
     if (email === undefined && phone_number === undefined && uid === undefined) {
-        return (0, util_1.mcpError)(`No user identifier supplied in auth_get_user tool`);
+        return (0, util_1.mcpError)("No user identifier supplied in auth_get_user tool");
     }
-    return (0, util_1.toContent)(await (0, auth_1.findUser)(projectId, email, phone_number, uid));
+    let user;
+    try {
+        user = await (0, auth_1.findUser)(projectId, email, phone_number, uid);
+    }
+    catch (err) {
+        return (0, util_1.mcpError)("Unable to find user");
+    }
+    return (0, util_1.toContent)(user);
 });

package/lib/mcp/tools/core/index.js

@@ -13,7 +13,11 @@ const get_environment_1 = require("./get_environment");
 const update_environment_1 = require("./update_environment");
 const list_projects_1 = require("./list_projects");
 const consult_assistant_1 = require("./consult_assistant");
+const login_1 = require("./login");
+const logout_1 = require("./logout");
 exports.coreTools = [
+    login_1.login,
+    logout_1.logout,
     get_project_1.get_project,
     list_apps_1.list_apps,
     get_admin_sdk_config_1.get_admin_sdk_config,

package/lib/mcp/tools/core/init.js

@@ -6,6 +6,7 @@ const tool_1 = require("../../tool");
 const util_1 = require("../../util");
 const database_1 = require("../../../init/features/database");
 const index_1 = require("../../../init/index");
+const freeTrial_1 = require("../../../dataconnect/freeTrial");
 exports.init = (0, tool_1.tool)({
     name: "init",
     description: "Initializes selected Firebase features in the workspace (Firestore, Data Connect, Realtime Database). All features are optional; provide only the products you wish to set up. " +
@@ -70,12 +71,19 @@ exports.init = (0, tool_1.tool)({
                 cloudsql_instance_id: zod_1.z
                     .string()
                     .optional()
-                    .describe("The GCP Cloud SQL instance ID to use in the Firebase Data Connect service. By default, use <serviceId>-fdc."),
+                    .describe("The GCP Cloud SQL instance ID to use in the Firebase Data Connect service. By default, use <serviceId>-fdc. " +
+                    "\nSet `provision_cloudsql` to true to start Cloud SQL provisioning."),
                 cloudsql_database: zod_1.z
                     .string()
                     .optional()
                     .default("fdcdb")
                     .describe("The Postgres database ID to use in the Firebase Data Connect service."),
+                provision_cloudsql: zod_1.z
+                    .boolean()
+                    .optional()
+                    .default(false)
+                    .describe("If true, provision the Cloud SQL instance if `cloudsql_instance_id` does not exist already. " +
+                    `\nThe first Cloud SQL instance in the project will use the Data Connect no-cost trial. See its terms of service: ${(0, freeTrial_1.freeTrialTermsLink)()}.`),
             })
                 .optional()
                 .describe("Provide this object to initialize Firebase Data Connect with Cloud SQL Postgres in this project directory.\n" +
@@ -138,6 +146,7 @@ exports.init = (0, tool_1.tool)({
             locationId: features.dataconnect.location_id || "",
             cloudSqlInstanceId: features.dataconnect.cloudsql_instance_id || "",
             cloudSqlDatabase: features.dataconnect.cloudsql_database || "",
+            shouldProvisionCSQL: !!features.dataconnect.provision_cloudsql,
         };
         featureInfo.dataconnectSdk = {
             apps: [],
@@ -155,7 +164,7 @@ exports.init = (0, tool_1.tool)({
     config.writeProjectFile("firebase.json", setup.config);
     config.writeProjectFile(".firebaserc", setup.rcfile);
     if (featureInfo.dataconnectSdk && !featureInfo.dataconnectSdk.apps.length) {
-        setup.instructions.push(`No app is found in the current folder. We recommend you create an app (web, ios, android) first, then re-run the 'firebase_init' MCP tool to add Data Connect SDKs to your apps.
+        setup.instructions.push(`No app is found in the current folder. We recommend you create an app (web, ios, android) first, then re-run the 'firebase_init' MCP tool with the same input without app_description to add Data Connect SDKs to your apps.
   Consider popular commands like 'npx create-react-app my-app', 'npx create-next-app my-app', 'flutter create my-app', etc`);
     }
     return (0, util_1.toContent)(`Successfully setup those features: ${featuresList.join(", ")}

package/lib/mcp/tools/core/login.js

@@ -0,0 +1,46 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.login = void 0;
+const zod_1 = require("zod");
+const tool_1 = require("../../tool");
+const auth_1 = require("../../../auth");
+const util_1 = require("../../util");
+const LoginInputSchema = zod_1.z.object({
+    authCode: zod_1.z.string().optional().describe("The authorization code from the login flow"),
+});
+exports.login = (0, tool_1.tool)({
+    name: "login",
+    description: "Logs the user into the Firebase CLI and MCP server.",
+    inputSchema: LoginInputSchema,
+    _meta: {
+        requiresAuth: false,
+    },
+}, async (input, ctx) => {
+    const { authCode } = input;
+    const serverWithState = ctx.host;
+    if (authCode) {
+        if (!serverWithState.authorize) {
+            return (0, util_1.mcpError)("Login flow not started. Please call this tool without the authCode argument first to get a login URI.");
+        }
+        try {
+            const creds = await serverWithState.authorize(authCode);
+            delete serverWithState.authorize;
+            const user = creds.user;
+            return (0, util_1.toContent)(`Successfully logged in as ${user.email}`);
+        }
+        catch (e) {
+            delete serverWithState.authorize;
+            return (0, util_1.mcpError)(`Login failed: ${e.message}`);
+        }
+    }
+    else {
+        const prototyper = await (0, auth_1.loginPrototyper)();
+        serverWithState.authorize = prototyper.authorize;
+        const result = {
+            uri: prototyper.uri,
+            sessionId: prototyper.sessionId,
+        };
+        const humanReadable = `Please visit this URL to login: ${result.uri}\nYour session ID is: ${result.sessionId}\nInstruct the use to copy the authorization code from that link, and paste it into chat.\nThen, run this tool again with that as the authCode argument to complete the login.`;
+        return (0, util_1.toContent)(humanReadable);
+    }
+});