@oka-core/reason 0.2.16 → 0.2.17

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAUA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,YAAY,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAWA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,YAAY,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/index.js

@@ -8,9 +8,12 @@ import { registerReadTools } from "./tools/read.js";
 import { registerAuthTools } from "./tools/auth.js";
 import { loadEnvFile } from "./auth.js";
 import { analytics } from "./analytics.js";
+import { initTelemetry, shutdownTelemetry } from "./telemetry.js";
 export { analytics } from "./analytics.js";
 // Load .env from the project root (cwd), env vars take precedence
 loadEnvFile(process.cwd());
+// Initialize OTel tracing (no-op if OTEL_EXPORTER_OTLP_ENDPOINT is not set)
+await initTelemetry();
 // Attach a no-op sink so analytics events don't queue indefinitely.
 // Downstream consumers can replace this by calling analytics.attach() with a real sink.
 analytics.attach({ track: () => { } });
@@ -27,4 +30,7 @@ registerWriteTools(server, client);
 registerReadTools(server, client);
 registerAuthTools(server, client);
 const transport = new StdioServerTransport();
+// Flush OTel spans on shutdown
+process.on("SIGTERM", () => void shutdownTelemetry());
+process.on("SIGINT", () => void shutdownTelemetry());
 await server.connect(transport);

package/dist/telemetry.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Optional OpenTelemetry initialization for the MCP server.
+ *
+ * Activates only when OTEL_EXPORTER_OTLP_ENDPOINT is set in the environment.
+ * Exports traces via OTLP/HTTP to the configured collector (e.g. https://otel.oka.so).
+ *
+ * Zero cost when disabled — returns a no-op shutdown function.
+ */
+/**
+ * Initialize OTel tracing if OTEL_EXPORTER_OTLP_ENDPOINT is set.
+ * Returns a shutdown function that flushes pending spans.
+ */
+export declare function initTelemetry(): Promise<() => Promise<void>>;
+/** Flush and shut down the OTel provider (if active). */
+export declare function shutdownTelemetry(): Promise<void>;
+//# sourceMappingURL=telemetry.d.ts.map

package/dist/telemetry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry.d.ts","sourceRoot":"","sources":["../src/telemetry.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH;;;GAGG;AACH,wBAAsB,aAAa,IAAI,OAAO,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,CAqDlE;AAED,yDAAyD;AACzD,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,CAIvD"}

package/dist/telemetry.js

@@ -0,0 +1,61 @@
+/**
+ * Optional OpenTelemetry initialization for the MCP server.
+ *
+ * Activates only when OTEL_EXPORTER_OTLP_ENDPOINT is set in the environment.
+ * Exports traces via OTLP/HTTP to the configured collector (e.g. https://otel.oka.so).
+ *
+ * Zero cost when disabled — returns a no-op shutdown function.
+ */
+let shutdownFn;
+/**
+ * Initialize OTel tracing if OTEL_EXPORTER_OTLP_ENDPOINT is set.
+ * Returns a shutdown function that flushes pending spans.
+ */
+export async function initTelemetry() {
+    const endpoint = process.env.OTEL_EXPORTER_OTLP_ENDPOINT;
+    if (!endpoint) {
+        return async () => { };
+    }
+    try {
+        const { NodeTracerProvider } = await import("@opentelemetry/sdk-trace-node");
+        const { BatchSpanProcessor } = await import("@opentelemetry/sdk-trace-base");
+        const { OTLPTraceExporter } = await import("@opentelemetry/exporter-trace-otlp-http");
+        const { Resource } = await import("@opentelemetry/resources");
+        const { ATTR_SERVICE_NAME, ATTR_SERVICE_VERSION } = await import("@opentelemetry/semantic-conventions");
+        const { createRequire } = await import("node:module");
+        const require = createRequire(import.meta.url);
+        const { version } = require("../package.json");
+        const resource = new Resource({
+            [ATTR_SERVICE_NAME]: process.env.OTEL_SERVICE_NAME ?? "oka-reason-mcp",
+            [ATTR_SERVICE_VERSION]: version,
+            "service.namespace": "agentic",
+        });
+        const exporter = new OTLPTraceExporter({
+            url: `${endpoint.replace(/\/$/, "")}/v1/traces`,
+            headers: process.env.OTEL_EXPORTER_OTLP_HEADERS
+                ? Object.fromEntries(process.env.OTEL_EXPORTER_OTLP_HEADERS.split(",").map((h) => {
+                    const [k = "", ...v] = h.split("=");
+                    return [k.trim(), v.join("=").trim()];
+                }))
+                : undefined,
+        });
+        const provider = new NodeTracerProvider({ resource });
+        provider.addSpanProcessor(new BatchSpanProcessor(exporter));
+        provider.register();
+        shutdownFn = async () => {
+            await provider.forceFlush();
+            await provider.shutdown();
+        };
+        return shutdownFn;
+    }
+    catch {
+        // OTel deps not installed — degrade gracefully
+        return async () => { };
+    }
+}
+/** Flush and shut down the OTel provider (if active). */
+export async function shutdownTelemetry() {
+    if (shutdownFn) {
+        await shutdownFn();
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oka-core/reason",
-  "version": "0.2.16",
+  "version": "0.2.17",
   "description": "MCP server for institutional knowledge capture, semantic search, and consolidation",
   "private": false,
   "publishConfig": {
@@ -58,6 +58,13 @@
     "@modelcontextprotocol/sdk": "^1.0.0",
     "zod": "^3.23.0"
   },
+  "optionalDependencies": {
+    "@opentelemetry/sdk-trace-node": "^1.25.0",
+    "@opentelemetry/sdk-trace-base": "^1.25.0",
+    "@opentelemetry/exporter-trace-otlp-http": "^0.52.0",
+    "@opentelemetry/resources": "^1.25.0",
+    "@opentelemetry/semantic-conventions": "^1.25.0"
+  },
   "devDependencies": {
     "typescript": "^5.5.0",
     "vitest": "^2.0.0",