@microsoft/opentelemetry 0.1.0-alpha.1

package/dist/esm/genai/instrumentations/langchain/tracer.js

@@ -0,0 +1,181 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+// Vendored from microsoft/Agent365-nodejs packages/agents-a365-observability-extensions-langchain
+import { context, trace, SpanKind, SpanStatusCode } from "@opentelemetry/api";
+import { BaseTracer } from "@langchain/core/tracers/base";
+import { isTracingSuppressed } from "@opentelemetry/core";
+import { diag } from "@opentelemetry/api";
+import { ATTR_ERROR_MESSAGE, ATTR_GEN_AI_PROVIDER_NAME } from "../../index.js";
+import * as Utils from "./utils.js";
+/**
+ * OpenTelemetry-based tracer for LangChain / LangGraph applications.
+ *
+ * Extends LangChain's `BaseTracer` callback handler so it can be injected into
+ * the LangChain callback system (via `LangChainTraceInstrumentor`). Every
+ * LangChain "run" (agent invocation, tool execution, or LLM call) is mapped to
+ * an OTel span with GenAI semantic convention attributes.
+ *
+ * Key behaviors:
+ * - Creates a span on `onRunCreate` and ends it on `_endTrace`.
+ * - Maintains parent–child span relationships by tracking run IDs and walking
+ *   up the parent chain to find the nearest span context.
+ * - Skips LangChain-internal runs (tagged `langsmith:hidden`, `Branch*`, or
+ *   unmapped run types) to avoid noisy traces.
+ * - Guards against unbounded memory with a hard cap of {@link MAX_RUNS}.
+ * - Content-sensitive attributes (messages, tool args, system instructions)
+ *   are only recorded when `isContentRecordingEnabled` is true.
+ */
+export class LangChainTracer extends BaseTracer {
+    /** Hard cap on concurrent tracked runs to prevent memory leaks. */
+    static MAX_RUNS = 10_000;
+    tracer;
+    isContentRecordingEnabled;
+    /** Active runs keyed by LangChain run ID. */
+    runs = new Map();
+    /** Maps each run ID → its parent run ID for parent-span-context lookup. */
+    parentByRunId = new Map();
+    constructor(tracer, options) {
+        super();
+        this.tracer = tracer;
+        this.isContentRecordingEnabled = options?.isContentRecordingEnabled ?? false;
+    }
+    name = "OpenTelemetryLangChainTracer";
+    persistRun(_run) {
+        return Promise.resolve();
+    }
+    /**
+     * Called by LangChain when a new run starts. Records the parent mapping
+     * and opens a span via {@link startTracing}.
+     */
+    async onRunCreate(run) {
+        this.parentByRunId.set(run.id, run.parent_run_id);
+        if (super.onRunCreate)
+            await super.onRunCreate(run);
+        this.startTracing(run);
+    }
+    /**
+     * Opens an OTel span for the given run. The span name is derived from the
+     * operation type (invoke_agent, execute_tool, chat) and the run/model name.
+     * Internal or unknown runs are silently skipped.
+     */
+    startTracing(run) {
+        if (isTracingSuppressed(context.active())) {
+            return;
+        }
+        const operation = Utils.getOperationType(run);
+        // Skip internal runs (LangSmith hidden, Branch nodes, unknown operations)
+        if (run.tags?.includes("langsmith:hidden") ||
+            run.name?.startsWith("Branch") ||
+            operation === "unknown") {
+            diag.debug(`[LangChainTracer] Skipping internal run: ${run.name} (parent: ${run.parent_run_id})`);
+            return;
+        }
+        // Attach to parent span if one exists in the run hierarchy
+        const parentCtx = this.getNearestParentSpanContext(run);
+        const activeContext = parentCtx
+            ? trace.setSpanContext(context.active(), parentCtx)
+            : context.active();
+        // Build span name: "<operation> <name|model>"
+        let spanName = run.name;
+        if (operation === "invoke_agent") {
+            spanName = `${operation} ${run.name}`;
+        }
+        else if (operation === "execute_tool") {
+            spanName = `${operation} ${run.name}`;
+        }
+        else if (operation === "chat") {
+            spanName = `${operation} ${Utils.getModel(run) || run.name}`.trim();
+        }
+        if (this.runs.size >= LangChainTracer.MAX_RUNS) {
+            diag.warn(`[LangChainTracer] Max runs (${LangChainTracer.MAX_RUNS}) reached, skipping span`);
+            this.parentByRunId.delete(run.id);
+            return;
+        }
+        const startTime = run.start_time ?? Date.now();
+        const span = this.tracer.startSpan(spanName, {
+            kind: SpanKind.INTERNAL,
+            startTime,
+            attributes: { [ATTR_GEN_AI_PROVIDER_NAME]: "langchain" },
+        }, activeContext);
+        this.runs.set(run.id, { run, span, startTime, lastAccessTime: startTime });
+    }
+    /**
+     * Called by LangChain when a run finishes. Sets status, enriches the span
+     * with GenAI attributes, and ends it. If content recording is enabled,
+     * message bodies, tool arguments, and system instructions are also attached.
+     */
+    async _endTrace(run) {
+        if (isTracingSuppressed(context.active())) {
+            // End any span that was started before suppression to avoid leaks.
+            const suppressedEntry = this.runs.get(run.id);
+            if (suppressedEntry) {
+                suppressedEntry.span.end(run.end_time ?? undefined);
+            }
+            this.parentByRunId.delete(run.id);
+            this.runs.delete(run.id);
+            return;
+        }
+        const operation = Utils.getOperationType(run);
+        if (run.tags?.includes("langsmith:hidden") ||
+            run.name?.startsWith("Branch") ||
+            operation === "unknown") {
+            diag.debug(`[LangChainTracer] Skipping internal run: ${run.name} (parent: ${run.parent_run_id})`);
+            return;
+        }
+        const entry = this.runs.get(run.id);
+        if (!entry) {
+            return;
+        }
+        const { span } = entry;
+        try {
+            entry.lastAccessTime = Date.now();
+            if (run.error) {
+                span.setStatus({ code: SpanStatusCode.ERROR });
+                span.setAttribute(ATTR_ERROR_MESSAGE, String(run.error));
+            }
+            else {
+                span.setStatus({ code: SpanStatusCode.OK });
+            }
+            // Always-on attributes: operation type, agent info, model, provider, session, tokens
+            Utils.setOperationTypeAttribute(operation, span);
+            Utils.setAgentAttributes(run, span);
+            Utils.setModelAttribute(run, span);
+            Utils.setProviderNameAttribute(run, span);
+            Utils.setSessionIdAttribute(run, span);
+            Utils.setTokenAttributes(run, span);
+            // Opt-in content attributes (may contain PII / large payloads)
+            if (this.isContentRecordingEnabled) {
+                Utils.setToolAttributes(run, span);
+                Utils.setInputMessagesAttribute(run, span);
+                Utils.setOutputMessagesAttribute(run, span);
+                Utils.setSystemInstructionsAttribute(run, span);
+            }
+        }
+        catch (error) {
+            diag.error(`[LangChainTracer] Error setting span attributes for run ${run.name}: ${error instanceof Error ? error.message : String(error)}`);
+            span.setStatus({ code: SpanStatusCode.ERROR });
+        }
+        finally {
+            span.end(run.end_time ?? undefined);
+            this.runs.delete(run.id);
+            this.parentByRunId.delete(run.id);
+            await super._endTrace(run);
+        }
+    }
+    /**
+     * Walks up the parent run chain to find the nearest ancestor that has an
+     * active span, returning its `SpanContext` so the new span can be linked
+     * as a child.
+     */
+    getNearestParentSpanContext(run) {
+        let pid = run.parent_run_id;
+        while (pid) {
+            const entry = this.runs.get(pid);
+            if (entry)
+                return entry.span.spanContext();
+            pid = this.parentByRunId.get(pid);
+        }
+        return undefined;
+    }
+}
+//# sourceMappingURL=tracer.js.map

package/dist/esm/genai/instrumentations/langchain/tracer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracer.js","sourceRoot":"","sources":["../../../../../src/genai/instrumentations/langchain/tracer.ts"],"names":[],"mappings":"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"}

package/dist/esm/genai/instrumentations/langchain/utils.d.ts

@@ -0,0 +1,16 @@
+import { Run } from "@langchain/core/tracers/base";
+import { Span } from "@opentelemetry/api";
+export declare function isString(value: unknown): value is string;
+export declare function getOperationType(run: Run): string;
+export declare function setOperationTypeAttribute(operation: string, span: Span): void;
+export declare function setAgentAttributes(run: Run, span: Span): void;
+export declare function setToolAttributes(run: Run, span: Span): void;
+export declare function setInputMessagesAttribute(run: Run, span: Span): void;
+export declare function setOutputMessagesAttribute(run: Run, span: Span): void;
+export declare function getModel(run: Run): string | undefined;
+export declare function setModelAttribute(run: Run, span: Span): void;
+export declare function setProviderNameAttribute(run: Run, span: Span): void;
+export declare function setSessionIdAttribute(run: Run, span: Span): void;
+export declare function setSystemInstructionsAttribute(run: Run, span: Span): Span | undefined;
+export declare function setTokenAttributes(run: Run, span: Span): void;
+//# sourceMappingURL=utils.d.ts.map

package/dist/esm/genai/instrumentations/langchain/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../../../src/genai/instrumentations/langchain/utils.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,GAAG,EAAE,MAAM,8BAA8B,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAuB1C,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAExD;AAGD,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,GAAG,GAAG,MAAM,CAWjD;AAGD,wBAAgB,yBAAyB,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,QAEtE;AAGD,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,QAOtD;AAGD,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,QAyBrD;AAED,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,QAwB7D;AA+ED,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,QAgE9D;AAGD,wBAAgB,QAAQ,CAAC,GAAG,EAAE,GAAG,GAAG,MAAM,GAAG,SAAS,CASrD;AAGD,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,QAGrD;AAGD,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,QAG5D;AAED,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,GAAG,IAAI,CAShE;AAGD,wBAAgB,8BAA8B,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,oBAuBlE;AAGD,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,QA2BtD"}

package/dist/esm/genai/instrumentations/langchain/utils.js

@@ -0,0 +1,305 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+// Vendored from microsoft/Agent365-nodejs packages/agents-a365-observability-extensions-langchain
+import { ATTR_GEN_AI_AGENT_NAME, ATTR_GEN_AI_INPUT_MESSAGES, ATTR_GEN_AI_OPERATION_NAME, ATTR_GEN_AI_OUTPUT_MESSAGES, ATTR_GEN_AI_PROVIDER_NAME, ATTR_GEN_AI_REQUEST_MODEL, ATTR_GEN_AI_SYSTEM_INSTRUCTIONS, ATTR_GEN_AI_TOOL_CALL_ARGUMENTS, ATTR_GEN_AI_TOOL_CALL_ID, ATTR_GEN_AI_TOOL_CALL_RESULT, ATTR_GEN_AI_TOOL_NAME, ATTR_GEN_AI_TOOL_TYPE, ATTR_GEN_AI_USAGE_INPUT_TOKENS, ATTR_GEN_AI_USAGE_OUTPUT_TOKENS, ATTR_MICROSOFT_SESSION_ID, GEN_AI_OPERATION_CHAT, GEN_AI_OPERATION_EXECUTE_TOOL, GEN_AI_OPERATION_INVOKE_AGENT, } from "../../index.js";
+// Type guards
+export function isString(value) {
+    return typeof value === "string";
+}
+// Operation type mapping
+export function getOperationType(run) {
+    let operation = "unknown";
+    if (run.run_type === "chain" && isLangGraphAgentInvoke(run)) {
+        operation = GEN_AI_OPERATION_INVOKE_AGENT;
+    }
+    else if (run.run_type === "tool") {
+        operation = GEN_AI_OPERATION_EXECUTE_TOOL;
+    }
+    else if (run.run_type === "llm") {
+        operation = GEN_AI_OPERATION_CHAT;
+    }
+    return operation;
+}
+// Operation type mapping
+export function setOperationTypeAttribute(operation, span) {
+    span.setAttribute(ATTR_GEN_AI_OPERATION_NAME, operation);
+}
+// Agent attributes
+export function setAgentAttributes(run, span) {
+    if (isLangGraphAgentInvoke(run)) {
+        const agentName = run.name;
+        if (isString(agentName)) {
+            span.setAttribute(ATTR_GEN_AI_AGENT_NAME, agentName);
+        }
+    }
+}
+// Tool attributes
+export function setToolAttributes(run, span) {
+    if (run.run_type !== "tool") {
+        return;
+    }
+    if (!run.serialized || typeof run.serialized !== "object" || Array.isArray(run.serialized)) {
+        return;
+    }
+    if (isString(run.name)) {
+        span.setAttribute(ATTR_GEN_AI_TOOL_NAME, run.name);
+    }
+    if (run.inputs)
+        span.setAttribute(ATTR_GEN_AI_TOOL_CALL_ARGUMENTS, JSON.stringify(run.inputs?.input ?? run.inputs));
+    if (run.outputs?.output?.kwargs?.content)
+        span.setAttribute(ATTR_GEN_AI_TOOL_CALL_RESULT, JSON.stringify(run.outputs?.output?.kwargs?.content));
+    span.setAttribute(ATTR_GEN_AI_TOOL_TYPE, "extension");
+    if (run.outputs?.output?.tool_call_id)
+        span.setAttribute(ATTR_GEN_AI_TOOL_CALL_ID, run.outputs?.output?.tool_call_id);
+}
+export function setInputMessagesAttribute(run, span) {
+    const messages = run.inputs?.messages;
+    if (!Array.isArray(messages)) {
+        return;
+    }
+    const preprocess = getScopeType(run) === "inference" && messages.length > 0 ? messages[0] : messages;
+    const processed = preprocess
+        ?.map((msg) => {
+        const content = extractMessageContent(msg);
+        if (!content)
+            return null;
+        const msgType = getMessageType(msg);
+        if (shouldIncludeInputMessage(msgType)) {
+            return content;
+        }
+        return null;
+    })
+        .filter(Boolean);
+    if (processed.length > 0) {
+        span.setAttribute(ATTR_GEN_AI_INPUT_MESSAGES, JSON.stringify(processed));
+    }
+}
+// Helper: Extract message content from various formats
+function extractMessageContent(msg) {
+    // Simple format: {role: "user", content}
+    if (isString(msg.content)) {
+        return msg.content;
+    }
+    // LangChain format: {lc_type: "human", lc_kwargs: {content}}
+    if (msg.lc_kwargs && typeof msg.lc_kwargs === "object" && !Array.isArray(msg.lc_kwargs)) {
+        const kwargs = msg.lc_kwargs;
+        if (isString(kwargs.content))
+            return kwargs.content;
+    }
+    // New LangChain format: {lc: 1, type: "constructor", kwargs: {content}}
+    if (msg.lc === 1 &&
+        msg.type === "constructor" &&
+        msg.kwargs &&
+        typeof msg.kwargs === "object" &&
+        !Array.isArray(msg.kwargs)) {
+        const kwargs = msg.kwargs;
+        if (isString(kwargs.content))
+            return kwargs.content;
+    }
+    return null;
+}
+// Helper: Determine message type
+function getMessageType(msg) {
+    // Simple format
+    if (isString(msg.role))
+        return msg.role;
+    // LangChain old format
+    if (isString(msg.lc_type))
+        return msg.lc_type;
+    if (isString(msg.type))
+        return msg.type;
+    // LangChain new format - check id array for message type
+    if (Array.isArray(msg.id)) {
+        const lastId = msg.id[msg.id.length - 1];
+        if (isString(lastId)) {
+            if (lastId.includes("Human"))
+                return "human";
+            if (lastId.includes("AI"))
+                return "ai";
+            if (lastId.includes("System"))
+                return "system";
+        }
+    }
+    return "unknown";
+}
+// Helper: Determine scope type from run
+function getScopeType(run) {
+    if (run.run_type === "chain" && isLangGraphAgentInvoke(run)) {
+        return "agent";
+    }
+    else if (run.run_type === "tool") {
+        return "tool";
+    }
+    else if (run.run_type === "llm") {
+        return "inference";
+    }
+    return "unknown";
+}
+// Helper: Check if input message should be included based on scope and message type
+function shouldIncludeInputMessage(msgType) {
+    // For input messages: all scopes want user/human messages only
+    return msgType === "user" || msgType === "human";
+}
+// Helper: Check if output message should be included based on scope and message type
+function shouldIncludeOutputMessage(scopeType, msgType) {
+    if (scopeType === "agent" || scopeType === "inference") {
+        // Agent and Inference scopes want assistant/AI messages only
+        return msgType === "ai" || msgType === "assistant";
+    }
+    else if (scopeType === "tool") {
+        // Tool scope wants all output messages
+        return true;
+    }
+    // Default: all messages
+    return true;
+}
+export function setOutputMessagesAttribute(run, span) {
+    const outputs = run.outputs;
+    if (!outputs) {
+        return;
+    }
+    const scopeType = getScopeType(run);
+    const messages = [];
+    // Direct messages array (used in agent/chain outputs)
+    if (Array.isArray(outputs.messages)) {
+        outputs.messages.forEach((msg) => {
+            const content = extractMessageContent(msg);
+            if (!content)
+                return;
+            const msgType = getMessageType(msg);
+            if (shouldIncludeOutputMessage(scopeType, msgType)) {
+                messages.push(content);
+            }
+        });
+    }
+    // LangChain generations format (used in LLM/inference outputs)
+    if (Array.isArray(outputs.generations)) {
+        outputs.generations.forEach((gen) => {
+            if (Array.isArray(gen)) {
+                gen.forEach((item) => {
+                    // Try message property
+                    if (item.message && typeof item.message === "object" && !Array.isArray(item.message)) {
+                        const msg = item.message;
+                        const content = extractMessageContent(msg);
+                        if (!content) {
+                            return;
+                        }
+                        const msgType = getMessageType(msg);
+                        if (shouldIncludeOutputMessage(scopeType, msgType)) {
+                            messages.push(content);
+                        }
+                    }
+                    // Try direct text property (for generation items)
+                    else if (isString(item.text) && scopeType === "inference") {
+                        messages.push(item.text);
+                    }
+                });
+            }
+        });
+    }
+    // Check for direct message object (some models return this)
+    if (outputs.message && typeof outputs.message === "object" && !Array.isArray(outputs.message)) {
+        const msg = outputs.message;
+        const content = extractMessageContent(msg);
+        if (content) {
+            const msgType = getMessageType(msg);
+            if (shouldIncludeOutputMessage(scopeType, msgType)) {
+                messages.push(content);
+            }
+        }
+    }
+    if (messages.length > 0) {
+        span.setAttribute(ATTR_GEN_AI_OUTPUT_MESSAGES, JSON.stringify(messages));
+    }
+}
+// Model - Helper to extract model name from run
+export function getModel(run) {
+    return [
+        run.outputs?.generations?.[0]?.[0]?.message?.kwargs?.response_metadata?.model_name,
+        run.extra?.metadata?.ls_model_name,
+        run.extra?.invocation_params?.model,
+        run.extra?.invocation_params?.model_name,
+    ]
+        .map((v) => (v != null ? String(v).trim() : ""))
+        .find((v) => v.length > 0);
+}
+// Model - Set model attribute on span
+export function setModelAttribute(run, span) {
+    const model = getModel(run);
+    if (model)
+        span.setAttribute(ATTR_GEN_AI_REQUEST_MODEL, model);
+}
+// Provider
+export function setProviderNameAttribute(run, span) {
+    const provider = run.extra?.metadata?.ls_provider;
+    if (isString(provider))
+        span.setAttribute(ATTR_GEN_AI_PROVIDER_NAME, provider.toLowerCase());
+}
+export function setSessionIdAttribute(run, span) {
+    const metadata = run.extra?.metadata;
+    if (!metadata)
+        return;
+    const sessionId = metadata.session_id ?? metadata.conversation_id ?? metadata.thread_id;
+    if (typeof sessionId === "string" && sessionId.length > 0) {
+        span.setAttribute(ATTR_MICROSOFT_SESSION_ID, sessionId);
+    }
+}
+// System instructions
+export function setSystemInstructionsAttribute(run, span) {
+    const inputs = run.inputs;
+    if (!inputs) {
+        return;
+    }
+    const prompts = Array.isArray(inputs.prompts)
+        ? inputs.prompts
+            .map((p) => String(p ?? "").trim())
+            .filter(Boolean)
+            .join("\n")
+        : "";
+    if (prompts)
+        return span.setAttribute(ATTR_GEN_AI_SYSTEM_INSTRUCTIONS, prompts);
+    const messages = Array.isArray(inputs.messages) ? inputs.messages : [];
+    const systemText = messages
+        .filter((m) => m.lc_type === "system")
+        .map((m) => String(m.lc_kwargs?.content ?? "").trim())
+        .filter(Boolean)
+        .join("\n");
+    if (systemText)
+        span.setAttribute(ATTR_GEN_AI_SYSTEM_INSTRUCTIONS, systemText);
+}
+// Tokens (input and output)
+export function setTokenAttributes(run, span) {
+    // Try multiple paths to find usage metadata (LLM direct/kwargs/response_metadata, agent calls, and chain/model_request outputs)
+    const usage = run.outputs?.generations?.[0]?.[0]?.message?.usage_metadata ||
+        run.outputs?.generations?.[0]?.[0]?.message?.kwargs?.usage_metadata ||
+        run.outputs?.generations?.[0]?.[0]?.message?.kwargs?.response_metadata?.tokenUsage ||
+        run.outputs?.messages?.[1]?.usage_metadata ||
+        run.outputs?.message?.response_metadata?.usage ||
+        run.outputs?.message?.response_metadata?.tokenUsage ||
+        run.outputs?.messages
+            ?.map((msg) => msg.response_metadata?.tokenUsage)
+            .filter(Boolean)[0];
+    if (!usage || typeof usage !== "object") {
+        return;
+    }
+    const usageObj = usage;
+    if (typeof usageObj.input_tokens === "number") {
+        span.setAttribute(ATTR_GEN_AI_USAGE_INPUT_TOKENS, usageObj.input_tokens);
+    }
+    if (typeof usageObj.output_tokens === "number") {
+        span.setAttribute(ATTR_GEN_AI_USAGE_OUTPUT_TOKENS, usageObj.output_tokens);
+    }
+}
+// LangGraph agent check
+function isLangGraphAgentInvoke(run) {
+    if (run.run_type !== "chain") {
+        return false;
+    }
+    if (!run.serialized || typeof run.serialized !== "object" || Array.isArray(run.serialized)) {
+        return false;
+    }
+    const serialized = run.serialized;
+    const id = serialized.id;
+    return Array.isArray(id) && id.includes("langgraph") && id.includes("CompiledStateGraph");
+}
+//# sourceMappingURL=utils.js.map

package/dist/esm/genai/instrumentations/langchain/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../../../src/genai/instrumentations/langchain/utils.ts"],"names":[],"mappings":"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"}

package/dist/esm/genai/semconv.d.ts

@@ -0,0 +1,33 @@
+/**
+ * GenAI semantic conventions (incubating/unstable).
+ *
+ * Per OTel recommendation, unstable conventions are copied locally rather than
+ * imported from @opentelemetry/semantic-conventions/incubating.
+ * See: https://opentelemetry.io/docs/specs/semconv/non-normative/code-generation/#stability-and-versioning
+ *
+ * Sourced from OTel semantic conventions + microsoft/Agent365-nodejs.
+ */
+export declare const GEN_AI_OPERATION_INVOKE_AGENT: "invoke_agent";
+export declare const GEN_AI_OPERATION_EXECUTE_TOOL: "execute_tool";
+export declare const GEN_AI_OPERATION_OUTPUT_MESSAGES: "output_messages";
+export declare const GEN_AI_OPERATION_CHAT: "chat";
+export declare const ATTR_ERROR_TYPE: "error.type";
+export declare const ATTR_ERROR_MESSAGE: "error.message";
+export declare const ATTR_GEN_AI_OPERATION_NAME: "gen_ai.operation.name";
+export declare const ATTR_GEN_AI_REQUEST_MODEL: "gen_ai.request.model";
+export declare const ATTR_GEN_AI_RESPONSE_MODEL: "gen_ai.response.model";
+export declare const ATTR_GEN_AI_PROVIDER_NAME: "gen_ai.provider.name";
+export declare const ATTR_GEN_AI_SYSTEM_INSTRUCTIONS: "gen_ai.system_instructions";
+export declare const ATTR_GEN_AI_INPUT_MESSAGES: "gen_ai.input.messages";
+export declare const ATTR_GEN_AI_OUTPUT_MESSAGES: "gen_ai.output.messages";
+export declare const ATTR_GEN_AI_USAGE_INPUT_TOKENS: "gen_ai.usage.input_tokens";
+export declare const ATTR_GEN_AI_USAGE_OUTPUT_TOKENS: "gen_ai.usage.output_tokens";
+export declare const ATTR_GEN_AI_AGENT_ID: "gen_ai.agent.id";
+export declare const ATTR_GEN_AI_AGENT_NAME: "gen_ai.agent.name";
+export declare const ATTR_GEN_AI_TOOL_CALL_ID: "gen_ai.tool.call.id";
+export declare const ATTR_GEN_AI_TOOL_NAME: "gen_ai.tool.name";
+export declare const ATTR_GEN_AI_TOOL_CALL_ARGUMENTS: "gen_ai.tool.call.arguments";
+export declare const ATTR_GEN_AI_TOOL_CALL_RESULT: "gen_ai.tool.call.result";
+export declare const ATTR_GEN_AI_TOOL_TYPE: "gen_ai.tool.type";
+export declare const ATTR_MICROSOFT_SESSION_ID: "microsoft.session.id";
+//# sourceMappingURL=semconv.d.ts.map

package/dist/esm/genai/semconv.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"semconv.d.ts","sourceRoot":"","sources":["../../../src/genai/semconv.ts"],"names":[],"mappings":"AAGA;;;;;;;;GAQG;AAGH,eAAO,MAAM,6BAA6B,EAAG,cAAuB,CAAC;AACrE,eAAO,MAAM,6BAA6B,EAAG,cAAuB,CAAC;AACrE,eAAO,MAAM,gCAAgC,EAAG,iBAA0B,CAAC;AAC3E,eAAO,MAAM,qBAAqB,EAAG,MAAe,CAAC;AAKrD,eAAO,MAAM,eAAe,EAAG,YAAqB,CAAC;AACrD,eAAO,MAAM,kBAAkB,EAAG,eAAwB,CAAC;AAG3D,eAAO,MAAM,0BAA0B,EAAG,uBAAgC,CAAC;AAC3E,eAAO,MAAM,yBAAyB,EAAG,sBAA+B,CAAC;AACzE,eAAO,MAAM,0BAA0B,EAAG,uBAAgC,CAAC;AAC3E,eAAO,MAAM,yBAAyB,EAAG,sBAA+B,CAAC;AACzE,eAAO,MAAM,+BAA+B,EAAG,4BAAqC,CAAC;AACrF,eAAO,MAAM,0BAA0B,EAAG,uBAAgC,CAAC;AAC3E,eAAO,MAAM,2BAA2B,EAAG,wBAAiC,CAAC;AAG7E,eAAO,MAAM,8BAA8B,EAAG,2BAAoC,CAAC;AACnF,eAAO,MAAM,+BAA+B,EAAG,4BAAqC,CAAC;AAGrF,eAAO,MAAM,oBAAoB,EAAG,iBAA0B,CAAC;AAC/D,eAAO,MAAM,sBAAsB,EAAG,mBAA4B,CAAC;AAGnE,eAAO,MAAM,wBAAwB,EAAG,qBAA8B,CAAC;AACvE,eAAO,MAAM,qBAAqB,EAAG,kBAA2B,CAAC;AACjE,eAAO,MAAM,+BAA+B,EAAG,4BAAqC,CAAC;AACrF,eAAO,MAAM,4BAA4B,EAAG,yBAAkC,CAAC;AAC/E,eAAO,MAAM,qBAAqB,EAAG,kBAA2B,CAAC;AAGjE,eAAO,MAAM,yBAAyB,EAAG,sBAA+B,CAAC"}

package/dist/esm/genai/semconv.js

@@ -0,0 +1,43 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+/**
+ * GenAI semantic conventions (incubating/unstable).
+ *
+ * Per OTel recommendation, unstable conventions are copied locally rather than
+ * imported from @opentelemetry/semantic-conventions/incubating.
+ * See: https://opentelemetry.io/docs/specs/semconv/non-normative/code-generation/#stability-and-versioning
+ *
+ * Sourced from OTel semantic conventions + microsoft/Agent365-nodejs.
+ */
+// --- Span operation names ---
+export const GEN_AI_OPERATION_INVOKE_AGENT = "invoke_agent";
+export const GEN_AI_OPERATION_EXECUTE_TOOL = "execute_tool";
+export const GEN_AI_OPERATION_OUTPUT_MESSAGES = "output_messages";
+export const GEN_AI_OPERATION_CHAT = "chat";
+// --- Attributes (ATTR_ prefix, following OTel convention) ---
+// Error
+export const ATTR_ERROR_TYPE = "error.type";
+export const ATTR_ERROR_MESSAGE = "error.message";
+// GenAI core
+export const ATTR_GEN_AI_OPERATION_NAME = "gen_ai.operation.name";
+export const ATTR_GEN_AI_REQUEST_MODEL = "gen_ai.request.model";
+export const ATTR_GEN_AI_RESPONSE_MODEL = "gen_ai.response.model";
+export const ATTR_GEN_AI_PROVIDER_NAME = "gen_ai.provider.name";
+export const ATTR_GEN_AI_SYSTEM_INSTRUCTIONS = "gen_ai.system_instructions";
+export const ATTR_GEN_AI_INPUT_MESSAGES = "gen_ai.input.messages";
+export const ATTR_GEN_AI_OUTPUT_MESSAGES = "gen_ai.output.messages";
+// GenAI usage
+export const ATTR_GEN_AI_USAGE_INPUT_TOKENS = "gen_ai.usage.input_tokens";
+export const ATTR_GEN_AI_USAGE_OUTPUT_TOKENS = "gen_ai.usage.output_tokens";
+// GenAI agent
+export const ATTR_GEN_AI_AGENT_ID = "gen_ai.agent.id";
+export const ATTR_GEN_AI_AGENT_NAME = "gen_ai.agent.name";
+// GenAI tool
+export const ATTR_GEN_AI_TOOL_CALL_ID = "gen_ai.tool.call.id";
+export const ATTR_GEN_AI_TOOL_NAME = "gen_ai.tool.name";
+export const ATTR_GEN_AI_TOOL_CALL_ARGUMENTS = "gen_ai.tool.call.arguments";
+export const ATTR_GEN_AI_TOOL_CALL_RESULT = "gen_ai.tool.call.result";
+export const ATTR_GEN_AI_TOOL_TYPE = "gen_ai.tool.type";
+// Microsoft-specific (not in OTel semconv)
+export const ATTR_MICROSOFT_SESSION_ID = "microsoft.session.id";
+//# sourceMappingURL=semconv.js.map

package/dist/esm/genai/semconv.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"semconv.js","sourceRoot":"","sources":["../../../src/genai/semconv.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,kCAAkC;AAElC;;;;;;;;GAQG;AAEH,+BAA+B;AAC/B,MAAM,CAAC,MAAM,6BAA6B,GAAG,cAAuB,CAAC;AACrE,MAAM,CAAC,MAAM,6BAA6B,GAAG,cAAuB,CAAC;AACrE,MAAM,CAAC,MAAM,gCAAgC,GAAG,iBAA0B,CAAC;AAC3E,MAAM,CAAC,MAAM,qBAAqB,GAAG,MAAe,CAAC;AAErD,+DAA+D;AAE/D,QAAQ;AACR,MAAM,CAAC,MAAM,eAAe,GAAG,YAAqB,CAAC;AACrD,MAAM,CAAC,MAAM,kBAAkB,GAAG,eAAwB,CAAC;AAE3D,aAAa;AACb,MAAM,CAAC,MAAM,0BAA0B,GAAG,uBAAgC,CAAC;AAC3E,MAAM,CAAC,MAAM,yBAAyB,GAAG,sBAA+B,CAAC;AACzE,MAAM,CAAC,MAAM,0BAA0B,GAAG,uBAAgC,CAAC;AAC3E,MAAM,CAAC,MAAM,yBAAyB,GAAG,sBAA+B,CAAC;AACzE,MAAM,CAAC,MAAM,+BAA+B,GAAG,4BAAqC,CAAC;AACrF,MAAM,CAAC,MAAM,0BAA0B,GAAG,uBAAgC,CAAC;AAC3E,MAAM,CAAC,MAAM,2BAA2B,GAAG,wBAAiC,CAAC;AAE7E,cAAc;AACd,MAAM,CAAC,MAAM,8BAA8B,GAAG,2BAAoC,CAAC;AACnF,MAAM,CAAC,MAAM,+BAA+B,GAAG,4BAAqC,CAAC;AAErF,cAAc;AACd,MAAM,CAAC,MAAM,oBAAoB,GAAG,iBAA0B,CAAC;AAC/D,MAAM,CAAC,MAAM,sBAAsB,GAAG,mBAA4B,CAAC;AAEnE,aAAa;AACb,MAAM,CAAC,MAAM,wBAAwB,GAAG,qBAA8B,CAAC;AACvE,MAAM,CAAC,MAAM,qBAAqB,GAAG,kBAA2B,CAAC;AACjE,MAAM,CAAC,MAAM,+BAA+B,GAAG,4BAAqC,CAAC;AACrF,MAAM,CAAC,MAAM,4BAA4B,GAAG,yBAAkC,CAAC;AAC/E,MAAM,CAAC,MAAM,qBAAqB,GAAG,kBAA2B,CAAC;AAEjE,2CAA2C;AAC3C,MAAM,CAAC,MAAM,yBAAyB,GAAG,sBAA+B,CAAC"}

package/dist/esm/genai/utils.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Maximum length for span attribute values.
+ * Values exceeding this limit will be truncated with a suffix.
+ */
+export declare const MAX_ATTRIBUTE_LENGTH = 8192;
+/**
+ * Truncate a string value to {@link MAX_ATTRIBUTE_LENGTH} characters.
+ * If the value exceeds the limit, it is trimmed and a truncation suffix is appended.
+ * @param value The string to truncate
+ * @returns The original string if within limits, otherwise the truncated string
+ */
+export declare function truncateValue(value: string): string;
+//# sourceMappingURL=utils.d.ts.map

package/dist/esm/genai/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/genai/utils.ts"],"names":[],"mappings":"AAkBA;;;GAGG;AACH,eAAO,MAAM,oBAAoB,OAAQ,CAAC;AAI1C;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAKnD"}