@mapbox/mcp-server 0.5.5 → 0.8.1-dev.0

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

@@ -1,8 +1,11 @@
+import { context, SpanStatusCode, trace } from '@opentelemetry/api';
+import { createLocalToolExecutionContext } from '../../utils/tracing.js';
 // Copyright (c) Mapbox, Inc.
 // Licensed under the MIT License.
 import { BaseTool } from '../BaseTool.js';
 import { getVersionInfo } from '../../utils/versionUtils.js';
-import { VersionSchema } from './VersionTool.schema.js';
+import { VersionSchema } from './VersionTool.input.schema.js';
+import { VersionResponseSchema } from './VersionTool.output.schema.js';
 export class VersionTool extends BaseTool {
     name = 'version_tool';
     description = 'Get the current version information of the MCP server';
@@ -14,36 +17,48 @@ export class VersionTool extends BaseTool {
         openWorldHint: false
     };
     constructor() {
-        super({ inputSchema: VersionSchema });
+        super({
+            inputSchema: VersionSchema,
+            outputSchema: VersionResponseSchema
+        });
     }
     // eslint-disable-next-line @typescript-eslint/no-unused-vars
     async run(_rawInput) {
-        try {
-            const versionInfo = 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 = createLocalToolExecutionContext(this.name, 0);
+        return await context.with(trace.setSpan(context.active(), toolContext.span), async () => {
+            try {
+                const versionInfo = 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}`;
+                // Validate with graceful fallback
+                const validatedVersionInfo = this.validateOutput(versionInfo);
+                toolContext.span.setStatus({ code: SpanStatusCode.OK });
+                toolContext.span.end();
+                return {
+                    content: [{ type: 'text', text: versionText }],
+                    structuredContent: validatedVersionInfo,
+                    isError: false
+                };
+            }
+            catch (error) {
+                const errorMessage = error instanceof Error ? error.message : String(error);
+                toolContext.span.setStatus({
+                    code: SpanStatusCode.ERROR,
+                    message: errorMessage
+                });
+                toolContext.span.end();
+                this.log('error', `${this.name}: Error during execution: ${errorMessage}`);
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: `VersionTool: Error during execution: ${errorMessage}`
+                        }
+                    ],
+                    isError: true
+                };
+            }
+        });
     }
 }
 //# sourceMappingURL=VersionTool.js.map

package/dist/esm/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,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAExD,MAAM,OAAO,WAAY,SAAQ,QAA8B;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,aAAa,EAAE,CAAC,CAAC;IACxC,CAAC;IAED,6DAA6D;IAC7D,KAAK,CAAC,GAAG,CAAC,SAAkB;QAO1B,IAAI,CAAC;YACH,MAAM,WAAW,GAAG,cAAc,EAAE,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"}
+{"version":3,"file":"VersionTool.js","sourceRoot":"","sources":["../../../../src/tools/version-tool/VersionTool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AACpE,OAAO,EAAE,+BAA+B,EAAE,MAAM,wBAAwB,CAAC;AACzE,6BAA6B;AAC7B,kCAAkC;AAElC,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAC9D,OAAO,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AAGvE,MAAM,OAAO,WAAY,SAAQ,QAGhC;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,aAAa;YAC1B,YAAY,EAAE,qBAAqB;SACpC,CAAC,CAAC;IACL,CAAC;IAED,6DAA6D;IAC7D,KAAK,CAAC,GAAG,CAAC,SAAkB;QAC1B,uCAAuC;QACvC,MAAM,WAAW,GAAG,+BAA+B,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;QAClE,OAAO,MAAM,OAAO,CAAC,IAAI,CACvB,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,WAAW,CAAC,IAAI,CAAC,EACjD,KAAK,IAAI,EAAE;YACT,IAAI,CAAC;gBACH,MAAM,WAAW,GAAG,cAAc,EAAE,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;gBAE7M,kCAAkC;gBAClC,MAAM,oBAAoB,GAAG,IAAI,CAAC,cAAc,CAC9C,WAAW,CACe,CAAC;gBAE7B,WAAW,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,cAAc,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,KAAK,EAAE,CAAC;gBACf,MAAM,YAAY,GAChB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;gBACzD,WAAW,CAAC,IAAI,CAAC,SAAS,CAAC;oBACzB,IAAI,EAAE,cAAc,CAAC,KAAK;oBAC1B,OAAO,EAAE,YAAY;iBACtB,CAAC,CAAC;gBACH,WAAW,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;gBACvB,IAAI,CAAC,GAAG,CACN,OAAO,EACP,GAAG,IAAI,CAAC,IAAI,6BAA6B,YAAY,EAAE,CACxD,CAAC;gBACF,OAAO;oBACL,OAAO,EAAE;wBACP;4BACE,IAAI,EAAE,MAAe;4BACrB,IAAI,EAAE,wCAAwC,YAAY,EAAE;yBAC7D;qBACF;oBACD,OAAO,EAAE,IAAI;iBACd,CAAC;YACJ,CAAC;QACH,CAAC,CACF,CAAC;IACJ,CAAC;CACF"}

package/dist/esm/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/esm/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/esm/tools/version-tool/VersionTool.output.schema.js

@@ -0,0 +1,12 @@
+// Copyright (c) Mapbox, Inc.
+// Licensed under the MIT License.
+import { z } from 'zod';
+// Schema for version tool output - matches the VersionInfo interface
+export const VersionResponseSchema = z.object({
+    name: z.string(),
+    version: z.string(),
+    sha: z.string(),
+    tag: z.string(),
+    branch: z.string()
+});
+//# sourceMappingURL=VersionTool.output.schema.js.map

package/dist/esm/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,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,qEAAqE;AACrE,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE;IACf,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE;IACf,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;CACnB,CAAC,CAAC"}

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

@@ -0,0 +1,44 @@
+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 class TracingPolicy implements HttpPolicy {
+    id: string;
+    constructor(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/esm/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;AAO9C,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;AAED,qBAAa,aAAc,YAAW,UAAU;IAC9C,EAAE,EAAE,MAAM,CAAC;gBAEC,EAAE,CAAC,EAAE,MAAM;IAIjB,MAAM,CACV,KAAK,EAAE,MAAM,GAAG,GAAG,GAAG,OAAO,EAC7B,IAAI,EAAE,WAAW,EACjB,IAAI,EAAE,WAAW,GAChB,OAAO,CAAC,QAAQ,CAAC;CA6CrB;AAUD,eAAO,MAAM,WAAW,UApLb,MAAM,GAAG,GAAG,GAAG,OAAO,SACvB,WAAW,KAChB,OAAO,CAAC,QAAQ,CAkLqC,CAAC;AAC3D,eAAO,MAAM,kBAAkB,cAAW,CAAC"}

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

@@ -1,14 +1,15 @@
 // Copyright (c) Mapbox, Inc.
 // Licensed under the MIT License.
 import { getVersionInfo } from './versionUtils.js';
+import { trace } from '@opentelemetry/api';
 function createRandomId(prefix) {
     return `${prefix}${Date.now()}-${Math.random().toString(36).substring(2, 11)}`;
 }
-export class PolicyPipeline {
+export class HttpPipeline {
     policies = [];
-    fetchImpl;
-    constructor(fetchImpl) {
-        this.fetchImpl = fetchImpl ?? fetch;
+    httpRequestImpl;
+    constructor(httpRequestImpl) {
+        this.httpRequestImpl = httpRequestImpl ?? fetch;
     }
     usePolicy(policy) {
         this.policies.push(policy);
@@ -27,12 +28,12 @@ export 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);
     }
@@ -97,10 +98,53 @@ export class RetryPolicy {
         return lastError;
     }
 }
-const pipeline = new PolicyPipeline();
+export class TracingPolicy {
+    id;
+    constructor(id) {
+        this.id = id ?? createRandomId('tracing-');
+    }
+    async handle(input, init, next) {
+        const response = await next(input, init);
+        // Capture response headers in the active span
+        const activeSpan = trace.getActiveSpan();
+        if (activeSpan) {
+            // Only capture Mapbox-specific headers for Mapbox API requests
+            const mapboxEndpoint = process.env.MAPBOX_API_ENDPOINT || 'https://api.mapbox.com/';
+            const url = typeof input === 'string'
+                ? input
+                : input instanceof URL
+                    ? input.href
+                    : input.url;
+            if (url && url.startsWith(mapboxEndpoint)) {
+                // Capture Mapbox/CloudFront headers
+                const cfId = response.headers.get('x-amz-cf-id');
+                if (cfId) {
+                    activeSpan.setAttribute('http.response.header.x_amz_cf_id', cfId);
+                }
+                const cfPop = response.headers.get('x-amz-cf-pop');
+                if (cfPop) {
+                    activeSpan.setAttribute('http.response.header.x_amz_cf_pop', cfPop);
+                }
+                const xCache = response.headers.get('x-cache');
+                if (xCache) {
+                    activeSpan.setAttribute('http.response.header.x_cache', xCache);
+                }
+                const etag = response.headers.get('etag');
+                if (etag) {
+                    activeSpan.setAttribute('http.response.header.etag', etag);
+                }
+            }
+            // Always capture HTTP status for all requests
+            activeSpan.setAttribute('http.response.status_code', response.status);
+        }
+        return response;
+    }
+}
+const pipeline = new HttpPipeline();
 const versionInfo = getVersionInfo();
 pipeline.usePolicy(UserAgentPolicy.fromVersionInfo(versionInfo, 'system-user-agent-policy'));
 pipeline.usePolicy(new RetryPolicy(3, 200, 2000, 'system-retry-policy'));
-export const fetchClient = pipeline.fetch.bind(pipeline);
-export const systemFetchPipeline = pipeline;
-//# sourceMappingURL=fetchRequest.js.map
+pipeline.usePolicy(new TracingPolicy('system-tracing-policy'));
+export const httpRequest = pipeline.execute.bind(pipeline);
+export const systemHttpPipeline = pipeline;
+//# sourceMappingURL=httpPipeline.js.map

package/dist/esm/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/esm/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/esm/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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"}