@langfuse/core 5.9.1 → 5.10.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -1,23 +1,40 @@
1
- ![GitHub Banner](https://github.com/langfuse/langfuse-js/assets/2834609/d1613347-445f-4e91-9e84-428fda9c3659)
1
+ ![GitHub Banner](https://github.com/user-attachments/assets/5810ae13-15d6-4b60-afd2-927adc501861)
2
2
 
3
3
  # @langfuse/core
4
4
 
5
- This is the core package of the Langfuse JS SDK containing the public API client, logger, utilities, and more.
5
+ [Langfuse](https://langfuse.com) is the open-source LLM engineering platform: tracing & evaluation for AI and agent applications, prompt management, datasets & experiments, and evaluation (scores). This is the **shared core package** of the Langfuse JS SDK: the generated REST API client (`LangfuseAPIClient`), logger, environment-variable handling, media types, and the `propagateAttributes` context propagation utilities. Use [`@langfuse/tracing`](https://www.npmjs.com/package/@langfuse/tracing) + [`@langfuse/otel`](https://www.npmjs.com/package/@langfuse/otel) for tracing and [`@langfuse/client`](https://www.npmjs.com/package/@langfuse/client) for prompt management, datasets/experiments, and scores.
6
+
7
+ > [!IMPORTANT]
8
+ > This is the current SDK generation (`@langfuse/*` scoped packages). The unscoped `langfuse-core` npm package belongs to the legacy v3 SDK. Migration guides: [v3 → v4](https://langfuse.com/docs/observability/sdk/upgrade-path/js-v3-to-v4), [v4 → v5](https://langfuse.com/docs/observability/sdk/upgrade-path/js-v4-to-v5).
9
+
10
+ ## Environment variables
11
+
12
+ Configuration shared across all `@langfuse/*` packages:
13
+
14
+ ```bash
15
+ LANGFUSE_PUBLIC_KEY="pk-lf-..."
16
+ LANGFUSE_SECRET_KEY="sk-lf-..."
17
+ LANGFUSE_BASE_URL="https://cloud.langfuse.com" # 🇪🇺 EU region. 🇺🇸 US: https://us.cloud.langfuse.com, 🇯🇵 Japan: https://jp.cloud.langfuse.com, ⚕️ HIPAA: https://hipaa.cloud.langfuse.com
18
+ ```
6
19
 
7
20
  ## Packages
8
21
 
9
- | Package | NPM | Description | Environments |
10
- | ------------------------------------------- | ----------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------- | ------------ |
11
- | [@langfuse/client](./packages/client) | [![NPM](https://img.shields.io/npm/v/@langfuse/client.svg)](https://www.npmjs.com/package/@langfuse/client) | Langfuse API client for universal JavaScript environments | Universal JS |
12
- | [@langfuse/tracing](./packages/tracing) | [![NPM](https://img.shields.io/npm/v/@langfuse/tracing.svg)](https://www.npmjs.com/package/@langfuse/tracing) | Langfuse instrumentation methods based on OpenTelemetry | Node.js 20+ |
13
- | [@langfuse/otel](./packages/otel) | [![NPM](https://img.shields.io/npm/v/@langfuse/otel.svg)](https://www.npmjs.com/package/@langfuse/otel) | Langfuse OpenTelemetry export helpers | Node.js 20+ |
14
- | [@langfuse/openai](./packages/openai) | [![NPM](https://img.shields.io/npm/v/@langfuse/openai.svg)](https://www.npmjs.com/package/@langfuse/openai) | Langfuse integration for OpenAI SDK | Universal JS |
15
- | [@langfuse/langchain](./packages/langchain) | [![NPM](https://img.shields.io/npm/v/@langfuse/langchain.svg)](https://www.npmjs.com/package/@langfuse/langchain) | Langfuse integration for LangChain | Universal JS |
22
+ | Package | NPM | Description | Environments |
23
+ | --------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------- | ------------ |
24
+ | [@langfuse/tracing](https://github.com/langfuse/langfuse-js/tree/main/packages/tracing) | [![NPM](https://img.shields.io/npm/v/@langfuse/tracing.svg)](https://www.npmjs.com/package/@langfuse/tracing) | OpenTelemetry-based tracing instrumentation | Node.js 20+ |
25
+ | [@langfuse/otel](https://github.com/langfuse/langfuse-js/tree/main/packages/otel) | [![NPM](https://img.shields.io/npm/v/@langfuse/otel.svg)](https://www.npmjs.com/package/@langfuse/otel) | `LangfuseSpanProcessor` to export OpenTelemetry spans to Langfuse | Node.js 20+ |
26
+ | [@langfuse/client](https://github.com/langfuse/langfuse-js/tree/main/packages/client) | [![NPM](https://img.shields.io/npm/v/@langfuse/client.svg)](https://www.npmjs.com/package/@langfuse/client) | Prompt management, datasets, experiments, scores, full REST API | Universal JS |
27
+ | [@langfuse/openai](https://github.com/langfuse/langfuse-js/tree/main/packages/openai) | [![NPM](https://img.shields.io/npm/v/@langfuse/openai.svg)](https://www.npmjs.com/package/@langfuse/openai) | `observeOpenAI` wrapper for tracing the OpenAI SDK | Universal JS |
28
+ | [@langfuse/langchain](https://github.com/langfuse/langfuse-js/tree/main/packages/langchain) | [![NPM](https://img.shields.io/npm/v/@langfuse/langchain.svg)](https://www.npmjs.com/package/@langfuse/langchain) | `CallbackHandler` for LangChain / LangGraph tracing | Universal JS |
29
+ | [@langfuse/vercel-ai-sdk](https://github.com/langfuse/langfuse-js/tree/main/packages/vercel-ai-sdk) | [![NPM](https://img.shields.io/npm/v/@langfuse/vercel-ai-sdk.svg)](https://www.npmjs.com/package/@langfuse/vercel-ai-sdk) | Telemetry integration for Vercel AI SDK v7 | Universal JS |
30
+ | [@langfuse/browser](https://github.com/langfuse/langfuse-js/tree/main/packages/browser) | [![NPM](https://img.shields.io/npm/v/@langfuse/browser.svg)](https://www.npmjs.com/package/@langfuse/browser) | Browser score ingestion with public-key auth | Browser |
31
+ | [@langfuse/core](https://github.com/langfuse/langfuse-js/tree/main/packages/core) | [![NPM](https://img.shields.io/npm/v/@langfuse/core.svg)](https://www.npmjs.com/package/@langfuse/core) | Shared core: generated API client, logger, utilities | Universal JS |
16
32
 
17
33
  ## Documentation
18
34
 
19
- - Docs: https://langfuse.com/docs/sdk/typescript
35
+ - Docs: https://langfuse.com/docs/observability/sdk/overview
20
36
  - Reference: https://js.reference.langfuse.com
37
+ - LLM/agent-readable docs index: https://langfuse.com/llms.txt
21
38
 
22
39
  ## License
23
40