@arizeai/openinference-genai 0.1.0

package/dist/esm/utils.js

@@ -0,0 +1,94 @@
+import { MimeType } from "@arizeai/openinference-semantic-conventions";
+export const safelyJSONStringify = (value) => {
+    try {
+        return JSON.stringify(value);
+    }
+    catch {
+        return null;
+    }
+};
+export const getNumber = (value) => {
+    if (typeof value === "number" && Number.isFinite(value))
+        return value;
+    return undefined;
+};
+export const getString = (value) => {
+    if (typeof value === "string" && value.length > 0)
+        return value;
+    return undefined;
+};
+export const getStringArray = (value) => {
+    if (Array.isArray(value) && value.every((v) => typeof v === "string")) {
+        return value;
+    }
+    return undefined;
+};
+export const safelyParseJSON = (value) => {
+    const s = getString(value);
+    if (!s)
+        return undefined;
+    try {
+        return JSON.parse(s);
+    }
+    catch {
+        return undefined;
+    }
+};
+export const getMimeType = (value) => {
+    if (safelyParseJSON(value))
+        return MimeType.JSON;
+    return MimeType.TEXT;
+};
+/**
+ * Assign attribute value to attributes object if value is not undefined or null
+ * This mutates the attrs object
+ * @param attrs - The attributes object to assign the value to
+ * @param key - The key to assign the value to
+ * @param value - The value to assign to the key
+ */
+export const set = (attrs, key, value) => {
+    if (value === undefined || value === null)
+        return;
+    attrs[key] = value;
+};
+/**
+ * Merge multiple attributes objects into a single attributes object
+ * This mutates the first attributes object
+ * @param groups - The groups of attributes to merge
+ * @returns The merged attributes
+ */
+export const merge = (...groups) => groups.reduce((acc, g) => Object.assign(acc, g), {});
+/**
+ * Convert a value to a string. If the value is already a string, return it.
+ * If the value can be jsonified, jsonify it.
+ * Otherwise, return the string representation of the value.
+ * @param value - The value to convert to a string
+ * @returns The string representation of the value
+ */
+export const toStringContent = (value) => {
+    if (typeof value === "string")
+        return value;
+    const json = safelyJSONStringify(value);
+    if (typeof json === "string")
+        return json;
+    return String(value);
+};
+/**
+ * Wraps a function with a try-catch block to catch and log any errors.
+ * @param fn - A function to wrap with a try-catch block.
+ * @returns A function that returns null if an error is thrown.
+ */
+export function withSafety({ fn, onError, }) {
+    return (...args) => {
+        try {
+            return fn(...args);
+        }
+        catch (error) {
+            if (onError) {
+                onError(error);
+            }
+            return null;
+        }
+    };
+}
+//# sourceMappingURL=utils.js.map

package/dist/esm/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,6CAA6C,CAAC;AAIvE,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,KAAc,EAAE,EAAE;IACpD,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAC/B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,KAAc,EAAsB,EAAE;IAC9D,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACtE,OAAO,SAAS,CAAC;AACnB,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,KAAc,EAAsB,EAAE;IAC9D,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,KAAK,CAAC;IAChE,OAAO,SAAS,CAAC;AACnB,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,KAAc,EAAwB,EAAE;IACrE,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,EAAE,CAAC;QACtE,OAAO,KAAiB,CAAC;IAC3B,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,KAAc,EAAW,EAAE;IACzD,MAAM,CAAC,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC;IAC3B,IAAI,CAAC,CAAC;QAAE,OAAO,SAAS,CAAC;IACzB,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACvB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,KAAc,EAAY,EAAE;IACtD,IAAI,eAAe,CAAC,KAAK,CAAC;QAAE,OAAO,QAAQ,CAAC,IAAI,CAAC;IACjD,OAAO,QAAQ,CAAC,IAAI,CAAC;AACvB,CAAC,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,GAAG,GAAG,CACjB,KAAiB,EACjB,GAAW,EACX,KAA6B,EAC7B,EAAE;IACF,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO;IAClD,KAAK,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;AACrB,CAAC,CAAC;AAEF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,GAAG,MAAoB,EAAc,EAAE,CAC3D,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,EAAgB,CAAC,CAAC;AAErE;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,KAAc,EAAU,EAAE;IACxD,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC5C,MAAM,IAAI,GAAG,mBAAmB,CAAC,KAAK,CAAC,CAAC;IACxC,IAAI,OAAO,IAAI,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC1C,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;AACvB,CAAC,CAAC;AAEF;;;;GAIG;AACH,MAAM,UAAU,UAAU,CAA4B,EACpD,EAAE,EACF,OAAO,GAIR;IACC,OAAO,CAAC,GAAG,IAAI,EAAE,EAAE;QACjB,IAAI,CAAC;YACH,OAAO,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC;QACrB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,OAAO,EAAE,CAAC;gBACZ,OAAO,CAAC,KAAK,CAAC,CAAC;YACjB,CAAC;YACD,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC,CAAC;AACJ,CAAC"}

package/package.json

@@ -0,0 +1,68 @@
+{
+  "name": "@arizeai/openinference-genai",
+  "version": "0.1.0",
+  "private": false,
+  "type": "module",
+  "types": "dist/esm/index.d.ts",
+  "description": "OpenInference utilities for converting OpenTelemetry GenAI span attributes to OpenInference span attributes",
+  "exports": {
+    ".": {
+      "import": "./dist/esm/index.js"
+    },
+    "./attributes": {
+      "import": "./dist/esm/attributes.js"
+    },
+    "./utils": {
+      "import": "./dist/esm/utils.js"
+    },
+    "./types": {
+      "types": "./dist/esm/types.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "keywords": [
+    "openinference",
+    "llm",
+    "opentelemetry",
+    "genai",
+    "agent"
+  ],
+  "author": "oss-devs@arize.com",
+  "license": "Apache-2.0",
+  "homepage": "https://github.com/arize-ai/openinference/tree/main/js/packages/openinference-genai",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Arize-ai/openinference.git"
+  },
+  "bugs": {
+    "url": "https://github.com/Arize-ai/openinference/issues"
+  },
+  "dependencies": {
+    "@arizeai/openinference-semantic-conventions": "2.1.2"
+  },
+  "devDependencies": {
+    "@opentelemetry/api": "^1.9.0",
+    "@opentelemetry/core": "^2.1.0",
+    "@opentelemetry/exporter-trace-otlp-proto": "^0.206.0",
+    "@opentelemetry/resources": "^2.1.0",
+    "@opentelemetry/sdk-trace-base": "^2.1.0",
+    "@opentelemetry/sdk-trace-node": "^2.1.0",
+    "@opentelemetry/semantic-conventions": "^1.37.0",
+    "@types/node": "^20.14.11",
+    "vitest": "^3.1.3"
+  },
+  "peerDependencies": {
+    "@opentelemetry/api": ">=1.9.0",
+    "@opentelemetry/semantic-conventions": ">=1.37.0"
+  },
+  "scripts": {
+    "prebuild": "rimraf dist",
+    "build": "tsc --build tsconfig.esm.json && tsc-alias -p tsconfig.esm.json",
+    "postbuild": "echo '{\"type\": \"module\"}' > ./dist/esm/package.json && rimraf dist/test dist/examples",
+    "type:check": "tsc --noEmit",
+    "test": "vitest"
+  }
+}

package/src/__generated__/opentelemetryInputMessages.ts

@@ -0,0 +1,104 @@
+/**
+ * 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;
+}

package/src/__generated__/opentelemetryOutputMessages.ts

@@ -0,0 +1,122 @@
+/**
+ * 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;
+}