@arizeai/openinference-genai 0.1.5 → 0.1.7

package/README.md

@@ -65,15 +65,11 @@ import { convertGenAISpanAttributesToOpenInferenceSpanAttributes } from "@arizea
 import type { Mutable } from "@arizeai/openinference-genai/types";
 
 class OpenInferenceOTLPTraceExporter extends OTLPTraceExporter {
-  export(
-    spans: ReadableSpan[],
-    resultCallback: (result: ExportResult) => void,
-  ) {
+  export(spans: ReadableSpan[], resultCallback: (result: ExportResult) => void) {
     const processedSpans = spans.map((span) => {
-      const processedAttributes =
-        convertGenAISpanAttributesToOpenInferenceSpanAttributes(
-          span.attributes,
-        );
+      const processedAttributes = convertGenAISpanAttributesToOpenInferenceSpanAttributes(
+        span.attributes,
+      );
       // optionally you can replace the entire attributes object with the
       // processed attributes if you want _only_ the OpenInference attributes
       (span as Mutable<ReadableSpan>).attributes = {
@@ -93,10 +89,7 @@ And then use it in the SpanProcessor of your choice.
 ```ts
 // instrumentation.ts
 import { resourceFromAttributes } from "@opentelemetry/resources";
-import {
-  NodeTracerProvider,
-  BatchSpanProcessor,
-} from "@opentelemetry/sdk-trace-node";
+import { NodeTracerProvider, BatchSpanProcessor } from "@opentelemetry/sdk-trace-node";
 import { ATTR_SERVICE_NAME } from "@opentelemetry/semantic-conventions";
 
 import { SEMRESATTRS_PROJECT_NAME } from "@arizeai/openinference-semantic-conventions";

package/dist/commonjs/__generated__/opentelemetryInputMessages.d.ts

@@ -0,0 +1,103 @@
+/**
+ * OpenTelemetry input messages schema
+ * As of 10/14/2025, this schema is still in draft status.
+ * https://opentelemetry.io/docs/specs/semconv/gen-ai/gen-ai-input-messages.json
+ */
+/**
+ * Role of the entity that created the message.
+ */
+export type Role = Role1 | string;
+export type Role1 = "system" | "user" | "assistant" | "tool";
+/**
+ * The type of the content captured in this part.
+ */
+export type Type = "text";
+/**
+ * Text content sent to or received from the model.
+ */
+export type Content = string;
+/**
+ * The type of the content captured in this part.
+ */
+export type Type1 = "tool_call";
+/**
+ * Unique identifier for the tool call.
+ */
+export type Id = string | null;
+/**
+ * Name of the tool.
+ */
+export type Name = string;
+/**
+ * The type of the content captured in this part.
+ */
+export type Type2 = "tool_call_response";
+/**
+ * Unique tool call identifier.
+ */
+export type Id1 = string | null;
+/**
+ * The type of the content captured in this part.
+ */
+export type Type3 = string;
+/**
+ * List of message parts that make up the message content.
+ */
+export type Parts = (TextPart | ToolCallRequestPart | ToolCallResponsePart)[];
+/**
+ * Represents the list of input messages sent to the model.
+ */
+export type InputMessages = ChatMessage[];
+export interface ChatMessage {
+    role: Role;
+    parts: Parts;
+    [k: string]: unknown;
+}
+/**
+ * Represents text content sent to or received from the model.
+ */
+export interface TextPart {
+    type: Type;
+    content: Content;
+    [k: string]: unknown;
+}
+/**
+ * Represents a tool call requested by the model.
+ */
+export interface ToolCallRequestPart {
+    type: Type1;
+    id?: Id;
+    name: Name;
+    arguments?: Arguments;
+    [k: string]: unknown;
+}
+/**
+ * Arguments for the tool call.
+ */
+export interface Arguments {
+    [k: string]: unknown;
+}
+/**
+ * Represents a tool call result sent to the model or a built-in tool call outcome and details.
+ */
+export interface ToolCallResponsePart {
+    type: Type2;
+    id?: Id1;
+    response: Response;
+    [k: string]: unknown;
+}
+/**
+ * Tool call response.
+ */
+export interface Response {
+    [k: string]: unknown;
+}
+/**
+ * Represents an arbitrary message part with any type and properties.
+ * This allows for extensibility with custom message part types.
+ */
+export interface GenericPart {
+    type: Type3;
+    [k: string]: unknown;
+}
+//# sourceMappingURL=opentelemetryInputMessages.d.ts.map

package/dist/commonjs/__generated__/opentelemetryInputMessages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"opentelemetryInputMessages.d.ts","sourceRoot":"","sources":["../../../src/__generated__/opentelemetryInputMessages.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,MAAM,MAAM,IAAI,GAAG,KAAK,GAAG,MAAM,CAAC;AAClC,MAAM,MAAM,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,WAAW,GAAG,MAAM,CAAC;AAC7D;;GAEG;AACH,MAAM,MAAM,IAAI,GAAG,MAAM,CAAC;AAC1B;;GAEG;AACH,MAAM,MAAM,OAAO,GAAG,MAAM,CAAC;AAC7B;;GAEG;AACH,MAAM,MAAM,KAAK,GAAG,WAAW,CAAC;AAChC;;GAEG;AACH,MAAM,MAAM,EAAE,GAAG,MAAM,GAAG,IAAI,CAAC;AAC/B;;GAEG;AACH,MAAM,MAAM,IAAI,GAAG,MAAM,CAAC;AAC1B;;GAEG;AACH,MAAM,MAAM,KAAK,GAAG,oBAAoB,CAAC;AACzC;;GAEG;AACH,MAAM,MAAM,GAAG,GAAG,MAAM,GAAG,IAAI,CAAC;AAChC;;GAEG;AACH,MAAM,MAAM,KAAK,GAAG,MAAM,CAAC;AAC3B;;GAEG;AACH,MAAM,MAAM,KAAK,GAAG,CAAC,QAAQ,GAAG,mBAAmB,GAAG,oBAAoB,CAAC,EAAE,CAAC;AAC9E;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,WAAW,EAAE,CAAC;AAE1C,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,IAAI,CAAC;IACX,KAAK,EAAE,KAAK,CAAC;IACb,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;CACtB;AACD;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,IAAI,CAAC;IACX,OAAO,EAAE,OAAO,CAAC;IACjB,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;CACtB;AACD;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,KAAK,CAAC;IACZ,EAAE,CAAC,EAAE,EAAE,CAAC;IACR,IAAI,EAAE,IAAI,CAAC;IACX,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;CACtB;AACD;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;CACtB;AACD;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,KAAK,CAAC;IACZ,EAAE,CAAC,EAAE,GAAG,CAAC;IACT,QAAQ,EAAE,QAAQ,CAAC;IACnB,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;CACtB;AACD;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;CACtB;AACD;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,KAAK,CAAC;IACZ,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;CACtB"}

package/dist/commonjs/__generated__/opentelemetryInputMessages.js

@@ -0,0 +1,8 @@
+"use strict";
+/**
+ * OpenTelemetry input messages schema
+ * As of 10/14/2025, this schema is still in draft status.
+ * https://opentelemetry.io/docs/specs/semconv/gen-ai/gen-ai-input-messages.json
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=opentelemetryInputMessages.js.map

package/dist/commonjs/__generated__/opentelemetryInputMessages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"opentelemetryInputMessages.js","sourceRoot":"","sources":["../../../src/__generated__/opentelemetryInputMessages.ts"],"names":[],"mappings":";AAAA;;;;GAIG"}

package/dist/commonjs/__generated__/opentelemetryOutputMessages.d.ts

@@ -0,0 +1,116 @@
+/**
+ * OpenTelemetry output messages schema
+ * As of 10/14/2025, this schema is still in draft status.
+ * https://opentelemetry.io/docs/specs/semconv/gen-ai/gen-ai-output-messages.json
+ */
+/**
+ * Role of the entity that created the message.
+ */
+export type Role = Role1 | string;
+export type Role1 = "system" | "user" | "assistant" | "tool";
+/**
+ * The type of the content captured in this part.
+ */
+export type Type = "text";
+/**
+ * Text content sent to or received from the model.
+ */
+export type Content = string;
+/**
+ * The type of the content captured in this part.
+ */
+export type Type1 = "tool_call";
+/**
+ * Unique identifier for the tool call.
+ */
+export type Id = string | null;
+/**
+ * Name of the tool.
+ */
+export type Name = string;
+/**
+ * The type of the content captured in this part.
+ */
+export type Type2 = "tool_call_response";
+/**
+ * Unique tool call identifier.
+ */
+export type Id1 = string | null;
+/**
+ * The type of the content captured in this part.
+ */
+export type Type3 = string;
+/**
+ * List of message parts that make up the message content.
+ */
+export type Parts = (TextPart | ToolCallRequestPart | ToolCallResponsePart)[];
+/**
+ * Reason for finishing the generation.
+ */
+export type FinishReason = FinishReason1 | string;
+/**
+ * Represents the reason for finishing the generation.
+ */
+export type FinishReason1 = "stop" | "length" | "content_filter" | "tool_call" | "error";
+/**
+ * Represents the list of output messages generated by the model or agent.
+ */
+export type OutputMessages = OutputMessage[];
+/**
+ * Represents an output message generated by the model or agent. The output message captures
+ * specific response (choice, candidate).
+ */
+export interface OutputMessage {
+    role: Role;
+    parts: Parts;
+    finish_reason: FinishReason;
+    [k: string]: unknown;
+}
+/**
+ * Represents text content sent to or received from the model.
+ */
+export interface TextPart {
+    type: Type;
+    content: Content;
+    [k: string]: unknown;
+}
+/**
+ * Represents a tool call requested by the model.
+ */
+export interface ToolCallRequestPart {
+    type: Type1;
+    id?: Id;
+    name: Name;
+    arguments?: Arguments;
+    [k: string]: unknown;
+}
+/**
+ * Arguments for the tool call.
+ */
+export interface Arguments {
+    [k: string]: unknown;
+}
+/**
+ * Represents a tool call result sent to the model or a built-in tool call outcome and details.
+ */
+export interface ToolCallResponsePart {
+    type: Type2;
+    id?: Id1;
+    response: Response;
+    [k: string]: unknown;
+}
+/**
+ * Tool call response.
+ */
+export interface Response {
+    [k: string]: unknown;
+}
+/**
+ * Represents an arbitrary message part with any type and properties.
+ * This allows for extensibility with custom message part types.
+ */
+export interface GenericPart {
+    type: Type3;
+    [k: string]: unknown;
+}
+//# sourceMappingURL=opentelemetryOutputMessages.d.ts.map

package/dist/commonjs/__generated__/opentelemetryOutputMessages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"opentelemetryOutputMessages.d.ts","sourceRoot":"","sources":["../../../src/__generated__/opentelemetryOutputMessages.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,MAAM,MAAM,IAAI,GAAG,KAAK,GAAG,MAAM,CAAC;AAClC,MAAM,MAAM,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,WAAW,GAAG,MAAM,CAAC;AAC7D;;GAEG;AACH,MAAM,MAAM,IAAI,GAAG,MAAM,CAAC;AAC1B;;GAEG;AACH,MAAM,MAAM,OAAO,GAAG,MAAM,CAAC;AAC7B;;GAEG;AACH,MAAM,MAAM,KAAK,GAAG,WAAW,CAAC;AAChC;;GAEG;AACH,MAAM,MAAM,EAAE,GAAG,MAAM,GAAG,IAAI,CAAC;AAC/B;;GAEG;AACH,MAAM,MAAM,IAAI,GAAG,MAAM,CAAC;AAC1B;;GAEG;AACH,MAAM,MAAM,KAAK,GAAG,oBAAoB,CAAC;AACzC;;GAEG;AACH,MAAM,MAAM,GAAG,GAAG,MAAM,GAAG,IAAI,CAAC;AAChC;;GAEG;AACH,MAAM,MAAM,KAAK,GAAG,MAAM,CAAC;AAC3B;;GAEG;AACH,MAAM,MAAM,KAAK,GAAG,CAAC,QAAQ,GAAG,mBAAmB,GAAG,oBAAoB,CAAC,EAAE,CAAC;AAC9E;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,aAAa,GAAG,MAAM,CAAC;AAClD;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,QAAQ,GAAG,gBAAgB,GAAG,WAAW,GAAG,OAAO,CAAC;AACzF;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,aAAa,EAAE,CAAC;AAE7C;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,IAAI,CAAC;IACX,KAAK,EAAE,KAAK,CAAC;IACb,aAAa,EAAE,YAAY,CAAC;IAC5B,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;CACtB;AACD;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,IAAI,CAAC;IACX,OAAO,EAAE,OAAO,CAAC;IACjB,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;CACtB;AACD;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,KAAK,CAAC;IACZ,EAAE,CAAC,EAAE,EAAE,CAAC;IACR,IAAI,EAAE,IAAI,CAAC;IACX,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;CACtB;AACD;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;CACtB;AACD;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,KAAK,CAAC;IACZ,EAAE,CAAC,EAAE,GAAG,CAAC;IACT,QAAQ,EAAE,QAAQ,CAAC;IACnB,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;CACtB;AACD;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;CACtB;AACD;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,KAAK,CAAC;IACZ,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;CACtB"}

package/dist/commonjs/__generated__/opentelemetryOutputMessages.js

@@ -0,0 +1,8 @@
+"use strict";
+/**
+ * OpenTelemetry output messages schema
+ * As of 10/14/2025, this schema is still in draft status.
+ * https://opentelemetry.io/docs/specs/semconv/gen-ai/gen-ai-output-messages.json
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=opentelemetryOutputMessages.js.map

package/dist/commonjs/__generated__/opentelemetryOutputMessages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"opentelemetryOutputMessages.js","sourceRoot":"","sources":["../../../src/__generated__/opentelemetryOutputMessages.ts"],"names":[],"mappings":";AAAA;;;;GAIG"}

package/dist/commonjs/attributes.d.ts

@@ -0,0 +1,79 @@
+import type { Attributes } from "@opentelemetry/api";
+import type { ChatMessage } from "./__generated__/opentelemetryInputMessages.js";
+import type { OutputMessage } from "./__generated__/opentelemetryOutputMessages.js";
+export type GenAIInputMessage = ChatMessage;
+export type GenAIInputMessagePart = ChatMessage["parts"][number];
+export type GenAIOutputMessage = OutputMessage & {
+    /** @deprecated use parts instead */
+    text?: string;
+};
+export type GenAIOutputMessagePart = OutputMessage["parts"][number];
+/**
+ * Convert GenAI span attributes to OpenInference span attributes
+ * @param spanAttributes - The span attributes containing GenAI span attributes to convert
+ * @returns The converted OpenInference span attributes
+ */
+export declare const convertGenAISpanAttributesToOpenInferenceSpanAttributes: (spanAttributes: Attributes) => Attributes;
+/**
+ * Map provider and system to openinference attributes
+ * @remarks TODO: add some heuristics that can map incoming provider names to the correct OpenInference provider name
+ * @param spanAttributes - The span attributes containing provider and system to map
+ * @returns The mapped provider and system attributes
+ */
+export declare const mapProviderAndSystem: (spanAttributes: Attributes) => Attributes;
+/**
+ * Map model name to openinference attributes
+ * @param spanAttributes - The span attributes containing model name to map
+ * @returns The mapped model name attributes
+ */
+export declare const mapModels: (spanAttributes: Attributes) => Attributes;
+/**
+ * Map span kind to openinference attributes
+ * @param spanAttributes - The span attributes containing span kind to map
+ * @returns The mapped span kind attributes
+ */
+export declare const mapSpanKind: (spanAttributes: Attributes) => Attributes;
+/**
+ * Map invocation parameters to openinference attributes
+ * @param spanAttributes - The span attributes containing invocation parameters to map
+ * @returns The mapped invocation parameters attributes
+ */
+export declare const mapInvocationParameters: (spanAttributes: Attributes) => Attributes;
+/**
+ * Map input value to openinference attributes
+ * @param spanAttributes - The span attributes containing input value to map
+ * @returns The mapped input value attributes
+ */
+export declare const mapInputValue: (spanAttributes: Attributes) => Attributes;
+/**
+ * Map output value to openinference attributes
+ * @param spanAttributes - The span attributes containing output value to map
+ * @returns The mapped output value attributes
+ */
+export declare const mapOutputValue: (spanAttributes: Attributes) => Attributes;
+/**
+ * Map input messages to openinference attributes
+ * @param spanAttributes - The span attributes containing input messages to map
+ * @returns The mapped input messages attributes
+ */
+export declare const mapInputMessages: (spanAttributes: Attributes) => Attributes;
+/**
+ * Map output messages to openinference attributes
+ * @param spanAttributes - The span attributes containing output messages to map
+ * @returns The mapped output messages attributes
+ */
+export declare const mapOutputMessages: (spanAttributes: Attributes) => Attributes;
+/**
+ * Map usage token counts to openinference attributes
+ * @param spanAttributes - The span attributes containing usage token counts to map
+ * @returns The mapped usage token counts attributes
+ */
+export declare const mapTokenCounts: (spanAttributes: Attributes) => Attributes;
+/**
+ * Map tool execution to openinference attributes
+ * @see https://opentelemetry.io/docs/specs/semconv/gen-ai/gen-ai-spans/#execute-tool-span
+ * @param spanAttributes - The span attributes containing tool execution to map
+ * @returns The mapped tool execution attributes
+ */
+export declare const mapToolExecution: (spanAttributes: Attributes) => Attributes;
+//# sourceMappingURL=attributes.d.ts.map

package/dist/commonjs/attributes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attributes.d.ts","sourceRoot":"","sources":["../../src/attributes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAiCrD,OAAO,KAAK,EAAE,WAAW,EAAe,MAAM,+CAA+C,CAAC;AAC9F,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gDAAgD,CAAC;AAapF,MAAM,MAAM,iBAAiB,GAAG,WAAW,CAAC;AAC5C,MAAM,MAAM,qBAAqB,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC;AACjE,MAAM,MAAM,kBAAkB,GAAG,aAAa,GAAG;IAC/C,oCAAoC;IACpC,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AACF,MAAM,MAAM,sBAAsB,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC;AA+GpE;;;;GAIG;AACH,eAAO,MAAM,uDAAuD,GAClE,gBAAgB,UAAU,KACzB,UAaF,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,GAAI,gBAAgB,UAAU,KAAG,UAKjE,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,SAAS,GAAI,gBAAgB,UAAU,KAAG,UAOtD,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,WAAW,GAAI,gBAAgB,UAAU,KAAG,UAgBxD,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,GAAI,gBAAgB,UAAU,KAAG,UA+BpE,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,aAAa,GAAI,gBAAgB,UAAU,KAAG,UAa1D,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,cAAc,GAAI,gBAAgB,UAAU,KAAG,UAa3D,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,GAAI,gBAAgB,UAAU,KAAG,UAgB7D,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,GAAI,gBAAgB,UAAU,KAAG,UAiB9D,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,cAAc,GAAI,gBAAgB,UAAU,KAAG,UAc3D,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,GAAI,gBAAgB,UAAU,KAAG,UAY7D,CAAC"}