@smartbear/mcp 0.27.2 → 0.29.0

package/README.md

@@ -35,7 +35,7 @@ See individual guides for suggested prompts and supported tools and resources:
   - [Portal](https://developer.smartbear.com/smartbear-mcp/docs/swagger-portal-integration) - Portal and product management capabilities
   - [Studio](https://developer.smartbear.com/smartbear-mcp/docs/swagger-studio-integration) - API and Domain management capabilities, including AI-powered API generation from prompts and automatic standardization
   - [Contract Testing (PactFlow)](https://developer.smartbear.com/pactflow/default/getting-started) - Contract testing capabilities
-  - [Functional Testing](https://developer.smartbear.com/smartbear-mcp/docs/functional-testing-integration) - API test discovery capabilities
+  - [Functional Testing](https://developer.smartbear.com/smartbear-mcp/docs/swagger-functional-testing-integration) - API test discovery capabilities
 - [QMetry](https://developer.smartbear.com/smartbear-mcp/docs/qmetry-integration) - QMetry Test Management capabilities
 - [Zephyr](https://developer.smartbear.com/smartbear-mcp/docs/zephyr-integration) - Zephyr Test Management capabilities
 - [Collaborator](https://developer.smartbear.com/smartbear-mcp/docs/collaborator-integration) - Review and Remote System Configuration management capabilities

package/dist/bearq/client.js

@@ -1,8 +1,9 @@
 import { z } from "zod";
-import { USER_AGENT } from "../common/info.js";
+import { getUserAgent } from "../common/info.js";
 import { getRequestHeader } from "../common/request-context.js";
 import { ToolError } from "../common/tools.js";
 import { DEFAULT_API_BASE_URL, AUTHORIZATION_HEADER } from "./config/constants.js";
+import { ListEnvironments } from "./tool/environments/list-environments.js";
 import { ChatWithQaLead } from "./tool/tasks/chat-with-qa-lead.js";
 import { ExpandApplicationModel } from "./tool/tasks/expand-application-model.js";
 import { GetTask } from "./tool/tasks/get-task.js";
@@ -53,7 +54,7 @@ class BearQClient {
     return {
       Authorization: `Bearer ${token}`,
       "Content-Type": "application/json",
-      "User-Agent": USER_AGENT
+      "User-Agent": getUserAgent()
     };
   }
   async registerTools(register, _getInput) {
@@ -69,7 +70,8 @@ class BearQClient {
       new GetTask(this),
       new GetTaskStatus(this),
       new StopTask(this),
-      new WaitForTask(this)
+      new WaitForTask(this),
+      new ListEnvironments(this)
     ];
     for (const tool of tools) {
       register(tool.specification, tool.handle);

package/dist/bearq/tool/environments/list-environments.js

@@ -0,0 +1,28 @@
+import { z } from "zod";
+import { Tool, ToolError } from "../../../common/tools.js";
+const inputSchema = z.object({});
+class ListEnvironments extends Tool {
+  specification = {
+    title: "List Environments",
+    toolset: "Environments",
+    summary: "Lists the environments configured in the workspace. Use this to discover valid environment names to pass to the test-running tools, and to identify the workspace default.",
+    inputSchema,
+    readOnly: true
+  };
+  handle = async (_args) => {
+    const res = await fetch(`${this.client.getBaseUrl()}/environments`, {
+      method: "GET",
+      headers: this.client.getHeaders()
+    });
+    if (!res.ok)
+      throw new ToolError(
+        `GET /environments failed: ${res.status} ${res.statusText}`
+      );
+    return {
+      content: [{ type: "text", text: JSON.stringify(await res.json()) }]
+    };
+  };
+}
+export {
+  ListEnvironments
+};

package/dist/bearq/tool/tasks/run-regression-tests.js

@@ -1,6 +1,10 @@
 import { z } from "zod";
 import { Tool, ToolError } from "../../../common/tools.js";
-const inputSchema = z.object({});
+const inputSchema = z.object({
+  environment: z.string().min(1).optional().describe(
+    "Target environment name to run tests against. Omit to use the workspace default."
+  )
+});
 class RunRegressionTests extends Tool {
   specification = {
     title: "Run Regression Tests",
@@ -8,11 +12,14 @@ class RunRegressionTests extends Tool {
     summary: "Runs the full BearQ regression suite — every regression-ready test case in the workspace. Use for CI/CD or pre-release smoke.",
     inputSchema
   };
-  handle = async (_args) => {
+  handle = async (args) => {
+    const { environment } = inputSchema.parse(args);
+    const body = { agent: "tester", mode: "run" };
+    if (environment !== void 0) body.environment = environment;
     const res = await fetch(`${this.client.getBaseUrl()}/tasks`, {
       method: "POST",
       headers: this.client.getHeaders(),
-      body: JSON.stringify({ agent: "tester", mode: "run" })
+      body: JSON.stringify(body)
     });
     if (!res.ok)
       throw new ToolError(

package/dist/bearq/tool/tasks/run-test-cases.js

@@ -1,7 +1,10 @@
 import { z } from "zod";
 import { Tool, ToolError } from "../../../common/tools.js";
 const inputSchema = z.object({
-  testCaseIds: z.array(z.number().int().positive()).min(1).describe("IDs of BearQ regression test cases to run.")
+  testCaseIds: z.array(z.number().int().positive()).min(1).describe("IDs of BearQ regression test cases to run."),
+  environment: z.string().min(1).optional().describe(
+    "Target environment name to run tests against. Omit to use the workspace default."
+  )
 });
 class RunTestCases extends Tool {
   specification = {
@@ -11,11 +14,17 @@ class RunTestCases extends Tool {
     inputSchema
   };
   handle = async (args) => {
-    const { testCaseIds } = inputSchema.parse(args);
+    const { testCaseIds, environment } = inputSchema.parse(args);
+    const body = {
+      agent: "tester",
+      mode: "run",
+      testCaseIds
+    };
+    if (environment !== void 0) body.environment = environment;
     const res = await fetch(`${this.client.getBaseUrl()}/tasks`, {
       method: "POST",
       headers: this.client.getHeaders(),
-      body: JSON.stringify({ agent: "tester", mode: "run", testCaseIds })
+      body: JSON.stringify(body)
     });
     if (!res.ok)
       throw new ToolError(

package/dist/bearq/tool/tasks/run-tests-in-functional-areas.js

@@ -1,7 +1,10 @@
 import { z } from "zod";
 import { Tool, ToolError } from "../../../common/tools.js";
 const inputSchema = z.object({
-  functionalAreas: z.array(z.union([z.number().int().positive(), z.string().min(1)])).min(1).describe("Functional areas to target, by ID or name.")
+  functionalAreas: z.array(z.union([z.number().int().positive(), z.string().min(1)])).min(1).describe("Functional areas to target, by ID or name."),
+  environment: z.string().min(1).optional().describe(
+    "Target environment name to run tests against. Omit to use the workspace default."
+  )
 });
 class RunTestsInFunctionalAreas extends Tool {
   specification = {
@@ -11,11 +14,17 @@ class RunTestsInFunctionalAreas extends Tool {
     inputSchema
   };
   handle = async (args) => {
-    const { functionalAreas } = inputSchema.parse(args);
+    const { functionalAreas, environment } = inputSchema.parse(args);
+    const body = {
+      agent: "tester",
+      mode: "run",
+      functionalAreas
+    };
+    if (environment !== void 0) body.environment = environment;
     const res = await fetch(`${this.client.getBaseUrl()}/tasks`, {
       method: "POST",
       headers: this.client.getHeaders(),
-      body: JSON.stringify({ agent: "tester", mode: "run", functionalAreas })
+      body: JSON.stringify(body)
     });
     if (!res.ok)
       throw new ToolError(

package/dist/bugsnag/client.js

@@ -1,5 +1,5 @@
 import { z } from "zod";
-import { USER_AGENT } from "../common/info.js";
+import { getUserAgent } from "../common/info.js";
 import { getRequestHeader } from "../common/request-context.js";
 import { ToolError } from "../common/tools.js";
 import { CurrentUserAPI } from "./client/api/CurrentUser.js";
@@ -123,7 +123,7 @@ class BugsnagClient {
         );
       },
       headers: {
-        "User-Agent": USER_AGENT,
+        "User-Agent": getUserAgent(),
         "Content-Type": "application/json",
         "X-Bugsnag-API": "true",
         "X-Version": "2"

package/dist/collaborator/client.js

@@ -1,5 +1,5 @@
 import { z } from "zod";
-import { USER_AGENT } from "../common/info.js";
+import { getUserAgent } from "../common/info.js";
 import { getRequestHeader } from "../common/request-context.js";
 const ConfigurationSchema = z.object({
   base_url: z.url().describe("Collaborator server base URL"),
@@ -48,7 +48,10 @@ class CollaboratorClient {
     ];
     const response = await fetch(url, {
       method: "POST",
-      headers: { "Content-Type": "application/json", "User-Agent": USER_AGENT },
+      headers: {
+        "Content-Type": "application/json",
+        "User-Agent": getUserAgent()
+      },
       body: JSON.stringify(body)
     });
     if (!response.ok) {

package/dist/common/client-identity.js

@@ -0,0 +1,20 @@
+import { getRequestContext } from "./request-context.js";
+function toClientIdentity(info, protocolVersion) {
+  return {
+    name: info?.name,
+    version: info?.version,
+    protocolVersion
+  };
+}
+let processClientIdentity;
+function setProcessClientIdentity(identity) {
+  processClientIdentity = identity;
+}
+function getCurrentClientIdentity() {
+  return getRequestContext()?.mcpClient ?? processClientIdentity;
+}
+export {
+  getCurrentClientIdentity,
+  setProcessClientIdentity,
+  toClientIdentity
+};

package/dist/common/info.js

@@ -1,11 +1,31 @@
 import packageJson from "../package.json.js";
+import { getCurrentClientIdentity } from "./client-identity.js";
 const MCP_SERVER_NAME = packageJson.config.mcpServerName;
 const MCP_SERVER_VERSION = packageJson.version;
 const MCP_TRANSPORT = process.env.MCP_TRANSPORT?.toLowerCase().trim() || "stdio";
 const USER_AGENT = `${MCP_SERVER_NAME}/${MCP_SERVER_VERSION} ${MCP_TRANSPORT}`;
+function sanitizeUserAgentToken(value) {
+  return value.replace(/[()\r\n;]/g, "").trim();
+}
+function clientIdentitySuffix(identity) {
+  if (!identity?.name) {
+    return "";
+  }
+  const clientName = sanitizeUserAgentToken(identity.name) || "unknown";
+  const version = identity.version ? sanitizeUserAgentToken(identity.version) || "unknown" : "unknown";
+  return ` (client: ${clientName}; clientVersion: ${version})`;
+}
+function appendClientIdentity(baseUserAgent) {
+  return baseUserAgent + clientIdentitySuffix(getCurrentClientIdentity());
+}
+function getUserAgent() {
+  return appendClientIdentity(USER_AGENT);
+}
 export {
   MCP_SERVER_NAME,
   MCP_SERVER_VERSION,
   MCP_TRANSPORT,
-  USER_AGENT
+  USER_AGENT,
+  appendClientIdentity,
+  getUserAgent
 };

package/dist/common/initialize.js

@@ -0,0 +1,29 @@
+import { toClientIdentity, setProcessClientIdentity } from "./client-identity.js";
+function handleInitializeMessage(server, message) {
+  if (typeof message !== "object" || message === null || !("method" in message) || message.method !== "initialize") {
+    return;
+  }
+  const params = message.params;
+  const identity = toClientIdentity(
+    params?.clientInfo,
+    params?.protocolVersion
+  );
+  server.setMcpClientIdentity(identity);
+  setProcessClientIdentity(identity);
+  const clientInfo = params?.clientInfo;
+  if (clientInfo) {
+    server.setClientInfo(clientInfo);
+  }
+  if (params?.protocolVersion === "2025-11-25") {
+    const clientCapabilities = params.capabilities ?? {};
+    if (Object.hasOwn(clientCapabilities, "sampling")) {
+      server.setSamplingSupported(true);
+    }
+    if (Object.hasOwn(clientCapabilities, "elicitation")) {
+      server.setElicitationSupported(true);
+    }
+  }
+}
+export {
+  handleInitializeMessage
+};

package/dist/common/request-context.js

@@ -6,6 +6,12 @@ function withRequestContext(req, fn) {
 function getRequestContext() {
   return requestContextStorage.getStore();
 }
+function setRequestMcpClient(identity) {
+  const context = getRequestContext();
+  if (context) {
+    context.mcpClient = identity;
+  }
+}
 function getRequestHeader(name) {
   const context = getRequestContext();
   if (!context?.headers) return void 0;
@@ -16,5 +22,6 @@ export {
   getRequestContext,
   getRequestHeader,
   requestContextStorage,
+  setRequestMcpClient,
   withRequestContext
 };

package/dist/common/server.js

@@ -2,6 +2,7 @@ import { McpServer, ResourceTemplate } from "@modelcontextprotocol/sdk/server/mc
 import { ZodObject, ZodIntersection } from "zod";
 import Bugsnag from "./bugsnag.js";
 import { CacheService } from "./cache.js";
+import { toClientIdentity } from "./client-identity.js";
 import { MCP_SERVER_VERSION, MCP_SERVER_NAME } from "./info.js";
 import { executeElicitationOrPolyfill, isElicitationPolyfillResult } from "./pollyfills.js";
 import { ToolError } from "./tools.js";
@@ -10,8 +11,10 @@ class SmartBearMcpServer extends McpServer {
   cache;
   samplingSupported = false;
   elicitationSupported = false;
+  clientInfo;
   clients = [];
   enabledToolsets;
+  mcpClientIdentity;
   constructor(enabledToolsets) {
     super(
       {
@@ -48,9 +51,42 @@ class SmartBearMcpServer extends McpServer {
   isElicitationSupported() {
     return this.elicitationSupported;
   }
+  setClientInfo(info) {
+    this.clientInfo = info;
+  }
+  getClientInfo() {
+    return this.clientInfo;
+  }
   getClients() {
     return this.clients;
   }
+  /**
+   * Record the MCP client identity reported in the `initialize` handshake.
+   * Captured once per session by the transport layer.
+   */
+  setMcpClientIdentity(identity) {
+    this.mcpClientIdentity = identity;
+  }
+  /**
+   * Return the MCP client identity for this session. Prefers the value captured
+   * at `initialize`; falls back to the SDK's `getClientVersion()` so callers
+   * still get an answer if the explicit capture was skipped.
+   */
+  getMcpClientIdentity() {
+    return this.mcpClientIdentity ?? toClientIdentity(this.server.getClientVersion());
+  }
+  /**
+   * Attach MCP client attribution to a Bugsnag event so errors can be segmented
+   * by originating client/marketplace.
+   */
+  addClientMetadata(event) {
+    const identity = this.getMcpClientIdentity();
+    event.addMetadata("mcpClient", {
+      mcp_client_name: identity.name ?? null,
+      mcp_client_version: identity.version ?? null,
+      mcp_protocol_version: identity.protocolVersion ?? null
+    });
+  }
   async cleanupSession(mcpSessionId) {
     for (const client of this.clients) {
       await client.cleanupSession?.(mcpSessionId);
@@ -106,6 +142,7 @@ class SmartBearMcpServer extends McpServer {
               } else {
                 Bugsnag.notify(e, (event) => {
                   event.addMetadata("app", { tool: toolName });
+                  this.addClientMetadata(event);
                   event.unhandled = true;
                 });
               }
@@ -156,6 +193,7 @@ ${result.instructions}`
                   resource: resourceName,
                   url: url2
                 });
+                this.addClientMetadata(event);
                 event.unhandled = true;
               });
               throw e;
@@ -181,6 +219,7 @@ ${result.instructions}`
                 event.addMetadata("app", {
                   prompt: this.getCapabilityName(client, params.title)
                 });
+                this.addClientMetadata(event);
                 event.unhandled = true;
               });
               throw e;

package/dist/common/transport-http.js

@@ -5,7 +5,8 @@ import { SSEServerTransport } from "@modelcontextprotocol/sdk/server/sse.js";
 import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
 import { isInitializeRequest } from "@modelcontextprotocol/sdk/types.js";
 import { clientRegistry } from "./client-registry.js";
-import { withRequestContext } from "./request-context.js";
+import { handleInitializeMessage } from "./initialize.js";
+import { withRequestContext, setRequestMcpClient } from "./request-context.js";
 import { SmartBearMcpServer } from "./server.js";
 import { isDraining, registerShutdownHandler } from "./shutdown.js";
 import { getEnvVarName } from "./transport-stdio.js";
@@ -211,19 +212,7 @@ async function createNewTransport(req, res, transports) {
       transports.set(newSessionId, { server, transport });
     }
   });
-  transport.onmessage = (message) => {
-    if ("method" in message && message.method === "initialize") {
-      if (message.params?.protocolVersion === "2025-11-25") {
-        const clientCapabilities = message.params?.capabilities;
-        if (Object.hasOwn(clientCapabilities, "sampling")) {
-          server.setSamplingSupported(true);
-        }
-        if (Object.hasOwn(clientCapabilities, "elicitation")) {
-          server.setElicitationSupported(true);
-        }
-      }
-    }
-  };
+  transport.onmessage = (message) => handleInitializeMessage(server, message);
   transport.onclose = () => {
     if (transport.sessionId) {
       console.log(`[MCP] Session closed: ${transport.sessionId}`);
@@ -280,10 +269,13 @@ async function handleStreamableHttpRequest(req, res, transports) {
       );
       return;
     }
-    await withRequestContext(
-      req,
-      async () => await transport.handleRequest(req, res, parsedBody)
-    );
+    const sessionServer = sessionId ? transports.get(sessionId)?.server : void 0;
+    await withRequestContext(req, async () => {
+      if (sessionServer) {
+        setRequestMcpClient(sessionServer.getMcpClientIdentity());
+      }
+      return await transport.handleRequest(req, res, parsedBody);
+    });
   } catch (error) {
     console.error("Error handling StreamableHTTP request:", error);
     res.writeHead(500, { "Content-Type": "text/plain" });
@@ -296,6 +288,7 @@ async function handleLegacySseRequest(req, res, transports) {
     return;
   }
   const transport = new SSEServerTransport("/message", res);
+  transport.onmessage = (message) => handleInitializeMessage(server, message);
   transports.set(transport.sessionId, { server, transport });
   res.on("close", () => {
     transports.delete(transport.sessionId);
@@ -328,14 +321,10 @@ async function handleLegacyMessageRequest(req, res, url, transports) {
   req.on("end", async () => {
     try {
       const parsedBody = JSON.parse(body);
-      await withRequestContext(
-        req,
-        async () => await session.transport.handlePostMessage(
-          req,
-          res,
-          parsedBody
-        )
-      );
+      await withRequestContext(req, async () => {
+        setRequestMcpClient(session.server.getMcpClientIdentity());
+        return await session.transport.handlePostMessage(req, res, parsedBody);
+      });
     } catch (error) {
       console.error("Error handling POST message:", error);
       res.writeHead(500, { "Content-Type": "text/plain" });

package/dist/common/transport-stdio.js

@@ -2,6 +2,7 @@ import { enableCompileCache } from "node:module";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { clientRegistry } from "./client-registry.js";
 import { USER_AGENT } from "./info.js";
+import { handleInitializeMessage } from "./initialize.js";
 import { SmartBearMcpServer } from "./server.js";
 import { registerShutdownHandler } from "./shutdown.js";
 import { isOptionalType, getTypeDescription } from "./zod-utils.js";
@@ -57,19 +58,7 @@ ${message.join("\n")}` : "No clients support environment variable configuration.
       console.error("[MCP][shutdown] Error closing stdio transport:", err);
     }
   });
-  transport.onmessage = (message) => {
-    if ("method" in message && message.method === "initialize") {
-      if (message.params?.protocolVersion === "2025-11-25") {
-        const clientCapabilities = message.params?.capabilities;
-        if (Object.hasOwn(clientCapabilities, "sampling")) {
-          server.setSamplingSupported(true);
-        }
-        if (Object.hasOwn(clientCapabilities, "elicitation")) {
-          server.setElicitationSupported(true);
-        }
-      }
-    }
-  };
+  transport.onmessage = (message) => handleInitializeMessage(server, message);
   await server.connect(transport);
 }
 function getEnvVarName(clientPrefix, key) {

package/dist/package.json.js

@@ -1,4 +1,4 @@
-const version = "0.27.2";
+const version = "0.29.0";
 const config = { "mcpServerName": "SmartBear MCP Server" };
 const packageJson = {
   version,

package/dist/pactflow/client.js

@@ -170,6 +170,10 @@ class PactflowClient {
     if (Array.isArray(contextToken)) {
       contextToken = contextToken[0];
     }
+    const clientInfo = this._server?.getClientInfo();
+    const sourceApplicationHeader = {
+      SOURCE_APPLICATION: clientInfo ? `${clientInfo.name}/${clientInfo.version}` : "unknown"
+    };
     if (contextToken) {
       let authHeader = contextToken;
       if (!contextToken.startsWith("Basic ") && !contextToken.startsWith("Bearer ")) {
@@ -178,7 +182,8 @@ class PactflowClient {
       return {
         Authorization: authHeader,
         "Content-Type": "application/json",
-        "User-Agent": USER_AGENT
+        "User-Agent": USER_AGENT,
+        ...sourceApplicationHeader
       };
     }
     if (this.token) {
@@ -189,14 +194,16 @@ class PactflowClient {
       return {
         Authorization: authHeader,
         "Content-Type": "application/json",
-        "User-Agent": USER_AGENT
+        "User-Agent": USER_AGENT,
+        ...sourceApplicationHeader
       };
     } else if (this.username && this.password) {
       const authString = `${this.username}:${this.password}`;
       return {
         Authorization: `Basic ${Buffer.from(authString).toString("base64")}`,
         "Content-Type": "application/json",
-        "User-Agent": USER_AGENT
+        "User-Agent": USER_AGENT,
+        ...sourceApplicationHeader
       };
     }
     return void 0;
@@ -1877,7 +1884,7 @@ class PactflowClient {
       `${this.baseUrl}/admin/teams/${encodeURIComponent(teamId)}/users`,
       {
         method: "PUT",
-        body: { uuids },
+        body: { users: uuids },
         errorContext: "Set Team Users"
       }
     );

package/dist/qmetry/client/api/client-api.js

@@ -1,4 +1,4 @@
-import { USER_AGENT } from "../../../common/info.js";
+import { getUserAgent } from "../../../common/info.js";
 import { QMETRY_DEFAULTS } from "../../config/constants.js";
 import { handleQMetryFetchError, handleQMetryApiError } from "./error-handler.js";
 async function qmetryRequest({
@@ -16,7 +16,7 @@ async function qmetryRequest({
   const headers = {
     apikey: token,
     project: project || QMETRY_DEFAULTS.PROJECT_KEY,
-    "User-Agent": USER_AGENT,
+    "User-Agent": getUserAgent(),
     "qmetry-source": "smartbear-mcp"
   };
   if (scopeId !== void 0) {

package/dist/qmetry/client/automation.js

@@ -1,4 +1,4 @@
-import { USER_AGENT } from "../../common/info.js";
+import { getUserAgent } from "../../common/info.js";
 import { QMETRY_DEFAULTS } from "../config/constants.js";
 import { QMETRY_PATHS } from "../config/rest-endpoints.js";
 import { DEFAULT_IMPORT_AUTOMATION_PAYLOAD } from "../types/automation.js";
@@ -91,7 +91,7 @@ async function importAutomationResults(token, baseUrl, project, payload) {
   const headers = {
     apikey: token,
     project: finalPayload.projectID || project || QMETRY_DEFAULTS.PROJECT_KEY,
-    "User-Agent": USER_AGENT,
+    "User-Agent": getUserAgent(),
     "qmetry-source": "smartbear-mcp"
     // Note: Content-Type will be set automatically by fetch for FormData
   };

package/dist/qtm4j/http/auth-service.js

@@ -1,4 +1,4 @@
-import { USER_AGENT } from "../../common/info.js";
+import { getUserAgent } from "../../common/info.js";
 import { CONTENT_TYPES, HTTP_HEADERS } from "../config/constants.js";
 class AuthService {
   apiKey;
@@ -13,7 +13,7 @@ class AuthService {
     return {
       [HTTP_HEADERS.API_KEY]: this.apiKey,
       [HTTP_HEADERS.CONTENT_TYPE]: CONTENT_TYPES.JSON,
-      [HTTP_HEADERS.USER_AGENT]: USER_AGENT,
+      [HTTP_HEADERS.USER_AGENT]: getUserAgent(),
       [HTTP_HEADERS.ACCEPT]: CONTENT_TYPES.JSON
     };
   }

package/dist/reflect/client.js

@@ -1,5 +1,5 @@
 import { z } from "zod";
-import { USER_AGENT } from "../common/info.js";
+import { getUserAgent } from "../common/info.js";
 import { getRequestHeader } from "../common/request-context.js";
 import { ToolError } from "../common/tools.js";
 import { API_KEY_HEADER, REFLECT_API_TOKEN_HEADER, AUTHORIZATION_HEADER } from "./config/constants.js";
@@ -73,7 +73,7 @@ class ReflectClient {
     return {
       ...this.getAuthHeader(),
       "Content-Type": "application/json",
-      "User-Agent": USER_AGENT
+      "User-Agent": getUserAgent()
     };
   }
   getSessionState(sessionId) {

package/dist/swagger/client/api.js

@@ -1,3 +1,4 @@
+import { appendClientIdentity } from "../../common/info.js";
 import { ToolError } from "../../common/tools.js";
 import { buildSubdomainCandidate, buildSuffixedSubdomain, buildPortalName, isConflictError, isOrganizationPortalConflict } from "./portal-utils.js";
 import { findTableOfContentsItem, buildPortalLiveUrl, normalizeSlug } from "./utils.js";
@@ -22,7 +23,7 @@ class SwaggerAPI {
     this.userAgent = userAgent;
   }
   get headers() {
-    return this.config.getHeaders(this.userAgent);
+    return this.config.getHeaders(appendClientIdentity(this.userAgent));
   }
   /**
    * Core response parsing logic shared between different response handlers.
@@ -677,7 +678,8 @@ class SwaggerAPI {
       contentType = "markdown",
       source = "internal",
       order = 0,
-      parentId = null
+      parentId = null,
+      pageSlug
     } = args;
     if (contentType === "html" && source === "internal" && pageContent !== void 0) {
       throw new ToolError(
@@ -694,12 +696,12 @@ class SwaggerAPI {
       );
     }
     const section = sections.items[0];
-    const pageSlug = normalizeSlug(pageTitle);
+    const resolvedPageSlug = pageSlug || normalizeSlug(pageTitle);
     const normalizedTitle = pageTitle.slice(0, 255);
     const tocItem = await this.createTableOfContents(section.id, {
       type: "new",
       title: normalizedTitle,
-      slug: pageSlug,
+      slug: resolvedPageSlug,
       order,
       parentId,
       content: {
@@ -724,7 +726,7 @@ class SwaggerAPI {
       sectionSlug: section.slug,
       pageDetails: {
         tableOfContentsId: tocItem.id,
-        slug: pageSlug,
+        slug: resolvedPageSlug,
         title: normalizedTitle,
         content: {
           type: contentType,