@agent-inspect/viewer 6.31.21 → 6.31.23

package/dist/index.mjs

@@ -2748,22 +2748,192 @@ function runTraceChecks(input, options = {}) {
   };
 }
 
+// packages/core/src/checks/canonical-equality.ts
+var DEFAULT_MAX_DEPTH = 8;
+var DEFAULT_MAX_BYTES = 16384;
+function sortKeysDeep(input, depth, maxDepth) {
+  if (depth > maxDepth) {
+    throw new Error("AI_CHECK_CANONICAL_DEPTH_EXCEEDED");
+  }
+  if (input === null || typeof input !== "object") return input;
+  if (Array.isArray(input)) {
+    return input.map((item) => sortKeysDeep(item, depth + 1, maxDepth));
+  }
+  const record = input;
+  const out = {};
+  for (const key of Object.keys(record).sort()) {
+    out[key] = sortKeysDeep(record[key], depth + 1, maxDepth);
+  }
+  return out;
+}
+function encodeCanonicalStructured(value, limits) {
+  const maxDepth = DEFAULT_MAX_DEPTH;
+  const maxBytes = DEFAULT_MAX_BYTES;
+  try {
+    const sorted = sortKeysDeep(value, 0, maxDepth);
+    const encoded = JSON.stringify(sorted);
+    if (encoded === void 0) {
+      return {
+        ok: false,
+        reason: "Value is not JSON-serializable for canonical comparison.",
+        code: "AI_CHECK_CANONICAL_UNSERIALIZABLE"
+      };
+    }
+    if (Buffer.byteLength(encoded, "utf8") > maxBytes) {
+      return {
+        ok: false,
+        reason: "Canonical structured value exceeds bounded size limit.",
+        code: "AI_CHECK_CANONICAL_SIZE_EXCEEDED"
+      };
+    }
+    return { ok: true, value: encoded };
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    if (message === "AI_CHECK_CANONICAL_DEPTH_EXCEEDED") {
+      return {
+        ok: false,
+        reason: "Canonical structured value exceeds bounded depth limit.",
+        code: "AI_CHECK_CANONICAL_DEPTH_EXCEEDED"
+      };
+    }
+    return {
+      ok: false,
+      reason: "Canonical structured encoding failed.",
+      code: "AI_CHECK_CANONICAL_UNSERIALIZABLE"
+    };
+  }
+}
+
+// packages/core/src/persisted/delivery-identity.ts
+var DELIVERY_CONFLICT_ATTR = "agent_inspect.delivery_conflict";
+var DELIVERY_EVENT_BASE_ATTR = "agent_inspect.delivery_event_base";
+var MAX_DELIVERY_BASE_LEN = 500;
+function stripReaderDeliveryDiscriminator(eventId, attributes) {
+  if (!eventId) return eventId;
+  const rawBase = attributes?.[DELIVERY_EVENT_BASE_ATTR];
+  if (typeof rawBase !== "string" || rawBase.trim() === "") return eventId;
+  const base = rawBase.trim().slice(0, MAX_DELIVERY_BASE_LEN);
+  if (eventId === base) return base;
+  const prefix = `${base}:`;
+  if (!eventId.startsWith(prefix)) return eventId;
+  const suffix = eventId.slice(prefix.length);
+  if (/^\d+$/.test(suffix)) return base;
+  return eventId;
+}
+function deliveryEventBaseFromIndexedId(eventId) {
+  if (!/:\d+$/.test(eventId)) return void 0;
+  const base = eventId.replace(/:\d+$/, "");
+  return base.length > 0 ? base.slice(0, MAX_DELIVERY_BASE_LEN) : void 0;
+}
+function canonicalDigest(value) {
+  if (value === void 0) return null;
+  const encoded = encodeCanonicalStructured(value);
+  return encoded.ok ? encoded.value : `unencodable:${encoded.code}`;
+}
+function capturedContentDigest(attributes) {
+  if (!attributes || typeof attributes !== "object") {
+    return { args: null, result: null };
+  }
+  const nested = attributes.metadata && typeof attributes.metadata === "object" ? attributes.metadata : void 0;
+  const args = attributes.arguments ?? attributes.args ?? attributes.input ?? nested?.arguments ?? nested?.args ?? nested?.input;
+  const result = attributes.result ?? attributes.output ?? attributes.response ?? nested?.result ?? nested?.output ?? nested?.response;
+  return {
+    args: args === void 0 ? null : canonicalDigest(args),
+    result: result === void 0 ? null : canonicalDigest(result)
+  };
+}
+function timeKey(fields) {
+  if (typeof fields.startedAt === "string" && fields.startedAt.trim() !== "") {
+    return fields.startedAt;
+  }
+  if (typeof fields.timestamp === "string" && fields.timestamp.trim() !== "") {
+    return fields.timestamp;
+  }
+  if (typeof fields.timestamp === "number" && Number.isFinite(fields.timestamp)) {
+    return String(fields.timestamp);
+  }
+  return null;
+}
+function deliverySemanticFingerprint(fields) {
+  const content = capturedContentDigest(fields.attributes);
+  return JSON.stringify({
+    stableEventId: stripReaderDeliveryDiscriminator(fields.eventId, fields.attributes),
+    runId: fields.runId,
+    kind: fields.kind,
+    name: fields.name,
+    status: fields.status ?? null,
+    parentId: fields.parentId ?? null,
+    sourceType: fields.sourceType ?? null,
+    time: timeKey(fields),
+    operationId: fields.operationId ?? null,
+    attemptId: fields.attemptId ?? null,
+    attemptNumber: fields.attemptNumber ?? null,
+    retryOf: fields.retryOf ?? null,
+    argsDigest: content.args,
+    resultDigest: content.result
+  });
+}
+function identityFieldsFromAttributes(attributes) {
+  if (!attributes || typeof attributes !== "object") {
+    return {
+      operationId: null,
+      attemptId: null,
+      attemptNumber: null,
+      retryOf: null
+    };
+  }
+  const nested = attributes.metadata && typeof attributes.metadata === "object" && !Array.isArray(attributes.metadata) ? attributes.metadata : void 0;
+  const pickString2 = (key) => {
+    const direct = attributes[key];
+    if (typeof direct === "string" && direct.trim() !== "") return direct.trim();
+    const nestedValue = nested?.[key];
+    if (typeof nestedValue === "string" && nestedValue.trim() !== "") {
+      return nestedValue.trim();
+    }
+    return null;
+  };
+  const pickNumber = () => {
+    const direct = attributes.attemptNumber ?? attributes.attempt;
+    if (typeof direct === "number" && Number.isFinite(direct)) return direct;
+    const nestedValue = nested?.attemptNumber ?? nested?.attempt;
+    if (typeof nestedValue === "number" && Number.isFinite(nestedValue)) {
+      return nestedValue;
+    }
+    return null;
+  };
+  return {
+    operationId: pickString2("operationId"),
+    attemptId: pickString2("attemptId"),
+    retryOf: pickString2("retryOf"),
+    attemptNumber: pickNumber()
+  };
+}
+function stampDeliveryConflict(event) {
+  return {
+    ...event,
+    attributes: {
+      ...event.attributes ?? {},
+      [DELIVERY_CONFLICT_ATTR]: true
+    }
+  };
+}
+
 // packages/core/src/checks/contract.ts
 new Set(OBSERVED_OUTCOME_METHODS);
 
 // packages/core/src/exporters/helpers.ts
-function sortKeysDeep(input) {
+function sortKeysDeep2(input) {
   if (input === null || typeof input !== "object") return input;
-  if (Array.isArray(input)) return input.map(sortKeysDeep);
+  if (Array.isArray(input)) return input.map(sortKeysDeep2);
   const o = input;
   const out = {};
   for (const k of Object.keys(o).sort()) {
-    out[k] = sortKeysDeep(o[k]);
+    out[k] = sortKeysDeep2(o[k]);
   }
   return out;
 }
 function stableJson(value, pretty) {
-  const sorted = sortKeysDeep(value);
+  const sorted = sortKeysDeep2(value);
   return JSON.stringify(sorted);
 }
 
@@ -3641,6 +3811,11 @@ function compactAttributes(entries) {
   }
   return Object.keys(out).length > 0 ? out : void 0;
 }
+function stampDeliveryEventBase(eventId, attributes) {
+  const base = deliveryEventBaseFromIndexedId(eventId);
+  if (!base) return attributes;
+  return { ...attributes ?? {}, [DELIVERY_EVENT_BASE_ATTR]: base };
+}
 function traceEventToPersistedInspectEvent(event, options) {
   const eventIndex = options?.eventIndex ?? 0;
   const eventId = createPersistedEventId(event, eventIndex);
@@ -3670,7 +3845,7 @@ function traceEventToPersistedInspectEvent(event, options) {
         startedAt: tsStart.iso,
         confidence: "explicit",
         source,
-        attributes
+        attributes: stampDeliveryEventBase(eventId, attributes)
       };
     }
     case "run_completed": {
@@ -3693,7 +3868,7 @@ function traceEventToPersistedInspectEvent(event, options) {
         durationMs: event.durationMs,
         confidence: "explicit",
         source,
-        attributes,
+        attributes: stampDeliveryEventBase(eventId, attributes),
         error
       };
     }
@@ -3718,7 +3893,7 @@ function traceEventToPersistedInspectEvent(event, options) {
         startedAt: tsStart.iso,
         confidence: "explicit",
         source,
-        attributes
+        attributes: stampDeliveryEventBase(eventId, attributes)
       };
       if (event.parentId !== void 0) {
         out.parentId = event.parentId;
@@ -3749,7 +3924,7 @@ function traceEventToPersistedInspectEvent(event, options) {
         durationMs: event.durationMs,
         confidence: "explicit",
         source,
-        attributes,
+        attributes: stampDeliveryEventBase(eventId, attributes),
         error
       };
     }
@@ -3776,7 +3951,7 @@ function traceEventToPersistedInspectEvent(event, options) {
         timestamp: tsMain.iso,
         confidence: "explicit",
         source,
-        attributes
+        attributes: stampDeliveryEventBase(eventId, attributes)
       };
       if (event.parentId !== void 0) {
         out.parentId = event.parentId;
@@ -3929,7 +4104,47 @@ var TreeBuilder = class {
       const sorted = [...runEvents].sort((a, b) => a.timestamp - b.timestamp);
       const nodes = /* @__PURE__ */ new Map();
       for (const e of sorted) {
-        nodes.set(e.eventId, { event: e, children: [], depth: 0 });
+        const existing = nodes.get(e.eventId);
+        if (!existing) {
+          nodes.set(e.eventId, { event: e, children: [], depth: 0 });
+          continue;
+        }
+        const existingAttrs = existing.event.attributes && typeof existing.event.attributes === "object" ? existing.event.attributes : void 0;
+        const nextAttrs = e.attributes && typeof e.attributes === "object" ? e.attributes : void 0;
+        const existingIdentity = identityFieldsFromAttributes(existingAttrs);
+        const nextIdentity = identityFieldsFromAttributes(nextAttrs);
+        const existingFp = deliverySemanticFingerprint({
+          eventId: existing.event.eventId,
+          runId: existing.event.runId,
+          kind: existing.event.kind,
+          name: existing.event.name,
+          status: existing.event.status,
+          parentId: existing.event.parentId,
+          timestamp: existing.event.timestamp,
+          sourceType: existing.event.source?.type,
+          attributes: existingAttrs,
+          ...existingIdentity
+        });
+        const nextFp = deliverySemanticFingerprint({
+          eventId: e.eventId,
+          runId: e.runId,
+          kind: e.kind,
+          name: e.name,
+          status: e.status,
+          parentId: e.parentId,
+          timestamp: e.timestamp,
+          sourceType: e.source?.type,
+          attributes: nextAttrs,
+          ...nextIdentity
+        });
+        if (existingFp === nextFp) {
+          continue;
+        }
+        nodes.set(e.eventId, {
+          event: stampDeliveryConflict(e),
+          children: [],
+          depth: 0
+        });
       }
       const { roots, summary } = linkNodesVisibilityFirst(nodes);
       const confidenceBreakdown = {
@@ -5394,6 +5609,12 @@ function promoteAgentInspectWorkflowIdentity(attributes, pathPrefix) {
     ["agent_inspect.retry_of", "retryOf", "string"],
     ["agent_inspect.attempt_number", "attemptNumber", "int"]
   ];
+  const conflictMapping = [
+    ["agent_inspect.identity_conflict.operation_id", "operationId", "string"],
+    ["agent_inspect.identity_conflict.attempt_id", "attemptId", "string"],
+    ["agent_inspect.identity_conflict.retry_of", "retryOf", "string"],
+    ["agent_inspect.identity_conflict.attempt_number", "attemptNumber", "int"]
+  ];
   const metadata = attributes.metadata && typeof attributes.metadata === "object" && !Array.isArray(attributes.metadata) ? { ...attributes.metadata } : {};
   for (const [dotted, camel, kind] of mapping) {
     const raw = attributes[dotted];
@@ -5445,6 +5666,55 @@ function promoteAgentInspectWorkflowIdentity(attributes, pathPrefix) {
     if (direct === void 0) attributes[camel] = promoted;
     if (nested === void 0) metadata[camel] = promoted;
   }
+  for (const [dotted, camel, kind] of conflictMapping) {
+    const raw = attributes[dotted];
+    if (raw === void 0 || raw === null) continue;
+    let alternate;
+    if (kind === "int") {
+      const n = typeof raw === "number" ? raw : typeof raw === "string" ? Number(raw) : NaN;
+      if (!Number.isFinite(n) || n < 1) {
+        warnings.push({
+          code: "otlp_identity_invalid",
+          message: `Ignoring invalid ${dotted} identity conflict value.`,
+          severity: "warning",
+          field: `${pathPrefix}.${dotted}`
+        });
+        continue;
+      }
+      alternate = Math.trunc(n);
+    } else if (typeof raw === "string" && raw.trim() !== "") {
+      alternate = raw.trim();
+    } else {
+      warnings.push({
+        code: "otlp_identity_invalid",
+        message: `Ignoring non-string ${dotted} identity conflict value.`,
+        severity: "warning",
+        field: `${pathPrefix}.${dotted}`
+      });
+      continue;
+    }
+    const preferred = attributes[camel];
+    if (preferred !== void 0 && preferred !== alternate) {
+      metadata[camel] = alternate;
+      warnings.push({
+        code: "otlp_identity_conflict",
+        message: `Conflicting ${camel}: attributes.${camel} vs nested alternate from ${dotted}; retaining both.`,
+        severity: "warning",
+        field: `${pathPrefix}.${dotted}`
+      });
+    } else if (preferred === void 0) {
+      metadata[camel] = alternate;
+    }
+  }
+  const conflictFields = attributes["agent_inspect.identity_conflict.fields"];
+  if (typeof conflictFields === "string" && conflictFields.trim() !== "") {
+    warnings.push({
+      code: "otlp_identity_conflict",
+      message: `Identity representation conflict fields retained after OTLP bounding: ${conflictFields.trim().slice(0, 200)}.`,
+      severity: "warning",
+      field: `${pathPrefix}.agent_inspect.identity_conflict.fields`
+    });
+  }
   if (Object.keys(metadata).length > 0) {
     attributes.metadata = metadata;
   }