@expo/cli 56.1.5 → 56.1.6

package/build/src/start/server/DevToolsPluginCliExtensionResults.js

@@ -8,17 +8,46 @@ Object.defineProperty(exports, "DevToolsPluginCliExtensionResults", {
         return DevToolsPluginCliExtensionResults;
     }
 });
+function _nodebuffer() {
+    const data = require("node:buffer");
+    _nodebuffer = function() {
+        return data;
+    };
+    return data;
+}
 const _DevToolsPluginschema = require("./DevToolsPlugin.schema");
+// Cap accumulated output at V8's max single-string length to bound heap growth.
+const MAX_OUTPUT_LENGTH = _nodebuffer().constants.MAX_STRING_LENGTH;
 class DevToolsPluginCliExtensionResults {
     constructor(onOutput){
         this.onOutput = onOutput;
         this._output = [];
+        this._totalLength = 0;
+        this._truncated = false;
     }
     append(output, level = 'info') {
+        if (this._truncated) return;
+        if (this._totalLength + output.length > MAX_OUTPUT_LENGTH) {
+            this._truncated = true;
+            const message = {
+                type: 'text',
+                text: `Output truncated: plugin exceeded V8's max string length (${MAX_OUTPUT_LENGTH} chars). Reduce output, paginate, or write to a file.`,
+                level: 'error'
+            };
+            this._output.push(message);
+            this.onOutput == null ? void 0 : this.onOutput.call(this, [
+                message
+            ]);
+            return;
+        }
+        this._totalLength += output.length;
         const results = this.parseOutputText(output, level);
         this._output.push(...results);
         this.onOutput == null ? void 0 : this.onOutput.call(this, results);
     }
+    isTruncated() {
+        return this._truncated;
+    }
     exit(code) {
         if (code === 0) return;
         this.append(`Process exited with code ${code}`, 'error');

package/build/src/start/server/DevToolsPluginCliExtensionResults.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../src/start/server/DevToolsPluginCliExtensionResults.ts"],"sourcesContent":["import type { DevToolsPluginOutput } from './DevToolsPlugin.schema';\nimport { DevToolsPluginOutputSchema } from './DevToolsPlugin.schema';\n\n/**\n * Class that collects and manages output from executed plugin commands\n *\n * Responsibilities:\n * - Collects output data from executed commands\n * - Parses and validates output data against expected schema\n * - Provides methods to append new output entries\n * - Handles exit codes and appends relevant messages\n * - Handles streaming of output via optional callback\n */\nexport class DevToolsPluginCliExtensionResults {\n  constructor(private onOutput?: (output: DevToolsPluginOutput) => void) {}\n\n  private _output: DevToolsPluginOutput = [];\n\n  public append(output: string, level: 'info' | 'warning' | 'error' = 'info') {\n    const results = this.parseOutputText(output, level);\n    this._output.push(...results);\n    this.onOutput?.(results);\n  }\n\n  public exit(code: number) {\n    if (code === 0) return;\n    this.append(`Process exited with code ${code}`, 'error');\n  }\n\n  public getOutput(): DevToolsPluginOutput {\n    return this._output;\n  }\n\n  private parseOutputText(\n    txt: string,\n    level: 'info' | 'warning' | 'error' = 'info'\n  ): DevToolsPluginOutput {\n    // Validate against schema\n    try {\n      const result = DevToolsPluginOutputSchema.safeParse(JSON.parse(txt));\n      if (!result.success) {\n        return [\n          {\n            type: 'text',\n            text: `Invalid JSON: ${result.error.issues.map((issue) => issue.message).join(', ')}`,\n            level: 'error',\n          },\n        ];\n      }\n      return result.data;\n    } catch {\n      // Not JSON, treat as plain text\n      const lines = txt.split('\\n');\n      const results: DevToolsPluginOutput = [];\n      for (const line of lines) {\n        if (line) {\n          results.push({ type: 'text', text: line, level });\n        }\n      }\n      return results;\n    }\n  }\n}\n"],"names":["DevToolsPluginCliExtensionResults","onOutput","_output","append","output","level","results","parseOutputText","push","exit","code","getOutput","txt","result","DevToolsPluginOutputSchema","safeParse","JSON","parse","success","type","text","error","issues","map","issue","message","join","data","lines","split","line"],"mappings":";;;;+BAaaA;;;eAAAA;;;sCAZ8B;AAYpC,MAAMA;IACX,YAAY,AAAQC,QAAiD,CAAE;aAAnDA,WAAAA;aAEZC,UAAgC,EAAE;IAF8B;IAIjEC,OAAOC,MAAc,EAAEC,QAAsC,MAAM,EAAE;QAC1E,MAAMC,UAAU,IAAI,CAACC,eAAe,CAACH,QAAQC;QAC7C,IAAI,CAACH,OAAO,CAACM,IAAI,IAAIF;QACrB,IAAI,CAACL,QAAQ,oBAAb,IAAI,CAACA,QAAQ,MAAb,IAAI,EAAYK;IAClB;IAEOG,KAAKC,IAAY,EAAE;QACxB,IAAIA,SAAS,GAAG;QAChB,IAAI,CAACP,MAAM,CAAC,CAAC,yBAAyB,EAAEO,MAAM,EAAE;IAClD;IAEOC,YAAkC;QACvC,OAAO,IAAI,CAACT,OAAO;IACrB;IAEQK,gBACNK,GAAW,EACXP,QAAsC,MAAM,EACtB;QACtB,0BAA0B;QAC1B,IAAI;YACF,MAAMQ,SAASC,gDAA0B,CAACC,SAAS,CAACC,KAAKC,KAAK,CAACL;YAC/D,IAAI,CAACC,OAAOK,OAAO,EAAE;gBACnB,OAAO;oBACL;wBACEC,MAAM;wBACNC,MAAM,CAAC,cAAc,EAAEP,OAAOQ,KAAK,CAACC,MAAM,CAACC,GAAG,CAAC,CAACC,QAAUA,MAAMC,OAAO,EAAEC,IAAI,CAAC,OAAO;wBACrFrB,OAAO;oBACT;iBACD;YACH;YACA,OAAOQ,OAAOc,IAAI;QACpB,EAAE,OAAM;YACN,gCAAgC;YAChC,MAAMC,QAAQhB,IAAIiB,KAAK,CAAC;YACxB,MAAMvB,UAAgC,EAAE;YACxC,KAAK,MAAMwB,QAAQF,MAAO;gBACxB,IAAIE,MAAM;oBACRxB,QAAQE,IAAI,CAAC;wBAAEW,MAAM;wBAAQC,MAAMU;wBAAMzB;oBAAM;gBACjD;YACF;YACA,OAAOC;QACT;IACF;AACF"}
+{"version":3,"sources":["../../../../src/start/server/DevToolsPluginCliExtensionResults.ts"],"sourcesContent":["import { constants as bufferConstants } from 'node:buffer';\n\nimport type { DevToolsPluginOutput } from './DevToolsPlugin.schema';\nimport { DevToolsPluginOutputSchema } from './DevToolsPlugin.schema';\n\n// Cap accumulated output at V8's max single-string length to bound heap growth.\nconst MAX_OUTPUT_LENGTH = bufferConstants.MAX_STRING_LENGTH;\n\n/**\n * Class that collects and manages output from executed plugin commands\n *\n * Responsibilities:\n * - Collects output data from executed commands\n * - Parses and validates output data against expected schema\n * - Provides methods to append new output entries\n * - Handles exit codes and appends relevant messages\n * - Handles streaming of output via optional callback\n */\nexport class DevToolsPluginCliExtensionResults {\n  constructor(private onOutput?: (output: DevToolsPluginOutput) => void) {}\n\n  private _output: DevToolsPluginOutput = [];\n  private _totalLength = 0;\n  private _truncated = false;\n\n  public append(output: string, level: 'info' | 'warning' | 'error' = 'info') {\n    if (this._truncated) return;\n    if (this._totalLength + output.length > MAX_OUTPUT_LENGTH) {\n      this._truncated = true;\n      const message = {\n        type: 'text' as const,\n        text: `Output truncated: plugin exceeded V8's max string length (${MAX_OUTPUT_LENGTH} chars). Reduce output, paginate, or write to a file.`,\n        level: 'error' as const,\n      };\n      this._output.push(message);\n      this.onOutput?.([message]);\n      return;\n    }\n    this._totalLength += output.length;\n    const results = this.parseOutputText(output, level);\n    this._output.push(...results);\n    this.onOutput?.(results);\n  }\n\n  public isTruncated(): boolean {\n    return this._truncated;\n  }\n\n  public exit(code: number) {\n    if (code === 0) return;\n    this.append(`Process exited with code ${code}`, 'error');\n  }\n\n  public getOutput(): DevToolsPluginOutput {\n    return this._output;\n  }\n\n  private parseOutputText(\n    txt: string,\n    level: 'info' | 'warning' | 'error' = 'info'\n  ): DevToolsPluginOutput {\n    // Validate against schema\n    try {\n      const result = DevToolsPluginOutputSchema.safeParse(JSON.parse(txt));\n      if (!result.success) {\n        return [\n          {\n            type: 'text',\n            text: `Invalid JSON: ${result.error.issues.map((issue) => issue.message).join(', ')}`,\n            level: 'error',\n          },\n        ];\n      }\n      return result.data;\n    } catch {\n      // Not JSON, treat as plain text\n      const lines = txt.split('\\n');\n      const results: DevToolsPluginOutput = [];\n      for (const line of lines) {\n        if (line) {\n          results.push({ type: 'text', text: line, level });\n        }\n      }\n      return results;\n    }\n  }\n}\n"],"names":["DevToolsPluginCliExtensionResults","MAX_OUTPUT_LENGTH","bufferConstants","MAX_STRING_LENGTH","onOutput","_output","_totalLength","_truncated","append","output","level","length","message","type","text","push","results","parseOutputText","isTruncated","exit","code","getOutput","txt","result","DevToolsPluginOutputSchema","safeParse","JSON","parse","success","error","issues","map","issue","join","data","lines","split","line"],"mappings":";;;;+BAkBaA;;;eAAAA;;;;yBAlBgC;;;;;;sCAGF;AAE3C,gFAAgF;AAChF,MAAMC,oBAAoBC,uBAAe,CAACC,iBAAiB;AAYpD,MAAMH;IACX,YAAY,AAAQI,QAAiD,CAAE;aAAnDA,WAAAA;aAEZC,UAAgC,EAAE;aAClCC,eAAe;aACfC,aAAa;IAJmD;IAMjEC,OAAOC,MAAc,EAAEC,QAAsC,MAAM,EAAE;QAC1E,IAAI,IAAI,CAACH,UAAU,EAAE;QACrB,IAAI,IAAI,CAACD,YAAY,GAAGG,OAAOE,MAAM,GAAGV,mBAAmB;YACzD,IAAI,CAACM,UAAU,GAAG;YAClB,MAAMK,UAAU;gBACdC,MAAM;gBACNC,MAAM,CAAC,0DAA0D,EAAEb,kBAAkB,qDAAqD,CAAC;gBAC3IS,OAAO;YACT;YACA,IAAI,CAACL,OAAO,CAACU,IAAI,CAACH;YAClB,IAAI,CAACR,QAAQ,oBAAb,IAAI,CAACA,QAAQ,MAAb,IAAI,EAAY;gBAACQ;aAAQ;YACzB;QACF;QACA,IAAI,CAACN,YAAY,IAAIG,OAAOE,MAAM;QAClC,MAAMK,UAAU,IAAI,CAACC,eAAe,CAACR,QAAQC;QAC7C,IAAI,CAACL,OAAO,CAACU,IAAI,IAAIC;QACrB,IAAI,CAACZ,QAAQ,oBAAb,IAAI,CAACA,QAAQ,MAAb,IAAI,EAAYY;IAClB;IAEOE,cAAuB;QAC5B,OAAO,IAAI,CAACX,UAAU;IACxB;IAEOY,KAAKC,IAAY,EAAE;QACxB,IAAIA,SAAS,GAAG;QAChB,IAAI,CAACZ,MAAM,CAAC,CAAC,yBAAyB,EAAEY,MAAM,EAAE;IAClD;IAEOC,YAAkC;QACvC,OAAO,IAAI,CAAChB,OAAO;IACrB;IAEQY,gBACNK,GAAW,EACXZ,QAAsC,MAAM,EACtB;QACtB,0BAA0B;QAC1B,IAAI;YACF,MAAMa,SAASC,gDAA0B,CAACC,SAAS,CAACC,KAAKC,KAAK,CAACL;YAC/D,IAAI,CAACC,OAAOK,OAAO,EAAE;gBACnB,OAAO;oBACL;wBACEf,MAAM;wBACNC,MAAM,CAAC,cAAc,EAAES,OAAOM,KAAK,CAACC,MAAM,CAACC,GAAG,CAAC,CAACC,QAAUA,MAAMpB,OAAO,EAAEqB,IAAI,CAAC,OAAO;wBACrFvB,OAAO;oBACT;iBACD;YACH;YACA,OAAOa,OAAOW,IAAI;QACpB,EAAE,OAAM;YACN,gCAAgC;YAChC,MAAMC,QAAQb,IAAIc,KAAK,CAAC;YACxB,MAAMpB,UAAgC,EAAE;YACxC,KAAK,MAAMqB,QAAQF,MAAO;gBACxB,IAAIE,MAAM;oBACRrB,QAAQD,IAAI,CAAC;wBAAEF,MAAM;wBAAQC,MAAMuB;wBAAM3B;oBAAM;gBACjD;YACF;YACA,OAAOM;QACT;IACF;AACF"}

package/build/src/start/server/MCPDevToolsPluginCLIExtensions.js

@@ -17,15 +17,25 @@ async function addMcpCapabilities(mcpServer, devServerManager) {
     const plugins = await devServerManager.devtoolsPluginManager.queryPluginsAsync();
     for (const plugin of plugins){
         if (plugin.cliExtensions) {
-            const commands = (plugin.cliExtensions.commands ?? []).filter((p)=>{
+            const mcpCommands = (plugin.cliExtensions.commands ?? []).filter((p)=>{
                 var _p_environments;
                 return (_p_environments = p.environments) == null ? void 0 : _p_environments.includes('mcp');
             });
-            if (commands.length === 0) {
+            if (mcpCommands.length === 0) {
                 continue;
             }
-            const schema = (0, _createMCPDevToolsExtensionSchema.createMCPDevToolsExtensionSchema)(plugin);
-            debug(`Installing MCP CLI extension for plugin: ${plugin.packageName} - found ${commands.length} commands`);
+            // Build an MCP-scoped descriptor so the schema enum and the executor's
+            // existence check both reject commands that were not declared MCP-enabled.
+            const mcpPlugin = {
+                packageName: plugin.packageName,
+                packageRoot: plugin.packageRoot,
+                cliExtensions: {
+                    ...plugin.cliExtensions,
+                    commands: mcpCommands
+                }
+            };
+            const schema = (0, _createMCPDevToolsExtensionSchema.createMCPDevToolsExtensionSchema)(mcpPlugin);
+            debug(`Installing MCP CLI extension for plugin: ${plugin.packageName} - found ${mcpCommands.length} commands`);
             mcpServer.registerTool(plugin.packageName, {
                 title: plugin.packageName,
                 description: plugin.description,
@@ -36,7 +46,7 @@ async function addMcpCapabilities(mcpServer, devServerManager) {
                 try {
                     const { command, ...args } = parameters;
                     const metroServerOrigin = devServerManager.getDefaultDevServer().getJsInspectorBaseUrl();
-                    const results = await new _DevToolsPluginCliExtensionExecutor.DevToolsPluginCliExtensionExecutor(plugin, devServerManager.projectRoot).execute({
+                    const results = await new _DevToolsPluginCliExtensionExecutor.DevToolsPluginCliExtensionExecutor(mcpPlugin, devServerManager.projectRoot).execute({
                         command,
                         args,
                         metroServerOrigin

package/build/src/start/server/MCPDevToolsPluginCLIExtensions.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../src/start/server/MCPDevToolsPluginCLIExtensions.ts"],"sourcesContent":["import type { DevServerManager } from './DevServerManager';\nimport { DevToolsPluginOutputSchema } from './DevToolsPlugin.schema';\nimport { DevToolsPluginCliExtensionExecutor } from './DevToolsPluginCliExtensionExecutor';\nimport type { McpServer } from './MCP';\nimport { createMCPDevToolsExtensionSchema } from './createMCPDevToolsExtensionSchema';\nimport { Log } from '../../log';\n\nconst debug = require('debug')('expo:start:server:devtools:mcp');\n\nexport async function addMcpCapabilities(mcpServer: McpServer, devServerManager: DevServerManager) {\n  const plugins = await devServerManager.devtoolsPluginManager.queryPluginsAsync();\n\n  for (const plugin of plugins) {\n    if (plugin.cliExtensions) {\n      const commands = (plugin.cliExtensions.commands ?? []).filter((p) =>\n        p.environments?.includes('mcp')\n      );\n      if (commands.length === 0) {\n        continue;\n      }\n\n      const schema = createMCPDevToolsExtensionSchema(plugin);\n\n      debug(\n        `Installing MCP CLI extension for plugin: ${plugin.packageName} - found ${commands.length} commands`\n      );\n\n      mcpServer.registerTool(\n        plugin.packageName,\n        {\n          title: plugin.packageName,\n          description: plugin.description,\n          inputSchema: { parameters: schema },\n        },\n        async ({ parameters }) => {\n          try {\n            const { command, ...args } = parameters;\n\n            const metroServerOrigin = devServerManager\n              .getDefaultDevServer()\n              .getJsInspectorBaseUrl();\n\n            const results = await new DevToolsPluginCliExtensionExecutor(\n              plugin,\n              devServerManager.projectRoot\n            ).execute({ command, args, metroServerOrigin });\n\n            const parsedResults = DevToolsPluginOutputSchema.safeParse(results);\n            if (parsedResults.success === false) {\n              throw new Error(\n                `Invalid output from CLI command: ${parsedResults.error.issues\n                  .map((issue) => issue.message)\n                  .join(', ')}`\n              );\n            }\n            return {\n              content: parsedResults.data\n                .map((line) => {\n                  const { type } = line;\n                  if (type === 'text') {\n                    return { type, text: line.text, level: line.level, url: line.url };\n                  } else if (line.type === 'image' || line.type === 'audio') {\n                    // We could present this as a resource_link, but it seems not to be well supported in MCP clients,\n                    // so we'll return a text with the link instead.\n                    return {\n                      type: 'text',\n                      text: `${type} resource: ${line.url}${line.text ? ' (' + line.text + ')' : ''}`,\n                    } as const;\n                  }\n                  return null;\n                })\n                .filter((line): line is Exclude<typeof line, null> => line !== null),\n            };\n          } catch (e: any) {\n            Log.error('Error executing MCP CLI command:', e);\n            return {\n              content: [{ type: 'text', text: `Error executing command: ${e.toString()}` }],\n              isError: true,\n            };\n          }\n        }\n      );\n    }\n  }\n}\n"],"names":["addMcpCapabilities","debug","require","mcpServer","devServerManager","plugins","devtoolsPluginManager","queryPluginsAsync","plugin","cliExtensions","commands","filter","p","environments","includes","length","schema","createMCPDevToolsExtensionSchema","packageName","registerTool","title","description","inputSchema","parameters","command","args","metroServerOrigin","getDefaultDevServer","getJsInspectorBaseUrl","results","DevToolsPluginCliExtensionExecutor","projectRoot","execute","parsedResults","DevToolsPluginOutputSchema","safeParse","success","Error","error","issues","map","issue","message","join","content","data","line","type","text","level","url","e","Log","toString","isError"],"mappings":";;;;+BASsBA;;;eAAAA;;;sCARqB;oDACQ;kDAEF;qBAC7B;AAEpB,MAAMC,QAAQC,QAAQ,SAAS;AAExB,eAAeF,mBAAmBG,SAAoB,EAAEC,gBAAkC;IAC/F,MAAMC,UAAU,MAAMD,iBAAiBE,qBAAqB,CAACC,iBAAiB;IAE9E,KAAK,MAAMC,UAAUH,QAAS;QAC5B,IAAIG,OAAOC,aAAa,EAAE;YACxB,MAAMC,WAAW,AAACF,CAAAA,OAAOC,aAAa,CAACC,QAAQ,IAAI,EAAE,AAAD,EAAGC,MAAM,CAAC,CAACC;oBAC7DA;wBAAAA,kBAAAA,EAAEC,YAAY,qBAAdD,gBAAgBE,QAAQ,CAAC;;YAE3B,IAAIJ,SAASK,MAAM,KAAK,GAAG;gBACzB;YACF;YAEA,MAAMC,SAASC,IAAAA,kEAAgC,EAACT;YAEhDP,MACE,CAAC,yCAAyC,EAAEO,OAAOU,WAAW,CAAC,SAAS,EAAER,SAASK,MAAM,CAAC,SAAS,CAAC;YAGtGZ,UAAUgB,YAAY,CACpBX,OAAOU,WAAW,EAClB;gBACEE,OAAOZ,OAAOU,WAAW;gBACzBG,aAAab,OAAOa,WAAW;gBAC/BC,aAAa;oBAAEC,YAAYP;gBAAO;YACpC,GACA,OAAO,EAAEO,UAAU,EAAE;gBACnB,IAAI;oBACF,MAAM,EAAEC,OAAO,EAAE,GAAGC,MAAM,GAAGF;oBAE7B,MAAMG,oBAAoBtB,iBACvBuB,mBAAmB,GACnBC,qBAAqB;oBAExB,MAAMC,UAAU,MAAM,IAAIC,sEAAkC,CAC1DtB,QACAJ,iBAAiB2B,WAAW,EAC5BC,OAAO,CAAC;wBAAER;wBAASC;wBAAMC;oBAAkB;oBAE7C,MAAMO,gBAAgBC,gDAA0B,CAACC,SAAS,CAACN;oBAC3D,IAAII,cAAcG,OAAO,KAAK,OAAO;wBACnC,MAAM,IAAIC,MACR,CAAC,iCAAiC,EAAEJ,cAAcK,KAAK,CAACC,MAAM,CAC3DC,GAAG,CAAC,CAACC,QAAUA,MAAMC,OAAO,EAC5BC,IAAI,CAAC,OAAO;oBAEnB;oBACA,OAAO;wBACLC,SAASX,cAAcY,IAAI,CACxBL,GAAG,CAAC,CAACM;4BACJ,MAAM,EAAEC,IAAI,EAAE,GAAGD;4BACjB,IAAIC,SAAS,QAAQ;gCACnB,OAAO;oCAAEA;oCAAMC,MAAMF,KAAKE,IAAI;oCAAEC,OAAOH,KAAKG,KAAK;oCAAEC,KAAKJ,KAAKI,GAAG;gCAAC;4BACnE,OAAO,IAAIJ,KAAKC,IAAI,KAAK,WAAWD,KAAKC,IAAI,KAAK,SAAS;gCACzD,kGAAkG;gCAClG,gDAAgD;gCAChD,OAAO;oCACLA,MAAM;oCACNC,MAAM,GAAGD,KAAK,WAAW,EAAED,KAAKI,GAAG,GAAGJ,KAAKE,IAAI,GAAG,OAAOF,KAAKE,IAAI,GAAG,MAAM,IAAI;gCACjF;4BACF;4BACA,OAAO;wBACT,GACCrC,MAAM,CAAC,CAACmC,OAA6CA,SAAS;oBACnE;gBACF,EAAE,OAAOK,GAAQ;oBACfC,QAAG,CAACd,KAAK,CAAC,oCAAoCa;oBAC9C,OAAO;wBACLP,SAAS;4BAAC;gCAAEG,MAAM;gCAAQC,MAAM,CAAC,yBAAyB,EAAEG,EAAEE,QAAQ,IAAI;4BAAC;yBAAE;wBAC7EC,SAAS;oBACX;gBACF;YACF;QAEJ;IACF;AACF"}
+{"version":3,"sources":["../../../../src/start/server/MCPDevToolsPluginCLIExtensions.ts"],"sourcesContent":["import type { DevServerManager } from './DevServerManager';\nimport type { DevToolsPluginInfo } from './DevToolsPlugin.schema';\nimport { DevToolsPluginOutputSchema } from './DevToolsPlugin.schema';\nimport { DevToolsPluginCliExtensionExecutor } from './DevToolsPluginCliExtensionExecutor';\nimport type { McpServer } from './MCP';\nimport { createMCPDevToolsExtensionSchema } from './createMCPDevToolsExtensionSchema';\nimport { Log } from '../../log';\n\nconst debug = require('debug')('expo:start:server:devtools:mcp');\n\nexport async function addMcpCapabilities(mcpServer: McpServer, devServerManager: DevServerManager) {\n  const plugins = await devServerManager.devtoolsPluginManager.queryPluginsAsync();\n\n  for (const plugin of plugins) {\n    if (plugin.cliExtensions) {\n      const mcpCommands = (plugin.cliExtensions.commands ?? []).filter((p) =>\n        p.environments?.includes('mcp')\n      );\n      if (mcpCommands.length === 0) {\n        continue;\n      }\n\n      // Build an MCP-scoped descriptor so the schema enum and the executor's\n      // existence check both reject commands that were not declared MCP-enabled.\n      const mcpPlugin: DevToolsPluginInfo = {\n        packageName: plugin.packageName,\n        packageRoot: plugin.packageRoot,\n        cliExtensions: {\n          ...plugin.cliExtensions,\n          commands: mcpCommands,\n        },\n      };\n\n      const schema = createMCPDevToolsExtensionSchema(mcpPlugin);\n\n      debug(\n        `Installing MCP CLI extension for plugin: ${plugin.packageName} - found ${mcpCommands.length} commands`\n      );\n\n      mcpServer.registerTool(\n        plugin.packageName,\n        {\n          title: plugin.packageName,\n          description: plugin.description,\n          inputSchema: { parameters: schema },\n        },\n        async ({ parameters }) => {\n          try {\n            const { command, ...args } = parameters;\n\n            const metroServerOrigin = devServerManager\n              .getDefaultDevServer()\n              .getJsInspectorBaseUrl();\n\n            const results = await new DevToolsPluginCliExtensionExecutor(\n              mcpPlugin,\n              devServerManager.projectRoot\n            ).execute({ command, args, metroServerOrigin });\n\n            const parsedResults = DevToolsPluginOutputSchema.safeParse(results);\n            if (parsedResults.success === false) {\n              throw new Error(\n                `Invalid output from CLI command: ${parsedResults.error.issues\n                  .map((issue) => issue.message)\n                  .join(', ')}`\n              );\n            }\n            return {\n              content: parsedResults.data\n                .map((line) => {\n                  const { type } = line;\n                  if (type === 'text') {\n                    return { type, text: line.text, level: line.level, url: line.url };\n                  } else if (line.type === 'image' || line.type === 'audio') {\n                    // We could present this as a resource_link, but it seems not to be well supported in MCP clients,\n                    // so we'll return a text with the link instead.\n                    return {\n                      type: 'text',\n                      text: `${type} resource: ${line.url}${line.text ? ' (' + line.text + ')' : ''}`,\n                    } as const;\n                  }\n                  return null;\n                })\n                .filter((line): line is Exclude<typeof line, null> => line !== null),\n            };\n          } catch (e: any) {\n            Log.error('Error executing MCP CLI command:', e);\n            return {\n              content: [{ type: 'text', text: `Error executing command: ${e.toString()}` }],\n              isError: true,\n            };\n          }\n        }\n      );\n    }\n  }\n}\n"],"names":["addMcpCapabilities","debug","require","mcpServer","devServerManager","plugins","devtoolsPluginManager","queryPluginsAsync","plugin","cliExtensions","mcpCommands","commands","filter","p","environments","includes","length","mcpPlugin","packageName","packageRoot","schema","createMCPDevToolsExtensionSchema","registerTool","title","description","inputSchema","parameters","command","args","metroServerOrigin","getDefaultDevServer","getJsInspectorBaseUrl","results","DevToolsPluginCliExtensionExecutor","projectRoot","execute","parsedResults","DevToolsPluginOutputSchema","safeParse","success","Error","error","issues","map","issue","message","join","content","data","line","type","text","level","url","e","Log","toString","isError"],"mappings":";;;;+BAUsBA;;;eAAAA;;;sCARqB;oDACQ;kDAEF;qBAC7B;AAEpB,MAAMC,QAAQC,QAAQ,SAAS;AAExB,eAAeF,mBAAmBG,SAAoB,EAAEC,gBAAkC;IAC/F,MAAMC,UAAU,MAAMD,iBAAiBE,qBAAqB,CAACC,iBAAiB;IAE9E,KAAK,MAAMC,UAAUH,QAAS;QAC5B,IAAIG,OAAOC,aAAa,EAAE;YACxB,MAAMC,cAAc,AAACF,CAAAA,OAAOC,aAAa,CAACE,QAAQ,IAAI,EAAE,AAAD,EAAGC,MAAM,CAAC,CAACC;oBAChEA;wBAAAA,kBAAAA,EAAEC,YAAY,qBAAdD,gBAAgBE,QAAQ,CAAC;;YAE3B,IAAIL,YAAYM,MAAM,KAAK,GAAG;gBAC5B;YACF;YAEA,uEAAuE;YACvE,2EAA2E;YAC3E,MAAMC,YAAgC;gBACpCC,aAAaV,OAAOU,WAAW;gBAC/BC,aAAaX,OAAOW,WAAW;gBAC/BV,eAAe;oBACb,GAAGD,OAAOC,aAAa;oBACvBE,UAAUD;gBACZ;YACF;YAEA,MAAMU,SAASC,IAAAA,kEAAgC,EAACJ;YAEhDhB,MACE,CAAC,yCAAyC,EAAEO,OAAOU,WAAW,CAAC,SAAS,EAAER,YAAYM,MAAM,CAAC,SAAS,CAAC;YAGzGb,UAAUmB,YAAY,CACpBd,OAAOU,WAAW,EAClB;gBACEK,OAAOf,OAAOU,WAAW;gBACzBM,aAAahB,OAAOgB,WAAW;gBAC/BC,aAAa;oBAAEC,YAAYN;gBAAO;YACpC,GACA,OAAO,EAAEM,UAAU,EAAE;gBACnB,IAAI;oBACF,MAAM,EAAEC,OAAO,EAAE,GAAGC,MAAM,GAAGF;oBAE7B,MAAMG,oBAAoBzB,iBACvB0B,mBAAmB,GACnBC,qBAAqB;oBAExB,MAAMC,UAAU,MAAM,IAAIC,sEAAkC,CAC1DhB,WACAb,iBAAiB8B,WAAW,EAC5BC,OAAO,CAAC;wBAAER;wBAASC;wBAAMC;oBAAkB;oBAE7C,MAAMO,gBAAgBC,gDAA0B,CAACC,SAAS,CAACN;oBAC3D,IAAII,cAAcG,OAAO,KAAK,OAAO;wBACnC,MAAM,IAAIC,MACR,CAAC,iCAAiC,EAAEJ,cAAcK,KAAK,CAACC,MAAM,CAC3DC,GAAG,CAAC,CAACC,QAAUA,MAAMC,OAAO,EAC5BC,IAAI,CAAC,OAAO;oBAEnB;oBACA,OAAO;wBACLC,SAASX,cAAcY,IAAI,CACxBL,GAAG,CAAC,CAACM;4BACJ,MAAM,EAAEC,IAAI,EAAE,GAAGD;4BACjB,IAAIC,SAAS,QAAQ;gCACnB,OAAO;oCAAEA;oCAAMC,MAAMF,KAAKE,IAAI;oCAAEC,OAAOH,KAAKG,KAAK;oCAAEC,KAAKJ,KAAKI,GAAG;gCAAC;4BACnE,OAAO,IAAIJ,KAAKC,IAAI,KAAK,WAAWD,KAAKC,IAAI,KAAK,SAAS;gCACzD,kGAAkG;gCAClG,gDAAgD;gCAChD,OAAO;oCACLA,MAAM;oCACNC,MAAM,GAAGD,KAAK,WAAW,EAAED,KAAKI,GAAG,GAAGJ,KAAKE,IAAI,GAAG,OAAOF,KAAKE,IAAI,GAAG,MAAM,IAAI;gCACjF;4BACF;4BACA,OAAO;wBACT,GACCvC,MAAM,CAAC,CAACqC,OAA6CA,SAAS;oBACnE;gBACF,EAAE,OAAOK,GAAQ;oBACfC,QAAG,CAACd,KAAK,CAAC,oCAAoCa;oBAC9C,OAAO;wBACLP,SAAS;4BAAC;gCAAEG,MAAM;gCAAQC,MAAM,CAAC,yBAAyB,EAAEG,EAAEE,QAAQ,IAAI;4BAAC;yBAAE;wBAC7EC,SAAS;oBACX;gBACF;YACF;QAEJ;IACF;AACF"}

package/build/src/start/server/UrlCreator.js

@@ -136,6 +136,10 @@ class UrlCreator {
     getDefaultRouteAddress() {
         return this.gatewayInfo.address;
     }
+    /** URL scheme configured for development-build deep links (e.g. `myapp`). `null` when unset. */ getScheme() {
+        var _this_defaults;
+        return ((_this_defaults = this.defaults) == null ? void 0 : _this_defaults.scheme) ?? null;
+    }
     /** Get the URL components from the Ngrok server URL. */ getTunnelUrlComponents(options) {
         const tunnelUrl = this.bundlerInfo.getTunnelUrl == null ? void 0 : this.bundlerInfo.getTunnelUrl.call(this.bundlerInfo);
         if (!tunnelUrl) {

package/build/src/start/server/UrlCreator.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../src/start/server/UrlCreator.ts"],"sourcesContent":["import assert from 'assert';\nimport { URL } from 'url';\n\nimport * as Log from '../../log';\nimport type { GatewayInfo } from '../../utils/ip';\nimport { getGateway, getGatewayAsync } from '../../utils/ip';\n\nconst debug = require('debug')('expo:start:server:urlCreator') as typeof console.log;\n\nexport interface CreateURLOptions {\n  /** URL scheme to use when opening apps in custom runtimes. */\n  scheme?: string | null;\n  /** Type of dev server host to use. */\n  hostType?: 'localhost' | 'lan' | 'tunnel';\n  /** Requested hostname. */\n  hostname?: string | null;\n}\n\ninterface UrlComponents {\n  port: string;\n  hostname: string;\n  protocol: string;\n}\n\ninterface BundlerInfo {\n  port: number;\n  getTunnelUrl?(): string | null;\n}\n\nexport class UrlCreator {\n  constructor(\n    public defaults: CreateURLOptions,\n    private bundlerInfo: BundlerInfo,\n    private gatewayInfo: GatewayInfo = getGateway()\n  ) {}\n\n  static async init(defaults: CreateURLOptions | undefined | null, bundlerInfo: BundlerInfo) {\n    const gatewayInfo = await getGatewayAsync();\n    return new UrlCreator(defaults || {}, bundlerInfo, gatewayInfo);\n  }\n\n  /**\n   * Return a URL for the \"loading\" interstitial page that is used to disambiguate which\n   * native runtime to open the dev server with.\n   *\n   * @param options options for creating the URL\n   * @param platform when opening the URL from the CLI to a connected device we can specify the platform as a query parameter, otherwise it will be inferred from the unsafe user agent sniffing.\n   *\n   * @returns URL like `http://localhost:8081/_expo/loading?platform=ios`\n   * @returns URL like `http://localhost:8081/_expo/loading` when no platform is provided.\n   */\n  public constructLoadingUrl(options: CreateURLOptions, platform: string | null): string {\n    const url = new URL('_expo/loading', this.constructUrl({ scheme: 'http', ...options }));\n    if (platform) {\n      url.search = new URLSearchParams({ platform }).toString();\n    }\n    const loadingUrl = url.toString();\n    debug(`Loading URL: ${loadingUrl}`);\n    return loadingUrl;\n  }\n\n  /** Create a URI for launching in a native dev client. Returns `null` when no `scheme` can be resolved. */\n  public constructDevClientUrl(options?: CreateURLOptions): null | string {\n    const protocol = options?.scheme || this.defaults?.scheme;\n\n    if (\n      !protocol ||\n      // Prohibit the use of http(s) in dev client URIs since they'll never be valid.\n      ['http', 'https'].includes(protocol.toLowerCase()) ||\n      // Prohibit the use of `_` characters in the protocol, Node will throw an error when parsing these URLs\n      protocol.includes('_')\n    ) {\n      debug(`Invalid protocol for dev client URL: ${protocol}`);\n      return null;\n    }\n\n    const manifestUrl = this.constructUrl({\n      ...options,\n      scheme: this.defaults?.hostType === 'tunnel' ? 'https' : 'http',\n    });\n    const devClientUrl = `${protocol}://expo-development-client/?url=${encodeURIComponent(\n      manifestUrl\n    )}`;\n    debug(`Dev client URL: ${devClientUrl} -- manifestUrl: ${manifestUrl} -- %O`, options);\n    return devClientUrl;\n  }\n\n  /** Create a generic URL. */\n  public constructUrl(options?: Partial<CreateURLOptions> | null): string {\n    const urlComponents = this.getUrlComponents({\n      ...this.defaults,\n      ...options,\n    });\n    const url = joinUrlComponents(urlComponents);\n    debug(`URL: ${url}`);\n    return url;\n  }\n\n  public getDefaultRouteAddress(): string {\n    return this.gatewayInfo.address;\n  }\n\n  /** Get the URL components from the Ngrok server URL. */\n  private getTunnelUrlComponents(options: Pick<CreateURLOptions, 'scheme'>): UrlComponents | null {\n    const tunnelUrl = this.bundlerInfo.getTunnelUrl?.();\n    if (!tunnelUrl) {\n      return null;\n    }\n    const parsed = new URL(tunnelUrl);\n    return {\n      port: parsed.port,\n      hostname: parsed.hostname,\n      protocol: options.scheme ?? 'http',\n    };\n  }\n\n  private getUrlComponents(options: CreateURLOptions): UrlComponents {\n    // Proxy comes first.\n    const proxyURL = getProxyUrl();\n    if (proxyURL) {\n      return getUrlComponentsFromProxyUrl(options, proxyURL);\n    }\n\n    // Ngrok.\n    if (options.hostType === 'tunnel') {\n      const components = this.getTunnelUrlComponents(options);\n      if (components) {\n        return components;\n      }\n      Log.warn('Tunnel URL not found (it might not be ready yet), falling back to LAN URL.');\n    } else if (options.hostType === 'localhost' && !options.hostname) {\n      options.hostname = 'localhost';\n    }\n\n    return {\n      hostname: getDefaultHostname(options, this.gatewayInfo),\n      port: this.bundlerInfo.port.toString(),\n      protocol: options.scheme ?? 'http',\n    };\n  }\n}\n\nfunction getUrlComponentsFromProxyUrl(\n  options: Pick<CreateURLOptions, 'scheme'>,\n  url: string\n): UrlComponents {\n  const parsedProxyUrl = new URL(url);\n  let protocol = options.scheme ?? 'http';\n  if (parsedProxyUrl.protocol === 'https:') {\n    if (protocol === 'http') {\n      protocol = 'https';\n    }\n    if (!parsedProxyUrl.port) {\n      parsedProxyUrl.port = '443';\n    }\n  }\n  return {\n    port: parsedProxyUrl.port,\n    hostname: parsedProxyUrl.hostname,\n    protocol,\n  };\n}\n\nconst getDefaultHostname = (options: CreateURLOptions, gateway: GatewayInfo) => {\n  // TODO: Drop REACT_NATIVE_PACKAGER_HOSTNAME\n  if (process.env.REACT_NATIVE_PACKAGER_HOSTNAME) {\n    return process.env.REACT_NATIVE_PACKAGER_HOSTNAME.trim();\n  } else if (options.hostname === 'localhost') {\n    // NOTE: We always convert \"localhost\" as a request to 127.0.0.1,\n    // to normalize to an address that's consistent\n    return '127.0.0.1';\n  } else {\n    // Fall back to local address\n    return options.hostname || gateway.address;\n  }\n};\n\nfunction joinUrlComponents({ protocol, hostname, port }: Partial<UrlComponents>): string {\n  assert(hostname, 'hostname cannot be inferred.');\n  const validProtocol = protocol ? `${protocol}://` : '';\n\n  const url = `${validProtocol}${hostname}`;\n\n  if (port) {\n    return url + `:${port}`;\n  }\n\n  return url;\n}\n\n/** @deprecated */\nfunction getProxyUrl(): string | undefined {\n  return process.env.EXPO_PACKAGER_PROXY_URL;\n}\n\n// TODO: Drop the undocumented env variables:\n// REACT_NATIVE_PACKAGER_HOSTNAME\n// EXPO_PACKAGER_PROXY_URL\n"],"names":["UrlCreator","debug","require","defaults","bundlerInfo","gatewayInfo","getGateway","init","getGatewayAsync","constructLoadingUrl","options","platform","url","URL","constructUrl","scheme","search","URLSearchParams","toString","loadingUrl","constructDevClientUrl","protocol","includes","toLowerCase","manifestUrl","hostType","devClientUrl","encodeURIComponent","urlComponents","getUrlComponents","joinUrlComponents","getDefaultRouteAddress","address","getTunnelUrlComponents","tunnelUrl","getTunnelUrl","parsed","port","hostname","proxyURL","getProxyUrl","getUrlComponentsFromProxyUrl","components","Log","warn","getDefaultHostname","parsedProxyUrl","gateway","process","env","REACT_NATIVE_PACKAGER_HOSTNAME","trim","assert","validProtocol","EXPO_PACKAGER_PROXY_URL"],"mappings":"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"}
+{"version":3,"sources":["../../../../src/start/server/UrlCreator.ts"],"sourcesContent":["import assert from 'assert';\nimport { URL } from 'url';\n\nimport * as Log from '../../log';\nimport type { GatewayInfo } from '../../utils/ip';\nimport { getGateway, getGatewayAsync } from '../../utils/ip';\n\nconst debug = require('debug')('expo:start:server:urlCreator') as typeof console.log;\n\nexport interface CreateURLOptions {\n  /** URL scheme to use when opening apps in custom runtimes. */\n  scheme?: string | null;\n  /** Type of dev server host to use. */\n  hostType?: 'localhost' | 'lan' | 'tunnel';\n  /** Requested hostname. */\n  hostname?: string | null;\n}\n\ninterface UrlComponents {\n  port: string;\n  hostname: string;\n  protocol: string;\n}\n\ninterface BundlerInfo {\n  port: number;\n  getTunnelUrl?(): string | null;\n}\n\nexport class UrlCreator {\n  constructor(\n    public defaults: CreateURLOptions,\n    private bundlerInfo: BundlerInfo,\n    private gatewayInfo: GatewayInfo = getGateway()\n  ) {}\n\n  static async init(defaults: CreateURLOptions | undefined | null, bundlerInfo: BundlerInfo) {\n    const gatewayInfo = await getGatewayAsync();\n    return new UrlCreator(defaults || {}, bundlerInfo, gatewayInfo);\n  }\n\n  /**\n   * Return a URL for the \"loading\" interstitial page that is used to disambiguate which\n   * native runtime to open the dev server with.\n   *\n   * @param options options for creating the URL\n   * @param platform when opening the URL from the CLI to a connected device we can specify the platform as a query parameter, otherwise it will be inferred from the unsafe user agent sniffing.\n   *\n   * @returns URL like `http://localhost:8081/_expo/loading?platform=ios`\n   * @returns URL like `http://localhost:8081/_expo/loading` when no platform is provided.\n   */\n  public constructLoadingUrl(options: CreateURLOptions, platform: string | null): string {\n    const url = new URL('_expo/loading', this.constructUrl({ scheme: 'http', ...options }));\n    if (platform) {\n      url.search = new URLSearchParams({ platform }).toString();\n    }\n    const loadingUrl = url.toString();\n    debug(`Loading URL: ${loadingUrl}`);\n    return loadingUrl;\n  }\n\n  /** Create a URI for launching in a native dev client. Returns `null` when no `scheme` can be resolved. */\n  public constructDevClientUrl(options?: CreateURLOptions): null | string {\n    const protocol = options?.scheme || this.defaults?.scheme;\n\n    if (\n      !protocol ||\n      // Prohibit the use of http(s) in dev client URIs since they'll never be valid.\n      ['http', 'https'].includes(protocol.toLowerCase()) ||\n      // Prohibit the use of `_` characters in the protocol, Node will throw an error when parsing these URLs\n      protocol.includes('_')\n    ) {\n      debug(`Invalid protocol for dev client URL: ${protocol}`);\n      return null;\n    }\n\n    const manifestUrl = this.constructUrl({\n      ...options,\n      scheme: this.defaults?.hostType === 'tunnel' ? 'https' : 'http',\n    });\n    const devClientUrl = `${protocol}://expo-development-client/?url=${encodeURIComponent(\n      manifestUrl\n    )}`;\n    debug(`Dev client URL: ${devClientUrl} -- manifestUrl: ${manifestUrl} -- %O`, options);\n    return devClientUrl;\n  }\n\n  /** Create a generic URL. */\n  public constructUrl(options?: Partial<CreateURLOptions> | null): string {\n    const urlComponents = this.getUrlComponents({\n      ...this.defaults,\n      ...options,\n    });\n    const url = joinUrlComponents(urlComponents);\n    debug(`URL: ${url}`);\n    return url;\n  }\n\n  public getDefaultRouteAddress(): string {\n    return this.gatewayInfo.address;\n  }\n\n  /** URL scheme configured for development-build deep links (e.g. `myapp`). `null` when unset. */\n  public getScheme(): string | null {\n    return this.defaults?.scheme ?? null;\n  }\n\n  /** Get the URL components from the Ngrok server URL. */\n  private getTunnelUrlComponents(options: Pick<CreateURLOptions, 'scheme'>): UrlComponents | null {\n    const tunnelUrl = this.bundlerInfo.getTunnelUrl?.();\n    if (!tunnelUrl) {\n      return null;\n    }\n    const parsed = new URL(tunnelUrl);\n    return {\n      port: parsed.port,\n      hostname: parsed.hostname,\n      protocol: options.scheme ?? 'http',\n    };\n  }\n\n  private getUrlComponents(options: CreateURLOptions): UrlComponents {\n    // Proxy comes first.\n    const proxyURL = getProxyUrl();\n    if (proxyURL) {\n      return getUrlComponentsFromProxyUrl(options, proxyURL);\n    }\n\n    // Ngrok.\n    if (options.hostType === 'tunnel') {\n      const components = this.getTunnelUrlComponents(options);\n      if (components) {\n        return components;\n      }\n      Log.warn('Tunnel URL not found (it might not be ready yet), falling back to LAN URL.');\n    } else if (options.hostType === 'localhost' && !options.hostname) {\n      options.hostname = 'localhost';\n    }\n\n    return {\n      hostname: getDefaultHostname(options, this.gatewayInfo),\n      port: this.bundlerInfo.port.toString(),\n      protocol: options.scheme ?? 'http',\n    };\n  }\n}\n\nfunction getUrlComponentsFromProxyUrl(\n  options: Pick<CreateURLOptions, 'scheme'>,\n  url: string\n): UrlComponents {\n  const parsedProxyUrl = new URL(url);\n  let protocol = options.scheme ?? 'http';\n  if (parsedProxyUrl.protocol === 'https:') {\n    if (protocol === 'http') {\n      protocol = 'https';\n    }\n    if (!parsedProxyUrl.port) {\n      parsedProxyUrl.port = '443';\n    }\n  }\n  return {\n    port: parsedProxyUrl.port,\n    hostname: parsedProxyUrl.hostname,\n    protocol,\n  };\n}\n\nconst getDefaultHostname = (options: CreateURLOptions, gateway: GatewayInfo) => {\n  // TODO: Drop REACT_NATIVE_PACKAGER_HOSTNAME\n  if (process.env.REACT_NATIVE_PACKAGER_HOSTNAME) {\n    return process.env.REACT_NATIVE_PACKAGER_HOSTNAME.trim();\n  } else if (options.hostname === 'localhost') {\n    // NOTE: We always convert \"localhost\" as a request to 127.0.0.1,\n    // to normalize to an address that's consistent\n    return '127.0.0.1';\n  } else {\n    // Fall back to local address\n    return options.hostname || gateway.address;\n  }\n};\n\nfunction joinUrlComponents({ protocol, hostname, port }: Partial<UrlComponents>): string {\n  assert(hostname, 'hostname cannot be inferred.');\n  const validProtocol = protocol ? `${protocol}://` : '';\n\n  const url = `${validProtocol}${hostname}`;\n\n  if (port) {\n    return url + `:${port}`;\n  }\n\n  return url;\n}\n\n/** @deprecated */\nfunction getProxyUrl(): string | undefined {\n  return process.env.EXPO_PACKAGER_PROXY_URL;\n}\n\n// TODO: Drop the undocumented env variables:\n// REACT_NATIVE_PACKAGER_HOSTNAME\n// EXPO_PACKAGER_PROXY_URL\n"],"names":["UrlCreator","debug","require","defaults","bundlerInfo","gatewayInfo","getGateway","init","getGatewayAsync","constructLoadingUrl","options","platform","url","URL","constructUrl","scheme","search","URLSearchParams","toString","loadingUrl","constructDevClientUrl","protocol","includes","toLowerCase","manifestUrl","hostType","devClientUrl","encodeURIComponent","urlComponents","getUrlComponents","joinUrlComponents","getDefaultRouteAddress","address","getScheme","getTunnelUrlComponents","tunnelUrl","getTunnelUrl","parsed","port","hostname","proxyURL","getProxyUrl","getUrlComponentsFromProxyUrl","components","Log","warn","getDefaultHostname","parsedProxyUrl","gateway","process","env","REACT_NATIVE_PACKAGER_HOSTNAME","trim","assert","validProtocol","EXPO_PACKAGER_PROXY_URL"],"mappings":"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"}

package/build/src/start/server/createMCPDevToolsExtensionSchema.js

@@ -33,6 +33,7 @@ function createMCPDevToolsExtensionSchema(plugin) {
     // Track which commands use each parameter for documentation
     const parameterCommandMap = {};
     const parameterDescriptions = {};
+    const parameterTypes = {};
     for (const command of commands){
         if (command.parameters && command.parameters.length > 0) {
             for (const param of command.parameters){
@@ -41,6 +42,7 @@ function createMCPDevToolsExtensionSchema(plugin) {
                     commands = [];
                     parameterCommandMap[param.name] = commands;
                     parameterDescriptions[param.name] = param.description || '';
+                    parameterTypes[param.name] = param.type;
                 }
                 commands.push(command.name);
             }
@@ -53,7 +55,7 @@ function createMCPDevToolsExtensionSchema(plugin) {
         const commandsUsingParam = commandList.length === commands.length ? 'all commands' : commandList.map((c)=>`"${c}"`).join(', ');
         // Include command context in the description so LLMs know when to use each parameter
         const fullDescription = baseDescription ? `${baseDescription} (Used by: ${commandsUsingParam})` : `Parameter for: ${commandsUsingParam}`;
-        allParameters[paramName] = _zod().z.string().optional().describe(fullDescription);
+        allParameters[paramName] = paramTypeToZod(parameterTypes[paramName]).optional().describe(fullDescription);
     }
     // Build the command description with clear instructions for the LLM
     const hasParameters = Object.keys(allParameters).length > 0;
@@ -65,5 +67,15 @@ function createMCPDevToolsExtensionSchema(plugin) {
     }).strict(); // .strict() adds additionalProperties: false
     return schema;
 }
+function paramTypeToZod(type) {
+    switch(type){
+        case 'number':
+            return _zod().z.number();
+        case 'confirm':
+            return _zod().z.boolean();
+        case 'text':
+            return _zod().z.string();
+    }
+}
 
 //# sourceMappingURL=createMCPDevToolsExtensionSchema.js.map

package/build/src/start/server/createMCPDevToolsExtensionSchema.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../src/start/server/createMCPDevToolsExtensionSchema.ts"],"sourcesContent":["import { z } from 'zod';\n\nimport type { DevToolsPlugin } from './DevToolsPlugin';\n\n/**\n * Creates an MCP-compatible JSON schema for a DevTools plugin's CLI extensions.\n *\n * LLM agents have varying support for complex JSON schema features like `anyOf`/`oneOf`\n * discriminated unions. This implementation uses a flat schema with an enum for the\n * command name, which provides the best compatibility across different LLM providers:\n *\n * - OpenAI: Supports `anyOf` but requires `additionalProperties: false` and all fields `required`\n * - Claude/Anthropic: Works best with simple flat schemas with enums\n * - Other providers: Generally have limited or inconsistent support for discriminated unions\n *\n * To compensate for the lack of discriminated unions, parameter descriptions include\n * which command(s) they belong to, and command descriptions include their parameters.\n *\n * The resulting schema structure is:\n * ```json\n * {\n *   \"type\": \"object\",\n *   \"properties\": {\n *     \"command\": {\n *       \"type\": \"string\",\n *       \"enum\": [\"cmd1\", \"cmd2\", ...],\n *       \"description\": \"The command to execute. Available commands: \\\"cmd1\\\" - Title 1 (params: foo); ...\"\n *     },\n *     \"foo\": { \"type\": \"string\", \"description\": \"Foo description (Used by: \\\"cmd1\\\")\" },\n *     ...\n *   },\n *   \"required\": [\"command\"],\n *   \"additionalProperties\": false\n * }\n * ```\n */\nexport function createMCPDevToolsExtensionSchema(plugin: DevToolsPlugin) {\n  if (plugin.cliExtensions == null || plugin.cliExtensions?.commands.length === 0) {\n    throw new Error(\n      `Plugin ${plugin.packageName} has no commands defined. Please define at least one command.`\n    );\n  }\n\n  const commands = plugin.cliExtensions.commands;\n\n  // Build a rich description that explains each command and its parameters\n  const commandDescriptions = commands\n    .map((c) => {\n      const params = c.parameters?.map((p) => p.name).join(', ');\n      return params ? `\"${c.name}\": ${c.title} (params: ${params})` : `\"${c.name}\": ${c.title}`;\n    })\n    .join('. ');\n\n  // Create enum of command names for clear LLM selection\n  const commandNames = commands.map((c) => c.name) as [string, ...string[]];\n\n  // Collect all unique parameters across all commands\n  // Track which commands use each parameter for documentation\n  const parameterCommandMap: Record<string, string[]> = {};\n  const parameterDescriptions: Record<string, string> = {};\n\n  for (const command of commands) {\n    if (command.parameters && command.parameters.length > 0) {\n      for (const param of command.parameters) {\n        let commands = parameterCommandMap[param.name];\n        if (!commands) {\n          commands = [];\n          parameterCommandMap[param.name] = commands;\n          parameterDescriptions[param.name] = param.description || '';\n        }\n        commands.push(command.name);\n      }\n    }\n  }\n\n  // Build parameters with descriptions that indicate which command(s) they belong to\n  const allParameters: Record<string, z.ZodTypeAny> = {};\n  for (const [paramName, commandList] of Object.entries(parameterCommandMap)) {\n    const baseDescription = parameterDescriptions[paramName];\n    const commandsUsingParam =\n      commandList.length === commands.length\n        ? 'all commands'\n        : commandList.map((c) => `\"${c}\"`).join(', ');\n\n    // Include command context in the description so LLMs know when to use each parameter\n    const fullDescription = baseDescription\n      ? `${baseDescription} (Used by: ${commandsUsingParam})`\n      : `Parameter for: ${commandsUsingParam}`;\n\n    allParameters[paramName] = z.string().optional().describe(fullDescription);\n  }\n\n  // Build the command description with clear instructions for the LLM\n  const hasParameters = Object.keys(allParameters).length > 0;\n  const commandDescription = hasParameters\n    ? `Required. The command to execute. You must select exactly one command from the enum values. ` +\n      `Each command may require specific parameters - only include parameters that belong to the selected command. ` +\n      `Commands: ${commandDescriptions}.`\n    : `Required. The command to execute. Select exactly one from the available options. ` +\n      `Commands: ${commandDescriptions}.`;\n\n  // Build the flat schema with additionalProperties: false for LLM compatibility\n  const schema = z\n    .object({\n      command: z.enum(commandNames).describe(commandDescription),\n      ...allParameters,\n    })\n    .strict(); // .strict() adds additionalProperties: false\n\n  return schema;\n}\n"],"names":["createMCPDevToolsExtensionSchema","plugin","cliExtensions","commands","length","Error","packageName","commandDescriptions","map","c","params","parameters","p","name","join","title","commandNames","parameterCommandMap","parameterDescriptions","command","param","description","push","allParameters","paramName","commandList","Object","entries","baseDescription","commandsUsingParam","fullDescription","z","string","optional","describe","hasParameters","keys","commandDescription","schema","object","enum","strict"],"mappings":"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"}
+{"version":3,"sources":["../../../../src/start/server/createMCPDevToolsExtensionSchema.ts"],"sourcesContent":["import { z } from 'zod';\n\nimport type { DevToolsPluginCommandParameter, DevToolsPluginInfo } from './DevToolsPlugin.schema';\n\n/**\n * Creates an MCP-compatible JSON schema for a DevTools plugin's CLI extensions.\n *\n * LLM agents have varying support for complex JSON schema features like `anyOf`/`oneOf`\n * discriminated unions. This implementation uses a flat schema with an enum for the\n * command name, which provides the best compatibility across different LLM providers:\n *\n * - OpenAI: Supports `anyOf` but requires `additionalProperties: false` and all fields `required`\n * - Claude/Anthropic: Works best with simple flat schemas with enums\n * - Other providers: Generally have limited or inconsistent support for discriminated unions\n *\n * To compensate for the lack of discriminated unions, parameter descriptions include\n * which command(s) they belong to, and command descriptions include their parameters.\n *\n * The resulting schema structure is:\n * ```json\n * {\n *   \"type\": \"object\",\n *   \"properties\": {\n *     \"command\": {\n *       \"type\": \"string\",\n *       \"enum\": [\"cmd1\", \"cmd2\", ...],\n *       \"description\": \"The command to execute. Available commands: \\\"cmd1\\\" - Title 1 (params: foo); ...\"\n *     },\n *     \"foo\": { \"type\": \"string\", \"description\": \"Foo description (Used by: \\\"cmd1\\\")\" },\n *     ...\n *   },\n *   \"required\": [\"command\"],\n *   \"additionalProperties\": false\n * }\n * ```\n */\nexport function createMCPDevToolsExtensionSchema(plugin: DevToolsPluginInfo) {\n  if (plugin.cliExtensions == null || plugin.cliExtensions?.commands.length === 0) {\n    throw new Error(\n      `Plugin ${plugin.packageName} has no commands defined. Please define at least one command.`\n    );\n  }\n\n  const commands = plugin.cliExtensions.commands;\n\n  // Build a rich description that explains each command and its parameters\n  const commandDescriptions = commands\n    .map((c) => {\n      const params = c.parameters?.map((p) => p.name).join(', ');\n      return params ? `\"${c.name}\": ${c.title} (params: ${params})` : `\"${c.name}\": ${c.title}`;\n    })\n    .join('. ');\n\n  // Create enum of command names for clear LLM selection\n  const commandNames = commands.map((c) => c.name) as [string, ...string[]];\n\n  // Collect all unique parameters across all commands\n  // Track which commands use each parameter for documentation\n  const parameterCommandMap: Record<string, string[]> = {};\n  const parameterDescriptions: Record<string, string> = {};\n  const parameterTypes: Record<string, DevToolsPluginCommandParameter['type']> = {};\n\n  for (const command of commands) {\n    if (command.parameters && command.parameters.length > 0) {\n      for (const param of command.parameters) {\n        let commands = parameterCommandMap[param.name];\n        if (!commands) {\n          commands = [];\n          parameterCommandMap[param.name] = commands;\n          parameterDescriptions[param.name] = param.description || '';\n          parameterTypes[param.name] = param.type;\n        }\n        commands.push(command.name);\n      }\n    }\n  }\n\n  // Build parameters with descriptions that indicate which command(s) they belong to\n  const allParameters: Record<string, z.ZodTypeAny> = {};\n  for (const [paramName, commandList] of Object.entries(parameterCommandMap)) {\n    const baseDescription = parameterDescriptions[paramName];\n    const commandsUsingParam =\n      commandList.length === commands.length\n        ? 'all commands'\n        : commandList.map((c) => `\"${c}\"`).join(', ');\n\n    // Include command context in the description so LLMs know when to use each parameter\n    const fullDescription = baseDescription\n      ? `${baseDescription} (Used by: ${commandsUsingParam})`\n      : `Parameter for: ${commandsUsingParam}`;\n\n    allParameters[paramName] = paramTypeToZod(parameterTypes[paramName]!)\n      .optional()\n      .describe(fullDescription);\n  }\n\n  // Build the command description with clear instructions for the LLM\n  const hasParameters = Object.keys(allParameters).length > 0;\n  const commandDescription = hasParameters\n    ? `Required. The command to execute. You must select exactly one command from the enum values. ` +\n      `Each command may require specific parameters - only include parameters that belong to the selected command. ` +\n      `Commands: ${commandDescriptions}.`\n    : `Required. The command to execute. Select exactly one from the available options. ` +\n      `Commands: ${commandDescriptions}.`;\n\n  // Build the flat schema with additionalProperties: false for LLM compatibility\n  const schema = z\n    .object({\n      command: z.enum(commandNames).describe(commandDescription),\n      ...allParameters,\n    })\n    .strict(); // .strict() adds additionalProperties: false\n\n  return schema;\n}\n\nfunction paramTypeToZod(type: DevToolsPluginCommandParameter['type']) {\n  switch (type) {\n    case 'number':\n      return z.number();\n    case 'confirm':\n      return z.boolean();\n    case 'text':\n      return z.string();\n  }\n}\n"],"names":["createMCPDevToolsExtensionSchema","plugin","cliExtensions","commands","length","Error","packageName","commandDescriptions","map","c","params","parameters","p","name","join","title","commandNames","parameterCommandMap","parameterDescriptions","parameterTypes","command","param","description","type","push","allParameters","paramName","commandList","Object","entries","baseDescription","commandsUsingParam","fullDescription","paramTypeToZod","optional","describe","hasParameters","keys","commandDescription","schema","z","object","enum","strict","number","boolean","string"],"mappings":"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"}

package/build/src/start/server/metro/MetroBundlerDevServer.js

@@ -107,6 +107,8 @@ const _errors = require("../../../utils/errors");
 const _filePath = require("../../../utils/filePath");
 const _nodeEnv = require("../../../utils/nodeEnv");
 const _port = require("../../../utils/port");
+const _AndroidAppIdResolver = require("../../platforms/android/AndroidAppIdResolver");
+const _AppleAppIdResolver = require("../../platforms/ios/AppleAppIdResolver");
 const _BundlerDevServer = require("../BundlerDevServer");
 const _getStaticRenderFunctions = require("../getStaticRenderFunctions");
 const _resolveLoader = require("./resolveLoader");
@@ -117,10 +119,12 @@ const _DomComponentsMiddleware = require("../middleware/DomComponentsMiddleware"
 const _FaviconMiddleware = require("../middleware/FaviconMiddleware");
 const _HistoryFallbackMiddleware = require("../middleware/HistoryFallbackMiddleware");
 const _InterstitialPageMiddleware = require("../middleware/InterstitialPageMiddleware");
+const _OpenMiddleware = require("../middleware/OpenMiddleware");
 const _RuntimeRedirectMiddleware = require("../middleware/RuntimeRedirectMiddleware");
 const _ServeStaticMiddleware = require("../middleware/ServeStaticMiddleware");
 const _metroOptions = require("../middleware/metroOptions");
 const _mutations = require("../middleware/mutations");
+const _openHandlers = require("../middleware/openHandlers");
 const _startTypescriptTypeGeneration = require("../type-generation/startTypescriptTypeGeneration");
 function _interop_require_default(obj) {
     return obj && obj.__esModule ? obj : {
@@ -959,6 +963,46 @@ class MetroBundlerDevServer extends _BundlerDevServer.BundlerDevServer {
                 }
             });
             middleware.use(deepLinkMiddleware.getHandler());
+            const getHostSupport = (platform)=>{
+                if (platform === 'ios' && process.platform !== 'darwin') {
+                    return {
+                        canOpen: false,
+                        reason: `iOS simulators require macOS with Xcode installed; this dev server is running on ${process.platform}.`
+                    };
+                }
+                return {
+                    canOpen: true
+                };
+            };
+            // Read all dev-server state live — pressing `s` in the terminal toggles `isDevClient`
+            // and the scheme, and `expo-dev-client` can be installed mid-run (re-resolved by
+            // isRedirectPageEnabled on every call).
+            const openMiddleware = new _OpenMiddleware.OpenMiddleware(this.projectRoot, {
+                serverBaseUrl,
+                getHostSupport,
+                getInfo: (0, _openHandlers.createInfoHandler)({
+                    urlCreator: this.getUrlCreator(),
+                    getIsDevClient: ()=>this.isDevClient,
+                    getIsRedirectPageEnabled: ()=>this.isRedirectPageEnabled(),
+                    getAppId: async (platform)=>{
+                        if (platform === 'web') return null;
+                        const resolver = platform === 'ios' ? new _AppleAppIdResolver.AppleAppIdResolver(this.projectRoot) : new _AndroidAppIdResolver.AndroidAppIdResolver(this.projectRoot);
+                        try {
+                            return await resolver.getAppIdAsync();
+                        } catch  {
+                            // Surfacing the error would block the dry-run; consumers can detect the missing id
+                            // from `appId: null` and prompt the user to configure ios.bundleIdentifier /
+                            // android.package.
+                            return null;
+                        }
+                    }
+                }),
+                open: (0, _openHandlers.createOpen)({
+                    getIsDevClient: ()=>this.isDevClient,
+                    openPlatformAsync: (target, resolver)=>this.openPlatformAsync(target, resolver)
+                })
+            });
+            middleware.use(openMiddleware.getHandler());
             const domComponentRenderer = (0, _DomComponentsMiddleware.createDomComponentsMiddleware)({
                 projectRoot: this.projectRoot
             }, instanceMetroOptions);