autotel-devtools 23.1.0 → 24.0.0

package/dist/types-B86Qkqg5.d.cts

@@ -0,0 +1,120 @@
+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;
+  /** 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[];
+  calls: number;
+  errors: 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;
+}
+interface WebMcpInventory {
+  tools: WebMcpTool[];
+  summary: WebMcpSummary;
+}
+//#endregion
+export { WebMcpInventory as i, SpanAttributes as n, SpanData as r, AttributeValue as t };

package/dist/types-B86Qkqg5.d.ts

@@ -0,0 +1,120 @@
+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;
+  /** 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[];
+  calls: number;
+  errors: 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;
+}
+interface WebMcpInventory {
+  tools: WebMcpTool[];
+  summary: WebMcpSummary;
+}
+//#endregion
+export { WebMcpInventory as i, SpanAttributes as n, SpanData as r, AttributeValue as t };

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

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

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

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