@browserstack/mcp-server 1.4.0-beta.1 → 1.4.0-beta.2

package/dist/server-factory.js

@@ -16,7 +16,7 @@ import addAppLiveTools from "./tools/applive.js";
 import addBuildInsightsTools from "./tools/build-insights.js";
 import { setupOnInitialized } from "./oninitialized.js";
 import addRCATools from "./tools/rca-agent.js";
-import addAskBrowserstackAITool from "./tools/ask-browserstack/register.js";
+import addAskBrowserStackAITool from "./tools/ask-browserstack/register.js";
 /**
  * Wrapper class for BrowserStack MCP Server
  * Stores a map of registered tools by name
@@ -55,7 +55,7 @@ export class BrowserStackMcpServer {
             // Hands a plain-language task to BrowserStack's agent and relays its mid-run
             // permission asks back to this client, so a write can be confirmed by the human
             // sitting in front of it rather than refused for want of anyone to ask.
-            addAskBrowserstackAITool,
+            addAskBrowserStackAITool,
         ];
         toolAdders.forEach((adder) => {
             // Each adder now returns a Record<string, Tool>

package/dist/tools/ask-browserstack/central-oauth.js

@@ -258,7 +258,7 @@ export async function mintCentralToken(url, credentials, transport, now = Date.n
     const pending = mintOnce(url, credentials, transport)
         .then(({ token, lifetimeMs }) => {
         cache.set(key, { token, expiresAt: now + lifetimeMs });
-        logger.info("askBrowserstackAI: signed in as %s (lifetime %ss)", credentials.username, Math.round(lifetimeMs / 1000));
+        logger.info("askBrowserStackAI: signed in as %s (lifetime %ss)", credentials.username, Math.round(lifetimeMs / 1000));
         return token;
     })
         .catch((error) => {

package/dist/tools/ask-browserstack/config.js

@@ -98,7 +98,7 @@ function announce(what, url, source) {
     if (announced.has(line))
         return;
     announced.add(line);
-    logger.info("askBrowserstackAI: %s is %s (source: %s)", what, url, source);
+    logger.info("askBrowserStackAI: %s is %s (source: %s)", what, url, source);
 }
 /**
  * Resolve Atlas's base URL:

package/dist/tools/ask-browserstack/register.d.ts

@@ -1,5 +1,5 @@
 /**
- * `askBrowserstackAI` — one tool call in, one tool result out, with a human's approval
+ * `askBrowserStackAI` — one tool call in, one tool result out, with a human's approval
  * relayed through the middle of it.
  *
  * The shape, and why:
@@ -55,7 +55,7 @@ export interface AskDeps {
     decisionTransport?: DecisionTransport;
 }
 export declare function relayMode(server: McpServer): RelayMode;
-export declare function addAskBrowserstackAITool(server: McpServer, deps: AskDeps, config?: BrowserStackConfig): Record<string, RegisteredTool>;
+export declare function addAskBrowserStackAITool(server: McpServer, deps: AskDeps, config?: BrowserStackConfig): Record<string, RegisteredTool>;
 /** The tool-adder the server factory calls. */
-export declare function addAskBrowserstackAIToolFromConfig(server: McpServer, config: BrowserStackConfig): Record<string, RegisteredTool>;
-export default addAskBrowserstackAIToolFromConfig;
+export declare function addAskBrowserStackAIToolFromConfig(server: McpServer, config: BrowserStackConfig): Record<string, RegisteredTool>;
+export default addAskBrowserStackAIToolFromConfig;

package/dist/tools/ask-browserstack/register.js

@@ -1,5 +1,5 @@
 /**
- * `askBrowserstackAI` — one tool call in, one tool result out, with a human's approval
+ * `askBrowserStackAI` — one tool call in, one tool result out, with a human's approval
  * relayed through the middle of it.
  *
  * The shape, and why:
@@ -47,7 +47,16 @@ import { PRODUCTS, } from "./types.js";
  * words alone, before any call is made — so the ordering is deliberate: when to reach for it
  * first, what it does second, and the consent behaviour last.
  */
-const DESCRIPTION = "Use this when no other BrowserStack tool here fits the task, or when the ones you tried " +
+const DESCRIPTION = 
+// Alpha status leads, deliberately. The model reads this before deciding to call, and a
+// tool that is not enabled for the account cannot do the job at all — so "there is a
+// per-account gate, fall back to the individual tools" is the most useful thing to say
+// first. Parenthesised so it reads as a status note, not as the tool's purpose.
+"(Alpha, limited availability. Enabled per account and per product; if it is not enabled " +
+    "the call returns an entitlement error, nothing runs, and you should complete the task " +
+    "with the individual tools instead. To request access, the user should contact their " +
+    "BrowserStack account owner.) " +
+    "Use this when no other BrowserStack tool here fits the task, or when the ones you tried " +
     "did not get you there. Prefer a specific tool whenever one fits: it is faster and more " +
     "predictable than handing the job to an agent. " +
     "Otherwise, describe what you want in plain language and BrowserStack's agent decides " +
@@ -147,7 +156,7 @@ async function relayOneAsk(server, ask, approvals, relatedRequestId) {
     // The SHAPE of the answer only — a fixed action enum and a boolean, never the description
     // or anything a user typed. Logged so that what a client actually submits can be read next
     // time rather than inferred from a compiled binary.
-    logger.info("askBrowserstackAI: elicitation answered %s", elicitationShape(answer));
+    logger.info("askBrowserStackAI: elicitation answered %s", elicitationShape(answer));
     const { decision, reason } = decide(answer);
     approvals.push({ description: ask.description, decision, reason });
     return { perm_id: ask.perm_id, decision, reason };
@@ -224,14 +233,14 @@ async function runStreamed(server, streamTransport, decisionTransport, url, head
         // description cannot produce an answerable prompt, so it must not produce a prompt.
         const ask = parseAsk(event.data);
         if (!ask) {
-            logger.error("askBrowserstackAI: unusable permission ask on the stream; ignoring");
+            logger.error("askBrowserStackAI: unusable permission ask on the stream; ignoring");
             continue;
         }
         if (!runId) {
             // Atlas emits `run` before any ask precisely so this cannot happen. If it does,
             // there is nowhere to send a decision — so do not prompt a human for an answer
             // that could never be delivered.
-            logger.error("askBrowserstackAI: permission ask arrived before run_id; cannot answer");
+            logger.error("askBrowserStackAI: permission ask arrived before run_id; cannot answer");
             continue;
         }
         // `relayOneAsk` RETHROWS on an unexpected elicitation failure. Under A2 that was
@@ -246,7 +255,7 @@ async function runStreamed(server, streamTransport, decisionTransport, url, head
             decision = await relayOneAsk(server, ask, approvals, relatedRequestId);
         }
         catch (error) {
-            logger.warn("askBrowserstackAI: elicitation failed, denying explicitly: %s", error instanceof Error ? error.message : String(error));
+            logger.warn("askBrowserStackAI: elicitation failed, denying explicitly: %s", error instanceof Error ? error.message : String(error));
             decision = { perm_id: ask.perm_id, decision: "deny", reason: "error" };
         }
         const status = await decisionTransport(decisionUrl(url, runId), headers, {
@@ -259,7 +268,7 @@ async function runStreamed(server, streamTransport, decisionTransport, url, head
             // own expiry, so a lost decision is safe — it can only cost an approval, never
             // grant one. Retrying risks the opposite: a duplicate that 409s, or worse, an
             // approval applied to a step the run has already moved past.
-            logger.warn("askBrowserstackAI: decision for %s was not accepted (HTTP %s)", decision.perm_id, status);
+            logger.warn("askBrowserStackAI: decision for %s was not accepted (HTTP %s)", decision.perm_id, status);
         }
     }
     if (!sawResult) {
@@ -283,7 +292,7 @@ export function relayMode(server) {
         ? "offered"
         : "no_human";
 }
-export function addAskBrowserstackAITool(server, deps, config) {
+export function addAskBrowserStackAITool(server, deps, config) {
     // A1 (CONTRACT v2) is the only path; A2 is gone. No version flag is needed to talk to
     // an Atlas that predates the stream: such a server answers `POST /agent` with ordinary
     // JSON, the parser sees no `text/event-stream`, and the run degrades to a read-only
@@ -300,7 +309,7 @@ export function addAskBrowserstackAITool(server, deps, config) {
             // Telemetry must not decide whether a tool call succeeds.
         }
     };
-    tools.askBrowserstackAI = server.tool("askBrowserstackAI", DESCRIPTION, {
+    tools.askBrowserStackAI = server.tool("askBrowserStackAI", DESCRIPTION, {
         product: z
             .enum(PRODUCTS)
             .describe("Which product to work in: tm (Test Management), a11y (Accessibility), " +
@@ -314,9 +323,9 @@ export function addAskBrowserstackAITool(server, deps, config) {
         // sets it false: consent is not a licence to delete.
         readOnlyHint: false,
         destructiveHint: false,
-        title: "Ask BrowserStack AI",
+        title: "Ask BrowserStack AI (Alpha)",
     }, async ({ product, query }, extra) => {
-        track("askBrowserstackAI");
+        track("askBrowserStackAI");
         const approvals = [];
         // Negotiated before anything else so the failure paths below report the mode they
         // would have run in.
@@ -347,7 +356,7 @@ export function addAskBrowserstackAITool(server, deps, config) {
             else {
                 // Omitted ENTIRELY, not sent empty: its absence is what selects Atlas's
                 // read-only HeadlessGate.
-                logger.info("askBrowserstackAI: no permission relay (%s); running read-only", mode);
+                logger.info("askBrowserStackAI: no permission relay (%s); running read-only", mode);
             }
             // `product` reaches the result so an entitlement refusal can name it: the flags
             // are per product, and a bare "not enabled" sends the user to their admin
@@ -361,7 +370,7 @@ export function addAskBrowserstackAITool(server, deps, config) {
             const message = error instanceof AskError || error instanceof Error
                 ? error.message
                 : String(error);
-            logger.error("askBrowserstackAI failed: %s", message);
+            logger.error("askBrowserStackAI failed: %s", message);
             // No `canElicit` argument: the request never left this process, so whether the
             // client could have been prompted is not what the reader needs to know.
             return toResult(errorResult(message, approvals));
@@ -373,9 +382,9 @@ export function addAskBrowserstackAITool(server, deps, config) {
     return tools;
 }
 /** The tool-adder the server factory calls. */
-export function addAskBrowserstackAIToolFromConfig(server, config) {
+export function addAskBrowserStackAIToolFromConfig(server, config) {
     if (!isEnabled()) {
-        logger.info("askBrowserstackAI disabled by ASK_BROWSERSTACK_DISABLED");
+        logger.info("askBrowserStackAI disabled by ASK_BROWSERSTACK_DISABLED");
         return {};
     }
     const credentials = () => ({
@@ -383,7 +392,7 @@ export function addAskBrowserstackAIToolFromConfig(server, config) {
         accessKey: config["browserstack-access-key"],
     });
     const tokenTransport = fetchTokenTransport();
-    return addAskBrowserstackAITool(server, {
+    return addAskBrowserStackAITool(server, {
         // Both resolved per call. An unconfigured host surfaces as a named error from the
         // tool rather than as a missing tool, so the cause is visible to whoever hits it.
         agentUrl,
@@ -391,4 +400,4 @@ export function addAskBrowserstackAIToolFromConfig(server, config) {
         credentialsFor: credentials,
     }, config);
 }
-export default addAskBrowserstackAIToolFromConfig;
+export default addAskBrowserStackAIToolFromConfig;

package/dist/tools/ask-browserstack/relay.js

@@ -58,10 +58,11 @@ export const RELAY_OFF_DETAILS = {
     // Not a refusal by anyone and not a relay problem at all: the account is not on the
     // product's agent flag. The product-specific sentence and what to do about it live in
     // `error`, so this one points there rather than duplicating the plumbing.
-    not_entitled: "NOBODY DECLINED THIS AND NOTHING RAN. BrowserStack AI is not enabled for this account, " +
-        "so the request was refused before the agent started. `error` says which product and " +
-        "what to do about it. This is an entitlement on the account, not a problem with your " +
-        "credentials and not a decision anyone made about your request.",
+    not_entitled: "NOBODY DECLINED THIS AND NOTHING RAN. Ask AI (Alpha) is not enabled on this account. " +
+        "Ask AI is in limited alpha and available only to enrolled accounts, so the request was " +
+        "refused before the agent started. `error` names the product. This is an entitlement on " +
+        "the account, not a problem with your credentials and not a decision anyone made about " +
+        "your request.",
     // The request never got as far as the agent. Distinct from `disabled` (the agent ran, with
     // the relay switched off) and from a decline (someone was asked and said no), because the
     // three call for completely different things from whoever reads them.
@@ -137,9 +138,10 @@ export function isNotEntitled(response) {
  */
 export const NOT_ENTITLED_DETAIL = (product) => {
     const scope = product && product.trim() ? ` for \`${product.trim()}\`` : "";
-    return (`BrowserStack AI is not enabled${scope} on your account. Please contact your admin. ` +
-        `YOUR CREDENTIALS ARE FINE — they authenticated successfully; this is a per-product ` +
-        `entitlement on the account. Nothing was run and nobody declined anything.`);
+    return (`Ask AI (Alpha) is not enabled${scope} on this account. Ask AI is in limited alpha and ` +
+        `available only to enrolled accounts. Authentication succeeded and nothing was run. ` +
+        `To request access, contact your BrowserStack account owner, or reach out at ` +
+        `https://www.browserstack.com/contact-sales`);
 };
 export function neverReachedAgent(response) {
     // No response at all: nothing could have run.

package/dist/tools/ask-browserstack/stream.js

@@ -120,7 +120,7 @@ export function parseFrame(frame) {
         // A frame we cannot read is not a frame we may guess at. Dropping it is safe
         // because the only consequence is that an ask goes unanswered and the gate denies
         // on its own expiry — never that something is approved.
-        logger.warn("askBrowserstackAI: unparseable stream frame, ignoring");
+        logger.warn("askBrowserStackAI: unparseable stream frame, ignoring");
         return null;
     }
 }

package/dist/tools/tool-handoff.d.ts

@@ -8,7 +8,7 @@
  * where the missing identifier comes from.
  *
  * Point at a sibling tool whenever one can produce the id — it is faster and more
- * predictable than an agent. Point at `askBrowserstackAI` only when NO tool here can.
+ * predictable than an agent. Point at `askBrowserStackAI` only when NO tool here can.
  *
  * The one that matters most: 15 of the 17 Test Management tools require a project
  * identifier and NONE of them accepts its absence, yet no tool in this server lists

package/dist/tools/tool-handoff.js

@@ -8,7 +8,7 @@
  * where the missing identifier comes from.
  *
  * Point at a sibling tool whenever one can produce the id — it is faster and more
- * predictable than an agent. Point at `askBrowserstackAI` only when NO tool here can.
+ * predictable than an agent. Point at `askBrowserStackAI` only when NO tool here can.
  *
  * The one that matters most: 15 of the 17 Test Management tools require a project
  * identifier and NONE of them accepts its absence, yet no tool in this server lists
@@ -21,7 +21,7 @@
  */
 /** No tool lists projects, so this genuinely has to go to the agent. */
 export const NEEDS_PROJECT_ID = " Requires a project identifier (PR-*). No tool here lists projects, so if you do not " +
-    'have one, call askBrowserstackAI with product "tm" and ask which projects exist, then ' +
+    'have one, call askBrowserStackAI with product "tm" and ask which projects exist, then ' +
     "retry this tool with the identifier it returns.";
 /** A sibling tool can produce the id — prefer it over the agent. */
 export function needsIdFrom(idLabel, sourceTool) {
@@ -33,15 +33,15 @@ export const NEEDS_TEST_PLAN_ID = needsIdFrom("a test plan identifier (TP-*)", "
 export const NEEDS_BUILD_ID = needsIdFrom("a BrowserStack build id", "getBuildId or listBuildId");
 /** Session ids are not listable by any tool here. */
 export const NEEDS_SESSION_ID = " Requires a session id, which no tool here lists. If you only know the build, call " +
-    "getBuildId or listBuildId; if you have neither, call askBrowserstackAI with product " +
+    "getBuildId or listBuildId; if you have neither, call askBrowserStackAI with product " +
     '"tra" and describe the run you mean.';
 /** A completed scan's ids come from startAccessibilityScan, or from the agent. */
 export const NEEDS_A11Y_SCAN_ID = " Requires the ids of a completed scan. They are returned by startAccessibilityScan; " +
-    'for a scan run earlier, call askBrowserstackAI with product "a11y" to locate it, since ' +
+    'for a scan run earlier, call askBrowserStackAI with product "a11y" to locate it, since ' +
     "no tool here lists past scans.";
 /** Auth-config ids are not listable by any tool here. */
 export const NEEDS_A11Y_CONFIG_ID = " Requires the numeric id returned by createAccessibilityAuthConfig. No tool here lists " +
-    "existing configurations, so if you do not have the id, call askBrowserstackAI with " +
+    "existing configurations, so if you do not have the id, call askBrowserStackAI with " +
     'product "a11y".';
 /** Test ids come from listTestIds, which itself needs a build id. */
 export const NEEDS_TEST_IDS = needsIdFrom("test ids", "listTestIds");

package/package.json

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