firebase-tools 15.16.0 → 15.17.0

package/lib/mcp/resources/index.js

@@ -16,6 +16,8 @@ const track_1 = require("../../track");
 const crashlytics_issues_1 = require("./guides/crashlytics_issues");
 const crashlytics_reports_1 = require("./guides/crashlytics_reports");
 const update_environment_ui_1 = require("./update_environment_ui");
+const deploy_ui_1 = require("./deploy_ui");
+const init_ui_1 = require("./init_ui");
 exports.resources = [
     app_id_1.app_id,
     crashlytics_investigations_1.crashlytics_investigations,
@@ -28,6 +30,8 @@ exports.resources = [
     init_auth_1.init_auth,
     init_hosting_1.init_hosting,
     update_environment_ui_1.update_environment_ui,
+    deploy_ui_1.deploy_ui,
+    init_ui_1.init_ui,
 ];
 exports.resourceTemplates = [docs_1.docs];
 async function resolveResource(uri, ctx, track = true) {

package/lib/mcp/resources/init_ui.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.init_ui = exports.RESOURCE_MIME_TYPE = void 0;
+const resource_1 = require("../resource");
+const path = require("path");
+const fs = require("fs/promises");
+exports.RESOURCE_MIME_TYPE = "text/html;profile=mcp-app";
+const resourceUri = "ui://core/init/mcp-app.html";
+exports.init_ui = (0, resource_1.resource)({
+    uri: resourceUri,
+    name: "Init UI",
+    description: "Visual interface for Firebase Init",
+    mimeType: exports.RESOURCE_MIME_TYPE,
+}, async (_uri, _ctx) => {
+    try {
+        const htmlPath = path.join(__dirname, "../apps/init/mcp-app.html");
+        const html = await fs.readFile(htmlPath, "utf-8");
+        return {
+            contents: [
+                {
+                    uri: resourceUri,
+                    mimeType: exports.RESOURCE_MIME_TYPE,
+                    text: html,
+                },
+            ],
+        };
+    }
+    catch (e) {
+        throw new Error(`Failed to load Init UI: ${e.message}`);
+    }
+});

package/lib/mcp/resources/update_environment_ui.js

@@ -4,13 +4,13 @@ exports.update_environment_ui = void 0;
 const resource_1 = require("../resource");
 const path = require("path");
 const fs = require("fs/promises");
-const util_1 = require("../util");
+const RESOURCE_MIME_TYPE = "text/html;profile=mcp-app";
 const resourceUri = "ui://core/update_environment/mcp-app.html";
 exports.update_environment_ui = (0, resource_1.resource)({
     uri: resourceUri,
     name: "Update Environment UI",
     description: "Visual interface for selecting active Firebase project",
-    mimeType: util_1.RESOURCE_MIME_TYPE,
+    mimeType: RESOURCE_MIME_TYPE,
 }, async () => {
     try {
         const htmlPath = path.join(__dirname, "../apps/update_environment/mcp-app.html");
@@ -19,7 +19,7 @@ exports.update_environment_ui = (0, resource_1.resource)({
             contents: [
                 {
                     uri: resourceUri,
-                    mimeType: util_1.RESOURCE_MIME_TYPE,
+                    mimeType: RESOURCE_MIME_TYPE,
                     text: html,
                 },
             ],

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

@@ -50,5 +50,5 @@ exports.get_users = (0, tool_1.tool)("auth", {
     if (!uids?.length && !emails?.length && !phone_numbers?.length) {
         users = await (0, auth_1.listUsers)(projectId, limit || 100);
     }
-    return (0, util_1.toContent)(users.map(prune));
+    return (0, util_1.toContent)({ users: users.map(prune) });
 });

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

@@ -0,0 +1,87 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.deploy = void 0;
+const zod_1 = require("zod");
+const tool_1 = require("../../tool");
+const deploy_1 = require("../../../deploy");
+const util_1 = require("../../util");
+const jobs_1 = require("../../util/jobs");
+const TARGETS = {
+    hosting: null,
+    database: null,
+    firestore: null,
+    functions: null,
+    storage: null,
+    remoteconfig: null,
+    extensions: null,
+    dataconnect: null,
+    apphosting: null,
+    auth: null,
+};
+exports.deploy = (0, tool_1.tool)("core", {
+    name: "deploy",
+    description: "Deploy resources to your Firebase project, based on the contents of firebase.json.",
+    inputSchema: zod_1.z.object({
+        only: zod_1.z
+            .string()
+            .optional()
+            .describe("Comma-separated list of services to deploy. Valid targets are: database, storage, firestore, functions, hosting, remoteconfig, extensions, dataconnect, apphosting, auth."),
+    }),
+    annotations: {
+        title: "Deploy Firebase Services",
+        readOnlyHint: false,
+    },
+    _meta: {
+        requiresAuth: true,
+        requiresProject: true,
+        ui: {
+            resourceUri: "ui://core/deploy/mcp-app.html",
+        },
+    },
+}, async ({ only }, ctx) => {
+    const validTargets = Object.keys(TARGETS);
+    let targets = validTargets;
+    if (only) {
+        const parts = only.split(",").map((p) => p.trim());
+        targets = parts.filter((p) => validTargets.includes(p));
+    }
+    const jobId = Date.now().toString();
+    jobs_1.jobTracker.createJob(jobId);
+    const options = {
+        only: only || "",
+        except: "",
+        filteredTargets: targets,
+        project: ctx.projectId,
+        projectId: ctx.projectId,
+        rc: ctx.rc,
+        config: ctx.config,
+        nonInteractive: true,
+        onProgress: (progress) => {
+            const phaseNumbers = {
+                predeploy: 10,
+                prepare: 30,
+                deploy: 60,
+                release: 80,
+                postdeploy: 100,
+            };
+            const percentage = phaseNumbers[progress.phase] || 0;
+            jobs_1.jobTracker.updateJob(jobId, { progress: percentage });
+            jobs_1.jobTracker.addLog(jobId, `Deploy [${progress.phase}]: Complete for targets ${(progress.targets || []).join(",")}`);
+        },
+    };
+    void (async () => {
+        try {
+            const res = await (0, deploy_1.deploy)(targets, options);
+            jobs_1.jobTracker.updateJob(jobId, { status: "success", progress: 100, result: res });
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            jobs_1.jobTracker.updateJob(jobId, { status: "failed", error: message });
+        }
+    })();
+    const contentRes = (0, util_1.toContent)(`Deployment started with Job ID: ${jobId}. Use deploy_status tool to track.`);
+    return {
+        ...contentRes,
+        structuredContent: { jobId, message: "Deployment started" },
+    };
+});

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

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.deploy_status = void 0;
+const zod_1 = require("zod");
+const tool_1 = require("../../tool");
+const util_1 = require("../../util");
+const jobs_1 = require("../../util/jobs");
+exports.deploy_status = (0, tool_1.tool)("core", {
+    name: "deploy_status",
+    description: "Check the status of a background deployment job using its Job ID.",
+    inputSchema: zod_1.z.object({
+        jobId: zod_1.z.string().describe("The Job ID returned by the deploy tool"),
+    }),
+    annotations: {
+        title: "Check Deployment Status",
+        readOnlyHint: true,
+    },
+    _meta: {
+        requiresAuth: true,
+        requiresProject: true,
+    },
+}, async ({ jobId }) => {
+    const job = jobs_1.jobTracker.getJob(jobId);
+    if (!job) {
+        return (0, util_1.mcpError)(`Job not found: ${jobId}`);
+    }
+    const contentRes = (0, util_1.toContent)(`Job ID: ${jobId}\nStatus: ${job.status}\nProgress: ${job.progress}%\n\nLogs:\n${job.logs.join("\n")}`);
+    return {
+        ...contentRes,
+        structuredContent: job,
+    };
+});

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

@@ -16,6 +16,8 @@ const logout_1 = require("./logout");
 const get_security_rules_1 = require("./get_security_rules");
 const validate_security_rules_1 = require("./validate_security_rules");
 const read_resources_1 = require("./read_resources");
+const deploy_1 = require("./deploy");
+const deploy_status_1 = require("./deploy_status");
 exports.coreTools = [
     login_1.login,
     logout_1.logout,
@@ -32,4 +34,6 @@ exports.coreTools = [
     init_1.init,
     get_security_rules_1.get_security_rules,
     read_resources_1.read_resources,
+    deploy_1.deploy,
+    deploy_status_1.deploy_status,
 ];

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

@@ -160,6 +160,9 @@ exports.init = (0, tool_1.tool)("core", {
     _meta: {
         requiresProject: false,
         requiresAuth: false,
+        ui: {
+            resourceUri: "ui://core/init/mcp-app.html",
+        },
     },
 }, async ({ features }, { projectId, config, rc }) => {
     const featuresList = [];

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

@@ -32,6 +32,9 @@ exports.update_environment = (0, tool_1.tool)("core", {
         optionalProjectDir: true,
         requiresAuth: false,
         requiresProject: false,
+        ui: {
+            resourceUri: "ui://core/update_environment/mcp-app.html",
+        },
     },
 }, async ({ project_dir, active_project, active_user_account }, { config, rc, host }) => {
     let output = "";

package/lib/mcp/tools/firestore/query_collection.js

@@ -127,6 +127,6 @@ exports.query_collection = (0, tool_1.tool)("firestore", {
     }
     const { documents } = await (0, firestore_1.queryCollection)(projectId, structuredQuery, database, emulatorUrl);
     const docs = documents.map(converter_1.firestoreDocumentToJson);
-    const docsContent = (0, util_1.toContent)(docs);
+    const docsContent = (0, util_1.toContent)({ documents: docs });
     return docsContent;
 });

package/lib/mcp/tools/functions/list_functions.js

@@ -35,11 +35,11 @@ exports.list_functions = (0, tool_1.tool)("functions", {
             runtime: endpoint.runtime,
         }));
         if (!formattedList.length) {
-            return (0, util_1.toContent)([], {
+            return (0, util_1.toContent)({ functions: [] }, {
                 contentPrefix: "No functions found in this project.\n\n",
             });
         }
-        return (0, util_1.toContent)(formattedList);
+        return (0, util_1.toContent)({ functions: formattedList });
     }
     catch (err) {
         const errMsg = (0, error_1.getErrMsg)(err?.original || err, "Failed to list functions.");

package/lib/mcp/util/jobs.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.jobTracker = void 0;
+class JobTracker {
+    constructor() {
+        this.jobs = new Map();
+    }
+    createJob(id) {
+        this.jobs.set(id, {
+            status: "running",
+            progress: 0,
+            logs: [],
+        });
+    }
+    updateJob(id, updates) {
+        const job = this.jobs.get(id);
+        if (job) {
+            Object.assign(job, updates);
+        }
+    }
+    addLog(id, log) {
+        const job = this.jobs.get(id);
+        if (job) {
+            job.logs.push(log);
+        }
+    }
+    getJob(id) {
+        return this.jobs.get(id);
+    }
+}
+exports.jobTracker = new JobTracker();

package/lib/mcp/util.js

@@ -1,6 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.RESOURCE_MIME_TYPE = void 0;
 exports.toContent = toContent;
 exports.applyAppMeta = applyAppMeta;
 exports.mcpError = mcpError;
@@ -26,10 +25,13 @@ function toContent(data, options) {
     }
     const prefix = options?.contentPrefix || "";
     const suffix = options?.contentSuffix || "";
-    return {
+    const result = {
         content: [{ type: "text", text: `${prefix}${text}${suffix}` }],
-        structuredContent: data,
     };
+    if (typeof data === "object" && data !== null && !Array.isArray(data)) {
+        result.structuredContent = data;
+    }
+    return result;
 }
 function applyAppMeta(result, resourceUri) {
     if (experiments.isEnabled("mcpapps")) {
@@ -241,4 +243,3 @@ function cleanSchema(schema) {
     const result = deepClean(schema, true);
     return result === null ? {} : result;
 }
-exports.RESOURCE_MIME_TYPE = "application/vnd.mcp.ext-app+html";