@frontmcp/observability 1.9.1-rc.3 → 1.9.2

package/esm/index.mjs

@@ -332,7 +332,7 @@ import {
   AgentCallHook,
   DynamicPlugin,
   FlowHooksOf,
-  FRONTMCP_CONTEXT,
+  FRONTMCP_CONTEXT as FRONTMCP_CONTEXT2,
   HttpHook,
   ListResourcesHook,
   ListResourceTemplatesHook,
@@ -772,15 +772,13 @@ var RequestLogCollector = class {
   }
 };
 
-// libs/observability/src/request-log/request-log.tokens.ts
-var REQUEST_LOG_COLLECTOR = /* @__PURE__ */ Symbol.for("frontmcp:observability:request-log-collector");
-
-// libs/observability/src/telemetry/telemetry.accessor.ts
+// libs/observability/src/plugin/observability.hooks.ts
 import {
-  SpanKind as SpanKind12,
-  SpanStatusCode as SpanStatusCode2,
-  trace as trace4
+  context as otelContext3,
+  SpanKind as SpanKind11,
+  trace as trace3
 } from "@opentelemetry/api";
+import { sha256Hex } from "@frontmcp/utils";
 
 // libs/observability/src/otel/otel.types.ts
 var McpAttributes = {
@@ -895,43 +893,6 @@ var EnduserAttributes = {
   SCOPE: "enduser.scope"
 };
 
-// libs/observability/src/otel/trace-context-bridge.ts
-import {
-  TraceFlags,
-  trace,
-  context as otelContext
-} from "@opentelemetry/api";
-function frontmcpToOTelSpanContext(tc) {
-  return {
-    traceId: tc.traceId,
-    spanId: tc.parentId,
-    traceFlags: tc.traceFlags & TraceFlags.SAMPLED ? TraceFlags.SAMPLED : TraceFlags.NONE,
-    isRemote: true
-  };
-}
-function otelToFrontmcpContext(sc) {
-  const flags = sc.traceFlags.toString(16).padStart(2, "0");
-  return {
-    traceId: sc.traceId,
-    parentId: sc.spanId,
-    traceFlags: sc.traceFlags,
-    raw: `00-${sc.traceId}-${sc.spanId}-${flags}`
-  };
-}
-function createOTelContextFromTrace(tc) {
-  const spanContext = frontmcpToOTelSpanContext(tc);
-  const span = trace.wrapSpanContext(spanContext);
-  return trace.setSpan(otelContext.active(), span);
-}
-
-// libs/observability/src/plugin/observability.hooks.ts
-import {
-  context as otelContext3,
-  SpanKind as SpanKind11,
-  trace as trace3
-} from "@opentelemetry/api";
-import { sha256Hex } from "@frontmcp/utils";
-
 // libs/observability/src/otel/spans/auth.span.ts
 import { SpanKind as SpanKind2 } from "@opentelemetry/api";
 
@@ -939,11 +900,11 @@ import { SpanKind as SpanKind2 } from "@opentelemetry/api";
 import {
   SpanKind,
   SpanStatusCode,
-  context as otelContext2,
-  trace as trace2
+  context as otelContext,
+  trace
 } from "@opentelemetry/api";
 function startSpan(tracer, options) {
-  const parentCtx = options.parentContext ?? otelContext2.active();
+  const parentCtx = options.parentContext ?? otelContext.active();
   const span = tracer.startSpan(
     options.name,
     {
@@ -952,7 +913,7 @@ function startSpan(tracer, options) {
     },
     parentCtx
   );
-  const spanContext = trace2.setSpan(parentCtx, span);
+  const spanContext = trace.setSpan(parentCtx, span);
   return { span, context: spanContext };
 }
 function endSpanOk(span) {
@@ -969,7 +930,7 @@ function endSpanError(span, error) {
 }
 async function withSpan(tracer, options, fn) {
   const { span, context: spanContext } = startSpan(tracer, options);
-  return otelContext2.with(spanContext, async () => {
+  return otelContext.with(spanContext, async () => {
     try {
       const result = await fn(span);
       endSpanOk(span);
@@ -1184,6 +1145,35 @@ function setTransportRequestType(span, requestType) {
   span.setAttribute(FrontMcpAttributes.TRANSPORT_REQUEST_TYPE, requestType);
 }
 
+// libs/observability/src/otel/trace-context-bridge.ts
+import {
+  TraceFlags,
+  trace as trace2,
+  context as otelContext2
+} from "@opentelemetry/api";
+function frontmcpToOTelSpanContext(tc) {
+  return {
+    traceId: tc.traceId,
+    spanId: tc.parentId,
+    traceFlags: tc.traceFlags & TraceFlags.SAMPLED ? TraceFlags.SAMPLED : TraceFlags.NONE,
+    isRemote: true
+  };
+}
+function otelToFrontmcpContext(sc) {
+  const flags = sc.traceFlags.toString(16).padStart(2, "0");
+  return {
+    traceId: sc.traceId,
+    parentId: sc.spanId,
+    traceFlags: sc.traceFlags,
+    raw: `00-${sc.traceId}-${sc.spanId}-${flags}`
+  };
+}
+function createOTelContextFromTrace(tc) {
+  const spanContext = frontmcpToOTelSpanContext(tc);
+  const span = trace2.wrapSpanContext(spanContext);
+  return trace2.setSpan(otelContext2.active(), span);
+}
+
 // libs/observability/src/plugin/observability.hooks.ts
 var SPAN_KEY = /* @__PURE__ */ Symbol.for("frontmcp:otel:span");
 var SPAN_CTX_KEY = /* @__PURE__ */ Symbol.for("frontmcp:otel:span-ctx");
@@ -1375,7 +1365,7 @@ function onToolWillApplyUI(flowCtx) {
 function onToolDidFinalize(flowCtx) {
   const rpcSpan = flowCtx.state?.[SPAN_KEY];
   const toolSpan = flowCtx.state?.[EXEC_SPAN_KEY];
-  const error = flowCtx.state?.error;
+  const error = flowCtx.state?.flowError;
   if (error) {
     if (toolSpan) endSpanError(toolSpan, error instanceof Error ? error : String(error));
     if (rpcSpan) endSpanError(rpcSpan, error instanceof Error ? error : String(error));
@@ -1428,7 +1418,7 @@ function onResourceDidExecute(flowCtx) {
 function onResourceDidFinalize(flowCtx) {
   const rpcSpan = flowCtx.state?.[SPAN_KEY];
   const resSpan = flowCtx.state?.[EXEC_SPAN_KEY];
-  const error = flowCtx.state?.error;
+  const error = flowCtx.state?.flowError;
   if (error) {
     if (resSpan) endSpanError(resSpan, error instanceof Error ? error : String(error));
     if (rpcSpan) endSpanError(rpcSpan, error instanceof Error ? error : String(error));
@@ -1484,7 +1474,7 @@ function onPromptDidExecute(flowCtx) {
 function onPromptDidFinalize(flowCtx) {
   const rpcSpan = flowCtx.state?.[SPAN_KEY];
   const promptSpan = flowCtx.state?.[EXEC_SPAN_KEY];
-  const error = flowCtx.state?.error;
+  const error = flowCtx.state?.flowError;
   if (error) {
     if (promptSpan) endSpanError(promptSpan, error instanceof Error ? error : String(error));
     if (rpcSpan) endSpanError(rpcSpan, error instanceof Error ? error : String(error));
@@ -1547,7 +1537,7 @@ function onAgentDidExecute(flowCtx) {
 function onAgentDidFinalize(flowCtx) {
   const rpcSpan = flowCtx.state?.[SPAN_KEY];
   const agentSpan = flowCtx.state?.[EXEC_SPAN_KEY];
-  const error = flowCtx.state?.error;
+  const error = flowCtx.state?.flowError;
   if (error) {
     if (agentSpan) endSpanError(agentSpan, error instanceof Error ? error : String(error));
     if (rpcSpan) endSpanError(rpcSpan, error instanceof Error ? error : String(error));
@@ -1586,7 +1576,7 @@ function onGenericFlowStage(stageName, flowCtx) {
 function onGenericFlowDidFinalize(flowCtx) {
   const span = flowCtx.state?.[SPAN_KEY];
   if (!span) return;
-  const error = flowCtx.state?.error;
+  const error = flowCtx.state?.flowError;
   if (error) {
     endSpanError(span, error instanceof Error ? error : String(error));
   } else {
@@ -1625,7 +1615,7 @@ function onTransportDidFinalize(flowCtx) {
   const span = flowCtx.state?.[SPAN_KEY];
   if (!span) return;
   recordStageEvent(span, "cleanup", flowCtx.state);
-  const error = flowCtx.state?.error;
+  const error = flowCtx.state?.flowError;
   if (error) {
     endSpanError(span, error instanceof Error ? error : String(error));
   } else {
@@ -1661,7 +1651,7 @@ function onAuthStage(stageName, flowCtx) {
 function onAuthDidFinalize(flowCtx) {
   const span = flowCtx.state?.[SPAN_KEY];
   if (!span) return;
-  const error = flowCtx.state?.error;
+  const error = flowCtx.state?.flowError;
   if (error) {
     setAuthResult(span, "unauthorized");
     endSpanError(span, error instanceof Error ? error : String(error));
@@ -1710,6 +1700,64 @@ function reportStartup(data) {
   emitStartupReport(tracer, data);
 }
 
+// libs/observability/src/request-log/request-log.tokens.ts
+var REQUEST_LOG_COLLECTOR = /* @__PURE__ */ Symbol.for("frontmcp:observability:request-log-collector");
+
+// libs/observability/src/request-log/request-log.hooks.ts
+var FRONTMCP_CONTEXT = /* @__PURE__ */ Symbol.for("frontmcp:CONTEXT");
+function resolve(flowCtx, token) {
+  try {
+    return flowCtx.get?.(token);
+  } catch {
+    return void 0;
+  }
+}
+function currentRequestLog(flowCtx) {
+  return resolve(flowCtx, FRONTMCP_CONTEXT)?.get(REQUEST_LOG_COLLECTOR);
+}
+function startRequestLog(flowCtx, options) {
+  const context = resolve(flowCtx, FRONTMCP_CONTEXT);
+  if (!context) return;
+  const collector = new RequestLogCollector(
+    {
+      requestId: context.requestId,
+      traceId: context.traceContext.traceId,
+      sessionIdHash: sessionTracingId(context.sessionId).slice(0, 12),
+      scopeId: context.scopeId
+    },
+    options
+  );
+  context.set(REQUEST_LOG_COLLECTOR, collector);
+  const request = flowCtx.rawInput?.request;
+  if (request?.method && request.path) collector.setHttpInfo(request.method, request.path);
+  const rpcMethod = request?.body?.method;
+  if (typeof rpcMethod === "string") collector.setRpcMethod(rpcMethod);
+}
+function recordRequestLogFailure(flowCtx) {
+  const failure = flowCtx.state?.["flowError"];
+  if (!failure) return;
+  const error = failure instanceof Error ? failure : new Error(String(failure));
+  currentRequestLog(flowCtx)?.setError({
+    type: error.name,
+    message: error.message,
+    code: error.code
+  });
+}
+async function completeRequestLog(flowCtx) {
+  const collector = currentRequestLog(flowCtx);
+  if (!collector || collector.isFinalized()) return;
+  const statusCode = flowCtx.state?.["statusCode"] ?? flowCtx.rawInput?.response?.statusCode;
+  if (typeof statusCode === "number" && statusCode >= 400) collector.setStatus("error", statusCode);
+  await collector.finalize();
+}
+
+// libs/observability/src/telemetry/telemetry.accessor.ts
+import {
+  SpanKind as SpanKind12,
+  SpanStatusCode as SpanStatusCode2,
+  trace as trace4
+} from "@opentelemetry/api";
+
 // libs/observability/src/telemetry/telemetry.counters.ts
 import { metrics } from "@opentelemetry/api";
 function snapshotKey(name, attributes) {
@@ -2085,8 +2133,19 @@ var ObservabilityPlugin = class extends DynamicPlugin {
   get tracingEnabled() {
     return this.options.tracing !== false;
   }
+  get requestLogsEnabled() {
+    return this.options.requestLogs !== false;
+  }
+  /** Names the entry a request serves on its request log, and records the entry flow's failure. */
+  annotateRequestLog(ctx, set) {
+    if (!this.requestLogsEnabled) return;
+    const flowCtx = ctx;
+    const log = currentRequestLog(ctx);
+    if (log && flowCtx.state?.input) set(log, flowCtx.state.input);
+  }
   _httpWillTrace(ctx) {
     if (this.tracingEnabled) onHttpWillTrace(this.tracingOpts, ctx);
+    if (this.options.requestLogs !== false) startRequestLog(ctx, this.options.requestLogs);
   }
   _httpWillQuota(ctx) {
     if (this.tracingEnabled) onHttpWillAcquireQuota(ctx);
@@ -2108,12 +2167,14 @@ var ObservabilityPlugin = class extends DynamicPlugin {
   }
   _httpDidFinalize(ctx) {
     if (this.tracingEnabled) onHttpDidFinalize(ctx);
+    if (this.requestLogsEnabled) void completeRequestLog(ctx);
   }
   _toolWillParse(ctx) {
     if (this.tracingEnabled) onToolWillParse(this.tracingOpts, ctx);
   }
   _toolWillFind(ctx) {
     if (this.tracingEnabled) onToolWillFindTool(ctx);
+    this.annotateRequestLog(ctx, (log, input) => log.setToolName(String(input["name"])));
   }
   _toolWillCheckAuth(ctx) {
     if (this.tracingEnabled) onToolWillCheckAuth(ctx);
@@ -2144,12 +2205,14 @@ var ObservabilityPlugin = class extends DynamicPlugin {
   }
   _toolDidFinalize(ctx) {
     if (this.tracingEnabled) onToolDidFinalize(ctx);
+    if (this.requestLogsEnabled) recordRequestLogFailure(ctx);
   }
   _resourceWillParse(ctx) {
     if (this.tracingEnabled) onResourceWillParse(this.tracingOpts, ctx);
   }
   _resourceWillFind(ctx) {
     if (this.tracingEnabled) onResourceWillFind(ctx);
+    this.annotateRequestLog(ctx, (log, input) => log.setResourceUri(String(input["uri"])));
   }
   _resourceWillCheckAuthorities(ctx) {
     if (this.tracingEnabled) onEntryWillCheckAuthorities(ctx);
@@ -2165,12 +2228,14 @@ var ObservabilityPlugin = class extends DynamicPlugin {
   }
   _resourceDidFinalize(ctx) {
     if (this.tracingEnabled) onResourceDidFinalize(ctx);
+    if (this.requestLogsEnabled) recordRequestLogFailure(ctx);
   }
   _promptWillParse(ctx) {
     if (this.tracingEnabled) onPromptWillParse(this.tracingOpts, ctx);
   }
   _promptWillFind(ctx) {
     if (this.tracingEnabled) onPromptWillFind(ctx);
+    this.annotateRequestLog(ctx, (log, input) => log.setPromptName(String(input["name"])));
   }
   _promptWillCheckAuthorities(ctx) {
     if (this.tracingEnabled) onEntryWillCheckAuthorities(ctx);
@@ -2186,6 +2251,7 @@ var ObservabilityPlugin = class extends DynamicPlugin {
   }
   _promptDidFinalize(ctx) {
     if (this.tracingEnabled) onPromptDidFinalize(ctx);
+    if (this.requestLogsEnabled) recordRequestLogFailure(ctx);
   }
   _agentWillParse(ctx) {
     if (this.tracingEnabled) onAgentWillParse(this.tracingOpts, ctx);
@@ -2480,7 +2546,7 @@ ObservabilityPlugin.dynamicProviders = (input) => {
       name: "observability:telemetry-accessor",
       provide: TELEMETRY_ACCESSOR,
       scope: ProviderScope.CONTEXT,
-      inject: () => [FRONTMCP_CONTEXT],
+      inject: () => [FRONTMCP_CONTEXT2],
       useFactory: (ctx) => new TelemetryAccessor(ctx)
     });
     providers.push({
@@ -2513,7 +2579,7 @@ ObservabilityPlugin.dynamicProviders = (input) => {
       name: "observability:request-log-collector",
       provide: REQUEST_LOG_COLLECTOR,
       scope: ProviderScope.CONTEXT,
-      inject: () => [FRONTMCP_CONTEXT],
+      inject: () => [FRONTMCP_CONTEXT2],
       useFactory: (ctx) => {
         return new RequestLogCollector(
           {
@@ -3212,6 +3278,13 @@ function renderJsonExposition(counters, gauges = []) {
 import { readdirSync } from "@frontmcp/utils";
 var NS_PER_SECOND = 1e9;
 var MICROS_PER_SECOND = 1e6;
+function probeSafely(probe) {
+  try {
+    return probe();
+  } catch {
+    return void 0;
+  }
+}
 function defaultMonitorEventLoopDelay() {
   try {
     const { monitorEventLoopDelay } = __require("node:perf_hooks");
@@ -3257,54 +3330,70 @@ var ProcessStatsCollector = class {
     this.getActiveHandles = init.getActiveHandles ?? defaultGetActiveHandles;
     this.getActiveRequests = init.getActiveRequests ?? defaultGetActiveRequests;
     this.readFdCount = init.readFdCount ?? defaultReadFdCount;
-    this.cpuStart = this.cpuUsage();
+    this.cpuStart = probeSafely(() => this.cpuUsage());
     if (this.options.eventLoopLag !== false) {
       this.histogram = init.monitorEventLoopDelay ? init.monitorEventLoopDelay() : defaultMonitorEventLoopDelay();
     }
   }
   collect() {
     const entries = [];
-    const cpu = this.cpuUsage(this.cpuStart);
-    entries.push({
-      name: "frontmcp_process_cpu_seconds_total",
-      value: cpu.user / MICROS_PER_SECOND,
-      attributes: { mode: "user" },
-      help: "CPU time consumed since collector start, by mode (seconds)"
-    });
-    entries.push({
-      name: "frontmcp_process_cpu_seconds_total",
-      value: cpu.system / MICROS_PER_SECOND,
-      attributes: { mode: "system" }
-    });
-    const mem = this.memoryUsage();
-    entries.push({
-      name: "frontmcp_process_resident_memory_bytes",
-      value: mem.rss,
-      help: "Resident memory size in bytes"
-    });
-    entries.push({
-      name: "frontmcp_process_heap_bytes",
-      value: mem.heapTotal,
-      help: "Total V8 heap size in bytes"
-    });
-    entries.push({
-      name: "frontmcp_process_heap_used_bytes",
-      value: mem.heapUsed,
-      help: "Used V8 heap size in bytes"
-    });
-    entries.push({
-      name: "frontmcp_process_external_bytes",
-      value: mem.external,
-      help: "Memory used by C++ objects bound to JS in bytes"
-    });
-    entries.push({
-      name: "frontmcp_process_uptime_seconds",
-      value: this.uptime(),
-      help: "Time since process start in seconds"
+    this.cpuStart ??= probeSafely(() => this.cpuUsage());
+    const cpu = this.cpuStart && probeSafely(() => this.cpuUsage(this.cpuStart));
+    if (cpu) {
+      entries.push({
+        name: "frontmcp_process_cpu_seconds_total",
+        value: cpu.user / MICROS_PER_SECOND,
+        attributes: { mode: "user" },
+        help: "CPU time consumed since collector start, by mode (seconds)"
+      });
+      entries.push({
+        name: "frontmcp_process_cpu_seconds_total",
+        value: cpu.system / MICROS_PER_SECOND,
+        attributes: { mode: "system" }
+      });
+    }
+    const mem = probeSafely(() => this.memoryUsage());
+    if (mem) {
+      entries.push({
+        name: "frontmcp_process_resident_memory_bytes",
+        value: mem.rss,
+        help: "Resident memory size in bytes"
+      });
+      entries.push({
+        name: "frontmcp_process_heap_bytes",
+        value: mem.heapTotal,
+        help: "Total V8 heap size in bytes"
+      });
+      entries.push({
+        name: "frontmcp_process_heap_used_bytes",
+        value: mem.heapUsed,
+        help: "Used V8 heap size in bytes"
+      });
+      entries.push({
+        name: "frontmcp_process_external_bytes",
+        value: mem.external,
+        help: "Memory used by C++ objects bound to JS in bytes"
+      });
+    }
+    const uptime = probeSafely(() => this.uptime());
+    if (uptime !== void 0) {
+      entries.push({
+        name: "frontmcp_process_uptime_seconds",
+        value: uptime,
+        help: "Time since process start in seconds"
+      });
+    }
+    const histogram = this.options.eventLoopLag !== false ? this.histogram : void 0;
+    const lag = histogram && probeSafely(() => {
+      const sample = {
+        meanSeconds: histogram.mean / NS_PER_SECOND,
+        p99Seconds: histogram.percentile(99) / NS_PER_SECOND
+      };
+      histogram.reset();
+      return sample;
     });
-    if (this.options.eventLoopLag !== false && this.histogram) {
-      const meanSeconds = this.histogram.mean / NS_PER_SECOND;
-      const p99Seconds = this.histogram.percentile(99) / NS_PER_SECOND;
+    if (lag) {
+      const { meanSeconds, p99Seconds } = lag;
       if (Number.isFinite(meanSeconds)) {
         entries.push({
           name: "frontmcp_nodejs_eventloop_lag_seconds",
@@ -3320,7 +3409,6 @@ var ProcessStatsCollector = class {
           attributes: { quantile: "p99" }
         });
       }
-      this.histogram.reset();
     }
     if (this.options.activeHandles !== false) {
       const handles = this.getActiveHandles?.();

package/esm/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@frontmcp/observability",
-  "version": "1.9.1-rc.3",
+  "version": "1.9.2",
   "description": "OpenTelemetry instrumentation, structured JSON logging, and request log objects for FrontMCP",
   "author": "AgentFront <info@agentfront.dev>",
   "license": "Apache-2.0",
@@ -51,8 +51,8 @@
     "@opentelemetry/api": "^1.9.0"
   },
   "peerDependencies": {
-    "@frontmcp/sdk": "1.9.1-rc.3",
-    "@frontmcp/utils": "1.9.1-rc.3",
+    "@frontmcp/sdk": "1.9.2",
+    "@frontmcp/utils": "1.9.2",
     "@opentelemetry/exporter-trace-otlp-http": "^0.219.0",
     "@opentelemetry/sdk-node": "^0.219.0",
     "@opentelemetry/sdk-trace-base": "^2.8.0",

package/index.js

@@ -831,11 +831,9 @@ var RequestLogCollector = class {
   }
 };
 
-// libs/observability/src/request-log/request-log.tokens.ts
-var REQUEST_LOG_COLLECTOR = /* @__PURE__ */ Symbol.for("frontmcp:observability:request-log-collector");
-
-// libs/observability/src/telemetry/telemetry.accessor.ts
-var import_api14 = require("@opentelemetry/api");
+// libs/observability/src/plugin/observability.hooks.ts
+var import_api12 = require("@opentelemetry/api");
+var import_utils = require("@frontmcp/utils");
 
 // libs/observability/src/otel/otel.types.ts
 var McpAttributes = {
@@ -950,60 +948,31 @@ var EnduserAttributes = {
   SCOPE: "enduser.scope"
 };
 
-// libs/observability/src/otel/trace-context-bridge.ts
-var import_api = require("@opentelemetry/api");
-function frontmcpToOTelSpanContext(tc) {
-  return {
-    traceId: tc.traceId,
-    spanId: tc.parentId,
-    traceFlags: tc.traceFlags & import_api.TraceFlags.SAMPLED ? import_api.TraceFlags.SAMPLED : import_api.TraceFlags.NONE,
-    isRemote: true
-  };
-}
-function otelToFrontmcpContext(sc) {
-  const flags = sc.traceFlags.toString(16).padStart(2, "0");
-  return {
-    traceId: sc.traceId,
-    parentId: sc.spanId,
-    traceFlags: sc.traceFlags,
-    raw: `00-${sc.traceId}-${sc.spanId}-${flags}`
-  };
-}
-function createOTelContextFromTrace(tc) {
-  const spanContext = frontmcpToOTelSpanContext(tc);
-  const span = import_api.trace.wrapSpanContext(spanContext);
-  return import_api.trace.setSpan(import_api.context.active(), span);
-}
-
-// libs/observability/src/plugin/observability.hooks.ts
-var import_api12 = require("@opentelemetry/api");
-var import_utils = require("@frontmcp/utils");
-
 // libs/observability/src/otel/spans/auth.span.ts
-var import_api3 = require("@opentelemetry/api");
+var import_api2 = require("@opentelemetry/api");
 
 // libs/observability/src/otel/spans/span.utils.ts
-var import_api2 = require("@opentelemetry/api");
+var import_api = require("@opentelemetry/api");
 function startSpan(tracer, options) {
-  const parentCtx = options.parentContext ?? import_api2.context.active();
+  const parentCtx = options.parentContext ?? import_api.context.active();
   const span = tracer.startSpan(
     options.name,
     {
-      kind: options.kind ?? import_api2.SpanKind.INTERNAL,
+      kind: options.kind ?? import_api.SpanKind.INTERNAL,
       attributes: options.attributes
     },
     parentCtx
   );
-  const spanContext = import_api2.trace.setSpan(parentCtx, span);
+  const spanContext = import_api.trace.setSpan(parentCtx, span);
   return { span, context: spanContext };
 }
 function endSpanOk(span) {
-  span.setStatus({ code: import_api2.SpanStatusCode.OK });
+  span.setStatus({ code: import_api.SpanStatusCode.OK });
   span.end();
 }
 function endSpanError(span, error) {
   const message = typeof error === "string" ? error : error.message;
-  span.setStatus({ code: import_api2.SpanStatusCode.ERROR, message });
+  span.setStatus({ code: import_api.SpanStatusCode.ERROR, message });
   if (error instanceof Error) {
     span.recordException(error);
   }
@@ -1011,7 +980,7 @@ function endSpanError(span, error) {
 }
 async function withSpan(tracer, options, fn) {
   const { span, context: spanContext } = startSpan(tracer, options);
-  return import_api2.context.with(spanContext, async () => {
+  return import_api.context.with(spanContext, async () => {
     try {
       const result = await fn(span);
       endSpanOk(span);
@@ -1027,7 +996,7 @@ async function withSpan(tracer, options, fn) {
 function startAuthSpan(tracer, options) {
   return startSpan(tracer, {
     name: `auth ${options.flowName}`,
-    kind: import_api3.SpanKind.INTERNAL,
+    kind: import_api2.SpanKind.INTERNAL,
     attributes: {
       [FrontMcpAttributes.FLOW_NAME]: options.flowName
     },
@@ -1042,11 +1011,11 @@ function setAuthResult(span, result) {
 }
 
 // libs/observability/src/otel/spans/fetch.span.ts
-var import_api4 = require("@opentelemetry/api");
+var import_api3 = require("@opentelemetry/api");
 function startFetchSpan(tracer, options) {
   return startSpan(tracer, {
     name: options.method.toUpperCase(),
-    kind: import_api4.SpanKind.CLIENT,
+    kind: import_api3.SpanKind.CLIENT,
     attributes: {
       [HttpAttributes.METHOD]: options.method.toUpperCase(),
       [HttpAttributes.URL_FULL]: options.url
@@ -1059,7 +1028,7 @@ function setFetchResponseStatus(span, statusCode) {
 }
 
 // libs/observability/src/otel/spans/http-server.span.ts
-var import_api5 = require("@opentelemetry/api");
+var import_api4 = require("@opentelemetry/api");
 function startHttpServerSpan(tracer, options) {
   const attributes = {
     [HttpAttributes.METHOD]: options.method.toUpperCase(),
@@ -1082,7 +1051,7 @@ function startHttpServerSpan(tracer, options) {
   }
   return startSpan(tracer, {
     name: `${options.method.toUpperCase()} ${options.path}`,
-    kind: import_api5.SpanKind.SERVER,
+    kind: import_api4.SpanKind.SERVER,
     attributes,
     parentContext: options.parentContext
   });
@@ -1092,11 +1061,11 @@ function setHttpResponseStatus(span, statusCode) {
 }
 
 // libs/observability/src/otel/spans/prompt.span.ts
-var import_api6 = require("@opentelemetry/api");
+var import_api5 = require("@opentelemetry/api");
 function startPromptSpan(tracer, options) {
   return startSpan(tracer, {
     name: `prompt ${options.name}`,
-    kind: import_api6.SpanKind.INTERNAL,
+    kind: import_api5.SpanKind.INTERNAL,
     attributes: {
       [FrontMcpAttributes.PROMPT_NAME]: options.name,
       [McpAttributes.COMPONENT_TYPE]: "prompt",
@@ -1107,7 +1076,7 @@ function startPromptSpan(tracer, options) {
 }
 
 // libs/observability/src/otel/spans/resource.span.ts
-var import_api7 = require("@opentelemetry/api");
+var import_api6 = require("@opentelemetry/api");
 function startResourceSpan(tracer, options) {
   const attributes = {
     [FrontMcpAttributes.RESOURCE_URI]: options.uri,
@@ -1120,14 +1089,14 @@ function startResourceSpan(tracer, options) {
   }
   return startSpan(tracer, {
     name: `resource ${options.uri}`,
-    kind: import_api7.SpanKind.INTERNAL,
+    kind: import_api6.SpanKind.INTERNAL,
     attributes,
     parentContext: options.parentContext
   });
 }
 
 // libs/observability/src/otel/spans/rpc.span.ts
-var import_api8 = require("@opentelemetry/api");
+var import_api7 = require("@opentelemetry/api");
 function startRpcSpan(tracer, options) {
   const attributes = {
     [RpcAttributes.SYSTEM]: "mcp",
@@ -1151,14 +1120,14 @@ function startRpcSpan(tracer, options) {
   }
   return startSpan(tracer, {
     name: options.method,
-    kind: import_api8.SpanKind.SERVER,
+    kind: import_api7.SpanKind.SERVER,
     attributes,
     parentContext: options.parentContext
   });
 }
 
 // libs/observability/src/otel/spans/startup.span.ts
-var import_api9 = require("@opentelemetry/api");
+var import_api8 = require("@opentelemetry/api");
 function emitStartupReport(tracer, data) {
   const attributes = {
     [FrontMcpAttributes.STARTUP_TOOLS_COUNT]: data.toolsCount,
@@ -1172,14 +1141,14 @@ function emitStartupReport(tracer, data) {
   }
   const { span } = startSpan(tracer, {
     name: "frontmcp.startup",
-    kind: import_api9.SpanKind.INTERNAL,
+    kind: import_api8.SpanKind.INTERNAL,
     attributes
   });
   endSpanOk(span);
 }
 
 // libs/observability/src/otel/spans/tool.span.ts
-var import_api10 = require("@opentelemetry/api");
+var import_api9 = require("@opentelemetry/api");
 function startToolSpan(tracer, options) {
   const attributes = {
     [FrontMcpAttributes.TOOL_NAME]: options.name,
@@ -1197,14 +1166,14 @@ function startToolSpan(tracer, options) {
   }
   return startSpan(tracer, {
     name: `tool ${options.name}`,
-    kind: import_api10.SpanKind.INTERNAL,
+    kind: import_api9.SpanKind.INTERNAL,
     attributes,
     parentContext: options.parentContext
   });
 }
 
 // libs/observability/src/otel/spans/transport.span.ts
-var import_api11 = require("@opentelemetry/api");
+var import_api10 = require("@opentelemetry/api");
 function startTransportSpan(tracer, options) {
   const attributes = {
     [FrontMcpAttributes.TRANSPORT_TYPE]: options.type
@@ -1217,7 +1186,7 @@ function startTransportSpan(tracer, options) {
   }
   return startSpan(tracer, {
     name: `transport ${options.type}`,
-    kind: import_api11.SpanKind.INTERNAL,
+    kind: import_api10.SpanKind.INTERNAL,
     attributes,
     parentContext: options.parentContext
   });
@@ -1226,6 +1195,31 @@ function setTransportRequestType(span, requestType) {
   span.setAttribute(FrontMcpAttributes.TRANSPORT_REQUEST_TYPE, requestType);
 }
 
+// libs/observability/src/otel/trace-context-bridge.ts
+var import_api11 = require("@opentelemetry/api");
+function frontmcpToOTelSpanContext(tc) {
+  return {
+    traceId: tc.traceId,
+    spanId: tc.parentId,
+    traceFlags: tc.traceFlags & import_api11.TraceFlags.SAMPLED ? import_api11.TraceFlags.SAMPLED : import_api11.TraceFlags.NONE,
+    isRemote: true
+  };
+}
+function otelToFrontmcpContext(sc) {
+  const flags = sc.traceFlags.toString(16).padStart(2, "0");
+  return {
+    traceId: sc.traceId,
+    parentId: sc.spanId,
+    traceFlags: sc.traceFlags,
+    raw: `00-${sc.traceId}-${sc.spanId}-${flags}`
+  };
+}
+function createOTelContextFromTrace(tc) {
+  const spanContext = frontmcpToOTelSpanContext(tc);
+  const span = import_api11.trace.wrapSpanContext(spanContext);
+  return import_api11.trace.setSpan(import_api11.context.active(), span);
+}
+
 // libs/observability/src/plugin/observability.hooks.ts
 var SPAN_KEY = /* @__PURE__ */ Symbol.for("frontmcp:otel:span");
 var SPAN_CTX_KEY = /* @__PURE__ */ Symbol.for("frontmcp:otel:span-ctx");
@@ -1417,7 +1411,7 @@ function onToolWillApplyUI(flowCtx) {
 function onToolDidFinalize(flowCtx) {
   const rpcSpan = flowCtx.state?.[SPAN_KEY];
   const toolSpan = flowCtx.state?.[EXEC_SPAN_KEY];
-  const error = flowCtx.state?.error;
+  const error = flowCtx.state?.flowError;
   if (error) {
     if (toolSpan) endSpanError(toolSpan, error instanceof Error ? error : String(error));
     if (rpcSpan) endSpanError(rpcSpan, error instanceof Error ? error : String(error));
@@ -1470,7 +1464,7 @@ function onResourceDidExecute(flowCtx) {
 function onResourceDidFinalize(flowCtx) {
   const rpcSpan = flowCtx.state?.[SPAN_KEY];
   const resSpan = flowCtx.state?.[EXEC_SPAN_KEY];
-  const error = flowCtx.state?.error;
+  const error = flowCtx.state?.flowError;
   if (error) {
     if (resSpan) endSpanError(resSpan, error instanceof Error ? error : String(error));
     if (rpcSpan) endSpanError(rpcSpan, error instanceof Error ? error : String(error));
@@ -1526,7 +1520,7 @@ function onPromptDidExecute(flowCtx) {
 function onPromptDidFinalize(flowCtx) {
   const rpcSpan = flowCtx.state?.[SPAN_KEY];
   const promptSpan = flowCtx.state?.[EXEC_SPAN_KEY];
-  const error = flowCtx.state?.error;
+  const error = flowCtx.state?.flowError;
   if (error) {
     if (promptSpan) endSpanError(promptSpan, error instanceof Error ? error : String(error));
     if (rpcSpan) endSpanError(rpcSpan, error instanceof Error ? error : String(error));
@@ -1589,7 +1583,7 @@ function onAgentDidExecute(flowCtx) {
 function onAgentDidFinalize(flowCtx) {
   const rpcSpan = flowCtx.state?.[SPAN_KEY];
   const agentSpan = flowCtx.state?.[EXEC_SPAN_KEY];
-  const error = flowCtx.state?.error;
+  const error = flowCtx.state?.flowError;
   if (error) {
     if (agentSpan) endSpanError(agentSpan, error instanceof Error ? error : String(error));
     if (rpcSpan) endSpanError(rpcSpan, error instanceof Error ? error : String(error));
@@ -1628,7 +1622,7 @@ function onGenericFlowStage(stageName, flowCtx) {
 function onGenericFlowDidFinalize(flowCtx) {
   const span = flowCtx.state?.[SPAN_KEY];
   if (!span) return;
-  const error = flowCtx.state?.error;
+  const error = flowCtx.state?.flowError;
   if (error) {
     endSpanError(span, error instanceof Error ? error : String(error));
   } else {
@@ -1667,7 +1661,7 @@ function onTransportDidFinalize(flowCtx) {
   const span = flowCtx.state?.[SPAN_KEY];
   if (!span) return;
   recordStageEvent(span, "cleanup", flowCtx.state);
-  const error = flowCtx.state?.error;
+  const error = flowCtx.state?.flowError;
   if (error) {
     endSpanError(span, error instanceof Error ? error : String(error));
   } else {
@@ -1703,7 +1697,7 @@ function onAuthStage(stageName, flowCtx) {
 function onAuthDidFinalize(flowCtx) {
   const span = flowCtx.state?.[SPAN_KEY];
   if (!span) return;
-  const error = flowCtx.state?.error;
+  const error = flowCtx.state?.flowError;
   if (error) {
     setAuthResult(span, "unauthorized");
     endSpanError(span, error instanceof Error ? error : String(error));
@@ -1752,6 +1746,60 @@ function reportStartup(data) {
   emitStartupReport(tracer, data);
 }
 
+// libs/observability/src/request-log/request-log.tokens.ts
+var REQUEST_LOG_COLLECTOR = /* @__PURE__ */ Symbol.for("frontmcp:observability:request-log-collector");
+
+// libs/observability/src/request-log/request-log.hooks.ts
+var FRONTMCP_CONTEXT = /* @__PURE__ */ Symbol.for("frontmcp:CONTEXT");
+function resolve(flowCtx, token) {
+  try {
+    return flowCtx.get?.(token);
+  } catch {
+    return void 0;
+  }
+}
+function currentRequestLog(flowCtx) {
+  return resolve(flowCtx, FRONTMCP_CONTEXT)?.get(REQUEST_LOG_COLLECTOR);
+}
+function startRequestLog(flowCtx, options) {
+  const context = resolve(flowCtx, FRONTMCP_CONTEXT);
+  if (!context) return;
+  const collector = new RequestLogCollector(
+    {
+      requestId: context.requestId,
+      traceId: context.traceContext.traceId,
+      sessionIdHash: sessionTracingId(context.sessionId).slice(0, 12),
+      scopeId: context.scopeId
+    },
+    options
+  );
+  context.set(REQUEST_LOG_COLLECTOR, collector);
+  const request = flowCtx.rawInput?.request;
+  if (request?.method && request.path) collector.setHttpInfo(request.method, request.path);
+  const rpcMethod = request?.body?.method;
+  if (typeof rpcMethod === "string") collector.setRpcMethod(rpcMethod);
+}
+function recordRequestLogFailure(flowCtx) {
+  const failure = flowCtx.state?.["flowError"];
+  if (!failure) return;
+  const error = failure instanceof Error ? failure : new Error(String(failure));
+  currentRequestLog(flowCtx)?.setError({
+    type: error.name,
+    message: error.message,
+    code: error.code
+  });
+}
+async function completeRequestLog(flowCtx) {
+  const collector = currentRequestLog(flowCtx);
+  if (!collector || collector.isFinalized()) return;
+  const statusCode = flowCtx.state?.["statusCode"] ?? flowCtx.rawInput?.response?.statusCode;
+  if (typeof statusCode === "number" && statusCode >= 400) collector.setStatus("error", statusCode);
+  await collector.finalize();
+}
+
+// libs/observability/src/telemetry/telemetry.accessor.ts
+var import_api14 = require("@opentelemetry/api");
+
 // libs/observability/src/telemetry/telemetry.counters.ts
 var import_api13 = require("@opentelemetry/api");
 function snapshotKey(name, attributes) {
@@ -2127,8 +2175,19 @@ var ObservabilityPlugin = class extends import_sdk2.DynamicPlugin {
   get tracingEnabled() {
     return this.options.tracing !== false;
   }
+  get requestLogsEnabled() {
+    return this.options.requestLogs !== false;
+  }
+  /** Names the entry a request serves on its request log, and records the entry flow's failure. */
+  annotateRequestLog(ctx, set) {
+    if (!this.requestLogsEnabled) return;
+    const flowCtx = ctx;
+    const log = currentRequestLog(ctx);
+    if (log && flowCtx.state?.input) set(log, flowCtx.state.input);
+  }
   _httpWillTrace(ctx) {
     if (this.tracingEnabled) onHttpWillTrace(this.tracingOpts, ctx);
+    if (this.options.requestLogs !== false) startRequestLog(ctx, this.options.requestLogs);
   }
   _httpWillQuota(ctx) {
     if (this.tracingEnabled) onHttpWillAcquireQuota(ctx);
@@ -2150,12 +2209,14 @@ var ObservabilityPlugin = class extends import_sdk2.DynamicPlugin {
   }
   _httpDidFinalize(ctx) {
     if (this.tracingEnabled) onHttpDidFinalize(ctx);
+    if (this.requestLogsEnabled) void completeRequestLog(ctx);
   }
   _toolWillParse(ctx) {
     if (this.tracingEnabled) onToolWillParse(this.tracingOpts, ctx);
   }
   _toolWillFind(ctx) {
     if (this.tracingEnabled) onToolWillFindTool(ctx);
+    this.annotateRequestLog(ctx, (log, input) => log.setToolName(String(input["name"])));
   }
   _toolWillCheckAuth(ctx) {
     if (this.tracingEnabled) onToolWillCheckAuth(ctx);
@@ -2186,12 +2247,14 @@ var ObservabilityPlugin = class extends import_sdk2.DynamicPlugin {
   }
   _toolDidFinalize(ctx) {
     if (this.tracingEnabled) onToolDidFinalize(ctx);
+    if (this.requestLogsEnabled) recordRequestLogFailure(ctx);
   }
   _resourceWillParse(ctx) {
     if (this.tracingEnabled) onResourceWillParse(this.tracingOpts, ctx);
   }
   _resourceWillFind(ctx) {
     if (this.tracingEnabled) onResourceWillFind(ctx);
+    this.annotateRequestLog(ctx, (log, input) => log.setResourceUri(String(input["uri"])));
   }
   _resourceWillCheckAuthorities(ctx) {
     if (this.tracingEnabled) onEntryWillCheckAuthorities(ctx);
@@ -2207,12 +2270,14 @@ var ObservabilityPlugin = class extends import_sdk2.DynamicPlugin {
   }
   _resourceDidFinalize(ctx) {
     if (this.tracingEnabled) onResourceDidFinalize(ctx);
+    if (this.requestLogsEnabled) recordRequestLogFailure(ctx);
   }
   _promptWillParse(ctx) {
     if (this.tracingEnabled) onPromptWillParse(this.tracingOpts, ctx);
   }
   _promptWillFind(ctx) {
     if (this.tracingEnabled) onPromptWillFind(ctx);
+    this.annotateRequestLog(ctx, (log, input) => log.setPromptName(String(input["name"])));
   }
   _promptWillCheckAuthorities(ctx) {
     if (this.tracingEnabled) onEntryWillCheckAuthorities(ctx);
@@ -2228,6 +2293,7 @@ var ObservabilityPlugin = class extends import_sdk2.DynamicPlugin {
   }
   _promptDidFinalize(ctx) {
     if (this.tracingEnabled) onPromptDidFinalize(ctx);
+    if (this.requestLogsEnabled) recordRequestLogFailure(ctx);
   }
   _agentWillParse(ctx) {
     if (this.tracingEnabled) onAgentWillParse(this.tracingOpts, ctx);
@@ -3252,6 +3318,13 @@ function renderJsonExposition(counters, gauges = []) {
 var import_utils2 = require("@frontmcp/utils");
 var NS_PER_SECOND = 1e9;
 var MICROS_PER_SECOND = 1e6;
+function probeSafely(probe) {
+  try {
+    return probe();
+  } catch {
+    return void 0;
+  }
+}
 function defaultMonitorEventLoopDelay() {
   try {
     const { monitorEventLoopDelay } = require("node:perf_hooks");
@@ -3297,54 +3370,70 @@ var ProcessStatsCollector = class {
     this.getActiveHandles = init.getActiveHandles ?? defaultGetActiveHandles;
     this.getActiveRequests = init.getActiveRequests ?? defaultGetActiveRequests;
     this.readFdCount = init.readFdCount ?? defaultReadFdCount;
-    this.cpuStart = this.cpuUsage();
+    this.cpuStart = probeSafely(() => this.cpuUsage());
     if (this.options.eventLoopLag !== false) {
       this.histogram = init.monitorEventLoopDelay ? init.monitorEventLoopDelay() : defaultMonitorEventLoopDelay();
     }
   }
   collect() {
     const entries = [];
-    const cpu = this.cpuUsage(this.cpuStart);
-    entries.push({
-      name: "frontmcp_process_cpu_seconds_total",
-      value: cpu.user / MICROS_PER_SECOND,
-      attributes: { mode: "user" },
-      help: "CPU time consumed since collector start, by mode (seconds)"
-    });
-    entries.push({
-      name: "frontmcp_process_cpu_seconds_total",
-      value: cpu.system / MICROS_PER_SECOND,
-      attributes: { mode: "system" }
-    });
-    const mem = this.memoryUsage();
-    entries.push({
-      name: "frontmcp_process_resident_memory_bytes",
-      value: mem.rss,
-      help: "Resident memory size in bytes"
-    });
-    entries.push({
-      name: "frontmcp_process_heap_bytes",
-      value: mem.heapTotal,
-      help: "Total V8 heap size in bytes"
-    });
-    entries.push({
-      name: "frontmcp_process_heap_used_bytes",
-      value: mem.heapUsed,
-      help: "Used V8 heap size in bytes"
-    });
-    entries.push({
-      name: "frontmcp_process_external_bytes",
-      value: mem.external,
-      help: "Memory used by C++ objects bound to JS in bytes"
-    });
-    entries.push({
-      name: "frontmcp_process_uptime_seconds",
-      value: this.uptime(),
-      help: "Time since process start in seconds"
+    this.cpuStart ??= probeSafely(() => this.cpuUsage());
+    const cpu = this.cpuStart && probeSafely(() => this.cpuUsage(this.cpuStart));
+    if (cpu) {
+      entries.push({
+        name: "frontmcp_process_cpu_seconds_total",
+        value: cpu.user / MICROS_PER_SECOND,
+        attributes: { mode: "user" },
+        help: "CPU time consumed since collector start, by mode (seconds)"
+      });
+      entries.push({
+        name: "frontmcp_process_cpu_seconds_total",
+        value: cpu.system / MICROS_PER_SECOND,
+        attributes: { mode: "system" }
+      });
+    }
+    const mem = probeSafely(() => this.memoryUsage());
+    if (mem) {
+      entries.push({
+        name: "frontmcp_process_resident_memory_bytes",
+        value: mem.rss,
+        help: "Resident memory size in bytes"
+      });
+      entries.push({
+        name: "frontmcp_process_heap_bytes",
+        value: mem.heapTotal,
+        help: "Total V8 heap size in bytes"
+      });
+      entries.push({
+        name: "frontmcp_process_heap_used_bytes",
+        value: mem.heapUsed,
+        help: "Used V8 heap size in bytes"
+      });
+      entries.push({
+        name: "frontmcp_process_external_bytes",
+        value: mem.external,
+        help: "Memory used by C++ objects bound to JS in bytes"
+      });
+    }
+    const uptime = probeSafely(() => this.uptime());
+    if (uptime !== void 0) {
+      entries.push({
+        name: "frontmcp_process_uptime_seconds",
+        value: uptime,
+        help: "Time since process start in seconds"
+      });
+    }
+    const histogram = this.options.eventLoopLag !== false ? this.histogram : void 0;
+    const lag = histogram && probeSafely(() => {
+      const sample = {
+        meanSeconds: histogram.mean / NS_PER_SECOND,
+        p99Seconds: histogram.percentile(99) / NS_PER_SECOND
+      };
+      histogram.reset();
+      return sample;
     });
-    if (this.options.eventLoopLag !== false && this.histogram) {
-      const meanSeconds = this.histogram.mean / NS_PER_SECOND;
-      const p99Seconds = this.histogram.percentile(99) / NS_PER_SECOND;
+    if (lag) {
+      const { meanSeconds, p99Seconds } = lag;
       if (Number.isFinite(meanSeconds)) {
         entries.push({
           name: "frontmcp_nodejs_eventloop_lag_seconds",
@@ -3360,7 +3449,6 @@ var ProcessStatsCollector = class {
           attributes: { quantile: "p99" }
         });
       }
-      this.histogram.reset();
     }
     if (this.options.activeHandles !== false) {
       const handles = this.getActiveHandles?.();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@frontmcp/observability",
-  "version": "1.9.1-rc.3",
+  "version": "1.9.2",
   "description": "OpenTelemetry instrumentation, structured JSON logging, and request log objects for FrontMCP",
   "author": "AgentFront <info@agentfront.dev>",
   "license": "Apache-2.0",
@@ -51,8 +51,8 @@
     "@opentelemetry/api": "^1.9.0"
   },
   "peerDependencies": {
-    "@frontmcp/sdk": "1.9.1-rc.3",
-    "@frontmcp/utils": "1.9.1-rc.3",
+    "@frontmcp/sdk": "1.9.2",
+    "@frontmcp/utils": "1.9.2",
     "@opentelemetry/exporter-trace-otlp-http": "^0.219.0",
     "@opentelemetry/sdk-node": "^0.219.0",
     "@opentelemetry/sdk-trace-base": "^2.8.0",

package/plugin/observability.plugin.d.ts

@@ -25,6 +25,9 @@ export default class ObservabilityPlugin extends DynamicPlugin<ObservabilityPlug
     private tracingOpts;
     constructor(options?: ObservabilityPluginOptionsInput);
     private get tracingEnabled();
+    private get requestLogsEnabled();
+    /** Names the entry a request serves on its request log, and records the entry flow's failure. */
+    private annotateRequestLog;
     _httpWillTrace(ctx: unknown): void;
     _httpWillQuota(ctx: unknown): void;
     _httpDidSemaphore(ctx: unknown): void;

package/process-stats/process-stats.collector.d.ts

@@ -53,7 +53,7 @@ export declare class ProcessStatsCollector {
     private readonly getActiveHandles?;
     private readonly getActiveRequests?;
     private readonly readFdCount;
-    private cpuStart;
+    private cpuStart?;
     constructor(init?: ProcessStatsCollectorOptions);
     collect(): GaugeSnapshotEntry[];
     /**

package/request-log/request-log.hooks.d.ts

@@ -0,0 +1,28 @@
+import { RequestLogCollector } from './request-log.collector';
+import type { RequestLogCollectorOptions } from './request-log.types';
+interface RequestLogFlowContext {
+    get?(token: unknown): unknown;
+    rawInput?: {
+        request?: {
+            method?: string;
+            path?: string;
+            body?: unknown;
+        };
+        response?: {
+            statusCode?: unknown;
+        };
+    };
+    state?: Record<string | symbol, unknown>;
+}
+/** The open request log of the request `flowCtx` serves; entry flows annotate it. */
+export declare function currentRequestLog(flowCtx: RequestLogFlowContext): RequestLogCollector | undefined;
+/** Opens the request's log, kept on the request context so the entry flows and log entries reach it. */
+export declare function startRequestLog(flowCtx: RequestLogFlowContext, options: RequestLogCollectorOptions): void;
+/** Records why an entry flow failed (its `state.flowError`) on the request's log. */
+export declare function recordRequestLogFailure(flowCtx: RequestLogFlowContext): void;
+/**
+ * Closes the request's log with its HTTP status, which fires `requestLogs.onRequestComplete`: the status the
+ * flow responded with (`state.statusCode`), else the one a transport wrote to the response itself.
+ */
+export declare function completeRequestLog(flowCtx: RequestLogFlowContext): Promise<void>;
+export {};

package/telemetry/telemetry.context-extension.d.ts

@@ -1,12 +1,12 @@
 /**
  * Module augmentation for TypeScript — adds `this.telemetry` to every
  * execution context: ExecutionContextBase (ToolContext, ResourceContext,
- * AgentContext, JobContext, SkillContext, ...) and PromptContext.
+ * AgentContext, JobContext, SkillContext, PromptContext, ...).
  *
  * This file provides type information only. The runtime getter is
  * installed by the SDK's context extension mechanism when the
- * ObservabilityPlugin registers its `contextExtensions`, on the same two
- * prototypes: ExecutionContextBase and PromptContext.
+ * ObservabilityPlugin registers its `contextExtensions`, on
+ * ExecutionContextBase.prototype, which PromptContext inherits.
  */
 import type { TelemetryAccessor } from './telemetry.accessor';
 declare module '@frontmcp/sdk' {