@jambonz/llm 0.4.6 → 0.5.1

package/dist/{types-DbqWrdT6.d.cts → types-BEgQaQIb.d.cts}

@@ -92,6 +92,42 @@ type LlmEvent = {
     finishReason: FinishReason;
     usage?: Usage;
     rawReason?: string;
+    /**
+     * Optional vendor-specific diagnostic data captured from response
+     * headers — request id, rate-limit remaining, routing/region, vendor
+     * processing time, cache token counts, etc. Each adapter contributes
+     * an allowlisted subset; never present unless the adapter populated it.
+     *
+     * Shape is `Record<string, string | number>` so consumers can render
+     * it as a key/value table without per-vendor knowledge. The webapp
+     * surfaces this on the per-turn detail view; feature-server forwards
+     * it on the agent verb's `turn_end` eventHook payload as
+     * `vendor_metadata`.
+     */
+    vendorMetadata?: Record<string, string | number>;
+    /**
+     * Optional client-side timing breakdown for diagnosing latency.
+     * Captured by the adapter using `process.hrtime`. Numbers are
+     * milliseconds. When present:
+     *   - `requestToHeadersMs`: from when the SDK call was initiated
+     *     to when response headers were received. Includes TLS/TCP
+     *     handshake (if connection was cold), network RTT in both
+     *     directions, and any vendor-side queueing/processing time
+     *     before the first byte.
+     *   - `headersToFirstTokenMs`: from response headers received to
+     *     first content chunk emitted. Usually small (<50ms) if the
+     *     vendor is streaming normally; larger values suggest SSE
+     *     buffering or chunk-transfer issues. Undefined if no token
+     *     was emitted (error or empty response).
+     *   - `totalMs`: full wall-clock from SDK call to stream end.
+     * Adapters that cannot measure these (different SDK shape) omit
+     * the field entirely.
+     */
+    clientTiming?: {
+        requestToHeadersMs: number;
+        headersToFirstTokenMs?: number;
+        totalMs: number;
+    };
 };
 /** Convenience alias for the fully-accumulated tool-call event shape. */
 type ToolCallEvent = Extract<LlmEvent, {

package/dist/{types-DbqWrdT6.d.ts → types-BEgQaQIb.d.ts}

@@ -92,6 +92,42 @@ type LlmEvent = {
     finishReason: FinishReason;
     usage?: Usage;
     rawReason?: string;
+    /**
+     * Optional vendor-specific diagnostic data captured from response
+     * headers — request id, rate-limit remaining, routing/region, vendor
+     * processing time, cache token counts, etc. Each adapter contributes
+     * an allowlisted subset; never present unless the adapter populated it.
+     *
+     * Shape is `Record<string, string | number>` so consumers can render
+     * it as a key/value table without per-vendor knowledge. The webapp
+     * surfaces this on the per-turn detail view; feature-server forwards
+     * it on the agent verb's `turn_end` eventHook payload as
+     * `vendor_metadata`.
+     */
+    vendorMetadata?: Record<string, string | number>;
+    /**
+     * Optional client-side timing breakdown for diagnosing latency.
+     * Captured by the adapter using `process.hrtime`. Numbers are
+     * milliseconds. When present:
+     *   - `requestToHeadersMs`: from when the SDK call was initiated
+     *     to when response headers were received. Includes TLS/TCP
+     *     handshake (if connection was cold), network RTT in both
+     *     directions, and any vendor-side queueing/processing time
+     *     before the first byte.
+     *   - `headersToFirstTokenMs`: from response headers received to
+     *     first content chunk emitted. Usually small (<50ms) if the
+     *     vendor is streaming normally; larger values suggest SSE
+     *     buffering or chunk-transfer issues. Undefined if no token
+     *     was emitted (error or empty response).
+     *   - `totalMs`: full wall-clock from SDK call to stream end.
+     * Adapters that cannot measure these (different SDK shape) omit
+     * the field entirely.
+     */
+    clientTiming?: {
+        requestToHeadersMs: number;
+        headersToFirstTokenMs?: number;
+        totalMs: number;
+    };
 };
 /** Convenience alias for the fully-accumulated tool-call event shape. */
 type ToolCallEvent = Extract<LlmEvent, {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jambonz/llm",
-  "version": "0.4.6",
+  "version": "0.5.1",
   "description": "Voice-oriented LLM adapter library — a uniform interface for streaming chat completions from multiple LLM vendors, with first-class support for tool calls, AbortSignal interruption, and lossless history round-tripping.",
   "type": "module",
   "main": "./dist/index.cjs",