@agent-inspect/mcp-server 6.31.17 → 6.31.19

package/dist/cli.mjs

@@ -1,4 +1,4 @@
-import { runReadOnlyMcpServer } from './chunk-Z4YKTU4Y.mjs';
+import { runReadOnlyMcpServer } from './chunk-L5YP42Q6.mjs';
 import { readFileSync } from 'fs';
 import path from 'path';
 import { fileURLToPath } from 'url';

package/dist/index.cjs

@@ -2568,7 +2568,7 @@ function extractSessionWorkflowMetadata(record) {
   assignString("conversationId", record.conversationId);
   assignString("groupId", record.groupId);
   assignString("parentGroupId", record.parentGroupId);
-  assignString("retryOf", record.retryOf);
+  assignString("retryOf", record.retryOf ?? record["agent_inspect.retry_of"]);
   assignString("retryReason", record.retryReason);
   assignString("handoffFrom", record.handoffFrom);
   assignString("handoffTo", record.handoffTo);
@@ -2581,8 +2581,8 @@ function extractSessionWorkflowMetadata(record) {
   assignString("toolCallId", record.toolCallId);
   assignString("mcpToolCallId", record.mcpToolCallId);
   assignString("linkedStepId", record.linkedStepId);
-  assignString("operationId", record.operationId);
-  assignString("attemptId", record.attemptId);
+  assignString("operationId", record.operationId ?? record["agent_inspect.operation_id"]);
+  assignString("attemptId", record.attemptId ?? record["agent_inspect.attempt_id"]);
   assignString("fallbackOf", record.fallbackOf);
   assignString("idempotencyKey", record.idempotencyKey);
   assignString("correlationId", record.correlationId);
@@ -2593,7 +2593,9 @@ function extractSessionWorkflowMetadata(record) {
     out.attempt = attempt;
     found = true;
   }
-  const attemptNumber = finitePositiveInt(record.attemptNumber);
+  const attemptNumber = finitePositiveInt(
+    record.attemptNumber ?? record["agent_inspect.attempt_number"]
+  );
   if (attemptNumber !== void 0) {
     out.attemptNumber = attemptNumber;
     found = true;
@@ -6420,6 +6422,70 @@ function mapOtlpEvents(value, pathPrefix) {
     unsupportedFields
   };
 }
+function promoteAgentInspectWorkflowIdentity(attributes, pathPrefix) {
+  const warnings = [];
+  const mapping = [
+    ["agent_inspect.operation_id", "operationId", "string"],
+    ["agent_inspect.attempt_id", "attemptId", "string"],
+    ["agent_inspect.retry_of", "retryOf", "string"],
+    ["agent_inspect.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];
+    if (raw === void 0 || raw === null) continue;
+    let promoted;
+    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 value.`,
+          severity: "warning",
+          field: `${pathPrefix}.${dotted}`
+        });
+        continue;
+      }
+      promoted = Math.trunc(n);
+    } else if (typeof raw === "string" && raw.trim() !== "") {
+      promoted = raw.trim();
+    } else {
+      warnings.push({
+        code: "otlp_identity_invalid",
+        message: `Ignoring non-string ${dotted} identity value.`,
+        severity: "warning",
+        field: `${pathPrefix}.${dotted}`
+      });
+      continue;
+    }
+    const direct = attributes[camel];
+    const nested = metadata[camel];
+    if (direct !== void 0 && direct !== promoted) {
+      warnings.push({
+        code: "otlp_identity_conflict",
+        message: `Conflicting ${camel}: attributes.${camel} vs ${dotted}; keeping camelCase.`,
+        severity: "warning",
+        field: `${pathPrefix}.${dotted}`
+      });
+      continue;
+    }
+    if (nested !== void 0 && nested !== promoted && direct === void 0) {
+      warnings.push({
+        code: "otlp_identity_conflict",
+        message: `Conflicting ${camel}: attributes.metadata.${camel} vs ${dotted}; keeping nested.`,
+        severity: "warning",
+        field: `${pathPrefix}.${dotted}`
+      });
+      continue;
+    }
+    if (direct === void 0) attributes[camel] = promoted;
+    if (nested === void 0) metadata[camel] = promoted;
+  }
+  if (Object.keys(metadata).length > 0) {
+    attributes.metadata = metadata;
+  }
+  return warnings;
+}
 function mapOtlpSpan(context) {
   const { span, pathPrefix } = context;
   const warnings = [];
@@ -6451,6 +6517,7 @@ function mapOtlpSpan(context) {
   if (context.scopeVersion !== void 0) {
     attributes["scope.version"] = context.scopeVersion;
   }
+  warnings.push(...promoteAgentInspectWorkflowIdentity(attributes, pathPrefix));
   for (const [key, value] of Object.entries(span)) {
     if (OTLP_SPAN_KEYS.has(key)) continue;
     unsupportedFields.push(`${pathPrefix}.${key}`);
@@ -6488,6 +6555,7 @@ function mapOtlpSpan(context) {
   if (events.events !== void 0) {
     attributes["otlp.events"] = events.events;
   }
+  warnings.push(...promoteAgentInspectWorkflowIdentity(attributes, pathPrefix));
   const traceId = readStringField(span, ["traceId"]) ?? "trace-unknown";
   const spanId = readStringField(span, ["spanId"]) ?? "span-unknown";
   const parentSpanId = readStringField(span, ["parentSpanId"]);
@@ -7592,6 +7660,51 @@ function genAiOperationName(kind) {
       return void 0;
   }
 }
+var STRUCTURAL_IDENTITY_KEYS = [
+  "operationId",
+  "attemptId",
+  "retryOf",
+  "attemptNumber",
+  "attempt"
+];
+function pickBoundedIdentityString(bag, key, maxLen) {
+  if (!bag || typeof bag !== "object") return void 0;
+  const direct = bag[key];
+  if (typeof direct === "string" && direct.trim() !== "") {
+    return direct.trim().slice(0, maxLen);
+  }
+  const nested = bag.metadata && typeof bag.metadata === "object" ? bag.metadata[key] : void 0;
+  if (typeof nested === "string" && nested.trim() !== "") {
+    return nested.trim().slice(0, maxLen);
+  }
+  return void 0;
+}
+function pickBoundedIdentityNumber(bag, key) {
+  if (!bag || typeof bag !== "object") return void 0;
+  const direct = bag[key];
+  if (typeof direct === "number" && Number.isFinite(direct)) return direct;
+  const nested = bag.metadata && typeof bag.metadata === "object" ? bag.metadata[key] : void 0;
+  if (typeof nested === "number" && Number.isFinite(nested)) return nested;
+  return void 0;
+}
+function appendStructuralIdentityAttrs(attrs2, meta, maxLen) {
+  const operationId = pickBoundedIdentityString(meta, "operationId", maxLen);
+  if (operationId !== void 0) {
+    attrs2.push(stringAttr2("agent_inspect.operation_id", operationId));
+  }
+  const attemptId = pickBoundedIdentityString(meta, "attemptId", maxLen);
+  if (attemptId !== void 0) {
+    attrs2.push(stringAttr2("agent_inspect.attempt_id", attemptId));
+  }
+  const retryOf = pickBoundedIdentityString(meta, "retryOf", maxLen);
+  if (retryOf !== void 0) {
+    attrs2.push(stringAttr2("agent_inspect.retry_of", retryOf));
+  }
+  const attemptNumber = pickBoundedIdentityNumber(meta, "attemptNumber") ?? pickBoundedIdentityNumber(meta, "attempt");
+  if (attemptNumber !== void 0) {
+    attrs2.push(intAttr("agent_inspect.attempt_number", attemptNumber));
+  }
+}
 function resolveSpanTimes(ev) {
   const startedAtMs = typeof ev.attributes?.startedAtMs === "number" && Number.isFinite(ev.attributes.startedAtMs) ? ev.attributes.startedAtMs : void 0;
   const endedAtMs = typeof ev.attributes?.endedAtMs === "number" && Number.isFinite(ev.attributes.endedAtMs) ? ev.attributes.endedAtMs : void 0;
@@ -7612,7 +7725,8 @@ function exportOtlpJson(tree, options) {
   const warnings = [
     "OTLP JSON export uses OTel GenAI-aligned attributes where applicable; experimental until verified against specific collectors.",
     "Not OTLP gRPC/protobuf \u2014 JSON mapping only. Generated locally; no network upload.",
-    "Status and span kind use OTLP numeric enums (StatusCode 0/1/2, SpanKind INTERNAL=1)."
+    "Status and span kind use OTLP numeric enums (StatusCode 0/1/2, SpanKind INTERNAL=1).",
+    "When present on source events, operationId/attemptId/retryOf/attemptNumber are emitted as bounded agent_inspect.* identity attributes (not a broad attribute dump)."
   ];
   const traceId = hexFrom2(`trace:${tree.runId}`, 16);
   const includeAttributes = options?.includeAttributes ?? false;
@@ -7660,6 +7774,11 @@ function exportOtlpJson(tree, options) {
       if (typeof inp === "number") attrs2.push(intAttr("gen_ai.usage.input_tokens", inp));
       if (typeof outp === "number") attrs2.push(intAttr("gen_ai.usage.output_tokens", outp));
     }
+    appendStructuralIdentityAttrs(
+      attrs2,
+      meta && typeof meta === "object" ? meta : void 0,
+      maxLen
+    );
     if (includeAttributes && meta && typeof meta === "object") {
       const skipKeys = /* @__PURE__ */ new Set([
         "tokens",
@@ -7668,7 +7787,8 @@ function exportOtlpJson(tree, options) {
         "responseModel",
         "responseModelId",
         "provider",
-        "originalSourceType"
+        "originalSourceType",
+        ...STRUCTURAL_IDENTITY_KEYS
       ]);
       for (const [k, v] of Object.entries(meta)) {
         if (skipKeys.has(k)) continue;