@revealui/mcp 0.1.1 → 0.1.5

package/dist/telemetry.js

@@ -0,0 +1,110 @@
+/**
+ * MCP Telemetry
+ *
+ * Structured event emitter for MCP operations. Supports multiple
+ * subscribers and provides convenience methods for common event types.
+ *
+ * @example
+ * ```typescript
+ * const telemetry = McpTelemetry.getInstance();
+ *
+ * // Register a JSON-lines handler
+ * telemetry.on(McpTelemetry.createJsonLogHandler());
+ *
+ * // Emit events
+ * telemetry.toolInvoke('stripe', 'create_customer', 'tenant-1', 'pro');
+ * telemetry.toolComplete('stripe', 'create_customer', true, 42, {
+ *   tenant: 'tenant-1',
+ * });
+ * ```
+ */
+// =============================================================================
+// Telemetry emitter
+// =============================================================================
+/**
+ * Simple event emitter for MCP telemetry.
+ * Supports multiple subscribers and structured event types.
+ * Default handler logs to structured JSON on stderr.
+ */
+export class McpTelemetry {
+    handlers = [];
+    static instance = null;
+    static getInstance() {
+        if (!McpTelemetry.instance) {
+            McpTelemetry.instance = new McpTelemetry();
+        }
+        return McpTelemetry.instance;
+    }
+    /** Register an event handler. Returns an unsubscribe function. */
+    on(handler) {
+        this.handlers.push(handler);
+        return () => {
+            this.handlers = this.handlers.filter((h) => h !== handler);
+        };
+    }
+    /** Emit an event to all registered handlers. */
+    emit(event) {
+        for (const handler of this.handlers) {
+            try {
+                handler(event);
+            }
+            catch {
+                // Telemetry must never throw
+            }
+        }
+    }
+    /** Convenience: emit a tool invocation event. */
+    toolInvoke(server, tool, tenant, tier) {
+        this.emit({
+            type: 'tool.invoke',
+            timestamp: Date.now(),
+            server,
+            tool,
+            tenant,
+            tier,
+        });
+    }
+    /** Convenience: emit a tool completion event. */
+    toolComplete(server, tool, success, durationMs, opts) {
+        this.emit({
+            type: success ? 'tool.complete' : 'tool.error',
+            timestamp: Date.now(),
+            server,
+            tool,
+            success,
+            durationMs,
+            ...opts,
+        });
+    }
+    /** Create a JSON-lines log handler (writes to stderr). */
+    static createJsonLogHandler() {
+        return (event) => {
+            process.stderr.write(`${JSON.stringify(event)}\n`);
+        };
+    }
+    /**
+     * Create an OpenTelemetry-compatible span handler stub.
+     * Pass your own tracer instance to wire real OTel export.
+     */
+    static createOtelHandler(tracer) {
+        return (event) => {
+            if (!tracer)
+                return;
+            const span = tracer.startSpan(`mcp.${event.type}`);
+            if (event.server)
+                span.setAttribute('mcp.server', event.server);
+            if (event.tool)
+                span.setAttribute('mcp.tool', event.tool);
+            if (event.durationMs !== undefined)
+                span.setAttribute('mcp.duration_ms', event.durationMs);
+            if (event.success !== undefined)
+                span.setAttribute('mcp.success', event.success);
+            span.end();
+        };
+    }
+    /** Reset singleton (for testing). */
+    static reset() {
+        McpTelemetry.instance = null;
+    }
+}
+//# sourceMappingURL=telemetry.js.map

package/dist/telemetry.js.map

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

package/package.json

@@ -1,11 +1,26 @@
 {
   "name": "@revealui/mcp",
-  "version": "0.1.1",
-  "description": "[Pro] Model Context Protocol integrations for RevealUI — adapter framework, hypervisor, and MCP contracts",
-  "license": "SEE LICENSE IN ../../LICENSE.commercial",
-  "type": "module",
-  "main": "./dist/index.js",
-  "types": "./dist/index.d.ts",
+  "version": "0.1.5",
+  "description": "Model Context Protocol integrations for RevealUI — adapter framework, hypervisor, and MCP contracts",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/RevealUIStudio/revealui.git",
+    "directory": "packages/mcp"
+  },
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.26.0",
+    "dotenv": "^17.2.4",
+    "@revealui/config": "0.3.0",
+    "@revealui/contracts": "1.3.3",
+    "@revealui/core": "0.5.2"
+  },
+  "devDependencies": {
+    "@electric-sql/pglite": "^0.4.2",
+    "pg": "^8.18.0",
+    "typescript": "^6.0.2",
+    "vitest": "^4.0.18"
+  },
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
@@ -30,36 +45,41 @@
     "./config": {
       "types": "./dist/config/index.d.ts",
       "import": "./dist/config/index.js"
+    },
+    "./pipeline": {
+      "types": "./dist/pipeline.d.ts",
+      "import": "./dist/pipeline.js"
+    },
+    "./rate-limiter": {
+      "types": "./dist/rate-limiter.d.ts",
+      "import": "./dist/rate-limiter.js"
+    },
+    "./telemetry": {
+      "types": "./dist/telemetry.d.ts",
+      "import": "./dist/telemetry.js"
+    },
+    "./auth": {
+      "types": "./dist/auth.d.ts",
+      "import": "./dist/auth.js"
+    },
+    "./stores/postgres": {
+      "types": "./dist/stores/postgres-idempotency.d.ts",
+      "import": "./dist/stores/postgres-idempotency.js"
     }
   },
   "files": [
     "dist"
   ],
-  "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.26.0",
-    "dotenv": "^17.2.4",
-    "@revealui/config": "0.3.0",
-    "@revealui/contracts": "1.2.0",
-    "@revealui/core": "0.3.0"
-  },
-  "devDependencies": {
-    "@electric-sql/pglite": "^0.3.15",
-    "pg": "^8.18.0",
-    "typescript": "^5.9.3",
-    "vitest": "^4.0.18"
-  },
-  "publishConfig": {
-    "access": "public"
-  },
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/RevealUIStudio/revealui.git",
-    "directory": "packages/mcp"
-  },
   "funding": {
     "type": "commercial",
     "url": "https://revealui.com/pro"
   },
+  "main": "./dist/index.js",
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "types": "./dist/index.d.ts",
   "scripts": {
     "build": "tsc",
     "clean": "rm -rf dist",