@browserstack/mcp-server 2.3.0-beta.7 → 2.3.0-beta.9

package/dist/tools/applive.js

@@ -59,7 +59,7 @@ export default function addAppLiveTools(server, config) {
     // screenshot in it, and every eval where an agent was asked to operate an app and chose
     // this tool ended with "my tools can start it but can't tap anything in it". The
     // description says so, and names the surface that can — only when that surface is on.
-    const description = "Open a manual App Live session for the user to operate by hand. It cannot be driven by the agent." +
+    const description = "Open a manual App Live session for the user to operate by hand. It cannot be driven by the agent, and it uploads the app to App Live's own store, which agent-driven device sessions cannot use." +
         (capabilityRegistryEnabled()
             ? " To tap, type or read the app yourself, use a mobiledevicecontrol session via invokeCapability."
             : "");

package/dist/tools/capability-registry/register.js

@@ -248,11 +248,13 @@ export function addCapabilityRegistryTools(server, deps, config) {
                     ? { verdict: "blank" }
                     : { verdict: "settled", product: ambiguity.settled })
             : undefined;
+        /** The product's title for the question put to a person; the key stays the handle. */
+        const label = (name) => registry.index.products[name]?.title ?? name;
         const routing = ambiguity.products.length > 1
             ? {
                 verdict: "products_clash",
                 note: `These products clash over ${ambiguity.terms.map((t) => `'${t}'`).join(", ")} — ` +
-                    `the same word means something different in ${ambiguity.products.join(" and ")}. ` +
+                    `the same word means something different in ${ambiguity.products.map(label).join(" and ")}. ` +
                     "ASK THE USER which they mean before searching or invoking anything; do not " +
                     "search each product in turn and merge the results. Searching before you " +
                     "ask will be refused: send the user's answer in `user_words` with this " +
@@ -260,9 +262,10 @@ export function addCapabilityRegistryTools(server, deps, config) {
                 routing_token: listingToken,
                 shared_terms: ambiguity.terms,
                 products: ambiguity.products,
-                question: `Which product do you mean — ${ambiguity.products.join(" or ")}?`,
+                question: `Which product do you mean — ${ambiguity.products.map(label).join(" or ")}?`,
                 senses: ambiguity.products.map((name) => ({
                     product: name,
+                    title: label(name),
                     means: ambiguity.terms
                         .map((term) => {
                         const entities = registry.index.products[name]?.entities ?? {};
@@ -293,6 +296,7 @@ export function addCapabilityRegistryTools(server, deps, config) {
                     routing_token: listingToken,
                     question: `Which product do you mean — ${registry
                         .productNames()
+                        .map(label)
                         .join(" or ")}?`,
                 }
                 : query
@@ -318,6 +322,9 @@ export function addCapabilityRegistryTools(server, deps, config) {
             ...(routing ? { routing } : {}),
             products: registry.productNames().map((name) => ({
                 name,
+                ...(registry.index.products[name].title
+                    ? { title: registry.index.products[name].title }
+                    : {}),
                 summary: registry.index.products[name].summary,
                 // THE ENTITIES AND WHAT EACH ONE IS. Routing is this tool's whole job, and a
                 // product summary alone does not do it: "add a tag to xyz test" reads as

package/dist/tools/capability-registry/types.d.ts

@@ -415,6 +415,14 @@ export interface AuthScheme {
     scopes?: string[];
 }
 export interface ProductIndex {
+    /**
+     * The product's name as a person would say it — "Mobile Device Control", not the key.
+     *
+     * The key stays the handle every call takes; this is what the routing question and
+     * the product listing show, because "which do you mean — mobiledevicecontrol or tm?"
+     * is a question asked in our vocabulary rather than the user's.
+     */
+    title?: string;
     summary: string;
     /**
      * Words that route to this product but are not the name of anything in it.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@browserstack/mcp-server",
-  "version": "2.3.0-beta.7",
+  "version": "2.3.0-beta.9",
   "description": "BrowserStack's Official MCP Server",
   "mcpName": "io.github.browserstack/mcp-server",
   "main": "dist/index.js",