agent-inspect 1.4.0 → 1.5.0

package/packages/core/dist/persisted.cjs

@@ -0,0 +1,1057 @@
+'use strict';
+
+// packages/core/src/types/persisted-inspect-event.ts
+var INSPECT_KINDS = [
+  "RUN",
+  "AGENT",
+  "LLM",
+  "TOOL",
+  "CHAIN",
+  "RETRIEVER",
+  "DECISION",
+  "RESULT",
+  "ERROR",
+  "LOGIC",
+  "LOG"
+];
+var ATTRIBUTION_CONFIDENCES = [
+  "explicit",
+  "correlated",
+  "heuristic",
+  "unknown"
+];
+var PERSISTED_EVENT_SOURCE_TYPES = [
+  "manual",
+  "json-log",
+  "log4js",
+  "adapter",
+  "ai-sdk",
+  "otel"
+];
+var PERSISTED_EVENT_STATUSES = [
+  "running",
+  "ok",
+  "error",
+  "unknown"
+];
+function isRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function isString(value) {
+  return typeof value === "string";
+}
+function isNonEmptyString(value) {
+  return typeof value === "string" && value.length > 0;
+}
+function isOptionalString(value) {
+  return value === void 0 || isString(value);
+}
+function isNonNegativeNumber(value) {
+  return typeof value === "number" && Number.isFinite(value) && value >= 0;
+}
+function isOptionalNonNegativeNumber(value) {
+  return value === void 0 || isNonNegativeNumber(value);
+}
+function isInspectKind(value) {
+  return typeof value === "string" && INSPECT_KINDS.includes(value);
+}
+function isAttributionConfidence(value) {
+  return typeof value === "string" && ATTRIBUTION_CONFIDENCES.includes(value);
+}
+function isPersistedEventSourceType(value) {
+  return typeof value === "string" && PERSISTED_EVENT_SOURCE_TYPES.includes(value);
+}
+function isPersistedEventStatus(value) {
+  return typeof value === "string" && PERSISTED_EVENT_STATUSES.includes(value);
+}
+function isPersistedEventSource(value) {
+  if (!isRecord(value)) return false;
+  if (!isPersistedEventSourceType(value.type)) return false;
+  if (!isOptionalString(value.name)) return false;
+  if (!isOptionalString(value.version)) return false;
+  return true;
+}
+function isPersistedInspectError(value) {
+  if (!isRecord(value)) return false;
+  if (!isNonEmptyString(value.message)) return false;
+  if (!isOptionalString(value.name)) return false;
+  if (!isOptionalString(value.code)) return false;
+  return true;
+}
+function isPersistedTokenUsage(value) {
+  if (!isRecord(value)) return false;
+  if (!isOptionalNonNegativeNumber(value.input)) return false;
+  if (!isOptionalNonNegativeNumber(value.output)) return false;
+  if (!isOptionalNonNegativeNumber(value.total)) return false;
+  return true;
+}
+function isPersistedTraceContext(value) {
+  if (!isRecord(value)) return false;
+  if (!isOptionalString(value.traceId)) return false;
+  if (!isOptionalString(value.spanId)) return false;
+  if (!isOptionalString(value.parentSpanId)) return false;
+  return true;
+}
+function isPersistedInspectEvent(value) {
+  if (!isRecord(value)) return false;
+  if (value.schemaVersion !== "0.2") return false;
+  if (!isNonEmptyString(value.eventId)) return false;
+  if (!isNonEmptyString(value.runId)) return false;
+  if (!isInspectKind(value.kind)) return false;
+  if (!isNonEmptyString(value.name)) return false;
+  if (!isNonEmptyString(value.timestamp)) return false;
+  if (!isAttributionConfidence(value.confidence)) return false;
+  if (!isPersistedEventSource(value.source)) return false;
+  if (value.parentId !== void 0 && !isNonEmptyString(value.parentId)) {
+    return false;
+  }
+  if (value.status !== void 0 && !isPersistedEventStatus(value.status)) {
+    return false;
+  }
+  if (!isOptionalString(value.startedAt)) return false;
+  if (!isOptionalString(value.endedAt)) return false;
+  if (value.durationMs !== void 0 && !isNonNegativeNumber(value.durationMs)) {
+    return false;
+  }
+  if (value.attributes !== void 0 && !isRecord(value.attributes)) {
+    return false;
+  }
+  if (value.error !== void 0 && !isPersistedInspectError(value.error)) {
+    return false;
+  }
+  if (value.tokenUsage !== void 0 && !isPersistedTokenUsage(value.tokenUsage)) {
+    return false;
+  }
+  if (value.trace !== void 0 && !isPersistedTraceContext(value.trace)) {
+    return false;
+  }
+  return true;
+}
+
+// packages/core/src/correlation-metadata.ts
+var TRACE_CORRELATION_KEYS = [
+  "correlationId",
+  "requestId",
+  "decisionId",
+  "groupId"
+];
+function isNonEmptyString2(value) {
+  return typeof value === "string" && value.length > 0;
+}
+function extractCorrelationMetadata(record) {
+  if (!record) {
+    return void 0;
+  }
+  const out = {};
+  let found = false;
+  for (const key of TRACE_CORRELATION_KEYS) {
+    const value = record[key];
+    if (isNonEmptyString2(value)) {
+      out[key] = value;
+      found = true;
+    }
+  }
+  return found ? out : void 0;
+}
+
+// packages/core/src/persisted/from-trace-event.ts
+function sanitizeIdPart(value) {
+  return value.replace(/[^a-zA-Z0-9_-]/g, "_");
+}
+function nodeIdForEvent(event) {
+  switch (event.event) {
+    case "run_started":
+    case "run_completed":
+      return event.runId;
+    case "step_started":
+    case "step_completed":
+      return event.stepId;
+    default:
+      return "unknown";
+  }
+}
+function createPersistedEventId(event, eventIndex) {
+  const runId = sanitizeIdPart(event.runId);
+  const ev = sanitizeIdPart(event.event);
+  const node = sanitizeIdPart(nodeIdForEvent(event));
+  return `manual:${runId}:${ev}:${node}:${eventIndex}`;
+}
+function toIsoTimestamp(ms) {
+  if (typeof ms !== "number" || !Number.isFinite(ms)) {
+    return { iso: (/* @__PURE__ */ new Date(0)).toISOString(), invalidTimestamp: true };
+  }
+  return { iso: new Date(ms).toISOString(), invalidTimestamp: false };
+}
+function buildSource(options) {
+  return {
+    type: "manual",
+    name: options?.sourceName ?? "trace-event",
+    version: options?.sourceVersion ?? "0.1"
+  };
+}
+function mapStepTypeToInspectKind(type) {
+  switch (type) {
+    case "run":
+      return "RUN";
+    case "llm":
+      return "LLM";
+    case "tool":
+      return "TOOL";
+    case "decision":
+      return "DECISION";
+    case "logic":
+    case "state":
+    case "custom":
+      return "LOGIC";
+    default:
+      return "LOGIC";
+  }
+}
+function mapRunOrStepStatus(status) {
+  return status === "success" ? "ok" : "error";
+}
+function mapErrorInfo(error) {
+  if (!error?.message) {
+    return {};
+  }
+  const out = {
+    persisted: {
+      message: error.message,
+      name: "Error"
+    }
+  };
+  if (typeof error.stack === "string" && error.stack.length > 0) {
+    out.errorStack = error.stack;
+  }
+  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;
+}
+function compactAttributes(entries) {
+  const out = {};
+  for (const [key, value] of Object.entries(entries)) {
+    if (value !== void 0) {
+      out[key] = value;
+    }
+  }
+  return Object.keys(out).length > 0 ? out : void 0;
+}
+function traceEventToPersistedInspectEvent(event, options) {
+  const eventIndex = options?.eventIndex ?? 0;
+  const eventId = createPersistedEventId(event, eventIndex);
+  const source = buildSource(options);
+  const tsMain = toIsoTimestamp(event.timestamp);
+  switch (event.event) {
+    case "run_started": {
+      const tsStart = toIsoTimestamp(event.startTime);
+      const correlation = extractCorrelationMetadata(event.metadata);
+      const attributes = compactAttributes({
+        legacyEvent: "run_started",
+        metadata: event.metadata !== void 0 ? { ...event.metadata } : void 0,
+        correlationId: correlation?.correlationId,
+        requestId: correlation?.requestId,
+        decisionId: correlation?.decisionId,
+        groupId: correlation?.groupId,
+        invalidTimestamp: tsMain.invalidTimestamp || tsStart.invalidTimestamp ? true : void 0
+      });
+      return {
+        schemaVersion: "0.2",
+        eventId,
+        runId: event.runId,
+        kind: "RUN",
+        name: event.name,
+        status: "running",
+        timestamp: tsMain.iso,
+        startedAt: tsStart.iso,
+        confidence: "explicit",
+        source,
+        attributes
+      };
+    }
+    case "run_completed": {
+      const tsEnd = toIsoTimestamp(event.endTime);
+      const { persisted: error, errorStack } = mapErrorInfo(event.error);
+      const attributes = compactAttributes({
+        legacyEvent: "run_completed",
+        errorStack,
+        invalidTimestamp: tsMain.invalidTimestamp || tsEnd.invalidTimestamp ? true : void 0
+      });
+      return {
+        schemaVersion: "0.2",
+        eventId,
+        runId: event.runId,
+        kind: "RUN",
+        name: "run",
+        status: mapRunOrStepStatus(event.status),
+        timestamp: tsMain.iso,
+        endedAt: tsEnd.iso,
+        durationMs: event.durationMs,
+        confidence: "explicit",
+        source,
+        attributes,
+        error
+      };
+    }
+    case "step_started": {
+      const tsStart = toIsoTimestamp(event.startTime);
+      const tokenUsage = mapTokenUsageFromMetadata(event.metadata);
+      const attributes = compactAttributes({
+        legacyEvent: "step_started",
+        stepId: event.stepId,
+        stepType: event.type,
+        metadata: event.metadata !== void 0 ? { ...event.metadata } : void 0,
+        invalidTimestamp: tsMain.invalidTimestamp || tsStart.invalidTimestamp ? true : void 0
+      });
+      const out = {
+        schemaVersion: "0.2",
+        eventId,
+        runId: event.runId,
+        kind: mapStepTypeToInspectKind(event.type),
+        name: event.name,
+        status: "running",
+        timestamp: tsMain.iso,
+        startedAt: tsStart.iso,
+        confidence: "explicit",
+        source,
+        attributes
+      };
+      if (event.parentId !== void 0) {
+        out.parentId = event.parentId;
+      }
+      if (tokenUsage !== void 0) {
+        out.tokenUsage = tokenUsage;
+      }
+      return out;
+    }
+    case "step_completed": {
+      const tsEnd = toIsoTimestamp(event.endTime);
+      const { persisted: error, errorStack } = mapErrorInfo(event.error);
+      const attributes = compactAttributes({
+        legacyEvent: "step_completed",
+        stepId: event.stepId,
+        errorStack,
+        invalidTimestamp: tsMain.invalidTimestamp || tsEnd.invalidTimestamp ? true : void 0
+      });
+      return {
+        schemaVersion: "0.2",
+        eventId,
+        runId: event.runId,
+        kind: "LOGIC",
+        name: event.stepId,
+        status: mapRunOrStepStatus(event.status),
+        timestamp: tsMain.iso,
+        endedAt: tsEnd.iso,
+        durationMs: event.durationMs,
+        confidence: "explicit",
+        source,
+        attributes,
+        error
+      };
+    }
+    default: {
+      const _exhaustive = event;
+      throw new Error(`Unsupported trace event: ${_exhaustive.event}`);
+    }
+  }
+}
+function traceEventsToPersistedInspectEvents(events, options) {
+  return events.map(
+    (event, index) => traceEventToPersistedInspectEvent(event, { ...options, eventIndex: index })
+  );
+}
+
+// packages/core/src/persisted/from-inspect-event.ts
+function sanitizeIdPart2(value) {
+  return value.replace(/[^a-zA-Z0-9_-]/g, "_");
+}
+function createFallbackEventId(event, eventIndex) {
+  const runId = sanitizeIdPart2(event.runId);
+  const kind = sanitizeIdPart2(event.kind);
+  const name = sanitizeIdPart2(event.name);
+  return `inspect:${runId}:${kind}:${name}:${eventIndex}`;
+}
+function toIsoTimestamp2(ms) {
+  if (typeof ms !== "number" || !Number.isFinite(ms)) {
+    return { iso: (/* @__PURE__ */ new Date(0)).toISOString(), invalidTimestamp: true };
+  }
+  return { iso: new Date(ms).toISOString(), invalidTimestamp: false };
+}
+function compactAttributes2(entries) {
+  const out = {};
+  for (const [key, value] of Object.entries(entries)) {
+    if (value !== void 0) {
+      out[key] = value;
+    }
+  }
+  return Object.keys(out).length > 0 ? out : void 0;
+}
+function mapInspectSourceToPersisted(source, options) {
+  const name = options?.sourceName;
+  const version = options?.sourceVersion;
+  switch (source.type) {
+    case "pino":
+      return {
+        persistedSource: {
+          type: "json-log",
+          name: name ?? "pino",
+          version
+        },
+        originalSourceType: "pino"
+      };
+    case "winston":
+      return {
+        persistedSource: {
+          type: "json-log",
+          name: name ?? "winston",
+          version
+        },
+        originalSourceType: "winston"
+      };
+    case "manual":
+    case "json-log":
+    case "log4js":
+    case "adapter":
+      return {
+        persistedSource: {
+          type: source.type,
+          name,
+          version
+        }
+      };
+    default:
+      return {
+        persistedSource: {
+          type: "json-log",
+          name,
+          version
+        }
+      };
+  }
+}
+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;
+}
+function mapErrorFromAttributes(event) {
+  if (event.status !== "error" || !event.attributes) {
+    return void 0;
+  }
+  const message = event.attributes.errorMessage;
+  if (typeof message !== "string" || message.length === 0) {
+    return void 0;
+  }
+  const err = { message };
+  if (typeof event.attributes.errorName === "string") {
+    err.name = event.attributes.errorName;
+  }
+  return err;
+}
+function inspectEventToPersistedInspectEvent(event, options) {
+  const eventIndex = options?.eventIndex ?? 0;
+  const eventId = typeof event.eventId === "string" && event.eventId.length > 0 ? event.eventId : createFallbackEventId(event, eventIndex);
+  const ts = toIsoTimestamp2(event.timestamp);
+  const { persistedSource, originalSourceType } = mapInspectSourceToPersisted(
+    event.source,
+    options
+  );
+  const attrsBase = event.attributes !== void 0 ? { ...event.attributes } : {};
+  const attributes = compactAttributes2({
+    ...attrsBase,
+    sourceFile: event.source.file,
+    sourceLine: event.source.line,
+    originalSourceType,
+    invalidTimestamp: ts.invalidTimestamp ? true : void 0
+  });
+  const tokenUsage = mapTokenUsageFromAttributes(event.attributes);
+  const error = mapErrorFromAttributes(event);
+  const inputPreview = event.attributes?.inputPreview;
+  const outputPreview = event.attributes?.outputPreview;
+  const out = {
+    schemaVersion: "0.2",
+    eventId,
+    runId: event.runId,
+    kind: event.kind,
+    name: event.name,
+    timestamp: ts.iso,
+    confidence: event.confidence,
+    source: persistedSource,
+    attributes
+  };
+  if (event.parentId !== void 0) {
+    out.parentId = event.parentId;
+  }
+  if (event.status !== void 0) {
+    out.status = event.status;
+  }
+  if (event.durationMs !== void 0 && Number.isFinite(event.durationMs) && event.durationMs >= 0) {
+    out.durationMs = event.durationMs;
+  }
+  if (tokenUsage !== void 0) {
+    out.tokenUsage = tokenUsage;
+  }
+  if (error !== void 0) {
+    out.error = error;
+  }
+  if (inputPreview !== void 0) {
+    out.inputSummary = inputPreview;
+  }
+  if (outputPreview !== void 0) {
+    out.outputSummary = outputPreview;
+  }
+  return out;
+}
+function inspectEventsToPersistedInspectEvents(events, options) {
+  return events.map(
+    (event, index) => inspectEventToPersistedInspectEvent(event, { ...options, eventIndex: index })
+  );
+}
+
+// packages/core/src/persisted/to-inspect-event.ts
+function compactAttributes3(entries) {
+  const out = {};
+  for (const [key, value] of Object.entries(entries)) {
+    if (value !== void 0) {
+      out[key] = value;
+    }
+  }
+  return Object.keys(out).length > 0 ? out : void 0;
+}
+function parseIsoToMs(iso) {
+  const parsed = Date.parse(iso);
+  if (!Number.isFinite(parsed)) {
+    return { ms: 0, invalidTimestamp: true };
+  }
+  return { ms: parsed, invalidTimestamp: false };
+}
+function mapPersistedSourceToInspect(event) {
+  const attrs = event.attributes ?? {};
+  const sourceName = event.source.name;
+  if (sourceName === "pino") {
+    return {
+      type: "pino",
+      file: typeof attrs.sourceFile === "string" ? attrs.sourceFile : void 0,
+      line: typeof attrs.sourceLine === "number" ? attrs.sourceLine : void 0
+    };
+  }
+  if (sourceName === "winston") {
+    return {
+      type: "winston",
+      file: typeof attrs.sourceFile === "string" ? attrs.sourceFile : void 0,
+      line: typeof attrs.sourceLine === "number" ? attrs.sourceLine : void 0
+    };
+  }
+  const mapType = (t) => {
+    switch (t) {
+      case "manual":
+        return "manual";
+      case "json-log":
+        return "json-log";
+      case "log4js":
+        return "log4js";
+      case "adapter":
+      case "ai-sdk":
+      case "otel":
+        return "adapter";
+      default:
+        return "json-log";
+    }
+  };
+  return {
+    type: mapType(event.source.type),
+    file: typeof attrs.sourceFile === "string" ? attrs.sourceFile : void 0,
+    line: typeof attrs.sourceLine === "number" ? attrs.sourceLine : void 0
+  };
+}
+function buildInspectAttributes(event) {
+  const attrs = event.attributes !== void 0 ? { ...event.attributes } : {};
+  if (event.inputSummary !== void 0) {
+    attrs.inputSummary = event.inputSummary;
+  }
+  if (event.outputSummary !== void 0) {
+    attrs.outputSummary = event.outputSummary;
+  }
+  if (event.error) {
+    if (event.error.name !== void 0) {
+      attrs.errorName = event.error.name;
+    }
+    attrs.errorMessage = event.error.message;
+    if (event.error.code !== void 0) {
+      attrs.errorCode = event.error.code;
+    }
+  }
+  if (event.tokenUsage) {
+    attrs.tokens = { ...event.tokenUsage };
+  }
+  if (event.source.type === "ai-sdk" || event.source.type === "otel") {
+    attrs.originalSourceType = event.source.type;
+  }
+  if (event.source.name !== void 0) {
+    attrs.sourceName = event.source.name;
+  }
+  if (event.source.version !== void 0) {
+    attrs.sourceVersion = event.source.version;
+  }
+  return attrs;
+}
+function persistedInspectEventToInspectEvent(event) {
+  if (!isPersistedInspectEvent(event)) {
+    throw new Error("Invalid PersistedInspectEvent: failed isPersistedInspectEvent");
+  }
+  const ts = parseIsoToMs(event.timestamp);
+  const attrs = buildInspectAttributes(event);
+  if (ts.invalidTimestamp) {
+    attrs.invalidTimestamp = true;
+  }
+  let status;
+  if (event.status === "running" || event.status === "ok" || event.status === "error") {
+    status = event.status;
+  } else if (event.status === "unknown") {
+    attrs.persistedStatus = "unknown";
+  }
+  const out = {
+    eventId: event.eventId,
+    runId: event.runId,
+    name: event.name,
+    kind: event.kind,
+    timestamp: ts.ms,
+    confidence: event.confidence,
+    source: mapPersistedSourceToInspect(event),
+    attributes: compactAttributes3(attrs)
+  };
+  if (event.parentId !== void 0) {
+    out.parentId = event.parentId;
+  }
+  if (status !== void 0) {
+    out.status = status;
+  }
+  if (event.durationMs !== void 0 && Number.isFinite(event.durationMs) && event.durationMs >= 0) {
+    out.durationMs = event.durationMs;
+  }
+  return out;
+}
+function persistedInspectEventsToInspectEvents(events, options) {
+  const skipInvalid = options?.skipInvalid === true;
+  const out = [];
+  for (const event of events) {
+    if (!isPersistedInspectEvent(event)) {
+      if (skipInvalid) {
+        continue;
+      }
+      throw new Error("Invalid PersistedInspectEvent: failed isPersistedInspectEvent");
+    }
+    out.push(persistedInspectEventToInspectEvent(event));
+  }
+  return out;
+}
+
+// packages/core/src/persisted/to-trace-event.ts
+function parseIsoToMs2(iso) {
+  const parsed = Date.parse(iso);
+  return Number.isFinite(parsed) ? parsed : 0;
+}
+function mapInspectKindToStepType(kind) {
+  switch (kind) {
+    case "LLM":
+      return "llm";
+    case "TOOL":
+      return "tool";
+    case "DECISION":
+      return "decision";
+    case "RUN":
+      return "run";
+    default:
+      return "logic";
+  }
+}
+function mapPersistedStatusToStepStatus(status) {
+  switch (status) {
+    case "ok":
+      return "success";
+    case "error":
+      return "error";
+    case "running":
+      return "running";
+    default:
+      return void 0;
+  }
+}
+function mapPersistedStatusToRunStatus(status) {
+  switch (status) {
+    case "ok":
+      return "success";
+    case "error":
+      return "error";
+    case "running":
+      return "running";
+    default:
+      return void 0;
+  }
+}
+function mapPersistedError(error) {
+  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;
+  if (stack) {
+    out.stack = stack;
+  }
+  return out;
+}
+function mapTokenUsageToMetadata(tokenUsage, attributes) {
+  const metadata = {};
+  if (attributes?.metadata && typeof attributes.metadata === "object") {
+    Object.assign(metadata, attributes.metadata);
+  }
+  if (tokenUsage) {
+    metadata.tokens = {
+      ...tokenUsage.input !== void 0 ? { input: tokenUsage.input } : {},
+      ...tokenUsage.output !== void 0 ? { output: tokenUsage.output } : {}
+    };
+  }
+  return Object.keys(metadata).length > 0 ? metadata : void 0;
+}
+function pickRunMetadata(attributes) {
+  if (!attributes) return void 0;
+  const metadata = attributes.metadata && typeof attributes.metadata === "object" ? { ...attributes.metadata } : {};
+  for (const key of [
+    "correlationId",
+    "requestId",
+    "decisionId",
+    "groupId"
+  ]) {
+    const value = attributes[key];
+    if (typeof value === "string" && value.trim() !== "") {
+      metadata[key] = value;
+    }
+  }
+  return Object.keys(metadata).length > 0 ? metadata : void 0;
+}
+function resolveStepId(event) {
+  const attrs = event.attributes;
+  if (attrs && typeof attrs.stepId === "string" && attrs.stepId.trim() !== "") {
+    return attrs.stepId;
+  }
+  return event.eventId;
+}
+function resolveStepType(event) {
+  const attrs = event.attributes;
+  if (attrs && typeof attrs.stepType === "string") {
+    const t = attrs.stepType;
+    if (t === "run" || t === "llm" || t === "tool" || t === "decision" || t === "logic" || t === "state" || t === "custom") {
+      return t;
+    }
+  }
+  return mapInspectKindToStepType(event.kind);
+}
+function resolveTimes(event) {
+  const timestamp = parseIsoToMs2(event.timestamp);
+  const startTime = event.startedAt !== void 0 ? parseIsoToMs2(event.startedAt) : timestamp;
+  let endTime = event.endedAt !== void 0 ? parseIsoToMs2(event.endedAt) : timestamp;
+  if (event.durationMs !== void 0 && Number.isFinite(event.durationMs) && event.durationMs >= 0 && event.endedAt === void 0) {
+    endTime = startTime + event.durationMs;
+  }
+  return { timestamp, startTime, endTime };
+}
+function fromLegacyRunStarted(event) {
+  const { timestamp, startTime } = resolveTimes(event);
+  const out = {
+    schemaVersion: "0.1",
+    event: "run_started",
+    timestamp,
+    runId: event.runId,
+    name: event.name,
+    startTime
+  };
+  const metadata = pickRunMetadata(event.attributes);
+  if (metadata) out.metadata = metadata;
+  return out;
+}
+function fromLegacyRunCompleted(event) {
+  const { timestamp, endTime } = resolveTimes(event);
+  const status = mapPersistedStatusToRunStatus(event.status) ?? "success";
+  const out = {
+    schemaVersion: "0.1",
+    event: "run_completed",
+    timestamp,
+    runId: event.runId,
+    status: status === "running" ? "success" : status,
+    endTime,
+    durationMs: event.durationMs ?? Math.max(0, endTime - timestamp)
+  };
+  const error = mapPersistedError(event.error);
+  if (error) out.error = error;
+  return out;
+}
+function fromLegacyStepStarted(event) {
+  const { timestamp, startTime } = resolveTimes(event);
+  const out = {
+    schemaVersion: "0.1",
+    event: "step_started",
+    timestamp,
+    runId: event.runId,
+    stepId: resolveStepId(event),
+    name: event.name,
+    type: resolveStepType(event),
+    startTime
+  };
+  if (event.parentId !== void 0) out.parentId = event.parentId;
+  const metadata = mapTokenUsageToMetadata(event.tokenUsage, event.attributes);
+  if (metadata) out.metadata = metadata;
+  return out;
+}
+function fromLegacyStepCompleted(event) {
+  const { timestamp, endTime } = resolveTimes(event);
+  const status = mapPersistedStatusToStepStatus(event.status) ?? "success";
+  const out = {
+    schemaVersion: "0.1",
+    event: "step_completed",
+    timestamp,
+    runId: event.runId,
+    stepId: resolveStepId(event),
+    status: status === "running" ? "success" : status,
+    endTime,
+    durationMs: event.durationMs ?? Math.max(0, endTime - timestamp)
+  };
+  const error = mapPersistedError(event.error);
+  if (error) out.error = error;
+  return out;
+}
+function fromNativeRun(event) {
+  const { timestamp, startTime, endTime } = resolveTimes(event);
+  const runStatus = mapPersistedStatusToRunStatus(event.status);
+  const out = [];
+  if (runStatus === "running" || event.startedAt !== void 0) {
+    const started = {
+      schemaVersion: "0.1",
+      event: "run_started",
+      timestamp,
+      runId: event.runId,
+      name: event.name,
+      startTime
+    };
+    const metadata = pickRunMetadata(event.attributes);
+    if (metadata) started.metadata = metadata;
+    out.push(started);
+  }
+  if (runStatus === "success" || runStatus === "error" || event.endedAt !== void 0) {
+    const completed = {
+      schemaVersion: "0.1",
+      event: "run_completed",
+      timestamp,
+      runId: event.runId,
+      status: runStatus === "error" ? "error" : "success",
+      endTime,
+      durationMs: event.durationMs ?? Math.max(0, endTime - startTime)
+    };
+    const error = mapPersistedError(event.error);
+    if (error) completed.error = error;
+    out.push(completed);
+  }
+  if (out.length === 0) {
+    out.push(fromLegacyRunStarted(event));
+  }
+  return out;
+}
+function fromNativeStep(event) {
+  const { timestamp, startTime, endTime } = resolveTimes(event);
+  const stepStatus = mapPersistedStatusToStepStatus(event.status);
+  const stepId = resolveStepId(event);
+  const out = [];
+  const shouldEmitStarted = stepStatus === "running" || event.startedAt !== void 0 || stepStatus === "success" || stepStatus === "error";
+  if (shouldEmitStarted) {
+    const started = {
+      schemaVersion: "0.1",
+      event: "step_started",
+      timestamp,
+      runId: event.runId,
+      stepId,
+      name: event.name,
+      type: resolveStepType(event),
+      startTime
+    };
+    if (event.parentId !== void 0) started.parentId = event.parentId;
+    const metadata = mapTokenUsageToMetadata(event.tokenUsage, event.attributes);
+    if (metadata) started.metadata = metadata;
+    out.push(started);
+  }
+  if (stepStatus === "success" || stepStatus === "error" || event.endedAt !== void 0 || event.durationMs !== void 0) {
+    const completed = {
+      schemaVersion: "0.1",
+      event: "step_completed",
+      timestamp,
+      runId: event.runId,
+      stepId,
+      status: stepStatus === "error" ? "error" : "success",
+      endTime,
+      durationMs: event.durationMs ?? Math.max(0, endTime - startTime)
+    };
+    const error = mapPersistedError(event.error);
+    if (error) completed.error = error;
+    out.push(completed);
+  }
+  if (out.length === 0) {
+    out.push(fromLegacyStepStarted(event));
+  }
+  return out;
+}
+function persistedInspectEventToTraceEvents(event) {
+  if (!isPersistedInspectEvent(event)) {
+    throw new Error("Invalid PersistedInspectEvent: failed isPersistedInspectEvent");
+  }
+  const legacyEvent = event.attributes?.legacyEvent;
+  if (legacyEvent === "run_started") return [fromLegacyRunStarted(event)];
+  if (legacyEvent === "run_completed") return [fromLegacyRunCompleted(event)];
+  if (legacyEvent === "step_started") return [fromLegacyStepStarted(event)];
+  if (legacyEvent === "step_completed") return [fromLegacyStepCompleted(event)];
+  if (event.kind === "RUN") {
+    return fromNativeRun(event);
+  }
+  return fromNativeStep(event);
+}
+function persistedInspectEventsToTraceEvents(events, options) {
+  const out = [];
+  events.forEach((event, index) => {
+    const rows = persistedInspectEventToTraceEvents(event);
+    if (rows.length === 0 && options?.eventIndex !== void 0) {
+      void options.eventIndex;
+    }
+    out.push(...rows);
+  });
+  return out;
+}
+
+// packages/core/src/logs/tree-builder.ts
+function inc(map, key) {
+  map[key] = (map[key] ?? 0) + 1;
+}
+function computeRunStatus(events) {
+  let hasRunning = false;
+  for (const e of events) {
+    if (e.status === "error") return "error";
+    if (e.status === "running") hasRunning = true;
+  }
+  if (hasRunning) return "running";
+  return "ok";
+}
+var TreeBuilder = class {
+  constructor(options) {
+    void options?.config;
+  }
+  build(events) {
+    const byRun = /* @__PURE__ */ new Map();
+    for (const e of events) {
+      if (!byRun.has(e.runId)) byRun.set(e.runId, []);
+      byRun.get(e.runId).push(e);
+    }
+    const out = [];
+    for (const [runId, runEvents] of byRun.entries()) {
+      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 roots = [];
+      for (const node of nodes.values()) {
+        const parentId = node.event.parentId;
+        if (parentId && nodes.has(parentId)) {
+          nodes.get(parentId).children.push(node);
+        } else {
+          roots.push(node);
+        }
+      }
+      const assignDepth = (n, depth) => {
+        n.depth = depth;
+        for (const c of n.children) assignDepth(c, depth + 1);
+      };
+      for (const r of roots) assignDepth(r, 0);
+      const confidenceBreakdown = {
+        explicit: 0,
+        correlated: 0,
+        heuristic: 0,
+        unknown: 0
+      };
+      const kinds = {};
+      for (const e of sorted) {
+        inc(confidenceBreakdown, e.confidence);
+        kinds[e.kind] = (kinds[e.kind] ?? 0) + 1;
+      }
+      const startedAt = sorted.length > 0 ? sorted[0].timestamp : void 0;
+      const endedAt = sorted.length > 0 ? sorted[sorted.length - 1].timestamp : void 0;
+      const status = computeRunStatus(sorted);
+      const durationMs = startedAt !== void 0 && endedAt !== void 0 && Number.isFinite(startedAt) && Number.isFinite(endedAt) && endedAt >= startedAt && status !== "running" ? endedAt - startedAt : void 0;
+      const name = sorted.find((e) => e.kind === "RUN")?.name;
+      out.push({
+        runId,
+        name,
+        status,
+        startedAt,
+        endedAt: status === "running" ? void 0 : endedAt,
+        durationMs,
+        children: roots,
+        metadata: {
+          totalEvents: sorted.length,
+          confidenceBreakdown,
+          kinds
+        }
+      });
+    }
+    out.sort((a, b) => (b.startedAt ?? 0) - (a.startedAt ?? 0));
+    return out;
+  }
+};
+
+// packages/core/src/persisted/tree-bridge.ts
+function persistedInspectEventsToRunTrees(events, options) {
+  const inspectEvents = persistedInspectEventsToInspectEvents(events, {
+    skipInvalid: options?.skipInvalid
+  });
+  return new TreeBuilder().build(inspectEvents);
+}
+function traceEventsToPersistedRunTrees(events) {
+  const persisted = traceEventsToPersistedInspectEvents(events);
+  return persistedInspectEventsToRunTrees(persisted);
+}
+
+exports.inspectEventToPersistedInspectEvent = inspectEventToPersistedInspectEvent;
+exports.inspectEventsToPersistedInspectEvents = inspectEventsToPersistedInspectEvents;
+exports.isPersistedInspectEvent = isPersistedInspectEvent;
+exports.persistedInspectEventToInspectEvent = persistedInspectEventToInspectEvent;
+exports.persistedInspectEventToTraceEvents = persistedInspectEventToTraceEvents;
+exports.persistedInspectEventsToInspectEvents = persistedInspectEventsToInspectEvents;
+exports.persistedInspectEventsToRunTrees = persistedInspectEventsToRunTrees;
+exports.persistedInspectEventsToTraceEvents = persistedInspectEventsToTraceEvents;
+exports.traceEventToPersistedInspectEvent = traceEventToPersistedInspectEvent;
+exports.traceEventsToPersistedInspectEvents = traceEventsToPersistedInspectEvents;
+exports.traceEventsToPersistedRunTrees = traceEventsToPersistedRunTrees;
+//# sourceMappingURL=persisted.cjs.map
+//# sourceMappingURL=persisted.cjs.map