autotel-devtools 23.1.0 → 24.1.0

package/dist/server/index.d.ts

@@ -1,9 +1,9 @@
-import "../types-DHDvZnnn.js";
-import { a as SpanData, i as LogData, n as ErrorGroup, o as TraceData, r as ErrorOccurrence, t as DevtoolsData } from "../types-DM8y4A9Z.js";
-import { a as DevtoolsStoreOptions, c as QueryLogsArgs, d as QueryTracesArgs, f as QueryTracesResult, i as DevtoolsStore, l as QueryLogsResult, m as TimeWindow, n as DevtoolsServer, o as MetricCatalogEntry, p as SPAN_SCHEMA, r as DevtoolsServerOptions, s as MetricSeries, t as DevtoolsSpanExporter, u as QueryMetricSeriesArgs } from "../exporter-C88W22vY.js";
+import "../types-hVSf0DoT.js";
+import { a as SpanData, i as LogData, n as ErrorGroup, o as TraceData, r as ErrorOccurrence, t as DevtoolsData } from "../types-Do48caKG.js";
+import { a as DevtoolsStoreOptions, c as QueryLogsArgs, d as QueryTracesArgs, f as QueryTracesResult, i as DevtoolsStore, l as QueryLogsResult, m as TimeWindow, n as DevtoolsServer, o as MetricCatalogEntry, p as SPAN_SCHEMA, r as DevtoolsServerOptions, s as MetricSeries, t as DevtoolsSpanExporter, u as QueryMetricSeriesArgs } from "../exporter-BRSxg3Du.js";
 import { DevtoolsLogExporter } from "./log-exporter.js";
 import { DevtoolsRemoteExporter, DevtoolsRemoteExporterOptions } from "./remote-exporter.js";
-import { t as ErrorAggregator } from "../error-aggregator-B52JI8jL.js";
+import { t as ErrorAggregator } from "../error-aggregator-BzhW482_.js";
 import { Server } from "node:http";
 import { AgentRawEvent, OtelMetricRecord } from "autotel-agents";
 //#region src/server/http.d.ts

package/dist/server/index.js

@@ -1,7 +1,7 @@
-import { C as ErrorAggregator, S as resolveTelemetryLimits, _ as isLoopbackHostname, a as probePortHolder, b as appendWithLimit, c as decodeOtlpTraceRequest, d as parseOtlpLogs, f as parseOtlpTraces, g as hostHeaderIsLoopback, h as allowSensitiveRequest, i as DEVTOOLS_IDENTITY, l as DevtoolsServer, m as SPAN_SCHEMA, n as createDevtoolsHttpServer, o as decodeOtlpLogsRequest, p as DevtoolsStore, s as decodeOtlpMetricsRequest, t as attachDevtoolsRoutes, u as isProtobufContentType, v as originIsLoopback, x as applyTelemetryLimits, y as appendManyWithLimit } from "../http-gk1xapnA.js";
+import { C as ErrorAggregator, S as resolveTelemetryLimits, _ as isLoopbackHostname, a as probePortHolder, b as appendWithLimit, c as decodeOtlpTraceRequest, d as parseOtlpLogs, f as parseOtlpTraces, g as hostHeaderIsLoopback, h as allowSensitiveRequest, i as DEVTOOLS_IDENTITY, l as DevtoolsServer, m as SPAN_SCHEMA, n as createDevtoolsHttpServer, o as decodeOtlpLogsRequest, p as DevtoolsStore, s as decodeOtlpMetricsRequest, t as attachDevtoolsRoutes, u as isProtobufContentType, v as originIsLoopback, x as applyTelemetryLimits, y as appendManyWithLimit } from "../http-JTSqQPVJ.js";
 import { DevtoolsSpanExporter } from "./exporter.js";
 import { DevtoolsLogExporter } from "./log-exporter.js";
 import { DevtoolsRemoteExporter } from "./remote-exporter.js";
-import { t as startOtlpGrpcReceiver } from "../grpc-DY-C1jSU.js";
+import { t as startOtlpGrpcReceiver } from "../grpc-C35twtEj.js";
 
 export { DEVTOOLS_IDENTITY, DevtoolsLogExporter, DevtoolsRemoteExporter, DevtoolsServer, DevtoolsSpanExporter, DevtoolsStore, ErrorAggregator, SPAN_SCHEMA, allowSensitiveRequest, appendManyWithLimit, appendWithLimit, applyTelemetryLimits, attachDevtoolsRoutes, createDevtoolsHttpServer, decodeOtlpLogsRequest, decodeOtlpMetricsRequest, decodeOtlpTraceRequest, hostHeaderIsLoopback, isLoopbackHostname, isProtobufContentType, originIsLoopback, parseOtlpLogs, parseOtlpTraces, probePortHolder, resolveTelemetryLimits, startOtlpGrpcReceiver };

package/dist/{types-DM8y4A9Z.d.ts → types-Do48caKG.d.ts}

@@ -1,4 +1,4 @@
-import { n as SpanAttributes } from "./types-DHDvZnnn.js";
+import { n as SpanAttributes } from "./types-hVSf0DoT.js";
 import { AgentSession } from "autotel-agents";
 //#region src/server/types.d.ts
 interface SpanData {

package/dist/{types-B0tjwFqj.d.cts → types-ZU74Na4z.d.cts}

@@ -1,4 +1,4 @@
-import { n as SpanAttributes } from "./types-DHDvZnnn.cjs";
+import { n as SpanAttributes } from "./types-hVSf0DoT.cjs";
 import { AgentSession } from "autotel-agents";
 //#region src/server/types.d.ts
 interface SpanData {

package/dist/types-hVSf0DoT.d.cts

@@ -0,0 +1,138 @@
+import { AgentSession } from "autotel-agents";
+//#region src/widget/types.d.ts
+/**
+ * What a span attribute holds once it has crossed OTLP. The widget is
+ * browser-safe and does not depend on the OTel API package, so the value type
+ * is named here rather than imported.
+ */
+type AttributeValue = string | number | boolean | null | undefined | Uint8Array | Array<AttributeValue> | {
+  [key: string]: AttributeValue;
+};
+/**
+ * A span's attribute bag as the devtools receives it. Wider than OpenTelemetry's
+ * own `Attributes` on purpose: OTLP's kvlist and array values decode to nested
+ * maps and lists, and the devtools displays whatever actually arrived.
+ */
+type SpanAttributes = Record<string, AttributeValue>;
+interface SpanData {
+  traceId: string;
+  spanId: string;
+  parentSpanId?: string;
+  name: string;
+  kind: 'INTERNAL' | 'SERVER' | 'CLIENT' | 'PRODUCER' | 'CONSUMER';
+  startTime: number;
+  endTime: number;
+  duration: number;
+  attributes: SpanAttributes;
+  status: {
+    code: 'OK' | 'ERROR' | 'UNSET';
+    message?: string;
+  };
+  events?: Array<{
+    name: string;
+    timestamp: number;
+    attributes?: SpanAttributes;
+  }>;
+  links?: Array<{
+    traceId: string;
+    spanId: string;
+    attributes?: SpanAttributes;
+  }>;
+  scope?: {
+    name?: string;
+    version?: string;
+  };
+}
+/**
+ * The WebMCP tool surface, as folded by `server/webmcp-aggregator`.
+ *
+ * A tool is not a span: it is a name whose lifecycle spans a registration, any
+ * number of executions and possibly a withdrawal, and it is only meaningful
+ * within the installation (page load) that registered it.
+ */
+interface WebMcpCall {
+  timestamp: number;
+  durationMs: number;
+  resultBytes: number;
+  resultType?: string;
+  envelope: boolean;
+  substituted: boolean;
+  error: boolean;
+  /** Installation-local order of this execute. Makes a chain readable. */
+  seq?: number;
+  /** True when the result matched a known library refusal string. */
+  refused: boolean;
+  refusal?: 'confirm' | 'unavailable';
+  /** Present only when the app opted into payload capture. Render masked. */
+  input?: string;
+  /** The exact string the agent received. Present only with payload capture. */
+  result?: string;
+  traceId: string;
+  spanId: string;
+}
+interface WebMcpTool {
+  name: string;
+  /** Installation (page load) this record belongs to. */
+  installationId: string;
+  service: string;
+  sessionId?: string;
+  /** False when the tool was only ever seen executing — see the module note. */
+  observedAtRegistration: boolean;
+  /** True while the tool is offered: registered, and not since withdrawn. */
+  offered: boolean;
+  firstSeen: number;
+  lastSeen: number;
+  descriptionLength?: number;
+  hasInputSchema?: boolean;
+  annotationsSent: string[];
+  /** Annotations the browser discarded. Available nowhere else. */
+  annotationsDropped: string[];
+  /** Display label the browser may promote over `name`. */
+  title?: string;
+  /** True when a non-empty title does not equal the tool name. */
+  labelMismatch: boolean;
+  /** True when this name came back with a different descriptor in this install. */
+  redefined: boolean;
+  /** Fingerprint of the last registered descriptor. */
+  descriptor?: string;
+  calls: number;
+  errors: number;
+  /** Executions whose result matched a known library refusal. */
+  refusedCalls: number;
+  /** Executions whose result was an unwrapped MCP `{ content: [...] }` envelope. */
+  envelopeCalls: number;
+  /** Of `resultBytes`, the part that is envelope wrapper rather than content. */
+  envelopeBytes: number;
+  /** Executions where the browser replaced an empty result with its own text. */
+  substitutedCalls: number;
+  /** UTF-8 bytes of result the agent has paid for across every call. */
+  resultBytes: number;
+  medianResultBytes: number;
+  /** The last few executions, newest first. Bounded — this is not a call log. */
+  recentCalls: WebMcpCall[];
+  traceId?: string;
+  spanId?: string;
+}
+interface WebMcpSummary {
+  installations: number;
+  /** Installations that registered nothing — the "instrumented too late" signature. */
+  emptyInstallations: number;
+  toolsOffered: number;
+  toolsWithdrawn: number;
+  calls: number;
+  errors: number;
+  resultBytes: number;
+  /** Bytes that are envelope wrapper rather than content. See `envelopeOverhead`. */
+  envelopeBytes: number;
+  toolsWithDroppedAnnotations: number;
+  toolsWithoutInputSchema: number;
+  toolsWithLabelMismatch: number;
+  toolsRedefined: number;
+  refusedCalls: number;
+}
+interface WebMcpInventory {
+  tools: WebMcpTool[];
+  summary: WebMcpSummary;
+}
+//#endregion
+export { WebMcpInventory as i, SpanAttributes as n, SpanData as r, AttributeValue as t };

package/dist/types-hVSf0DoT.d.ts

@@ -0,0 +1,138 @@
+import { AgentSession } from "autotel-agents";
+//#region src/widget/types.d.ts
+/**
+ * What a span attribute holds once it has crossed OTLP. The widget is
+ * browser-safe and does not depend on the OTel API package, so the value type
+ * is named here rather than imported.
+ */
+type AttributeValue = string | number | boolean | null | undefined | Uint8Array | Array<AttributeValue> | {
+  [key: string]: AttributeValue;
+};
+/**
+ * A span's attribute bag as the devtools receives it. Wider than OpenTelemetry's
+ * own `Attributes` on purpose: OTLP's kvlist and array values decode to nested
+ * maps and lists, and the devtools displays whatever actually arrived.
+ */
+type SpanAttributes = Record<string, AttributeValue>;
+interface SpanData {
+  traceId: string;
+  spanId: string;
+  parentSpanId?: string;
+  name: string;
+  kind: 'INTERNAL' | 'SERVER' | 'CLIENT' | 'PRODUCER' | 'CONSUMER';
+  startTime: number;
+  endTime: number;
+  duration: number;
+  attributes: SpanAttributes;
+  status: {
+    code: 'OK' | 'ERROR' | 'UNSET';
+    message?: string;
+  };
+  events?: Array<{
+    name: string;
+    timestamp: number;
+    attributes?: SpanAttributes;
+  }>;
+  links?: Array<{
+    traceId: string;
+    spanId: string;
+    attributes?: SpanAttributes;
+  }>;
+  scope?: {
+    name?: string;
+    version?: string;
+  };
+}
+/**
+ * The WebMCP tool surface, as folded by `server/webmcp-aggregator`.
+ *
+ * A tool is not a span: it is a name whose lifecycle spans a registration, any
+ * number of executions and possibly a withdrawal, and it is only meaningful
+ * within the installation (page load) that registered it.
+ */
+interface WebMcpCall {
+  timestamp: number;
+  durationMs: number;
+  resultBytes: number;
+  resultType?: string;
+  envelope: boolean;
+  substituted: boolean;
+  error: boolean;
+  /** Installation-local order of this execute. Makes a chain readable. */
+  seq?: number;
+  /** True when the result matched a known library refusal string. */
+  refused: boolean;
+  refusal?: 'confirm' | 'unavailable';
+  /** Present only when the app opted into payload capture. Render masked. */
+  input?: string;
+  /** The exact string the agent received. Present only with payload capture. */
+  result?: string;
+  traceId: string;
+  spanId: string;
+}
+interface WebMcpTool {
+  name: string;
+  /** Installation (page load) this record belongs to. */
+  installationId: string;
+  service: string;
+  sessionId?: string;
+  /** False when the tool was only ever seen executing — see the module note. */
+  observedAtRegistration: boolean;
+  /** True while the tool is offered: registered, and not since withdrawn. */
+  offered: boolean;
+  firstSeen: number;
+  lastSeen: number;
+  descriptionLength?: number;
+  hasInputSchema?: boolean;
+  annotationsSent: string[];
+  /** Annotations the browser discarded. Available nowhere else. */
+  annotationsDropped: string[];
+  /** Display label the browser may promote over `name`. */
+  title?: string;
+  /** True when a non-empty title does not equal the tool name. */
+  labelMismatch: boolean;
+  /** True when this name came back with a different descriptor in this install. */
+  redefined: boolean;
+  /** Fingerprint of the last registered descriptor. */
+  descriptor?: string;
+  calls: number;
+  errors: number;
+  /** Executions whose result matched a known library refusal. */
+  refusedCalls: number;
+  /** Executions whose result was an unwrapped MCP `{ content: [...] }` envelope. */
+  envelopeCalls: number;
+  /** Of `resultBytes`, the part that is envelope wrapper rather than content. */
+  envelopeBytes: number;
+  /** Executions where the browser replaced an empty result with its own text. */
+  substitutedCalls: number;
+  /** UTF-8 bytes of result the agent has paid for across every call. */
+  resultBytes: number;
+  medianResultBytes: number;
+  /** The last few executions, newest first. Bounded — this is not a call log. */
+  recentCalls: WebMcpCall[];
+  traceId?: string;
+  spanId?: string;
+}
+interface WebMcpSummary {
+  installations: number;
+  /** Installations that registered nothing — the "instrumented too late" signature. */
+  emptyInstallations: number;
+  toolsOffered: number;
+  toolsWithdrawn: number;
+  calls: number;
+  errors: number;
+  resultBytes: number;
+  /** Bytes that are envelope wrapper rather than content. See `envelopeOverhead`. */
+  envelopeBytes: number;
+  toolsWithDroppedAnnotations: number;
+  toolsWithoutInputSchema: number;
+  toolsWithLabelMismatch: number;
+  toolsRedefined: number;
+  refusedCalls: number;
+}
+interface WebMcpInventory {
+  tools: WebMcpTool[];
+  summary: WebMcpSummary;
+}
+//#endregion
+export { WebMcpInventory as i, SpanAttributes as n, SpanData as r, AttributeValue as t };