@linnify/agentlens-langchain 0.0.0-stage → 0.3.1

package/LICENSE

@@ -0,0 +1,18 @@
+Copyright (c) 2026 Linnify. All rights reserved.
+
+This software and its documentation are proprietary to Linnify and are not
+open source. Linnify grants you a limited, non-exclusive, non-transferable,
+revocable license to install and use this software, unmodified, solely to
+send data from your applications to the AgentLens service, subject to your
+agreement with Linnify governing your use of AgentLens.
+
+You may not copy, modify, distribute, sublicense, sell, reverse engineer, or
+create derivative works of this software, or use it for any other purpose,
+except as expressly permitted by Linnify in writing or by applicable law.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
+LINNIFY BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN
+ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/README.md

@@ -1,3 +1,77 @@
-# Temporary Holding Version
+# @linnify/agentlens-langchain
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+AgentLens callback handler for [LangChain](https://js.langchain.com) and [LangGraph](https://langchain-ai.github.io/langgraphjs/): every run becomes a trace in AgentLens via `@linnify/agentlens-otel`, and `handler.client` sends scores (👍/👎 and other feedback) via `@linnify/agentlens-client`.
+
+```bash
+npm install @linnify/agentlens-langchain
+```
+
+It works with `@langchain/core` 1.x: `createAgent` agents (from `langchain`), LangGraph `StateGraph`s, and plain models, chains, tools and retrievers. `createAgent` compiles to a LangGraph graph, so both are traced the same way.
+
+## Usage
+
+Create one handler per agent and pass it in the `callbacks` of each run. Per-run values travel in the run's `metadata`.
+
+```ts
+import { AgentLensCallbackHandler } from '@linnify/agentlens-langchain';
+
+// Reads AGENTLENS_API_KEY (and AGENTLENS_BASE_URL, if set) when not passed.
+export const agentLens = new AgentLensCallbackHandler({ agent: 'support_bot' });
+
+await agent.invoke(
+  { messages: [{ role: 'user', content: 'Where is my order?' }] },
+  {
+    callbacks: [agentLens],
+    configurable: { thread_id: conversationId }, // becomes the trace's session
+    metadata: { tenant: 'acme', userId: 'user-42' }
+  }
+);
+```
+
+| Option | Run metadata | What it sets |
+|---|---|---|
+| `agent` | `agentlensAgent` | The AgentLens agent of the trace (lowercase letters, digits and underscores). Required, in one of the two. |
+| `tenant` | `tenant` | The trace's tenant, to filter traces and usage per tenant. |
+| `sessionId` | `sessionId`, else `thread_id` | The trace's session. LangGraph copies `configurable.thread_id` into the metadata, so a conversation's turns share a session. |
+| `userId` | `userId` | The trace's user. |
+| `environment` | `environment` | The trace's environment; defaults to `AGENTLENS_ENVIRONMENT`. |
+| `apiKey`, `baseUrl` | | Default to `AGENTLENS_API_KEY` and `AGENTLENS_BASE_URL` (production when unset). |
+| `mask` | | A function applied to every input, output and metadata value before it is sent, e.g. to redact secrets in graph state. |
+| `serviceName` | | The `service.name` resource of the spans (default `langchain`). |
+
+Run metadata wins over the handler's options. Spans without an agent are dropped with a logged error.
+
+## What gets traced
+
+- The root run is the trace. It is sent as it ran, and AgentLens reads the trace's input and output from it, trimmed to the turn: a chat app that resends the history each call shows only its last user messages, and a graph with a checkpointer, which returns every message of the thread, shows only what this run added. A compiled graph (`createAgent` or `StateGraph`) is an **agent** observation, each graph node a **span**, each model call a **generation** (model, parameters, token usage including cached and reasoning tokens, finish reason, available tools) and each tool call a **tool** (with its tool call id).
+- LangGraph's own plumbing (`__start__`, channel writes, conditional-edge routers) is left out; its children attach to the nearest traced run.
+- LangChain messages are sent as `{ role, content, tool_calls, tool_call_id }`, which AgentLens renders as a conversation. Other state is sent as plain JSON; class instances such as tools are named, not dumped.
+- A LangGraph interrupt or `Command` is not an error. Runs still open when their trace ends (an aborted stream) are closed with an error.
+- The handler never registers a global OpenTelemetry provider, so it runs next to other tracing (Langfuse, LangSmith, your own OTel setup).
+
+## Feedback
+
+The trace id is the root run's id without dashes. Pass your own `runId` to know it before the run ends, or read `handler.lastTraceId` after it when runs don't overlap:
+
+```ts
+import { randomUUID } from 'node:crypto';
+import { traceIdFromRunId } from '@linnify/agentlens-langchain';
+
+const runId = randomUUID();
+await agent.invoke(input, { runId, callbacks: [agentLens] });
+
+agentLens.client?.score.create({ traceId: traceIdFromRunId(runId), name: 'User Feedback', value: true });
+```
+
+For a trace sent to another agent with `agentlensAgent`, pass the same `agent` to `score.create()`.
+
+## Short-lived processes
+
+Spans are batched. In scripts, serverless functions and tests, wait for LangChain's background callbacks and flush before exiting:
+
+```ts
+import { awaitAllCallbacks } from '@langchain/core/callbacks/promises';
+
+await awaitAllCallbacks();
+await agentLens.shutdown(); // or flush() to keep using it
+```

package/dist/handler.d.ts

@@ -0,0 +1,53 @@
+import { BaseCallbackHandler } from '@langchain/core/callbacks/base';
+import type { DocumentInterface } from '@langchain/core/documents';
+import { type BaseMessage } from '@langchain/core/messages';
+import type { LLMResult } from '@langchain/core/outputs';
+import type { Serialized } from '@langchain/core/load/serializable';
+import type { ChainValues } from '@langchain/core/utils/types';
+import { AgentLensClient } from '@linnify/agentlens-client';
+export interface AgentLensCallbackHandlerParams {
+    apiKey?: string;
+    /** The AgentLens agent the traces belong to; `agentlensAgent` run metadata overrides it per trace. */
+    agent?: string;
+    baseUrl?: string;
+    flushAt?: number;
+    /** In seconds. */
+    flushInterval?: number;
+    environment?: string;
+    /** Defaults for every trace; `tenant`, `sessionId` and `userId` run metadata override them. */
+    tenant?: string;
+    sessionId?: string;
+    userId?: string;
+    /** Runs on every input, output and metadata value before it leaves the process, e.g. to redact secrets. */
+    mask?: (value: unknown) => unknown;
+    serviceName?: string;
+}
+/** The id AgentLens gives the trace a root run starts, so feedback can be sent for it with `client.score.create()`. */
+export declare const traceIdFromRunId: (runId: string) => string;
+export declare class AgentLensCallbackHandler extends BaseCallbackHandler {
+    #private;
+    name: string;
+    /** The trace id of the last root run that ended; read it right after `invoke()` when runs don't overlap. */
+    lastTraceId: string | null;
+    constructor(params?: AgentLensCallbackHandlerParams);
+    /** Sends scores, e.g. end-user feedback, for the traces this handler records. */
+    get client(): AgentLensClient | undefined;
+    copy(): this;
+    handleChainStart(chain: Serialized, inputs: ChainValues, runId: string, parentRunId?: string, tags?: string[], metadata?: Record<string, unknown>, _runType?: string, runName?: string): void;
+    handleChainEnd(outputs: ChainValues, runId: string): void;
+    handleChainError(error: unknown, runId: string): void;
+    handleChatModelStart(llm: Serialized, messages: BaseMessage[][], runId: string, parentRunId?: string, extraParams?: Record<string, unknown>, tags?: string[], metadata?: Record<string, unknown>, runName?: string): void;
+    handleLLMStart(llm: Serialized, prompts: string[], runId: string, parentRunId?: string, extraParams?: Record<string, unknown>, tags?: string[], metadata?: Record<string, unknown>, runName?: string): void;
+    handleLLMNewToken(_token: string, _idx: unknown, runId: string): void;
+    handleChatModelStreamEvent(_event: unknown, runId: string): void;
+    handleLLMEnd(output: LLMResult, runId: string): void;
+    handleLLMError(error: unknown, runId: string): void;
+    handleToolStart(tool: Serialized, input: string, runId: string, parentRunId?: string, tags?: string[], metadata?: Record<string, unknown>, runName?: string, toolCallId?: string): void;
+    handleToolEnd(output: unknown, runId: string): void;
+    handleToolError(error: unknown, runId: string): void;
+    handleRetrieverStart(retriever: Serialized, query: string, runId: string, parentRunId?: string, tags?: string[], metadata?: Record<string, unknown>, name?: string): void;
+    handleRetrieverEnd(documents: DocumentInterface[], runId: string): void;
+    handleRetrieverError(error: unknown, runId: string): void;
+    flush(): Promise<void>;
+    shutdown(): Promise<void>;
+}

package/dist/handler.js

@@ -0,0 +1,303 @@
+import { randomBytes } from 'node:crypto';
+import { BaseCallbackHandler } from '@langchain/core/callbacks/base';
+import { isBaseMessage } from '@langchain/core/messages';
+import { AgentLensClient } from '@linnify/agentlens-client';
+import { AgentLensSpanProcessor } from '@linnify/agentlens-otel';
+import { resourceFromAttributes } from '@opentelemetry/resources';
+import { finishReason, generationOutput, modelParameters, responseModel, toChatMessage, toolNames, toSerializable, usageFrom } from './serialize.js';
+import { toReadableSpan } from './span.js';
+const SCOPE_NAME = '@linnify/agentlens-langchain';
+const HIDDEN_TAG = 'langsmith:hidden';
+const GRAPH_CLASSES = new Set(['CompiledStateGraph', 'CompiledGraph', 'Pregel']);
+const MAX_OPEN_RUNS = 10_000;
+const text = (value) => typeof value === 'string' && value ? value : undefined;
+const hex = (runId) => runId.replace(/-/g, '').toLowerCase();
+/** The id AgentLens gives the trace a root run starts, so feedback can be sent for it with `client.score.create()`. */
+export const traceIdFromRunId = (runId) => {
+    const id = hex(runId);
+    return /^[0-9a-f]{32}$/.test(id) ? id : randomBytes(16).toString('hex');
+};
+// Run ids are UUIDv7: the leading digits are a timestamp shared by runs started together,
+// so the span id takes the random tail.
+const spanIdFromRunId = (runId) => {
+    const id = hex(runId);
+    return /^[0-9a-f]{32}$/.test(id) ? id.slice(16) : randomBytes(8).toString('hex');
+};
+const isBubbleUp = (error) => typeof error === 'object' && error !== null && error.is_bubble_up === true;
+const isGraph = (serialized) => {
+    const name = serialized?.id?.at(-1);
+    return name !== undefined && GRAPH_CLASSES.has(name);
+};
+const parseJson = (value) => {
+    try {
+        return JSON.parse(value);
+    }
+    catch {
+        return value;
+    }
+};
+export class AgentLensCallbackHandler extends BaseCallbackHandler {
+    name = 'AgentLensCallbackHandler';
+    /** The trace id of the last root run that ended; read it right after `invoke()` when runs don't overlap. */
+    lastTraceId = null;
+    #processor;
+    #client;
+    #resource;
+    #mask;
+    #defaults;
+    #runs = new Map();
+    // A hidden run (LangGraph plumbing) is not traced: its children attach to its nearest traced ancestor.
+    #hidden = new Map();
+    constructor(params = {}) {
+        super();
+        this.#mask = params.mask ?? ((value) => value);
+        this.#resource = resourceFromAttributes({ 'service.name': params.serviceName ?? 'langchain' });
+        this.#defaults = {
+            agent: params.agent,
+            tenant: params.tenant,
+            sessionId: params.sessionId,
+            userId: params.userId,
+            environment: params.environment ?? process.env.AGENTLENS_ENVIRONMENT
+        };
+        const apiKey = params.apiKey ?? process.env.AGENTLENS_API_KEY;
+        if (!apiKey) {
+            console.warn('[AgentLens] Missing API key; traces will not be sent. Set AGENTLENS_API_KEY.');
+            return;
+        }
+        const { baseUrl, flushAt, flushInterval } = params;
+        this.#processor = new AgentLensSpanProcessor({ apiKey, baseUrl, flushAt, flushInterval });
+        this.#client = new AgentLensClient({ apiKey, agent: params.agent, baseUrl, flushAt, flushInterval });
+    }
+    /** Sends scores, e.g. end-user feedback, for the traces this handler records. */
+    get client() {
+        return this.#client;
+    }
+    // LangChain copies handlers in a few code paths; the open runs must stay in one place.
+    copy() {
+        return this;
+    }
+    // LangChain calls `handleChainStart(chain, inputs, runId, parentRunId, tags, metadata, runType, runName)`,
+    // whatever order its type declaration lists them in.
+    handleChainStart(chain, inputs, runId, parentRunId, tags, metadata, _runType, runName) {
+        this.#safely(() => {
+            const name = runName ?? chain?.id?.at(-1) ?? 'chain';
+            // LangGraph tags its own plumbing (`__start__`, channel writes) as hidden, and a conditional
+            // edge runs as an unnamed lambda inside the node it leaves.
+            if (tags?.includes(HIDDEN_TAG) || (name === 'RunnableLambda' && metadata?.langgraph_node !== undefined)) {
+                this.#hidden.set(runId, this.#tracedParent(parentRunId));
+                return;
+            }
+            this.#start(runId, parentRunId, {
+                name,
+                type: isGraph(chain) ? 'agent' : 'span',
+                input: toSerializable(inputs),
+                tags,
+                metadata
+            });
+        });
+    }
+    handleChainEnd(outputs, runId) {
+        this.#safely(() => this.#end(runId, { output: toSerializable(outputs) }));
+    }
+    handleChainError(error, runId) {
+        this.#safely(() => this.#fail(runId, error));
+    }
+    handleChatModelStart(llm, messages, runId, parentRunId, extraParams, tags, metadata, runName) {
+        this.#safely(() => {
+            const prompts = messages.map((batch) => batch.map(toChatMessage));
+            this.#startGeneration(runId, parentRunId, llm, runName, prompts.length === 1 ? prompts[0] : prompts, {
+                extraParams,
+                tags,
+                metadata
+            });
+        });
+    }
+    handleLLMStart(llm, prompts, runId, parentRunId, extraParams, tags, metadata, runName) {
+        this.#safely(() => {
+            this.#startGeneration(runId, parentRunId, llm, runName, prompts.length === 1 ? prompts[0] : prompts, {
+                extraParams,
+                tags,
+                metadata
+            });
+        });
+    }
+    handleLLMNewToken(_token, _idx, runId) {
+        this.#recordCompletionStart(runId);
+    }
+    handleChatModelStreamEvent(_event, runId) {
+        this.#recordCompletionStart(runId);
+    }
+    handleLLMEnd(output, runId) {
+        this.#safely(() => {
+            const run = this.#runs.get(runId);
+            if (run) {
+                run.attributes.finishReason = finishReason(output);
+                if (run.completionStartTime) {
+                    run.attributes.completionStartTime = new Date(run.completionStartTime).toISOString();
+                }
+            }
+            this.#end(runId, { output: generationOutput(output), model: responseModel(output), usage: usageFrom(output) });
+        });
+    }
+    handleLLMError(error, runId) {
+        this.#safely(() => this.#fail(runId, error));
+    }
+    handleToolStart(tool, input, runId, parentRunId, tags, metadata, runName, toolCallId) {
+        this.#safely(() => {
+            const name = runName ?? tool?.id?.at(-1) ?? 'tool';
+            this.#start(runId, parentRunId, {
+                name,
+                type: 'tool',
+                input: parseJson(input),
+                tags,
+                metadata,
+                attributes: { toolName: name, toolCallId }
+            });
+        });
+    }
+    handleToolEnd(output, runId) {
+        this.#safely(() => {
+            const content = isBaseMessage(output) ? output.content : output;
+            this.#end(runId, { output: toSerializable(typeof content === 'string' ? parseJson(content) : content) });
+        });
+    }
+    handleToolError(error, runId) {
+        this.#safely(() => this.#fail(runId, error));
+    }
+    handleRetrieverStart(retriever, query, runId, parentRunId, tags, metadata, name) {
+        this.#safely(() => {
+            this.#start(runId, parentRunId, {
+                name: name ?? retriever?.id?.at(-1) ?? 'retriever',
+                type: 'span',
+                input: query,
+                tags,
+                metadata
+            });
+        });
+    }
+    handleRetrieverEnd(documents, runId) {
+        this.#safely(() => {
+            const output = documents.map(({ pageContent, metadata }) => ({ pageContent, metadata }));
+            this.#end(runId, { output: toSerializable(output) });
+        });
+    }
+    handleRetrieverError(error, runId) {
+        this.#safely(() => this.#fail(runId, error));
+    }
+    async flush() {
+        await Promise.all([this.#processor?.forceFlush(), this.#client?.flush()]);
+    }
+    async shutdown() {
+        await Promise.all([this.#processor?.shutdown(), this.#client?.shutdown()]);
+    }
+    #startGeneration(runId, parentRunId, llm, runName, input, { extraParams, tags, metadata }) {
+        const invocationParams = extraParams?.invocation_params;
+        this.#start(runId, parentRunId, {
+            name: runName ?? llm?.id?.at(-1) ?? 'llm',
+            type: 'generation',
+            input,
+            tags,
+            metadata,
+            model: text(invocationParams?.model) ?? text(invocationParams?.model_name) ?? text(metadata?.ls_model_name),
+            modelParameters: modelParameters(invocationParams),
+            attributes: { provider: text(metadata?.ls_provider), availableTools: toolNames(invocationParams) }
+        });
+    }
+    #start(runId, parentRunId, run) {
+        const parent = this.#runs.get(this.#tracedParent(parentRunId) ?? '');
+        const trace = parent?.trace ?? this.#trace(runId, run.metadata);
+        this.#evictOldest();
+        this.#runs.set(runId, {
+            trace,
+            spanId: spanIdFromRunId(runId),
+            parentSpanId: parent?.spanId,
+            name: run.name,
+            type: run.type,
+            startTime: Date.now(),
+            input: run.input,
+            model: run.model,
+            modelParameters: run.modelParameters,
+            metadata: {
+                ...toSerializable(run.metadata ?? {}),
+                ...(run.tags?.length ? { tags: run.tags } : {})
+            },
+            attributes: Object.fromEntries(Object.entries(run.attributes ?? {}).filter(([, value]) => value !== undefined))
+        });
+    }
+    #trace(runId, metadata) {
+        return {
+            traceId: traceIdFromRunId(runId),
+            agent: text(metadata?.agentlensAgent) ?? this.#defaults.agent,
+            tenant: text(metadata?.tenant) ?? this.#defaults.tenant,
+            // LangGraph copies `configurable.thread_id` into the run metadata.
+            sessionId: text(metadata?.sessionId) ?? text(metadata?.thread_id) ?? this.#defaults.sessionId,
+            userId: text(metadata?.userId) ?? this.#defaults.userId,
+            environment: this.#defaults.environment ?? text(metadata?.environment)
+        };
+    }
+    #tracedParent(parentRunId) {
+        if (!parentRunId)
+            return undefined;
+        if (this.#runs.has(parentRunId))
+            return parentRunId;
+        return this.#hidden.get(parentRunId);
+    }
+    #recordCompletionStart(runId) {
+        const run = this.#runs.get(runId);
+        if (run && !run.completionStartTime)
+            run.completionStartTime = Date.now();
+    }
+    #fail(runId, error) {
+        // A LangGraph interrupt or `Command` travels as an error, but the run didn't fail.
+        if (isBubbleUp(error)) {
+            const run = this.#runs.get(runId);
+            if (run)
+                run.attributes.interrupted = true;
+            this.#end(runId, {});
+            return;
+        }
+        this.#end(runId, { error: error instanceof Error ? `${error.name}: ${error.message}` : String(error) });
+    }
+    #end(runId, end) {
+        if (this.#hidden.delete(runId))
+            return;
+        const run = this.#runs.get(runId);
+        if (!run)
+            return;
+        this.#runs.delete(runId);
+        this.#export(run, end);
+        if (run.parentSpanId)
+            return;
+        this.lastTraceId = run.trace.traceId;
+        // An aborted stream can leave runs that never end; they close with their trace.
+        for (const [openId, open] of this.#runs) {
+            if (open.trace !== run.trace)
+                continue;
+            this.#runs.delete(openId);
+            this.#export(open, { error: 'The run had not ended when its trace ended' });
+        }
+    }
+    #export(run, end) {
+        if (!this.#processor)
+            return;
+        const attributes = Object.fromEntries(Object.entries(run.attributes).filter(([, value]) => value !== undefined));
+        const metadata = Object.keys(attributes).length > 0 ? { ...run.metadata, attributes } : run.metadata;
+        this.#processor.onEnd(toReadableSpan({ ...run, metadata }, end, { resource: this.#resource, scopeName: SCOPE_NAME, mask: this.#mask }));
+    }
+    #evictOldest() {
+        if (this.#runs.size < MAX_OPEN_RUNS)
+            return;
+        const oldest = this.#runs.keys().next().value;
+        if (oldest)
+            this.#runs.delete(oldest);
+    }
+    #safely(fn) {
+        try {
+            fn();
+        }
+        catch (error) {
+            console.error('[AgentLens] Failed to record a LangChain run:', error);
+        }
+    }
+}
+//# sourceMappingURL=handler.js.map

package/dist/handler.js.map

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

package/dist/index.d.ts

@@ -0,0 +1 @@
+export { AgentLensCallbackHandler, traceIdFromRunId, type AgentLensCallbackHandlerParams } from './handler.js';

package/dist/index.js

@@ -0,0 +1,2 @@
+export { AgentLensCallbackHandler, traceIdFromRunId } from './handler.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,wBAAwB,EACxB,gBAAgB,EAEjB,MAAM,cAAc,CAAC"}

package/dist/serialize.d.ts

@@ -0,0 +1,37 @@
+import { type BaseMessage } from '@langchain/core/messages';
+import type { LLMResult } from '@langchain/core/outputs';
+export interface ChatMessage {
+    role: string;
+    content: unknown;
+    name?: string;
+    tool_calls?: {
+        id?: string;
+        name: string;
+        args: unknown;
+    }[];
+    tool_call_id?: string;
+}
+export declare const toChatMessage: (message: BaseMessage) => ChatMessage;
+/**
+ * LangGraph state holds class instances (messages, tools, clients) and can be circular, so it
+ * is turned into plain JSON before it is sent: messages become `{ role, content, tool_calls }`,
+ * which AgentLens renders as a conversation, and other LangChain objects are named, not dumped.
+ */
+export declare const toSerializable: (value: unknown, seen?: WeakSet<object>, depth?: number) => unknown;
+export interface Usage {
+    input?: number;
+    output?: number;
+    total?: number;
+    cache_read?: number;
+    cache_write?: number;
+    reasoning?: number;
+}
+export declare const lastMessage: (output: LLMResult) => BaseMessage | undefined;
+export declare const generationOutput: (output: LLMResult) => unknown;
+/** Chat models report `usage_metadata` on the message; older LLM integrations only `llmOutput.tokenUsage`. */
+export declare const usageFrom: (output: LLMResult) => Usage | undefined;
+export declare const responseModel: (output: LLMResult) => string | undefined;
+export declare const finishReason: (output: LLMResult) => string | undefined;
+/** Invocation params also carry the tool schemas and the full request; only the settings are kept. */
+export declare const modelParameters: (invocationParams: unknown) => Record<string, unknown> | undefined;
+export declare const toolNames: (invocationParams: unknown) => string[] | undefined;

package/dist/serialize.js

@@ -0,0 +1,145 @@
+import { isBaseMessage } from '@langchain/core/messages';
+const MAX_DEPTH = 20;
+const ROLES = {
+    human: 'user',
+    ai: 'assistant',
+    system: 'system',
+    tool: 'tool',
+    function: 'tool',
+    developer: 'system'
+};
+export const toChatMessage = (message) => {
+    const type = message.getType();
+    const role = ROLES[type] ?? (type === 'generic' && 'role' in message ? String(message.role) : type);
+    const toolCalls = 'tool_calls' in message && Array.isArray(message.tool_calls) && message.tool_calls.length > 0
+        ? message.tool_calls.map(({ id, name, args }) => ({ id, name, args }))
+        : undefined;
+    const toolCallId = 'tool_call_id' in message ? message.tool_call_id : undefined;
+    return {
+        role,
+        content: toSerializable(message.content),
+        ...(message.name ? { name: message.name } : {}),
+        ...(toolCalls ? { tool_calls: toolCalls } : {}),
+        ...(typeof toolCallId === 'string' ? { tool_call_id: toolCallId } : {})
+    };
+};
+const isLangChainSerializable = (value) => Array.isArray(value.lc_namespace);
+/**
+ * LangGraph state holds class instances (messages, tools, clients) and can be circular, so it
+ * is turned into plain JSON before it is sent: messages become `{ role, content, tool_calls }`,
+ * which AgentLens renders as a conversation, and other LangChain objects are named, not dumped.
+ */
+export const toSerializable = (value, seen = new WeakSet(), depth = 0) => {
+    if (value === null || value === undefined)
+        return value;
+    if (typeof value === 'bigint')
+        return value.toString();
+    if (typeof value === 'function' || typeof value === 'symbol')
+        return undefined;
+    if (typeof value !== 'object')
+        return value;
+    if (depth > MAX_DEPTH)
+        return '[MaxDepth]';
+    if (seen.has(value))
+        return '[Circular]';
+    if (isBaseMessage(value))
+        return toChatMessage(value);
+    if (value instanceof Date)
+        return value.toISOString();
+    if (value instanceof Error)
+        return { name: value.name, message: value.message };
+    seen.add(value);
+    try {
+        if (Array.isArray(value))
+            return value.map((item) => toSerializable(item, seen, depth + 1) ?? null);
+        if (value instanceof Map)
+            return toSerializable(Object.fromEntries(value), seen, depth + 1);
+        if (value instanceof Set)
+            return toSerializable([...value], seen, depth + 1);
+        if (isLangChainSerializable(value)) {
+            const name = typeof value.name === 'string' ? value.name : value.constructor.name;
+            return `[${value.lc_namespace.at(-1) ?? 'langchain'}: ${name}]`;
+        }
+        const entries = Object.entries(value).flatMap(([key, item]) => {
+            const serialized = toSerializable(item, seen, depth + 1);
+            return serialized === undefined ? [] : [[key, serialized]];
+        });
+        return Object.fromEntries(entries);
+    }
+    finally {
+        seen.delete(value);
+    }
+};
+const lastGeneration = (output) => output.generations.at(-1)?.at(-1);
+export const lastMessage = (output) => {
+    const generation = lastGeneration(output);
+    return generation && 'message' in generation && isBaseMessage(generation.message)
+        ? generation.message
+        : undefined;
+};
+export const generationOutput = (output) => {
+    const message = lastMessage(output);
+    if (message)
+        return toChatMessage(message);
+    return lastGeneration(output)?.text;
+};
+const withoutUndefined = (value) => Object.fromEntries(Object.entries(value).filter(([, item]) => item !== undefined));
+/** Chat models report `usage_metadata` on the message; older LLM integrations only `llmOutput.tokenUsage`. */
+export const usageFrom = (output) => {
+    const message = lastMessage(output);
+    const metadata = (message && 'usage_metadata' in message ? message.usage_metadata : undefined);
+    if (metadata) {
+        return withoutUndefined({
+            input: metadata.input_tokens,
+            output: metadata.output_tokens,
+            total: metadata.total_tokens,
+            cache_read: metadata.input_token_details?.cache_read,
+            cache_write: metadata.input_token_details?.cache_creation,
+            reasoning: metadata.output_token_details?.reasoning
+        });
+    }
+    const legacy = output.llmOutput?.tokenUsage;
+    if (!legacy)
+        return undefined;
+    return withoutUndefined({
+        input: legacy.promptTokens,
+        output: legacy.completionTokens,
+        total: legacy.totalTokens
+    });
+};
+const responseMetadata = (output) => lastMessage(output)?.response_metadata;
+export const responseModel = (output) => {
+    const metadata = responseMetadata(output);
+    const model = metadata?.model_name ?? metadata?.model;
+    return typeof model === 'string' && model ? model : undefined;
+};
+export const finishReason = (output) => {
+    const metadata = responseMetadata(output);
+    const reason = metadata?.finish_reason ?? metadata?.stop_reason;
+    return typeof reason === 'string' ? reason : undefined;
+};
+const PRIMITIVE_TYPES = new Set(['string', 'number', 'boolean']);
+/** Invocation params also carry the tool schemas and the full request; only the settings are kept. */
+export const modelParameters = (invocationParams) => {
+    if (!invocationParams || typeof invocationParams !== 'object')
+        return undefined;
+    const parameters = Object.fromEntries(Object.entries(invocationParams).filter(([key, value]) => PRIMITIVE_TYPES.has(typeof value) && !['model', 'model_name', 'modelName'].includes(key)));
+    return Object.keys(parameters).length > 0 ? parameters : undefined;
+};
+export const toolNames = (invocationParams) => {
+    const tools = invocationParams?.tools;
+    if (!Array.isArray(tools))
+        return undefined;
+    const names = tools.flatMap((tool) => {
+        if (!tool || typeof tool !== 'object')
+            return [];
+        const candidate = tool;
+        if (Array.isArray(candidate.functionDeclarations)) {
+            return candidate.functionDeclarations.flatMap((declaration) => typeof declaration.name === 'string' ? [declaration.name] : []);
+        }
+        const name = candidate.name ?? candidate.function?.name;
+        return typeof name === 'string' ? [name] : [];
+    });
+    return names.length > 0 ? names : undefined;
+};
+//# sourceMappingURL=serialize.js.map

package/dist/serialize.js.map

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

package/dist/span.d.ts

@@ -0,0 +1,35 @@
+import { type AgentLensObservationType } from '@linnify/agentlens-otel';
+import type { Resource } from '@opentelemetry/resources';
+import type { ReadableSpan } from '@opentelemetry/sdk-trace-base';
+export interface TraceContext {
+    traceId: string;
+    agent?: string;
+    sessionId?: string;
+    userId?: string;
+    tenant?: string;
+    environment?: string;
+}
+export interface Run {
+    trace: TraceContext;
+    spanId: string;
+    parentSpanId?: string;
+    name: string;
+    type: AgentLensObservationType;
+    startTime: number;
+    input?: unknown;
+    metadata: Record<string, unknown>;
+    model?: string;
+    modelParameters?: Record<string, unknown>;
+}
+export interface RunEnd {
+    output?: unknown;
+    error?: string;
+    model?: string;
+    usage?: object;
+    metadata?: Record<string, unknown>;
+}
+export declare const toReadableSpan: (run: Run, end: RunEnd, { resource, scopeName, mask }: {
+    resource: Resource;
+    scopeName: string;
+    mask: (value: unknown) => unknown;
+}) => ReadableSpan;

package/dist/span.js

@@ -0,0 +1,60 @@
+import { AGENTLENS_ATTRIBUTES } from '@linnify/agentlens-otel';
+import { SpanKind, SpanStatusCode, TraceFlags } from '@opentelemetry/api';
+const toHrTime = (ms) => [Math.floor(ms / 1000), (ms % 1000) * 1_000_000];
+const serialize = (value) => {
+    if (value === undefined)
+        return undefined;
+    if (typeof value === 'string')
+        return value;
+    try {
+        return JSON.stringify(value);
+    }
+    catch {
+        return undefined;
+    }
+};
+export const toReadableSpan = (run, end, { resource, scopeName, mask }) => {
+    const endTime = Date.now();
+    const { trace } = run;
+    const input = mask(run.input);
+    const output = mask(end.output);
+    // Session, user, tenant and environment ride on every span: a trace's spans can reach
+    // AgentLens in several batches, and the root is the last to end.
+    const attributes = {
+        [AGENTLENS_ATTRIBUTES.AGENT]: trace.agent,
+        [AGENTLENS_ATTRIBUTES.OBSERVATION_TYPE]: run.type,
+        [AGENTLENS_ATTRIBUTES.OBSERVATION_INPUT]: serialize(input),
+        [AGENTLENS_ATTRIBUTES.OBSERVATION_OUTPUT]: serialize(output),
+        [AGENTLENS_ATTRIBUTES.OBSERVATION_METADATA]: serialize(mask({ ...run.metadata, ...end.metadata })),
+        [AGENTLENS_ATTRIBUTES.OBSERVATION_MODEL]: end.model ?? run.model,
+        [AGENTLENS_ATTRIBUTES.OBSERVATION_MODEL_PARAMETERS]: serialize(run.modelParameters),
+        [AGENTLENS_ATTRIBUTES.OBSERVATION_USAGE]: serialize(end.usage),
+        [AGENTLENS_ATTRIBUTES.TRACE_SESSION_ID]: trace.sessionId,
+        [AGENTLENS_ATTRIBUTES.TRACE_USER_ID]: trace.userId,
+        [AGENTLENS_ATTRIBUTES.TRACE_TENANT]: trace.tenant,
+        [AGENTLENS_ATTRIBUTES.TRACE_ENVIRONMENT]: trace.environment
+    };
+    const durationMs = endTime - run.startTime;
+    return {
+        name: run.name,
+        kind: SpanKind.INTERNAL,
+        spanContext: () => ({ traceId: trace.traceId, spanId: run.spanId, traceFlags: TraceFlags.SAMPLED }),
+        parentSpanContext: run.parentSpanId
+            ? { traceId: trace.traceId, spanId: run.parentSpanId, traceFlags: TraceFlags.SAMPLED }
+            : undefined,
+        startTime: toHrTime(run.startTime),
+        endTime: toHrTime(endTime),
+        duration: toHrTime(durationMs),
+        status: end.error ? { code: SpanStatusCode.ERROR, message: end.error } : { code: SpanStatusCode.OK },
+        attributes: Object.fromEntries(Object.entries(attributes).filter(([, value]) => value !== undefined)),
+        links: [],
+        events: [],
+        ended: true,
+        resource,
+        instrumentationScope: { name: scopeName },
+        droppedAttributesCount: 0,
+        droppedEventsCount: 0,
+        droppedLinksCount: 0
+    };
+};
+//# sourceMappingURL=span.js.map

package/dist/span.js.map

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

package/package.json

@@ -1,6 +1,56 @@
 {
   "name": "@linnify/agentlens-langchain",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.3.1",
+  "description": "AgentLens callback handler for LangChain and LangGraph: traces and feedback",
+  "license": "SEE LICENSE IN LICENSE",
+  "author": "Linnify",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/linnify/agentlens-sdk.git",
+    "directory": "packages/langchain"
+  },
+  "keywords": [
+    "agentlens",
+    "observability",
+    "tracing",
+    "llm",
+    "opentelemetry",
+    "langchain",
+    "langgraph"
+  ],
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@opentelemetry/resources": "^2.10.0",
+    "@opentelemetry/sdk-trace-base": "^2.10.0",
+    "@linnify/agentlens-client": "^0.3.1",
+    "@linnify/agentlens-otel": "^0.3.1"
+  },
+  "peerDependencies": {
+    "@langchain/core": ">=1.0.0 <2.0.0",
+    "@opentelemetry/api": "^1.9.0"
+  },
+  "devDependencies": {
+    "@langchain/core": "^1.2.0",
+    "@opentelemetry/api": "^1.9.1"
+  },
+  "scripts": {
+    "build": "node -e \"require('node:fs').rmSync('dist',{recursive:true,force:true})\" && tsc",
+    "type-check": "tsc --noEmit",
+    "lint": "publint --strict && attw --pack --profile esm-only"
+  }
 }