@warpmetrics/warp 0.0.18 → 0.0.19

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@warpmetrics/warp",
-  "version": "0.0.18",
+  "version": "0.0.19",
   "description": "Measure your agents, not your LLM calls.",
   "type": "module",
   "main": "src/index.js",

package/src/core/transport.js

@@ -166,7 +166,7 @@ export function logRun(data) {
     label: data.label,
     opts: data.opts || null,
     refId: data.refId || null,
-    timestamp: new Date().toISOString(),
+    startedAt: data.startedAt || new Date().toISOString(),
   });
 }
 
@@ -175,7 +175,7 @@ export function logGroup(data) {
     id: data.id,
     label: data.label,
     opts: data.opts || null,
-    timestamp: new Date().toISOString(),
+    startedAt: data.startedAt || new Date().toISOString(),
   });
 }
 

package/src/core/warp.js

@@ -32,13 +32,14 @@ function createInterceptor(originalFn, context, provider) {
 
     try {
       const result  = await originalFn.apply(context, args);
-      const latency = Date.now() - start;
+      const duration = Date.now() - start;
 
       if (stream) {
         return wrapStream(result, { callId, provider, model, messages, tools, start });
       }
 
       const ext  = provider.extract(result);
+      const endedAt = new Date().toISOString();
 
       responseRegistry.set(result, {
         id: callId,
@@ -47,8 +48,9 @@ function createInterceptor(originalFn, context, provider) {
           response: ext.response,
           tools: tools ? tools.map(t => t.function?.name || t.name).filter(Boolean) : null,
           toolCalls: ext.toolCalls,
-          tokens: ext.tokens, latency,
-          timestamp: new Date().toISOString(),
+          tokens: ext.tokens, duration,
+          startedAt: new Date(start).toISOString(),
+          endedAt,
           status: 'success',
         },
       });
@@ -56,13 +58,15 @@ function createInterceptor(originalFn, context, provider) {
       return result;
     } catch (error) {
       const errorResult = { _warpError: true };
+      const duration = Date.now() - start;
       responseRegistry.set(errorResult, {
         id: callId,
         data: {
           id: callId, provider: provider.name, model, messages,
           error: error.message,
-          latency: Date.now() - start,
-          timestamp: new Date().toISOString(),
+          duration,
+          startedAt: new Date(start).toISOString(),
+          endedAt: new Date().toISOString(),
           status: 'error',
         },
       });
@@ -95,6 +99,7 @@ function wrapStream(stream, ctx) {
         ? ctx.provider.normalizeUsage(usage)
         : { prompt: 0, completion: 0, total: 0 };
 
+      const duration = Date.now() - ctx.start;
       responseRegistry.set(wrapped, {
         id: ctx.callId,
         data: {
@@ -102,8 +107,9 @@ function wrapStream(stream, ctx) {
           response: content,
           tools: ctx.tools ? ctx.tools.map(t => t.function?.name || t.name).filter(Boolean) : null,
           tokens,
-          latency: Date.now() - ctx.start,
-          timestamp: new Date().toISOString(),
+          duration,
+          startedAt: new Date(ctx.start).toISOString(),
+          endedAt: new Date().toISOString(),
           status: 'success',
         },
       });

package/src/index.d.ts

@@ -63,9 +63,11 @@ export interface TraceData {
   /** Token usage. */
   tokens?: { prompt?: number; completion?: number; total?: number };
   /** Duration in milliseconds. */
-  latency?: number;
-  /** ISO 8601 timestamp (auto-generated if omitted). */
-  timestamp?: string;
+  duration?: number;
+  /** ISO 8601 timestamp of when the call started. */
+  startedAt?: string;
+  /** ISO 8601 timestamp of when the call ended (auto-generated if omitted). */
+  endedAt?: string;
   /** "success" (default) or "error". */
   status?: string;
   /** Error message. */

package/src/trace/group.js

@@ -14,6 +14,7 @@ import { logGroup, logLink, getConfig } from '../core/transport.js';
  * @returns {{ readonly id: string, readonly _type: 'group' }}
  */
 export function group(target, label, opts) {
+  const startedAt = new Date().toISOString();
   const targetId = getRef(target);
   if (!targetId) {
     if (getConfig().debug) console.warn('[warpmetrics] group() — target not recognised.');
@@ -29,6 +30,7 @@ export function group(target, label, opts) {
     label,
     opts: opts || null,
     parentId: targetId,
+    startedAt,
     groups: [],
     calls: [],
   };

package/src/trace/run.js

@@ -14,6 +14,7 @@ import { logRun, getConfig } from '../core/transport.js';
  * @returns {{ readonly id: string, readonly _type: 'run' }}
  */
 export function run(labelOrRef, labelOrOpts, maybeOpts) {
+  const startedAt = new Date().toISOString();
   let refId = null;
   let label, opts;
 
@@ -37,6 +38,7 @@ export function run(labelOrRef, labelOrOpts, maybeOpts) {
     label,
     opts,
     refId,
+    startedAt,
     groups: [],
     calls: [],
   };

package/src/trace/trace.js

@@ -26,6 +26,10 @@ export function trace(target, data) {
 
   const id = generateId('call');
 
+  const endedAt = data.endedAt || data.timestamp || new Date().toISOString();
+  const duration = data.duration ?? data.latency ?? null;
+  const startedAt = data.startedAt || (duration != null ? new Date(new Date(endedAt).getTime() - duration).toISOString() : endedAt);
+
   const event = {
     id,
     provider: data.provider,
@@ -35,8 +39,9 @@ export function trace(target, data) {
     tools: data.tools || null,
     toolCalls: data.toolCalls || null,
     tokens: data.tokens || null,
-    latency: data.latency ?? null,
-    timestamp: data.timestamp || new Date().toISOString(),
+    duration,
+    startedAt,
+    endedAt,
     status: data.status || 'success',
   };