appium-mcp 1.84.2 → 1.85.0

package/dist/telemetry/tracer.js

@@ -0,0 +1,59 @@
+/**
+ * Shared tracer helpers for appium-mcp instrumentation. Tool, prompt, and
+ * resource wrappers use this module so span creation, exception recording, and
+ * disabled-telemetry behavior stay consistent across MCP operation types.
+ */
+import { context, SpanKind, SpanStatusCode, trace, } from '@opentelemetry/api';
+import { isTelemetryEnabled } from './attributes.js';
+const TRACER_NAME = 'appium-mcp';
+/**
+ * Gets the OpenTelemetry tracer for appium-mcp. This is used by tool, prompt,
+ * and resource wrappers to create spans with a consistent name and configuration.
+ * @returns The OpenTelemetry tracer for appium-mcp.
+ */
+export function getAppiumMcpTracer() {
+    return trace.getTracer(TRACER_NAME);
+}
+/**
+ * Gets the currently active OpenTelemetry span from the context. This is used by
+ * tool, prompt, and resource wrappers to add attributes or record exceptions on the
+ * active span without needing to pass the span object through multiple layers of calls.
+ * @returns The currently active OpenTelemetry span, or undefined if there is no active span.
+ */
+export function getActiveSpan() {
+    return trace.getActiveSpan();
+}
+/**
+ * Runs the given asynchronous operation within a new OpenTelemetry span with the specified name and attributes.
+ * If telemetry is not enabled, the operation is run without creating a span.
+ * If the operation throws an error, the error is recorded on the span and re-thrown.
+ * @param name The name of the span.
+ * @param attributes The attributes to set on the span.
+ * @param operation The asynchronous operation to run within the span.
+ * @returns The result of the asynchronous operation.
+ */
+export async function withSpan(name, attributes, operation) {
+    if (!isTelemetryEnabled()) {
+        return operation();
+    }
+    const span = getAppiumMcpTracer().startSpan(name, {
+        attributes,
+        kind: SpanKind.INTERNAL,
+    });
+    try {
+        return await context.with(trace.setSpan(context.active(), span), operation);
+    }
+    catch (error) {
+        span.recordException(error);
+        span.setStatus({
+            code: SpanStatusCode.ERROR,
+            message: error instanceof Error ? error.message : String(error),
+        });
+        throw error;
+    }
+    finally {
+        span.end();
+    }
+}
+export { SpanStatusCode };
+//# sourceMappingURL=tracer.js.map

package/dist/telemetry/tracer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracer.js","sourceRoot":"","sources":["../../src/telemetry/tracer.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,OAAO,EACP,QAAQ,EACR,cAAc,EACd,KAAK,GAEN,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAErD,MAAM,WAAW,GAAG,YAAY,CAAC;AAEjC;;;;GAIG;AACH,MAAM,UAAU,kBAAkB;IAChC,OAAO,KAAK,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;AACtC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,aAAa;IAC3B,OAAO,KAAK,CAAC,aAAa,EAAE,CAAC;AAC/B,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,IAAY,EACZ,UAAsB,EACtB,SAA2B;IAE3B,IAAI,CAAC,kBAAkB,EAAE,EAAE,CAAC;QAC1B,OAAO,SAAS,EAAE,CAAC;IACrB,CAAC;IAED,MAAM,IAAI,GAAG,kBAAkB,EAAE,CAAC,SAAS,CAAC,IAAI,EAAE;QAChD,UAAU;QACV,IAAI,EAAE,QAAQ,CAAC,QAAQ;KACxB,CAAC,CAAC;IAEH,IAAI,CAAC;QACH,OAAO,MAAM,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,IAAI,CAAC,EAAE,SAAS,CAAC,CAAC;IAC9E,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,CAAC,eAAe,CAAC,KAAc,CAAC,CAAC;QACrC,IAAI,CAAC,SAAS,CAAC;YACb,IAAI,EAAE,cAAc,CAAC,KAAK;YAC1B,OAAO,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;SAChE,CAAC,CAAC;QACH,MAAM,KAAK,CAAC;IACd,CAAC;YAAS,CAAC;QACT,IAAI,CAAC,GAAG,EAAE,CAAC;IACb,CAAC;AACH,CAAC;AAED,OAAO,EAAE,cAAc,EAAE,CAAC"}

package/dist/telemetry/wrapOperations.d.ts

@@ -0,0 +1,30 @@
+/**
+ * FastMCP operation wrappers that create spans around registered MCP handlers.
+ * Installing these wrappers before built-in and plugin registration covers
+ * tools, prompts, resources, and resource templates without changing handler
+ * return values or recording sensitive request/response payloads.
+ */
+import type { FastMCP } from 'fastmcp';
+type ToolDef = Parameters<FastMCP['addTool']>[0];
+/**
+ * Installs telemetry wrappers on the given FastMCP server instance. This should be
+ * called early in the server setup process, before registering any tools, prompts,
+ * or resources, to ensure that all operations are wrapped with OpenTelemetry spans.
+ * Each span will be named according to the operation type and include attributes
+ * such as tool name, prompt name, resource URI, session ID, and input keys, while
+ * avoiding any sensitive information.
+ * @param server The FastMCP server instance on which to install telemetry wrappers.
+ */
+export declare function installTelemetryWrappers(server: FastMCP): void;
+/**
+ * Wraps a tool definition with telemetry spans around its execute function.
+ * The span will be named "tools/call {toolName}" and include attributes for the tool name,
+ * session ID (if available), and input keys. If the tool execution results in an error,
+ * the span status will be set to error and an attribute will indicate that the result is an error.
+ * @param toolDef The original tool definition to wrap.
+ * @returns A new tool definition with telemetry spans around the execute function.
+ */
+export declare function wrapToolWithTelemetry(toolDef: ToolDef): ToolDef;
+export declare function safeInputValueAttributes(args: unknown): Record<string, string | number | boolean | string[]>;
+export {};
+//# sourceMappingURL=wrapOperations.d.ts.map

package/dist/telemetry/wrapOperations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wrapOperations.d.ts","sourceRoot":"","sources":["../../src/telemetry/wrapOperations.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAWvC,KAAK,OAAO,GAAG,UAAU,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAUjD;;;;;;;;GAQG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAmC9D;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAwB/D;AAED,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,OAAO,GACZ,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,EAAE,CAAC,CAmBtD"}

package/dist/telemetry/wrapOperations.js

@@ -0,0 +1,156 @@
+/**
+ * FastMCP operation wrappers that create spans around registered MCP handlers.
+ * Installing these wrappers before built-in and plugin registration covers
+ * tools, prompts, resources, and resource templates without changing handler
+ * return values or recording sensitive request/response payloads.
+ */
+import { isArgumentValueTelemetryEnabled, safeAttributeValue, safeInputKeys, safeSessionId, } from './attributes.js';
+import { getActiveSpan, SpanStatusCode, withSpan } from './tracer.js';
+import { isSensitiveKey } from '../utils/sensitive.js';
+/**
+ * Installs telemetry wrappers on the given FastMCP server instance. This should be
+ * called early in the server setup process, before registering any tools, prompts,
+ * or resources, to ensure that all operations are wrapped with OpenTelemetry spans.
+ * Each span will be named according to the operation type and include attributes
+ * such as tool name, prompt name, resource URI, session ID, and input keys, while
+ * avoiding any sensitive information.
+ * @param server The FastMCP server instance on which to install telemetry wrappers.
+ */
+export function installTelemetryWrappers(server) {
+    const originalAddTool = server.addTool.bind(server);
+    server.addTool = ((toolDef) => originalAddTool(wrapToolWithTelemetry(toolDef)));
+    if (typeof server.addPrompt === 'function') {
+        const originalAddPrompt = server.addPrompt.bind(server);
+        server.addPrompt = ((promptDef) => originalAddPrompt(wrapPromptWithTelemetry(promptDef)));
+    }
+    if (typeof server.addResource === 'function') {
+        const originalAddResource = server.addResource.bind(server);
+        server.addResource = ((resourceDef) => originalAddResource(wrapResourceWithTelemetry(resourceDef)));
+    }
+    if (typeof server.addResourceTemplate === 'function') {
+        const originalAddResourceTemplate = server.addResourceTemplate.bind(server);
+        server.addResourceTemplate = ((resourceTemplateDef) => originalAddResourceTemplate(wrapResourceTemplateWithTelemetry(resourceTemplateDef)));
+    }
+}
+/**
+ * Wraps a tool definition with telemetry spans around its execute function.
+ * The span will be named "tools/call {toolName}" and include attributes for the tool name,
+ * session ID (if available), and input keys. If the tool execution results in an error,
+ * the span status will be set to error and an attribute will indicate that the result is an error.
+ * @param toolDef The original tool definition to wrap.
+ * @returns A new tool definition with telemetry spans around the execute function.
+ */
+export function wrapToolWithTelemetry(toolDef) {
+    const execute = toolDef.execute;
+    if (!execute) {
+        return toolDef;
+    }
+    const toolName = toolDef.name ?? 'unknown_tool';
+    return {
+        ...toolDef,
+        execute: async (args, context) => withSpan(`tools/call ${toolName}`, toolAttributes(toolName, args), async () => {
+            const result = await execute(args, context);
+            if (isErrorResult(result)) {
+                getActiveSpan()?.setStatus({ code: SpanStatusCode.ERROR });
+                getActiveSpan()?.setAttribute('mcp.tool.result.is_error', true);
+            }
+            return result;
+        }),
+    };
+}
+export function safeInputValueAttributes(args) {
+    if (!isArgumentValueTelemetryEnabled()) {
+        return {};
+    }
+    if (!args || typeof args !== 'object' || Array.isArray(args)) {
+        return {};
+    }
+    const attributes = {};
+    for (const [key, value] of Object.entries(args)) {
+        // do not include sensitive keys as attributes, and avoid logging large strings or buffers
+        if (isSensitiveKey(key)) {
+            continue;
+        }
+        attributes[`mcp.input.value.${key}`] = safeAttributeValue(value);
+    }
+    return attributes;
+}
+/**
+ * Wraps a prompt definition with telemetry spans around its load function.
+ * The span will be named "prompts/get {promptName}" and include attributes for the prompt name
+ * and input keys. If the prompt load results in an error, the span status will be set to error
+ * and an attribute will indicate that the result is an error.
+ * @param promptDef The original prompt definition to wrap.
+ * @returns A new prompt definition with telemetry spans around the load function.
+ */
+function wrapPromptWithTelemetry(promptDef) {
+    const load = promptDef.load;
+    if (!load) {
+        return promptDef;
+    }
+    const promptName = promptDef.name ?? 'unknown_prompt';
+    return {
+        ...promptDef,
+        load: async (args, auth) => withSpan(`prompts/get ${promptName}`, {
+            'mcp.prompt.name': promptName,
+            ...inputAttributes(args),
+        }, () => load(args, auth)),
+    };
+}
+function wrapResourceWithTelemetry(resourceDef) {
+    const load = resourceDef.load;
+    if (!load) {
+        return resourceDef;
+    }
+    const uri = resourceDef.uri ?? 'unknown_resource';
+    return {
+        ...resourceDef,
+        load: async () => withSpan('resources/read', {
+            'mcp.resource.uri': uri,
+        }, () => load()),
+    };
+}
+function wrapResourceTemplateWithTelemetry(resourceTemplateDef) {
+    const load = resourceTemplateDef.load;
+    if (!load) {
+        return resourceTemplateDef;
+    }
+    const uriTemplate = resourceTemplateDef.uriTemplate?.toString() ?? 'unknown_resource_template';
+    return {
+        ...resourceTemplateDef,
+        load: async (args, auth) => withSpan('resources/read', {
+            'mcp.resource.uri_template': uriTemplate,
+            ...inputAttributes(args),
+        }, () => load(args, auth)),
+    };
+}
+function toolAttributes(toolName, args) {
+    const attributes = {
+        'mcp.tool.name': toolName,
+    };
+    const sessionId = safeSessionId(args);
+    if (sessionId) {
+        attributes['appium.session.id'] = sessionId;
+    }
+    return {
+        ...attributes,
+        ...inputAttributes(args),
+    };
+}
+function inputAttributes(args) {
+    return {
+        ...inputKeyAttributes(args),
+        ...safeInputValueAttributes(args),
+    };
+}
+function inputKeyAttributes(args) {
+    const inputKeys = safeInputKeys(args);
+    return inputKeys.length > 0 ? { 'mcp.input.keys': inputKeys } : {};
+}
+function isErrorResult(result) {
+    return (!!result &&
+        typeof result === 'object' &&
+        'isError' in result &&
+        result.isError === true);
+}
+//# sourceMappingURL=wrapOperations.js.map

package/dist/telemetry/wrapOperations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wrapOperations.js","sourceRoot":"","sources":["../../src/telemetry/wrapOperations.ts"],"names":[],"mappings":"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"}

package/dist/tools/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,KAAK,EAAiB,OAAO,EAAE,MAAM,SAAS,CAAC;AAsCtD,MAAM,CAAC,OAAO,UAAU,aAAa,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAmJ3D"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,KAAK,EAAiB,OAAO,EAAE,MAAM,SAAS,CAAC;AAuCtD,MAAM,CAAC,OAAO,UAAU,aAAa,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAsI3D"}

package/dist/tools/index.js

@@ -1,4 +1,5 @@
 import log from '../logger.js';
+import { isSensitiveKey } from '../utils/sensitive.js';
 import session from './session/session.js';
 import generateLocators from './test-generation/locators.js';
 import selectDevice from './session/select-device.js';
@@ -41,24 +42,13 @@ export default function registerTools(server) {
         if (typeof originalExecute !== 'function') {
             return originalAddTool(toolDef);
         }
-        const SENSITIVE_KEYS = [
-            'password',
-            'token',
-            'accesstoken',
-            'authorization',
-            'apikey',
-            'secret',
-            'clientsecret',
-            'remoteserverurl',
-        ];
         const redactArgs = (obj) => {
             if (obj === undefined || obj === null) {
                 return obj;
             }
             try {
                 return JSON.parse(JSON.stringify(obj, (key, value) => {
-                    if (key &&
-                        SENSITIVE_KEYS.some((k) => key.toLowerCase().includes(k))) {
+                    if (key && isSensitiveKey(key)) {
                         return '[REDACTED]';
                     }
                     // Avoid logging extremely large buffers/strings

package/dist/tools/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"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"}

package/dist/utils/env.d.ts

@@ -0,0 +1,2 @@
+export declare function isTruthyEnvValue(value: string | undefined): boolean;
+//# sourceMappingURL=env.d.ts.map

package/dist/utils/env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../../src/utils/env.ts"],"names":[],"mappings":"AAEA,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAEnE"}

package/dist/utils/env.js

@@ -0,0 +1,5 @@
+const TRUE_VALUES = new Set(['1', 'true', 'yes', 'on']);
+export function isTruthyEnvValue(value) {
+    return TRUE_VALUES.has(value?.trim().toLowerCase() ?? '');
+}
+//# sourceMappingURL=env.js.map

package/dist/utils/env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.js","sourceRoot":"","sources":["../../src/utils/env.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC;AAExD,MAAM,UAAU,gBAAgB,CAAC,KAAyB;IACxD,OAAO,WAAW,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC;AAC5D,CAAC"}

package/dist/utils/sensitive.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Determines if a given key is considered sensitive based on whether it includes any of the defined sensitive key parts.
+ * The check is case-insensitive and ignores non-alphanumeric characters, so keys like "API-Key", "client secret", or "remote_server_url" would all be correctly identified as sensitive.
+ * @param key The key to check for sensitivity.
+ * @returns True if the key is considered sensitive, false otherwise.
+ */
+export declare function isSensitiveKey(key: string): boolean;
+//# sourceMappingURL=sensitive.d.ts.map

package/dist/utils/sensitive.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sensitive.d.ts","sourceRoot":"","sources":["../../src/utils/sensitive.ts"],"names":[],"mappings":"AAcA;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAKnD"}

package/dist/utils/sensitive.js

@@ -0,0 +1,27 @@
+const SENSITIVE_KEY_PARTS = [
+    'api_key',
+    'apikey',
+    'authorization',
+    'client_secret',
+    'clientsecret',
+    'credential',
+    'password',
+    'remote_server_url',
+    'remoteserverurl',
+    'secret',
+    'token',
+];
+/**
+ * Determines if a given key is considered sensitive based on whether it includes any of the defined sensitive key parts.
+ * The check is case-insensitive and ignores non-alphanumeric characters, so keys like "API-Key", "client secret", or "remote_server_url" would all be correctly identified as sensitive.
+ * @param key The key to check for sensitivity.
+ * @returns True if the key is considered sensitive, false otherwise.
+ */
+export function isSensitiveKey(key) {
+    const normalized = normalizeKey(key);
+    return SENSITIVE_KEY_PARTS.some((part) => normalized.includes(normalizeKey(part)));
+}
+function normalizeKey(key) {
+    return key.replace(/[^a-zA-Z0-9]/g, '').toLowerCase();
+}
+//# sourceMappingURL=sensitive.js.map

package/dist/utils/sensitive.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sensitive.js","sourceRoot":"","sources":["../../src/utils/sensitive.ts"],"names":[],"mappings":"AAAA,MAAM,mBAAmB,GAAG;IAC1B,SAAS;IACT,QAAQ;IACR,eAAe;IACf,eAAe;IACf,cAAc;IACd,YAAY;IACZ,UAAU;IACV,mBAAmB;IACnB,iBAAiB;IACjB,QAAQ;IACR,OAAO;CACR,CAAC;AAEF;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,GAAW;IACxC,MAAM,UAAU,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC;IACrC,OAAO,mBAAmB,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CACvC,UAAU,CAAC,QAAQ,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CACxC,CAAC;AACJ,CAAC;AAED,SAAS,YAAY,CAAC,GAAW;IAC/B,OAAO,GAAG,CAAC,OAAO,CAAC,eAAe,EAAE,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;AACxD,CAAC"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "appium-mcp",
   "mcpName": "io.github.appium/appium-mcp",
-  "version": "1.84.2",
+  "version": "1.85.0",
   "type": "module",
   "repository": {
     "type": "git",
@@ -32,6 +32,11 @@
     "start:stdio": "node dist/index.js",
     "start:httpStream": "node dist/index.js --httpStream",
     "start:httpStream:port": "node dist/index.js --httpStream --port=",
+    "telemetry:jaeger:start": "sh tools/telemetry/jaeger.sh start",
+    "telemetry:jaeger:stop": "sh tools/telemetry/jaeger.sh stop",
+    "telemetry:jaeger:logs": "sh tools/telemetry/jaeger.sh logs",
+    "telemetry:jaeger:config": "sh tools/telemetry/jaeger.sh config",
+    "telemetry:appium:start:httpStream": "APPIUM_MCP_OTEL_ENABLED=true OTEL_SERVICE_NAME=appium-mcp-local OTEL_EXPORTER_OTLP_TRACES_ENDPOINT=http://127.0.0.1:4318/v1/traces OTEL_TRACES_SAMPLER=parentbased_always_on npm run start:httpStream",
     "dev": "npx fastmcp dev src/index.js",
     "inspect": "npx fastmcp inspect src/index.js",
     "dev:built": "node dist/index.js",
@@ -55,6 +60,10 @@
     "@appium/mcp-documentation": "^1.0.1",
     "@appium/support": "^7.0.2",
     "@modelcontextprotocol/sdk": "^1.22.0",
+    "@opentelemetry/api": "^1.9.1",
+    "@opentelemetry/exporter-trace-otlp-http": "^0.218.0",
+    "@opentelemetry/sdk-node": "^0.218.0",
+    "@xenova/transformers": "^2.17.2",
     "@xmldom/xmldom": "^0.9.8",
     "appium-adb": "^15.0.0",
     "appium-ios-device": "^3.1.0",

package/server.json

@@ -3,12 +3,12 @@
   "name": "io.github.appium/appium-mcp",
   "title": "MCP Appium - Mobile Development and Automation Server",
   "description": "MCP server for Appium mobile automation on iOS and Android devices with test creation tools.",
-  "version": "1.84.2",
+  "version": "1.85.0",
   "packages": [
     {
       "registryType": "npm",
       "identifier": "appium-mcp",
-      "version": "1.84.2",
+      "version": "1.85.0",
       "transport": {
         "type": "stdio"
       }

package/src/core.ts

@@ -21,6 +21,8 @@ export {
   PluginManager,
   verifyAppiumMcpNames,
 } from './plugin.js';
+export { isTelemetryEnabled } from './telemetry/attributes.js';
+export { getAppiumMcpTracer, withSpan } from './telemetry/tracer.js';
 export type {
   AppiumMcpPlugin,
   PluginContext,

package/src/create-server.ts

@@ -5,7 +5,7 @@
  * ```ts
  * import { createAppiumMcpServer } from 'appium-mcp/core';
  *
- * const server = createAppiumMcpServer({
+ * const server = await createAppiumMcpServer({
  *   plugins: [new CheckoutPlugin(), new LoginGuardPlugin()],
  * });
  *
@@ -22,6 +22,8 @@ import log from './logger.js';
 import { PluginManager } from './plugin.js';
 import type { AppiumMcpPlugin } from './plugin.js';
 import { installPolicy, type AppiumMcpPolicy } from './policy.js';
+import { initializeOpenTelemetry } from './telemetry/init.js';
+import { installTelemetryWrappers } from './telemetry/wrapOperations.js';
 
 const SERVER_VERSION = pkg.version as `${number}.${number}.${number}`;
 
@@ -82,11 +84,11 @@ type DisconnectSessionPolicy = 'delete_all' | 'skip';
  * server.  It replicates the setup that the default `server.ts` performs, while
  * also registering plugin tools and lifecycle hooks.
  *
- * @returns A configured `FastMCP` instance ready to be `start()`-ed.
+ * @returns A promise resolving to a configured `FastMCP` instance ready to be `start()`-ed.
  */
-export function createAppiumMcpServer(
+export async function createAppiumMcpServer(
   options: CreateAppiumMcpServerOptions = {}
-): FastMCP {
+): Promise<FastMCP> {
   const {
     plugins = [],
     serverName = 'MCP Appium',
@@ -110,6 +112,8 @@ export function createAppiumMcpServer(
   });
 
   installPolicy(server, policy);
+  await initializeOpenTelemetry();
+  installTelemetryWrappers(server);
 
   // -------------------------------------------------------------------------
   // 1. Install plugin hooks BEFORE registering any tools so that every built-in

package/src/server.ts

@@ -8,5 +8,5 @@ try {
   plugins.push(new AppiumDocumentation());
 } catch (_err) {}
 
-const server = createAppiumMcpServer({ plugins });
+const server = await createAppiumMcpServer({ plugins });
 export default server;

package/src/session-store.ts

@@ -1,5 +1,5 @@
-import { AndroidUiautomator2Driver } from 'appium-uiautomator2-driver';
-import { XCUITestDriver } from 'appium-xcuitest-driver';
+import type { AndroidUiautomator2Driver } from 'appium-uiautomator2-driver';
+import type { XCUITestDriver } from 'appium-xcuitest-driver';
 import type { Client } from 'webdriver';
 import log from './logger.js';
 import {
@@ -58,9 +58,7 @@ export const PLATFORM = {
 export function isRemoteDriverSession(driver: NullableDriverInstance): boolean {
   if (driver) {
     return (
-      !(driver instanceof AndroidUiautomator2Driver) &&
       driver.constructor?.name !== 'AndroidUiautomator2Driver' &&
-      !(driver instanceof XCUITestDriver) &&
       driver.constructor?.name !== 'XCUITestDriver'
     );
   }
@@ -82,10 +80,7 @@ export function isRemoteDriverSession(driver: NullableDriverInstance): boolean {
 export function isAndroidUiautomator2DriverSession(
   driver: NullableDriverInstance
 ): driver is AndroidUiautomator2Driver {
-  return (
-    driver instanceof AndroidUiautomator2Driver ||
-    driver?.constructor?.name === 'AndroidUiautomator2Driver'
-  );
+  return driver?.constructor?.name === 'AndroidUiautomator2Driver';
 }
 
 /**
@@ -102,10 +97,7 @@ export function isAndroidUiautomator2DriverSession(
 export function isXCUITestDriverSession(
   driver: NullableDriverInstance
 ): driver is XCUITestDriver {
-  return (
-    driver instanceof XCUITestDriver ||
-    driver?.constructor?.name === 'XCUITestDriver'
-  );
+  return driver?.constructor?.name === 'XCUITestDriver';
 }
 
 export async function setSession(
@@ -392,16 +384,10 @@ function selectNextActiveSessionId(deletedSessionId: string): string | null {
 }
 
 export const getPlatformName = (driver: any): string => {
-  if (
-    driver instanceof AndroidUiautomator2Driver ||
-    driver?.constructor?.name === 'AndroidUiautomator2Driver'
-  ) {
+  if (driver?.constructor?.name === 'AndroidUiautomator2Driver') {
     return PLATFORM.android;
   }
-  if (
-    driver instanceof XCUITestDriver ||
-    driver?.constructor?.name === 'XCUITestDriver'
-  ) {
+  if (driver?.constructor?.name === 'XCUITestDriver') {
     return PLATFORM.ios;
   }