autotel-skybridge 0.0.0 → 0.1.0

package/README.md

@@ -14,7 +14,7 @@ npm install autotel autotel-skybridge
 // src/instrumentation.ts: import this first in src/index.ts
 import { init } from 'autotel';
 
-init({ service: 'my-app', endpoint: process.env.OTEL_EXPORTER_OTLP_ENDPOINT });
+init({ service: 'my-app' }); // reads OTEL_EXPORTER_OTLP_ENDPOINT / _HEADERS
 ```
 
 ```ts
@@ -36,9 +36,9 @@ export const app = new Skybridge({
 
 ## What you get
 
-- A `SERVER` span per `tools/call` (`tools/call search`), `resources/read` and `prompts/get`, with the attributes from the OTel MCP semantic conventions (`mcp.method.name`, `gen_ai.tool.name`, `mcp.resource.uri`, ...). This includes Skybridge view resources.
-- The span's parent is the caller's trace context from `_meta`, so an instrumented client (`instrumentMcpClient` from `autotel-mcp-instrumentation`) and the server share one trace. Spans started inside a tool nest under it.
-- A thrown tool error becomes an `isError` result in Skybridge. The span is marked `ERROR` with `error.type=tool_error` and `mcp.failure.*` grouping, and the original exception (message and stack) is recorded on it.
+- A `SERVER` span per `tools/call` (`tools/call search`), `resources/read` and `prompts/get`, with the attributes from the OTel MCP semantic conventions (`mcp.method.name`, `gen_ai.tool.name`, `mcp.resource.uri`, ...). View resources are included, with the `?v=` cache key dropped from the URI. The duration metric labels tools and prompts by name and leaves resource URIs off, since a URI can expand a template.
+- The caller's trace context in `_meta` parents the span, so an `instrumentMcpClient` caller and your server share one trace. Spans you start inside a tool nest under it.
+- Skybridge answers a thrown tool error with an `isError` result. The span records `ERROR` with the failure text as its status message, `error.type=tool_error`, `mcp.failure.*` grouping, and the original exception. A `createStructuredError` keeps its `why`, `fix` and `code` as `error.*` attributes.
 - Payload sizes, the `mcp.server.operation.duration` metric, and the security signals from `autotel-mcp-instrumentation`.
 
 ## Options
@@ -52,7 +52,11 @@ skybridgeTracing({
 });
 ```
 
-Tool annotations and manifest classification are not recorded, because a middleware sees the request, never the tool's registration.
+The middleware runs before the SDK validates the request. `captureToolArgs` and the security classifiers see the arguments as sent, and the span name comes from the requested tool name. A call to an unknown tool gets the bare method name, and the duration metric leaves the name out. Tool annotations and manifest classification come from `instrumentMcpServer`, which sees each tool's registration.
+
+## Vercel
+
+`skybridge build` writes Vercel's prebuilt output. Add `protocol: 'http'` (the bundled JSON exporter) and `forceFlushOnShutdown: process.env.VERCEL === '1'` to `init()`, set `OTEL_EXPORTER_OTLP_ENDPOINT` and `OTEL_EXPORTER_OTLP_HEADERS` on the project, and run `vercel deploy --prebuilt`.
 
 ## Example
 

package/dist/index.cjs

@@ -35,15 +35,14 @@ const TRACED_METHODS = /* @__PURE__ */ new Map([
 *     server.registerTool(...).mcpMiddleware(skybridgeTracing()),
 * });
 * ```
-*
-* Tool annotations and manifest classification are not available: a
-* middleware sees the request, never the tool's registration.
 */
 function skybridgeTracing(config) {
 	return (request, extra, next) => {
 		const type = TRACED_METHODS.get(request.method);
 		if (!type || !extra) return next();
-		const name = String(type === "resource" ? request.params.uri : request.params.name);
+		const rawName = type === "resource" ? request.params.uri : request.params.name;
+		if (typeof rawName !== "string") return next();
+		const name = type === "resource" ? rawName.split("?")[0] : rawName;
 		return (0, autotel_mcp_instrumentation.traceMcpHandler)(async () => {
 			const result = await next();
 			const error = TOOL_ERROR in extra ? extra[TOOL_ERROR] : void 0;
@@ -54,7 +53,7 @@ function skybridgeTracing(config) {
 			name,
 			resourceUri: type === "resource" ? name : void 0,
 			config
-		})(type === "resource" ? name : request.params.arguments, extra);
+		})(type === "resource" ? rawName : request.params.arguments, extra);
 	};
 }
 //#endregion

package/dist/index.d.cts

@@ -14,9 +14,6 @@ import { McpMiddlewareFn } from "skybridge/server";
  *     server.registerTool(...).mcpMiddleware(skybridgeTracing()),
  * });
  * ```
- *
- * Tool annotations and manifest classification are not available: a
- * middleware sees the request, never the tool's registration.
  */
 export declare function skybridgeTracing(config?: McpInstrumentationConfig$1): McpMiddlewareFn;
 //#endregion

package/dist/index.d.ts

@@ -14,9 +14,6 @@ import { McpMiddlewareFn } from "skybridge/server";
  *     server.registerTool(...).mcpMiddleware(skybridgeTracing()),
  * });
  * ```
- *
- * Tool annotations and manifest classification are not available: a
- * middleware sees the request, never the tool's registration.
  */
 export declare function skybridgeTracing(config?: McpInstrumentationConfig$1): McpMiddlewareFn;
 //#endregion

package/dist/index.js

@@ -34,15 +34,14 @@ const TRACED_METHODS = /* @__PURE__ */ new Map([
 *     server.registerTool(...).mcpMiddleware(skybridgeTracing()),
 * });
 * ```
-*
-* Tool annotations and manifest classification are not available: a
-* middleware sees the request, never the tool's registration.
 */
 function skybridgeTracing(config) {
 	return (request, extra, next) => {
 		const type = TRACED_METHODS.get(request.method);
 		if (!type || !extra) return next();
-		const name = String(type === "resource" ? request.params.uri : request.params.name);
+		const rawName = type === "resource" ? request.params.uri : request.params.name;
+		if (typeof rawName !== "string") return next();
+		const name = type === "resource" ? rawName.split("?")[0] : rawName;
 		return traceMcpHandler(async () => {
 			const result = await next();
 			const error = TOOL_ERROR in extra ? extra[TOOL_ERROR] : void 0;
@@ -53,7 +52,7 @@ function skybridgeTracing(config) {
 			name,
 			resourceUri: type === "resource" ? name : void 0,
 			config
-		})(type === "resource" ? name : request.params.arguments, extra);
+		})(type === "resource" ? rawName : request.params.arguments, extra);
 	};
 }
 //#endregion

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "autotel-skybridge",
-  "version": "0.0.0",
+  "version": "0.1.0",
   "description": "OpenTelemetry for Skybridge MCP Apps, powered by autotel",
   "license": "Apache-2.0",
   "type": "module",
@@ -20,14 +20,6 @@
     "LICENSE",
     "NOTICE"
   ],
-  "scripts": {
-    "build": "tsdown",
-    "dev": "tsdown --watch",
-    "type-check": "tsc --noEmit",
-    "lint": "oxlint -c oxlint.json --disable-nested-config src",
-    "test": "vitest run",
-    "clean": "rimraf dist"
-  },
   "keywords": [
     "opentelemetry",
     "otel",
@@ -40,7 +32,7 @@
   ],
   "author": "Jag Reehal <jag@jagreehal.com> (https://jagreehal.com)",
   "dependencies": {
-    "autotel-mcp-instrumentation": "workspace:*"
+    "autotel-mcp-instrumentation": "59.1.0"
   },
   "peerDependencies": {
     "autotel": "*",
@@ -54,7 +46,7 @@
     "@opentelemetry/sdk-trace-base": "^2.11.0",
     "@opentelemetry/sdk-trace-node": "^2.11.0",
     "@types/node": "^26.6.3",
-    "autotel": "workspace:*",
+    "autotel": "7.10.1",
     "skybridge": "^2.0.1",
     "tsdown": "^0.23.0",
     "typescript": "^7.0.2",
@@ -69,5 +61,13 @@
   "bugs": {
     "url": "https://github.com/jagreehal/autotel/issues"
   },
-  "homepage": "https://github.com/jagreehal/autotel/tree/main/packages/autotel-skybridge#readme"
-}
+  "homepage": "https://github.com/jagreehal/autotel/tree/main/packages/autotel-skybridge#readme",
+  "scripts": {
+    "build": "tsdown",
+    "dev": "tsdown --watch",
+    "type-check": "tsc --noEmit",
+    "lint": "oxlint -c oxlint.json --disable-nested-config src",
+    "test": "vitest run",
+    "clean": "rimraf dist"
+  }
+}