agent-inspect 6.3.0 → 6.4.1

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

@@ -1,6 +1,6 @@
-import { b as InspectRunTree, c as InspectNode } from './inspect-event-IqwOHbGo.cjs';
-import { R as RedactionProfile, h as TraceEvent } from './types-B1X87dUW.cjs';
-import './log-config-CW8w5YQ9.cjs';
+import { a as InspectRunTree, b as InspectNode } from './inspect-event-DVg84S4v.cjs';
+import { R as RedactionProfile, h as TraceEvent } from './types-BLX3tiOW.cjs';
+import './log-config-BG1WmWf2.cjs';
 
 /**
  * v0.7 local export formats. No sinks — string output only.
@@ -94,6 +94,31 @@ declare function exportOtlpJson(tree: InspectRunTree, options?: Partial<ExportOp
 
 declare function validateExportContent(format: ExportFormat, content: string): ExportValidationResult;
 
+/** Validate committed or exported OpenInference-compatible JSON fixtures. */
+declare function validateOpenInferenceFixture(content: string): ExportValidationResult;
+/** Validate committed or exported OTLP JSON fixtures. */
+declare function validateOtlpJsonFixture(content: string): ExportValidationResult;
+
+/**
+ * Semantic field checks beyond shape validation for standards fixtures.
+ */
+
+declare function validateOpenInferenceSemanticFixture(content: string): ExportValidationResult;
+declare function validateOtlpJsonSemanticFixture(content: string): ExportValidationResult;
+
+/**
+ * Documented OpenTelemetry GenAI semantic convention reference for OTLP JSON exports.
+ * Local mapping only — no OTel SDK dependency in core.
+ */
+declare const OTEL_GEN_AI_SEMCONV_PIN: {
+    /** Human-readable pin label recorded in export metadata and docs. */
+    readonly version: "1.36.0";
+    /** Public spec URL for maintainers validating attribute names. */
+    readonly specUrl: "https://opentelemetry.io/docs/specs/semconv/gen-ai/";
+    /** Attribute families emitted by agent-inspect OTLP JSON export. */
+    readonly attributes: readonly ["gen_ai.operation.name", "gen_ai.request.model", "gen_ai.usage.input_tokens", "gen_ai.usage.output_tokens", "gen_ai.prompt", "gen_ai.completion"];
+};
+
 interface RedactRunTreeForExportOptions {
     redactionProfile?: RedactionProfile;
 }
@@ -135,4 +160,4 @@ interface ReportResult {
  */
 declare function buildRunReport(events: TraceEvent[], options: ReportOptions): ReportResult;
 
-export { EXPORT_PAYLOAD_VERSION, type ExportFormat, type ExportOptions, type ExportResult, type ExportValidationResult, type OpenInferenceExport, type OpenInferenceSpan, type ReportFormat, type ReportOptions, type ReportResult, type TraceExporter, buildRunReport, compactAttributes, escapeHtml, escapeMarkdown, exportHtml, exportMarkdown, exportOpenInference, exportOtlpJson, exportRunTree, flattenTree, manualTraceEventsToRunTree, mergeExportDefaults, redactRunTreeForExport, safeString, stableJson, summarizeTree, validateExport, validateExportContent };
+export { EXPORT_PAYLOAD_VERSION, type ExportFormat, type ExportOptions, type ExportResult, type ExportValidationResult, OTEL_GEN_AI_SEMCONV_PIN, type OpenInferenceExport, type OpenInferenceSpan, type ReportFormat, type ReportOptions, type ReportResult, type TraceExporter, buildRunReport, compactAttributes, escapeHtml, escapeMarkdown, exportHtml, exportMarkdown, exportOpenInference, exportOtlpJson, exportRunTree, flattenTree, manualTraceEventsToRunTree, mergeExportDefaults, redactRunTreeForExport, safeString, stableJson, summarizeTree, validateExport, validateExportContent, validateOpenInferenceFixture, validateOpenInferenceSemanticFixture, validateOtlpJsonFixture, validateOtlpJsonSemanticFixture };

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

@@ -1,6 +1,6 @@
-import { b as InspectRunTree, c as InspectNode } from './inspect-event-IqwOHbGo.js';
-import { R as RedactionProfile, h as TraceEvent } from './types-BVkjSd0q.js';
-import './log-config-SRA4xTp8.js';
+import { a as InspectRunTree, b as InspectNode } from './inspect-event-DVg84S4v.js';
+import { R as RedactionProfile, h as TraceEvent } from './types-MuwXSJ4b.js';
+import './log-config-Ck0aT_Ou.js';
 
 /**
  * v0.7 local export formats. No sinks — string output only.
@@ -94,6 +94,31 @@ declare function exportOtlpJson(tree: InspectRunTree, options?: Partial<ExportOp
 
 declare function validateExportContent(format: ExportFormat, content: string): ExportValidationResult;
 
+/** Validate committed or exported OpenInference-compatible JSON fixtures. */
+declare function validateOpenInferenceFixture(content: string): ExportValidationResult;
+/** Validate committed or exported OTLP JSON fixtures. */
+declare function validateOtlpJsonFixture(content: string): ExportValidationResult;
+
+/**
+ * Semantic field checks beyond shape validation for standards fixtures.
+ */
+
+declare function validateOpenInferenceSemanticFixture(content: string): ExportValidationResult;
+declare function validateOtlpJsonSemanticFixture(content: string): ExportValidationResult;
+
+/**
+ * Documented OpenTelemetry GenAI semantic convention reference for OTLP JSON exports.
+ * Local mapping only — no OTel SDK dependency in core.
+ */
+declare const OTEL_GEN_AI_SEMCONV_PIN: {
+    /** Human-readable pin label recorded in export metadata and docs. */
+    readonly version: "1.36.0";
+    /** Public spec URL for maintainers validating attribute names. */
+    readonly specUrl: "https://opentelemetry.io/docs/specs/semconv/gen-ai/";
+    /** Attribute families emitted by agent-inspect OTLP JSON export. */
+    readonly attributes: readonly ["gen_ai.operation.name", "gen_ai.request.model", "gen_ai.usage.input_tokens", "gen_ai.usage.output_tokens", "gen_ai.prompt", "gen_ai.completion"];
+};
+
 interface RedactRunTreeForExportOptions {
     redactionProfile?: RedactionProfile;
 }
@@ -135,4 +160,4 @@ interface ReportResult {
  */
 declare function buildRunReport(events: TraceEvent[], options: ReportOptions): ReportResult;
 
-export { EXPORT_PAYLOAD_VERSION, type ExportFormat, type ExportOptions, type ExportResult, type ExportValidationResult, type OpenInferenceExport, type OpenInferenceSpan, type ReportFormat, type ReportOptions, type ReportResult, type TraceExporter, buildRunReport, compactAttributes, escapeHtml, escapeMarkdown, exportHtml, exportMarkdown, exportOpenInference, exportOtlpJson, exportRunTree, flattenTree, manualTraceEventsToRunTree, mergeExportDefaults, redactRunTreeForExport, safeString, stableJson, summarizeTree, validateExport, validateExportContent };
+export { EXPORT_PAYLOAD_VERSION, type ExportFormat, type ExportOptions, type ExportResult, type ExportValidationResult, OTEL_GEN_AI_SEMCONV_PIN, type OpenInferenceExport, type OpenInferenceSpan, type ReportFormat, type ReportOptions, type ReportResult, type TraceExporter, buildRunReport, compactAttributes, escapeHtml, escapeMarkdown, exportHtml, exportMarkdown, exportOpenInference, exportOtlpJson, exportRunTree, flattenTree, manualTraceEventsToRunTree, mergeExportDefaults, redactRunTreeForExport, safeString, stableJson, summarizeTree, validateExport, validateExportContent, validateOpenInferenceFixture, validateOpenInferenceSemanticFixture, validateOtlpJsonFixture, validateOtlpJsonSemanticFixture };

package/packages/core/dist/exporters.mjs

@@ -984,6 +984,76 @@ function manualTraceEventsToRunTree(events) {
   };
 }
 
+// packages/core/src/exporters/fixtures.ts
+function validateOpenInferenceFixture(content) {
+  return validateExportContent("openinference", content);
+}
+function validateOtlpJsonFixture(content) {
+  return validateExportContent("otlp-json", content);
+}
+
+// packages/core/src/exporters/semantic-validation.ts
+var SEMCONV_PIN = "OTEL_GEN_AI_SEMCONV_PIN";
+function semanticWarnings(format, parsed) {
+  const warnings = [];
+  if (format === "openinference") {
+    const spans = Array.isArray(parsed.spans) ? parsed.spans : [];
+    if (spans.length > 0) {
+      const first = spans[0];
+      if (first.trace_id === void 0 && first.traceId === void 0) {
+        warnings.push("OpenInference semantic: first span missing trace_id");
+      }
+    }
+  }
+  if (format === "otlp-json") {
+    warnings.push(`OTLP semantic validation pinned to ${SEMCONV_PIN} mapping docs`);
+  }
+  return warnings;
+}
+function validateOpenInferenceSemanticFixture(content) {
+  const base = validateOpenInferenceFixture(content);
+  if (!base.ok) return base;
+  try {
+    const parsed = JSON.parse(content);
+    return {
+      ...base,
+      warnings: [...base.warnings, ...semanticWarnings("openinference", parsed)]
+    };
+  } catch {
+    return base;
+  }
+}
+function validateOtlpJsonSemanticFixture(content) {
+  const base = validateOtlpJsonFixture(content);
+  if (!base.ok) return base;
+  try {
+    const parsed = JSON.parse(content);
+    return {
+      ...base,
+      warnings: [...base.warnings, ...semanticWarnings("otlp-json", parsed)]
+    };
+  } catch {
+    return base;
+  }
+}
+
+// packages/core/src/exporters/semconv.ts
+var OTEL_GEN_AI_SEMCONV_PIN = {
+  /** Human-readable pin label recorded in export metadata and docs. */
+  version: "1.36.0",
+  /** Public spec URL for maintainers validating attribute names. */
+  specUrl: "https://opentelemetry.io/docs/specs/semconv/gen-ai/",
+  /** Attribute families emitted by agent-inspect OTLP JSON export. */
+  attributes: [
+    "gen_ai.operation.name",
+    "gen_ai.request.model",
+    "gen_ai.usage.input_tokens",
+    "gen_ai.usage.output_tokens",
+    "gen_ai.prompt",
+    "gen_ai.completion"
+  ]
+};
+
 // packages/core/src/exporters/index.ts
 function mergeExportDefaults(options) {
   return {
@@ -1179,6 +1249,6 @@ ${attrsSection}
   };
 }
 
-export { EXPORT_PAYLOAD_VERSION, buildRunReport, exportHtml, exportMarkdown, exportOpenInference, exportOtlpJson, exportRunTree, manualTraceEventsToRunTree, mergeExportDefaults, redactRunTreeForExport, validateExport, validateExportContent };
+export { EXPORT_PAYLOAD_VERSION, OTEL_GEN_AI_SEMCONV_PIN, buildRunReport, exportHtml, exportMarkdown, exportOpenInference, exportOtlpJson, exportRunTree, manualTraceEventsToRunTree, mergeExportDefaults, redactRunTreeForExport, validateExport, validateExportContent, validateOpenInferenceFixture, validateOpenInferenceSemanticFixture, validateOtlpJsonFixture, validateOtlpJsonSemanticFixture };
 //# sourceMappingURL=exporters.mjs.map
 //# sourceMappingURL=exporters.mjs.map