agent-inspect 1.5.0 → 1.6.0

package/packages/core/dist/{log-config-BzGmDYum.d.cts → inspect-event-Des4JDHo.d.cts}

@@ -38,34 +38,4 @@ interface InspectRunTree {
     };
 }
 
-interface LogEventMapping {
-    kind?: InspectKind;
-    name?: string;
-    parent?: string;
-    status?: "running" | "ok" | "error";
-    startsRun?: boolean;
-    endsRun?: boolean;
-    startsStep?: boolean;
-    endsStep?: boolean;
-}
-type RedactionStrategy = "full" | "prefix" | "hash";
-type RedactionRule = string | {
-    key: string;
-    strategy: RedactionStrategy;
-    keep?: number;
-};
-interface LogIngestConfig {
-    runIdKeys: string[];
-    eventKey: string;
-    timestampKey?: string;
-    messageKey?: string;
-    levelKey?: string;
-    parentIdKey?: string;
-    durationKey?: string;
-    statusKey?: string;
-    mappings?: Record<string, LogEventMapping>;
-    redact?: RedactionRule[];
-    heuristicWindowMs?: number;
-}
-
-export type { AttributionConfidence as A, EventSource as E, InspectEvent as I, LogEventMapping as L, RedactionRule as R, InspectKind as a, InspectNode as b, InspectRunTree as c, LogIngestConfig as d, RedactionStrategy as e };
+export type { AttributionConfidence as A, EventSource as E, InspectKind as I, InspectEvent as a, InspectNode as b, InspectRunTree as c };

package/packages/core/dist/{log-config-BzGmDYum.d.ts → inspect-event-Des4JDHo.d.ts}

@@ -38,34 +38,4 @@ interface InspectRunTree {
     };
 }
 
-interface LogEventMapping {
-    kind?: InspectKind;
-    name?: string;
-    parent?: string;
-    status?: "running" | "ok" | "error";
-    startsRun?: boolean;
-    endsRun?: boolean;
-    startsStep?: boolean;
-    endsStep?: boolean;
-}
-type RedactionStrategy = "full" | "prefix" | "hash";
-type RedactionRule = string | {
-    key: string;
-    strategy: RedactionStrategy;
-    keep?: number;
-};
-interface LogIngestConfig {
-    runIdKeys: string[];
-    eventKey: string;
-    timestampKey?: string;
-    messageKey?: string;
-    levelKey?: string;
-    parentIdKey?: string;
-    durationKey?: string;
-    statusKey?: string;
-    mappings?: Record<string, LogEventMapping>;
-    redact?: RedactionRule[];
-    heuristicWindowMs?: number;
-}
-
-export type { AttributionConfidence as A, EventSource as E, InspectEvent as I, LogEventMapping as L, RedactionRule as R, InspectKind as a, InspectNode as b, InspectRunTree as c, LogIngestConfig as d, RedactionStrategy as e };
+export type { AttributionConfidence as A, EventSource as E, InspectKind as I, InspectEvent as a, InspectNode as b, InspectRunTree as c };

package/packages/core/dist/log-config-BnH8Ykcb.d.cts

@@ -0,0 +1,33 @@
+import { I as InspectKind } from './inspect-event-Des4JDHo.cjs';
+
+interface LogEventMapping {
+    kind?: InspectKind;
+    name?: string;
+    parent?: string;
+    status?: "running" | "ok" | "error";
+    startsRun?: boolean;
+    endsRun?: boolean;
+    startsStep?: boolean;
+    endsStep?: boolean;
+}
+type RedactionStrategy = "full" | "prefix" | "hash";
+type RedactionRule = string | {
+    key: string;
+    strategy: RedactionStrategy;
+    keep?: number;
+};
+interface LogIngestConfig {
+    runIdKeys: string[];
+    eventKey: string;
+    timestampKey?: string;
+    messageKey?: string;
+    levelKey?: string;
+    parentIdKey?: string;
+    durationKey?: string;
+    statusKey?: string;
+    mappings?: Record<string, LogEventMapping>;
+    redact?: RedactionRule[];
+    heuristicWindowMs?: number;
+}
+
+export type { LogEventMapping as L, RedactionRule as R, LogIngestConfig as a, RedactionStrategy as b };

package/packages/core/dist/log-config-C1GcJPIM.d.ts

@@ -0,0 +1,33 @@
+import { I as InspectKind } from './inspect-event-Des4JDHo.js';
+
+interface LogEventMapping {
+    kind?: InspectKind;
+    name?: string;
+    parent?: string;
+    status?: "running" | "ok" | "error";
+    startsRun?: boolean;
+    endsRun?: boolean;
+    startsStep?: boolean;
+    endsStep?: boolean;
+}
+type RedactionStrategy = "full" | "prefix" | "hash";
+type RedactionRule = string | {
+    key: string;
+    strategy: RedactionStrategy;
+    keep?: number;
+};
+interface LogIngestConfig {
+    runIdKeys: string[];
+    eventKey: string;
+    timestampKey?: string;
+    messageKey?: string;
+    levelKey?: string;
+    parentIdKey?: string;
+    durationKey?: string;
+    statusKey?: string;
+    mappings?: Record<string, LogEventMapping>;
+    redact?: RedactionRule[];
+    heuristicWindowMs?: number;
+}
+
+export type { LogEventMapping as L, RedactionRule as R, LogIngestConfig as a, RedactionStrategy as b };

package/packages/core/dist/logs.d.cts

@@ -1,5 +1,6 @@
-import { d as LogIngestConfig, L as LogEventMapping, R as RedactionRule, I as InspectEvent, c as InspectRunTree } from './log-config-BzGmDYum.cjs';
-export { e as RedactionStrategy } from './log-config-BzGmDYum.cjs';
+import { a as LogIngestConfig, L as LogEventMapping, R as RedactionRule } from './log-config-BnH8Ykcb.cjs';
+export { b as RedactionStrategy } from './log-config-BnH8Ykcb.cjs';
+import { a as InspectEvent, c as InspectRunTree } from './inspect-event-Des4JDHo.cjs';
 
 type ParserWarningCode = "MALFORMED_JSON" | "MISSING_RUN_ID" | "MISSING_EVENT" | "MISSING_TIMESTAMP" | "UNSUPPORTED_LOG4JS_PAYLOAD" | "CONFIG_ERROR" | "UNKNOWN";
 interface ParserWarning {

package/packages/core/dist/logs.d.ts

@@ -1,5 +1,6 @@
-import { d as LogIngestConfig, L as LogEventMapping, R as RedactionRule, I as InspectEvent, c as InspectRunTree } from './log-config-BzGmDYum.js';
-export { e as RedactionStrategy } from './log-config-BzGmDYum.js';
+import { a as LogIngestConfig, L as LogEventMapping, R as RedactionRule } from './log-config-C1GcJPIM.js';
+export { b as RedactionStrategy } from './log-config-C1GcJPIM.js';
+import { a as InspectEvent, c as InspectRunTree } from './inspect-event-Des4JDHo.js';
 
 type ParserWarningCode = "MALFORMED_JSON" | "MISSING_RUN_ID" | "MISSING_EVENT" | "MISSING_TIMESTAMP" | "UNSUPPORTED_LOG4JS_PAYLOAD" | "CONFIG_ERROR" | "UNKNOWN";
 interface ParserWarning {

package/packages/core/dist/logs.mjs

@@ -1,6 +1,6 @@
-export { DEFAULT_LOG_INGEST_CONFIG, EventNormalizer, JsonLogParser, LiveLogAccumulator, Log4jsParser, loadLogIngestConfig, matchMapping, mergeLogIngestConfig, parseLogLine, parseLogsToTrees, renderRunTree, renderRunTrees, wildcardMatch } from './chunk-QPAU2TPA.mjs';
-import './chunk-7TGZLWEE.mjs';
-export { TreeBuilder } from './chunk-E5F2LQCX.mjs';
+export { DEFAULT_LOG_INGEST_CONFIG, EventNormalizer, JsonLogParser, LiveLogAccumulator, Log4jsParser, loadLogIngestConfig, matchMapping, mergeLogIngestConfig, parseLogLine, parseLogsToTrees, renderRunTree, renderRunTrees, wildcardMatch } from './chunk-HR7G62IE.mjs';
 export { DEFAULT_REDACT_KEYS, Redactor } from './chunk-VU6O5QAH.mjs';
+export { TreeBuilder } from './chunk-E5F2LQCX.mjs';
+import './chunk-7TGZLWEE.mjs';
 //# sourceMappingURL=logs.mjs.map
 //# sourceMappingURL=logs.mjs.map

package/packages/core/dist/persisted-inspect-event-0kaRADsp.d.cts

@@ -0,0 +1,56 @@
+import { I as InspectKind, A as AttributionConfidence } from './inspect-event-Des4JDHo.cjs';
+
+type PersistedSchemaVersion = "0.2";
+type PersistedEventSourceType = "manual" | "json-log" | "log4js" | "adapter" | "ai-sdk" | "otel";
+interface PersistedEventSource {
+    type: PersistedEventSourceType;
+    name?: string;
+    version?: string;
+}
+type PersistedEventStatus = "running" | "ok" | "error" | "unknown";
+interface PersistedInspectError {
+    name?: string;
+    message: string;
+    code?: string;
+}
+interface PersistedTokenUsage {
+    input?: number;
+    output?: number;
+    total?: number;
+    cached?: number;
+}
+interface PersistedTraceContext {
+    traceId?: string;
+    spanId?: string;
+    parentSpanId?: string;
+}
+interface PersistedInspectEvent {
+    schemaVersion: PersistedSchemaVersion;
+    eventId: string;
+    runId: string;
+    parentId?: string;
+    kind: InspectKind;
+    name: string;
+    status?: PersistedEventStatus;
+    timestamp: string;
+    startedAt?: string;
+    endedAt?: string;
+    durationMs?: number;
+    confidence: AttributionConfidence;
+    source: PersistedEventSource;
+    attributes?: Record<string, unknown>;
+    inputSummary?: unknown;
+    outputSummary?: unknown;
+    error?: PersistedInspectError;
+    tokenUsage?: PersistedTokenUsage;
+    trace?: PersistedTraceContext;
+}
+/**
+ * Runtime guard for a v0.2 {@link PersistedInspectEvent} JSON object.
+ *
+ * Timestamp fields (`timestamp`, `startedAt`, `endedAt`) are validated as
+ * non-empty strings only — stricter ISO-8601 parsing may be added later.
+ */
+declare function isPersistedInspectEvent(value: unknown): value is PersistedInspectEvent;
+
+export { type PersistedInspectEvent as P, type PersistedEventSource as a, type PersistedEventSourceType as b, type PersistedEventStatus as c, type PersistedInspectError as d, type PersistedSchemaVersion as e, type PersistedTokenUsage as f, type PersistedTraceContext as g, isPersistedInspectEvent as i };

package/packages/core/dist/persisted-inspect-event-DiFto0K2.d.ts

@@ -0,0 +1,56 @@
+import { I as InspectKind, A as AttributionConfidence } from './inspect-event-Des4JDHo.js';
+
+type PersistedSchemaVersion = "0.2";
+type PersistedEventSourceType = "manual" | "json-log" | "log4js" | "adapter" | "ai-sdk" | "otel";
+interface PersistedEventSource {
+    type: PersistedEventSourceType;
+    name?: string;
+    version?: string;
+}
+type PersistedEventStatus = "running" | "ok" | "error" | "unknown";
+interface PersistedInspectError {
+    name?: string;
+    message: string;
+    code?: string;
+}
+interface PersistedTokenUsage {
+    input?: number;
+    output?: number;
+    total?: number;
+    cached?: number;
+}
+interface PersistedTraceContext {
+    traceId?: string;
+    spanId?: string;
+    parentSpanId?: string;
+}
+interface PersistedInspectEvent {
+    schemaVersion: PersistedSchemaVersion;
+    eventId: string;
+    runId: string;
+    parentId?: string;
+    kind: InspectKind;
+    name: string;
+    status?: PersistedEventStatus;
+    timestamp: string;
+    startedAt?: string;
+    endedAt?: string;
+    durationMs?: number;
+    confidence: AttributionConfidence;
+    source: PersistedEventSource;
+    attributes?: Record<string, unknown>;
+    inputSummary?: unknown;
+    outputSummary?: unknown;
+    error?: PersistedInspectError;
+    tokenUsage?: PersistedTokenUsage;
+    trace?: PersistedTraceContext;
+}
+/**
+ * Runtime guard for a v0.2 {@link PersistedInspectEvent} JSON object.
+ *
+ * Timestamp fields (`timestamp`, `startedAt`, `endedAt`) are validated as
+ * non-empty strings only — stricter ISO-8601 parsing may be added later.
+ */
+declare function isPersistedInspectEvent(value: unknown): value is PersistedInspectEvent;
+
+export { type PersistedInspectEvent as P, type PersistedEventSource as a, type PersistedEventSourceType as b, type PersistedEventStatus as c, type PersistedInspectError as d, type PersistedSchemaVersion as e, type PersistedTokenUsage as f, type PersistedTraceContext as g, isPersistedInspectEvent as i };

package/packages/core/dist/persisted.cjs

@@ -83,6 +83,7 @@ function isPersistedTokenUsage(value) {
   if (!isOptionalNonNegativeNumber(value.input)) return false;
   if (!isOptionalNonNegativeNumber(value.output)) return false;
   if (!isOptionalNonNegativeNumber(value.total)) return false;
+  if (!isOptionalNonNegativeNumber(value.cached)) return false;
   return true;
 }
 function isPersistedTraceContext(value) {
@@ -154,6 +155,32 @@ function extractCorrelationMetadata(record) {
   return found ? out : void 0;
 }
 
+// packages/core/src/persisted/token-usage.ts
+function isRecord2(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function nonNegativeFinite(value) {
+  return typeof value === "number" && Number.isFinite(value) && value >= 0 ? value : void 0;
+}
+function normalizeTokenUsage(value) {
+  if (!isRecord2(value)) return void 0;
+  const input = nonNegativeFinite(value.input);
+  const output = nonNegativeFinite(value.output);
+  const suppliedTotal = nonNegativeFinite(value.total);
+  const cached = nonNegativeFinite(value.cached);
+  const derivedTotal = input !== void 0 && output !== void 0 && Number.isFinite(input + output) ? input + output : void 0;
+  const total = suppliedTotal ?? derivedTotal;
+  if (input === void 0 && output === void 0 && total === void 0 && cached === void 0) {
+    return void 0;
+  }
+  return {
+    ...input !== void 0 ? { input } : {},
+    ...output !== void 0 ? { output } : {},
+    ...total !== void 0 ? { total } : {},
+    ...cached !== void 0 ? { cached } : {}
+  };
+}
+
 // packages/core/src/persisted/from-trace-event.ts
 function sanitizeIdPart(value) {
   return value.replace(/[^a-zA-Z0-9_-]/g, "_");
@@ -226,22 +253,7 @@ function mapErrorInfo(error) {
   return out;
 }
 function mapTokenUsageFromMetadata(metadata) {
-  const tokens = metadata?.tokens;
-  if (!tokens || typeof tokens !== "object") {
-    return void 0;
-  }
-  const input = typeof tokens.input === "number" && Number.isFinite(tokens.input) && tokens.input >= 0 ? tokens.input : void 0;
-  const output = typeof tokens.output === "number" && Number.isFinite(tokens.output) && tokens.output >= 0 ? tokens.output : void 0;
-  if (input === void 0 && output === void 0) {
-    return void 0;
-  }
-  const usage = {};
-  if (input !== void 0) usage.input = input;
-  if (output !== void 0) usage.output = output;
-  if (input !== void 0 && output !== void 0) {
-    usage.total = input + output;
-  }
-  return usage;
+  return normalizeTokenUsage(metadata?.tokens);
 }
 function compactAttributes(entries) {
   const out = {};
@@ -445,23 +457,7 @@ function mapInspectSourceToPersisted(source, options) {
   }
 }
 function mapTokenUsageFromAttributes(attributes) {
-  const tokens = attributes?.tokens;
-  if (!tokens || typeof tokens !== "object" || Array.isArray(tokens)) {
-    return void 0;
-  }
-  const rec = tokens;
-  const input = typeof rec.input === "number" && Number.isFinite(rec.input) && rec.input >= 0 ? rec.input : void 0;
-  const output = typeof rec.output === "number" && Number.isFinite(rec.output) && rec.output >= 0 ? rec.output : void 0;
-  if (input === void 0 && output === void 0) {
-    return void 0;
-  }
-  const usage = {};
-  if (input !== void 0) usage.input = input;
-  if (output !== void 0) usage.output = output;
-  if (input !== void 0 && output !== void 0) {
-    usage.total = input + output;
-  }
-  return usage;
+  return normalizeTokenUsage(attributes?.tokens);
 }
 function mapErrorFromAttributes(event) {
   if (event.status !== "error" || !event.attributes) {
@@ -718,10 +714,10 @@ function mapPersistedStatusToRunStatus(status) {
       return void 0;
   }
 }
-function mapPersistedError(error) {
+function mapPersistedError(error, attributes) {
   if (!error?.message) return void 0;
   const out = { message: error.message };
-  const stack = typeof error.name === "string" && error.name.length > 0 ? error.name : void 0;
+  const stack = typeof attributes?.errorStack === "string" && attributes.errorStack.length > 0 ? attributes.errorStack : void 0;
   if (stack) {
     out.stack = stack;
   }
@@ -735,7 +731,9 @@ function mapTokenUsageToMetadata(tokenUsage, attributes) {
   if (tokenUsage) {
     metadata.tokens = {
       ...tokenUsage.input !== void 0 ? { input: tokenUsage.input } : {},
-      ...tokenUsage.output !== void 0 ? { output: tokenUsage.output } : {}
+      ...tokenUsage.output !== void 0 ? { output: tokenUsage.output } : {},
+      ...tokenUsage.total !== void 0 ? { total: tokenUsage.total } : {},
+      ...tokenUsage.cached !== void 0 ? { cached: tokenUsage.cached } : {}
     };
   }
   return Object.keys(metadata).length > 0 ? metadata : void 0;
@@ -808,7 +806,7 @@ function fromLegacyRunCompleted(event) {
     endTime,
     durationMs: event.durationMs ?? Math.max(0, endTime - timestamp)
   };
-  const error = mapPersistedError(event.error);
+  const error = mapPersistedError(event.error, event.attributes);
   if (error) out.error = error;
   return out;
 }
@@ -842,7 +840,7 @@ function fromLegacyStepCompleted(event) {
     endTime,
     durationMs: event.durationMs ?? Math.max(0, endTime - timestamp)
   };
-  const error = mapPersistedError(event.error);
+  const error = mapPersistedError(event.error, event.attributes);
   if (error) out.error = error;
   return out;
 }
@@ -873,7 +871,7 @@ function fromNativeRun(event) {
       endTime,
       durationMs: event.durationMs ?? Math.max(0, endTime - startTime)
     };
-    const error = mapPersistedError(event.error);
+    const error = mapPersistedError(event.error, event.attributes);
     if (error) completed.error = error;
     out.push(completed);
   }
@@ -915,7 +913,7 @@ function fromNativeStep(event) {
       endTime,
       durationMs: event.durationMs ?? Math.max(0, endTime - startTime)
     };
-    const error = mapPersistedError(event.error);
+    const error = mapPersistedError(event.error, event.attributes);
     if (error) completed.error = error;
     out.push(completed);
   }