@mapbox/mcp-server 0.5.5 → 0.6.1

package/dist/commonjs/tools/version-tool/VersionTool.js

@@ -1,11 +1,14 @@
 "use strict";
-// Copyright (c) Mapbox, Inc.
-// Licensed under the MIT License.
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.VersionTool = void 0;
+const api_1 = require("@opentelemetry/api");
+const tracing_js_1 = require("../../utils/tracing.js");
+// Copyright (c) Mapbox, Inc.
+// Licensed under the MIT License.
 const BaseTool_js_1 = require("../BaseTool.js");
 const versionUtils_js_1 = require("../../utils/versionUtils.js");
-const VersionTool_schema_js_1 = require("./VersionTool.schema.js");
+const VersionTool_input_schema_js_1 = require("./VersionTool.input.schema.js");
+const VersionTool_output_schema_js_1 = require("./VersionTool.output.schema.js");
 class VersionTool extends BaseTool_js_1.BaseTool {
     name = 'version_tool';
     description = 'Get the current version information of the MCP server';
@@ -17,36 +20,48 @@ class VersionTool extends BaseTool_js_1.BaseTool {
         openWorldHint: false
     };
     constructor() {
-        super({ inputSchema: VersionTool_schema_js_1.VersionSchema });
+        super({
+            inputSchema: VersionTool_input_schema_js_1.VersionSchema,
+            outputSchema: VersionTool_output_schema_js_1.VersionResponseSchema
+        });
     }
     // eslint-disable-next-line @typescript-eslint/no-unused-vars
     async run(_rawInput) {
-        try {
-            const versionInfo = (0, versionUtils_js_1.getVersionInfo)();
-            const versionText = `MCP Server Version Information:
-- Name: ${versionInfo.name}
-- Version: ${versionInfo.version}
-- SHA: ${versionInfo.sha}
-- Tag: ${versionInfo.tag}
-- Branch: ${versionInfo.branch}`;
-            return {
-                content: [{ type: 'text', text: versionText }],
-                isError: false
-            };
-        }
-        catch (error) {
-            const errorMessage = error instanceof Error ? error.message : String(error);
-            this.log('error', `${this.name}: Error during execution: ${errorMessage}`);
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: errorMessage
-                    }
-                ],
-                isError: true
-            };
-        }
+        // Create tracing context for this tool
+        const toolContext = (0, tracing_js_1.createLocalToolExecutionContext)(this.name, 0);
+        return await api_1.context.with(api_1.trace.setSpan(api_1.context.active(), toolContext.span), async () => {
+            try {
+                const versionInfo = (0, versionUtils_js_1.getVersionInfo)();
+                const versionText = `MCP Server Version Information:\n- Name: ${versionInfo.name}\n- Version: ${versionInfo.version}\n- SHA: ${versionInfo.sha}\n- Tag: ${versionInfo.tag}\n- Branch: ${versionInfo.branch}`;
+                const validatedVersionInfo = VersionTool_output_schema_js_1.VersionResponseSchema.parse(versionInfo);
+                toolContext.span.setStatus({ code: api_1.SpanStatusCode.OK });
+                toolContext.span.end();
+                return {
+                    content: [{ type: 'text', text: versionText }],
+                    structuredContent: validatedVersionInfo,
+                    isError: false
+                };
+            }
+            catch (validationError) {
+                toolContext.span.setStatus({
+                    code: api_1.SpanStatusCode.ERROR,
+                    message: validationError instanceof Error
+                        ? validationError.message
+                        : 'Unknown validation error'
+                });
+                toolContext.span.end();
+                this.log('error', `Output schema validation failed: ${validationError instanceof Error ? validationError.message : 'Unknown validation error'}`);
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: 'VersionTool: Output schema validation failed.'
+                        }
+                    ],
+                    isError: true
+                };
+            }
+        });
     }
 }
 exports.VersionTool = VersionTool;

package/dist/commonjs/tools/version-tool/VersionTool.js.map

@@ -1 +1 @@
-{"version":3,"file":"VersionTool.js","sourceRoot":"","sources":["../../../../src/tools/version-tool/VersionTool.ts"],"names":[],"mappings":";AAAA,6BAA6B;AAC7B,kCAAkC;;;AAElC,gDAA0C;AAC1C,iEAA6D;AAC7D,mEAAwD;AAExD,MAAa,WAAY,SAAQ,sBAA8B;IACpD,IAAI,GAAG,cAAc,CAAC;IACtB,WAAW,GAClB,uDAAuD,CAAC;IACjD,WAAW,GAAG;QACrB,KAAK,EAAE,0BAA0B;QACjC,YAAY,EAAE,IAAI;QAClB,eAAe,EAAE,KAAK;QACtB,cAAc,EAAE,IAAI;QACpB,aAAa,EAAE,KAAK;KACrB,CAAC;IAEF;QACE,KAAK,CAAC,EAAE,WAAW,EAAE,qCAAa,EAAE,CAAC,CAAC;IACxC,CAAC;IAED,6DAA6D;IAC7D,KAAK,CAAC,GAAG,CAAC,SAAkB;QAO1B,IAAI,CAAC;YACH,MAAM,WAAW,GAAG,IAAA,gCAAc,GAAE,CAAC;YAErC,MAAM,WAAW,GAAG;UAChB,WAAW,CAAC,IAAI;aACb,WAAW,CAAC,OAAO;SACvB,WAAW,CAAC,GAAG;SACf,WAAW,CAAC,GAAG;YACZ,WAAW,CAAC,MAAM,EAAE,CAAC;YAE3B,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;gBAC9C,OAAO,EAAE,KAAK;aACf,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,YAAY,GAChB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAEzD,IAAI,CAAC,GAAG,CACN,OAAO,EACP,GAAG,IAAI,CAAC,IAAI,6BAA6B,YAAY,EAAE,CACxD,CAAC;YAEF,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,YAAY;qBACnB;iBACF;gBACD,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC;CACF;AA1DD,kCA0DC"}
+{"version":3,"file":"VersionTool.js","sourceRoot":"","sources":["../../../../src/tools/version-tool/VersionTool.ts"],"names":[],"mappings":";;;AAAA,4CAAoE;AACpE,uDAAyE;AACzE,6BAA6B;AAC7B,kCAAkC;AAElC,gDAA0C;AAC1C,iEAA6D;AAC7D,+EAA8D;AAC9D,iFAAuE;AAGvE,MAAa,WAAY,SAAQ,sBAGhC;IACU,IAAI,GAAG,cAAc,CAAC;IACtB,WAAW,GAClB,uDAAuD,CAAC;IACjD,WAAW,GAAG;QACrB,KAAK,EAAE,0BAA0B;QACjC,YAAY,EAAE,IAAI;QAClB,eAAe,EAAE,KAAK;QACtB,cAAc,EAAE,IAAI;QACpB,aAAa,EAAE,KAAK;KACrB,CAAC;IAEF;QACE,KAAK,CAAC;YACJ,WAAW,EAAE,2CAAa;YAC1B,YAAY,EAAE,oDAAqB;SACpC,CAAC,CAAC;IACL,CAAC;IAED,6DAA6D;IAC7D,KAAK,CAAC,GAAG,CAAC,SAAkB;QAC1B,uCAAuC;QACvC,MAAM,WAAW,GAAG,IAAA,4CAA+B,EAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;QAClE,OAAO,MAAM,aAAO,CAAC,IAAI,CACvB,WAAK,CAAC,OAAO,CAAC,aAAO,CAAC,MAAM,EAAE,EAAE,WAAW,CAAC,IAAI,CAAC,EACjD,KAAK,IAAI,EAAE;YACT,IAAI,CAAC;gBACH,MAAM,WAAW,GAAG,IAAA,gCAAc,GAAE,CAAC;gBACrC,MAAM,WAAW,GAAG,4CAA4C,WAAW,CAAC,IAAI,gBAAgB,WAAW,CAAC,OAAO,YAAY,WAAW,CAAC,GAAG,YAAY,WAAW,CAAC,GAAG,eAAe,WAAW,CAAC,MAAM,EAAE,CAAC;gBAC7M,MAAM,oBAAoB,GAAG,oDAAqB,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;gBACtE,WAAW,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,oBAAc,CAAC,EAAE,EAAE,CAAC,CAAC;gBACxD,WAAW,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;gBACvB,OAAO;oBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;oBACvD,iBAAiB,EAAE,oBAAoB;oBACvC,OAAO,EAAE,KAAK;iBACf,CAAC;YACJ,CAAC;YAAC,OAAO,eAAe,EAAE,CAAC;gBACzB,WAAW,CAAC,IAAI,CAAC,SAAS,CAAC;oBACzB,IAAI,EAAE,oBAAc,CAAC,KAAK;oBAC1B,OAAO,EACL,eAAe,YAAY,KAAK;wBAC9B,CAAC,CAAC,eAAe,CAAC,OAAO;wBACzB,CAAC,CAAC,0BAA0B;iBACjC,CAAC,CAAC;gBACH,WAAW,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;gBACvB,IAAI,CAAC,GAAG,CACN,OAAO,EACP,oCAAoC,eAAe,YAAY,KAAK,CAAC,CAAC,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,CAAC,0BAA0B,EAAE,CAC9H,CAAC;gBACF,OAAO;oBACL,OAAO,EAAE;wBACP;4BACE,IAAI,EAAE,MAAe;4BACrB,IAAI,EAAE,+CAA+C;yBACtD;qBACF;oBACD,OAAO,EAAE,IAAI;iBACd,CAAC;YACJ,CAAC;QACH,CAAC,CACF,CAAC;IACJ,CAAC;CACF;AAlED,kCAkEC"}

package/dist/commonjs/tools/version-tool/VersionTool.output.schema.d.ts

@@ -0,0 +1,22 @@
+import { z } from 'zod';
+export declare const VersionResponseSchema: z.ZodObject<{
+    name: z.ZodString;
+    version: z.ZodString;
+    sha: z.ZodString;
+    tag: z.ZodString;
+    branch: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    version: string;
+    sha: string;
+    tag: string;
+    branch: string;
+}, {
+    name: string;
+    version: string;
+    sha: string;
+    tag: string;
+    branch: string;
+}>;
+export type VersionResponse = z.infer<typeof VersionResponseSchema>;
+//# sourceMappingURL=VersionTool.output.schema.d.ts.map

package/dist/commonjs/tools/version-tool/VersionTool.output.schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"VersionTool.output.schema.d.ts","sourceRoot":"","sources":["../../../../src/tools/version-tool/VersionTool.output.schema.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;EAMhC,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC"}

package/dist/commonjs/tools/version-tool/VersionTool.output.schema.js

@@ -0,0 +1,15 @@
+"use strict";
+// Copyright (c) Mapbox, Inc.
+// Licensed under the MIT License.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VersionResponseSchema = void 0;
+const zod_1 = require("zod");
+// Schema for version tool output - matches the VersionInfo interface
+exports.VersionResponseSchema = zod_1.z.object({
+    name: zod_1.z.string(),
+    version: zod_1.z.string(),
+    sha: zod_1.z.string(),
+    tag: zod_1.z.string(),
+    branch: zod_1.z.string()
+});
+//# sourceMappingURL=VersionTool.output.schema.js.map

package/dist/commonjs/tools/version-tool/VersionTool.output.schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"VersionTool.output.schema.js","sourceRoot":"","sources":["../../../../src/tools/version-tool/VersionTool.output.schema.ts"],"names":[],"mappings":";AAAA,6BAA6B;AAC7B,kCAAkC;;;AAElC,6BAAwB;AAExB,qEAAqE;AACxD,QAAA,qBAAqB,GAAG,OAAC,CAAC,MAAM,CAAC;IAC5C,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE;IAChB,OAAO,EAAE,OAAC,CAAC,MAAM,EAAE;IACnB,GAAG,EAAE,OAAC,CAAC,MAAM,EAAE;IACf,GAAG,EAAE,OAAC,CAAC,MAAM,EAAE;IACf,MAAM,EAAE,OAAC,CAAC,MAAM,EAAE;CACnB,CAAC,CAAC"}

package/dist/commonjs/utils/httpPipeline.d.ts

@@ -0,0 +1,39 @@
+import { type HttpRequest } from './types.js';
+export interface HttpPolicy {
+    id: string;
+    handle(input: string | URL | Request, init: RequestInit, next: HttpRequest): Promise<Response>;
+}
+export declare class HttpPipeline {
+    private policies;
+    private httpRequestImpl;
+    constructor(httpRequestImpl?: HttpRequest);
+    usePolicy(policy: HttpPolicy): void;
+    removePolicy(policyOrId: HttpPolicy | string): void;
+    findPolicyById(id: string): HttpPolicy | undefined;
+    listPolicies(): HttpPolicy[];
+    execute(input: string | URL | Request, init?: RequestInit): Promise<Response>;
+}
+export declare class UserAgentPolicy implements HttpPolicy {
+    private userAgent;
+    id: string;
+    constructor(userAgent: string, id?: string);
+    handle(input: string | URL | Request, init: RequestInit, next: HttpRequest): Promise<Response>;
+    static fromVersionInfo(versionInfo: {
+        name: string;
+        version: string;
+        sha: string;
+        tag: string;
+        branch: string;
+    }, id?: string): UserAgentPolicy;
+}
+export declare class RetryPolicy implements HttpPolicy {
+    private maxRetries;
+    private baseDelayMs;
+    private maxDelayMs;
+    id: string;
+    constructor(maxRetries?: number, baseDelayMs?: number, maxDelayMs?: number, id?: string);
+    handle(input: string | URL | Request, init: RequestInit, next: HttpRequest): Promise<Response>;
+}
+export declare const httpRequest: (input: string | URL | Request, init?: RequestInit) => Promise<Response>;
+export declare const systemHttpPipeline: HttpPipeline;
+//# sourceMappingURL=httpPipeline.d.ts.map

package/dist/commonjs/utils/httpPipeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"httpPipeline.d.ts","sourceRoot":"","sources":["../../../src/utils/httpPipeline.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,YAAY,CAAC;AAM9C,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,CACJ,KAAK,EAAE,MAAM,GAAG,GAAG,GAAG,OAAO,EAC7B,IAAI,EAAE,WAAW,EACjB,IAAI,EAAE,WAAW,GAChB,OAAO,CAAC,QAAQ,CAAC,CAAC;CACtB;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAoB;IACpC,OAAO,CAAC,eAAe,CAAc;gBAEzB,eAAe,CAAC,EAAE,WAAW;IAIzC,SAAS,CAAC,MAAM,EAAE,UAAU;IAI5B,YAAY,CAAC,UAAU,EAAE,UAAU,GAAG,MAAM;IAQ5C,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS;IAIlD,YAAY;IAIN,OAAO,CACX,KAAK,EAAE,MAAM,GAAG,GAAG,GAAG,OAAO,EAC7B,IAAI,GAAE,WAAgB,GACrB,OAAO,CAAC,QAAQ,CAAC;CAkBrB;AAED,qBAAa,eAAgB,YAAW,UAAU;IAI9C,OAAO,CAAC,SAAS;IAHnB,EAAE,EAAE,MAAM,CAAC;gBAGD,SAAS,EAAE,MAAM,EACzB,EAAE,CAAC,EAAE,MAAM;IAIP,MAAM,CACV,KAAK,EAAE,MAAM,GAAG,GAAG,GAAG,OAAO,EAC7B,IAAI,EAAE,WAAW,EACjB,IAAI,EAAE,WAAW,GAChB,OAAO,CAAC,QAAQ,CAAC;IAmBpB,MAAM,CAAC,eAAe,CACpB,WAAW,EAAE;QACX,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,GAAG,EAAE,MAAM,CAAC;QACZ,GAAG,EAAE,MAAM,CAAC;QACZ,MAAM,EAAE,MAAM,CAAC;KAChB,EACD,EAAE,CAAC,EAAE,MAAM,GACV,eAAe;CAInB;AAED,qBAAa,WAAY,YAAW,UAAU;IAI1C,OAAO,CAAC,UAAU;IAClB,OAAO,CAAC,WAAW;IACnB,OAAO,CAAC,UAAU;IALpB,EAAE,EAAE,MAAM,CAAC;gBAGD,UAAU,GAAE,MAAU,EACtB,WAAW,GAAE,MAAY,EACzB,UAAU,GAAE,MAAa,EACjC,EAAE,CAAC,EAAE,MAAM;IAKP,MAAM,CACV,KAAK,EAAE,MAAM,GAAG,GAAG,GAAG,OAAO,EAC7B,IAAI,EAAE,WAAW,EACjB,IAAI,EAAE,WAAW,GAChB,OAAO,CAAC,QAAQ,CAAC;CA2BrB;AASD,eAAO,MAAM,WAAW,UAzHb,MAAM,GAAG,GAAG,GAAG,OAAO,SACvB,WAAW,KAChB,OAAO,CAAC,QAAQ,CAuHqC,CAAC;AAC3D,eAAO,MAAM,kBAAkB,cAAW,CAAC"}

package/dist/commonjs/utils/{fetchRequest.js → httpPipeline.js}

@@ -2,16 +2,16 @@
 // Copyright (c) Mapbox, Inc.
 // Licensed under the MIT License.
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.systemFetchPipeline = exports.fetchClient = exports.RetryPolicy = exports.UserAgentPolicy = exports.PolicyPipeline = void 0;
+exports.systemHttpPipeline = exports.httpRequest = exports.RetryPolicy = exports.UserAgentPolicy = exports.HttpPipeline = void 0;
 const versionUtils_js_1 = require("./versionUtils.js");
 function createRandomId(prefix) {
     return `${prefix}${Date.now()}-${Math.random().toString(36).substring(2, 11)}`;
 }
-class PolicyPipeline {
+class HttpPipeline {
     policies = [];
-    fetchImpl;
-    constructor(fetchImpl) {
-        this.fetchImpl = fetchImpl ?? fetch;
+    httpRequestImpl;
+    constructor(httpRequestImpl) {
+        this.httpRequestImpl = httpRequestImpl ?? fetch;
     }
     usePolicy(policy) {
         this.policies.push(policy);
@@ -30,17 +30,17 @@ class PolicyPipeline {
     listPolicies() {
         return this.policies;
     }
-    async fetch(input, init = {}) {
+    async execute(input, init = {}) {
         const dispatch = async (i, req, options) => {
             if (i < this.policies.length) {
-                return this.policies[i].handle(req, options, (nextReq, nextOptions) => dispatch(i + 1, nextReq, nextOptions));
+                return this.policies[i].handle(req, options, (nextReq, nextOptions) => dispatch(i + 1, nextReq, nextOptions || {}));
             }
-            return this.fetchImpl(req, options); // Use injected fetch
+            return this.httpRequestImpl(req, options); // Use injected httpRequest
         };
         return dispatch(0, input, init);
     }
 }
-exports.PolicyPipeline = PolicyPipeline;
+exports.HttpPipeline = HttpPipeline;
 class UserAgentPolicy {
     userAgent;
     id;
@@ -103,10 +103,10 @@ class RetryPolicy {
     }
 }
 exports.RetryPolicy = RetryPolicy;
-const pipeline = new PolicyPipeline();
+const pipeline = new HttpPipeline();
 const versionInfo = (0, versionUtils_js_1.getVersionInfo)();
 pipeline.usePolicy(UserAgentPolicy.fromVersionInfo(versionInfo, 'system-user-agent-policy'));
 pipeline.usePolicy(new RetryPolicy(3, 200, 2000, 'system-retry-policy'));
-exports.fetchClient = pipeline.fetch.bind(pipeline);
-exports.systemFetchPipeline = pipeline;
-//# sourceMappingURL=fetchRequest.js.map
+exports.httpRequest = pipeline.execute.bind(pipeline);
+exports.systemHttpPipeline = pipeline;
+//# sourceMappingURL=httpPipeline.js.map

package/dist/commonjs/utils/httpPipeline.js.map

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

package/dist/commonjs/utils/tracing.d.ts

@@ -0,0 +1,99 @@
+import { type Span } from '@opentelemetry/api';
+import { type HttpRequest } from './types.js';
+/**
+ * Tool execution context providing dependencies via options bag pattern
+ */
+export interface LocalToolExecutionContext {
+    span: Span;
+    tracingContext: {
+        parentSpan?: Span;
+        sessionId?: string;
+        userId?: string;
+        accountId?: string;
+        chatSessionId?: string;
+        promptId?: string;
+    };
+    extra?: Record<string, unknown>;
+}
+/**
+ * Tool execution context providing dependencies via options bag pattern
+ */
+export interface ToolExecutionContext {
+    span: Span;
+    tracingContext: {
+        parentSpan?: Span;
+        sessionId?: string;
+        userId?: string;
+        accountId?: string;
+        chatSessionId?: string;
+        promptId?: string;
+    };
+    httpRequest: HttpRequest;
+    extra?: Record<string, unknown>;
+}
+/**
+ * Create a tool execution context with all necessary dependencies
+ */
+export declare function createLocalToolExecutionContext(toolName: string, inputSize: number, extra?: Record<string, unknown>): LocalToolExecutionContext;
+/**
+ * Create a tool execution context with all necessary dependencies
+ */
+export declare function createToolExecutionContext(toolName: string, inputSize: number, httpRequest: HttpRequest, extra?: Record<string, unknown>): ToolExecutionContext;
+/**
+ * Initialize OpenTelemetry tracing
+ * Should be called once at application startup
+ *
+ * For MCP servers using stdio transport, console output should be avoided.
+ * This implementation automatically detects and handles MCP compatibility.
+ */
+export declare function initializeTracing(): Promise<void>;
+/**
+ * Shutdown tracing gracefully
+ */
+export declare function shutdownTracing(): Promise<void>;
+/**
+ * Check if tracing is enabled
+ */
+export declare function isTracingInitialized(): boolean;
+/**
+ * Get the default tracer for the MCP server
+ */
+export declare function getTracer(): import("@opentelemetry/api").Tracer;
+/**
+ * Create a span for tool execution with comprehensive attributes
+ */
+export declare function createToolSpan(toolName: string, inputSize: number, extra?: {
+    sessionId?: string;
+    userId?: string;
+    accountId?: string;
+    chatSessionId?: string;
+    promptId?: string;
+}): Span;
+/**
+ * Create a span for HTTP requests with comprehensive attributes
+ */
+export declare function createHttpSpan(method: string, url: string, extra?: {
+    userAgent?: string;
+    contentLength?: number;
+    sessionId?: string;
+}): Span;
+/**
+ * Mark a span as successful and end it
+ */
+export declare function markSpanSuccess(span: Span, attributes?: Record<string, string | number | boolean>): void;
+/**
+ * Mark a span as failed with error information and end it
+ */
+export declare function markSpanError(span: Span, error: Error | string, attributes?: Record<string, string | number | boolean>): void;
+/**
+ * Validate JWT token format for tracing (basic format check only)
+ */
+export declare function validateJwtForTracing(token?: string): {
+    isValid: boolean;
+    error?: string;
+};
+/**
+ * Helper function to get size of an object in bytes (approximate)
+ */
+export declare function getObjectSize(obj: unknown): number;
+//# sourceMappingURL=tracing.d.ts.map

package/dist/commonjs/utils/tracing.d.ts.map

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

package/dist/commonjs/utils/tracing.js

@@ -0,0 +1,283 @@
+"use strict";
+// Copyright (c) Mapbox, Inc.
+// Licensed under the MIT License.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createLocalToolExecutionContext = createLocalToolExecutionContext;
+exports.createToolExecutionContext = createToolExecutionContext;
+exports.initializeTracing = initializeTracing;
+exports.shutdownTracing = shutdownTracing;
+exports.isTracingInitialized = isTracingInitialized;
+exports.getTracer = getTracer;
+exports.createToolSpan = createToolSpan;
+exports.createHttpSpan = createHttpSpan;
+exports.markSpanSuccess = markSpanSuccess;
+exports.markSpanError = markSpanError;
+exports.validateJwtForTracing = validateJwtForTracing;
+exports.getObjectSize = getObjectSize;
+const sdk_node_1 = require("@opentelemetry/sdk-node");
+const auto_instrumentations_node_1 = require("@opentelemetry/auto-instrumentations-node");
+const resources_1 = require("@opentelemetry/resources");
+const semantic_conventions_1 = require("@opentelemetry/semantic-conventions");
+const exporter_trace_otlp_http_1 = require("@opentelemetry/exporter-trace-otlp-http");
+const api_1 = require("@opentelemetry/api");
+const versionUtils_js_1 = require("./versionUtils.js");
+const incubating_1 = require("@opentelemetry/semantic-conventions/incubating");
+// Global SDK instance
+let sdk = null;
+let isTracingEnabled = false;
+/**
+ * Create a tool execution context with all necessary dependencies
+ */
+function createLocalToolExecutionContext(toolName, inputSize, extra) {
+    const span = createToolSpan(toolName, inputSize, {
+        sessionId: extra?.sessionId,
+        userId: extra?.userId,
+        accountId: extra?.accountId,
+        chatSessionId: extra?.chatSessionId,
+        promptId: extra?.promptId
+    });
+    return {
+        span,
+        tracingContext: {
+            parentSpan: span,
+            sessionId: extra?.sessionId,
+            userId: extra?.userId,
+            accountId: extra?.accountId,
+            chatSessionId: extra?.chatSessionId,
+            promptId: extra?.promptId
+        },
+        extra
+    };
+}
+/**
+ * Create a tool execution context with all necessary dependencies
+ */
+function createToolExecutionContext(toolName, inputSize, httpRequest, extra) {
+    const span = createToolSpan(toolName, inputSize, {
+        sessionId: extra?.sessionId,
+        userId: extra?.userId,
+        accountId: extra?.accountId,
+        chatSessionId: extra?.chatSessionId,
+        promptId: extra?.promptId
+    });
+    return {
+        span,
+        tracingContext: {
+            parentSpan: span,
+            sessionId: extra?.sessionId,
+            userId: extra?.userId,
+            accountId: extra?.accountId,
+            chatSessionId: extra?.chatSessionId,
+            promptId: extra?.promptId
+        },
+        httpRequest,
+        extra
+    };
+}
+/**
+ * Initialize OpenTelemetry tracing
+ * Should be called once at application startup
+ *
+ * For MCP servers using stdio transport, console output should be avoided.
+ * This implementation automatically detects and handles MCP compatibility.
+ */
+async function initializeTracing() {
+    // Skip initialization if already initialized or if running in test environment
+    if (sdk || process.env.NODE_ENV === 'test' || process.env.VITEST) {
+        return;
+    }
+    // Skip if tracing is explicitly disabled
+    if (process.env.OTEL_TRACING_ENABLED === 'false') {
+        return;
+    }
+    const versionInfo = (0, versionUtils_js_1.getVersionInfo)();
+    try {
+        // Create resource with service information
+        const resource = new resources_1.Resource({
+            [semantic_conventions_1.ATTR_SERVICE_NAME]: process.env.OTEL_SERVICE_NAME || versionInfo.name,
+            [semantic_conventions_1.ATTR_SERVICE_VERSION]: versionInfo.version,
+            [incubating_1.ATTR_SERVICE_INSTANCE_ID]: process.env.HOSTNAME || 'unknown',
+            'service.git.sha': versionInfo.sha,
+            'service.git.branch': versionInfo.branch,
+            'service.git.tag': versionInfo.tag
+        });
+        // Configure exporters
+        const exporters = [];
+        // Console exporter for development (avoid in stdio transport)
+        if (process.env.OTEL_EXPORTER_CONSOLE_ENABLED === 'true') {
+            const { ConsoleSpanExporter } = await import('@opentelemetry/sdk-trace-base');
+            exporters.push(new ConsoleSpanExporter());
+        }
+        // OTLP HTTP exporter for production
+        const otlpEndpoint = process.env.OTEL_EXPORTER_OTLP_ENDPOINT;
+        if (otlpEndpoint) {
+            exporters.push(new exporter_trace_otlp_http_1.OTLPTraceExporter({
+                url: `${otlpEndpoint}/v1/traces`,
+                headers: process.env.OTEL_EXPORTER_OTLP_HEADERS
+                    ? JSON.parse(process.env.OTEL_EXPORTER_OTLP_HEADERS)
+                    : {}
+            }));
+        }
+        // Skip tracing if no exporters configured
+        if (exporters.length === 0) {
+            return;
+        }
+        // Create SDK instance
+        sdk = new sdk_node_1.NodeSDK({
+            resource,
+            traceExporter: exporters[0],
+            instrumentations: [
+                (0, auto_instrumentations_node_1.getNodeAutoInstrumentations)({
+                    // Disable instrumentations that might be too noisy
+                    '@opentelemetry/instrumentation-fs': {
+                        enabled: false
+                    },
+                    '@opentelemetry/instrumentation-dns': {
+                        enabled: false
+                    },
+                    // Ensure HTTP instrumentation is enabled for HTTP requests
+                    '@opentelemetry/instrumentation-http': {
+                        enabled: true
+                    },
+                    // Enable fetch instrumentation for HTTP requests
+                    '@opentelemetry/instrumentation-undici': {
+                        enabled: true
+                    }
+                })
+            ]
+        });
+        // Start the SDK
+        sdk.start();
+        isTracingEnabled = true;
+    }
+    catch {
+        // Silently handle initialization errors to avoid breaking MCP stdio
+        isTracingEnabled = false;
+    }
+}
+/**
+ * Shutdown tracing gracefully
+ */
+async function shutdownTracing() {
+    if (sdk) {
+        await sdk.shutdown();
+        sdk = null;
+        isTracingEnabled = false;
+    }
+}
+/**
+ * Check if tracing is enabled
+ */
+function isTracingInitialized() {
+    return isTracingEnabled;
+}
+/**
+ * Get the default tracer for the MCP server
+ */
+function getTracer() {
+    return api_1.trace.getTracer('mapbox-mcp-server');
+}
+/**
+ * Create a span for tool execution with comprehensive attributes
+ */
+function createToolSpan(toolName, inputSize, extra) {
+    const tracer = getTracer();
+    const span = tracer.startSpan(`tool.${toolName}`, {
+        kind: api_1.SpanKind.INTERNAL,
+        attributes: {
+            'tool.name': toolName,
+            'tool.input.size': inputSize,
+            'operation.type': 'tool_execution',
+            ...(extra?.sessionId && { 'session.id': extra.sessionId }),
+            ...(extra?.userId && { 'user.id': extra.userId }),
+            ...(extra?.accountId && { 'account.id': extra.accountId }),
+            ...(extra?.chatSessionId && { 'chat.session.id': extra.chatSessionId }),
+            ...(extra?.promptId && { 'prompt.id': extra.promptId })
+        }
+    });
+    return span;
+}
+/**
+ * Create a span for HTTP requests with comprehensive attributes
+ */
+function createHttpSpan(method, url, extra) {
+    const tracer = getTracer();
+    const span = tracer.startSpan(`http.${method.toLowerCase()}`, {
+        kind: api_1.SpanKind.CLIENT,
+        attributes: {
+            'http.method': method,
+            'http.url': url,
+            'operation.type': 'http_request',
+            ...(extra?.userAgent && { 'http.user_agent': extra.userAgent }),
+            ...(extra?.contentLength && {
+                'http.request.content_length': extra.contentLength
+            }),
+            ...(extra?.sessionId && { 'session.id': extra.sessionId })
+        }
+    });
+    return span;
+}
+/**
+ * Mark a span as successful and end it
+ */
+function markSpanSuccess(span, attributes) {
+    if (attributes) {
+        span.setAttributes(attributes);
+    }
+    span.setStatus({ code: api_1.SpanStatusCode.OK });
+    span.end();
+}
+/**
+ * Mark a span as failed with error information and end it
+ */
+function markSpanError(span, error, attributes) {
+    const errorMessage = typeof error === 'string' ? error : error.message;
+    const errorType = typeof error === 'string' ? 'Error' : error.constructor.name;
+    span.setAttributes({
+        'error.type': errorType,
+        'error.message': errorMessage,
+        ...(attributes || {})
+    });
+    if (typeof error !== 'string') {
+        span.recordException(error);
+    }
+    span.setStatus({
+        code: api_1.SpanStatusCode.ERROR,
+        message: errorMessage
+    });
+    span.end();
+}
+/**
+ * Validate JWT token format for tracing (basic format check only)
+ */
+function validateJwtForTracing(token) {
+    if (!token) {
+        return { isValid: true }; // No token is valid (optional)
+    }
+    // Basic JWT format validation (header.payload.signature)
+    const parts = token.split('.');
+    if (parts.length !== 3) {
+        return { isValid: false, error: 'Invalid JWT format' };
+    }
+    try {
+        // Try to decode the header and payload (just to validate base64 format)
+        JSON.parse(Buffer.from(parts[0], 'base64url').toString());
+        JSON.parse(Buffer.from(parts[1], 'base64url').toString());
+        return { isValid: true };
+    }
+    catch {
+        return { isValid: false, error: 'Invalid JWT encoding' };
+    }
+}
+/**
+ * Helper function to get size of an object in bytes (approximate)
+ */
+function getObjectSize(obj) {
+    try {
+        return JSON.stringify(obj).length;
+    }
+    catch {
+        return 0;
+    }
+}
+//# sourceMappingURL=tracing.js.map