Upgrading @langfuse/core from 5.x to 6.x

Comparison of the public API of @langfuse/core 5.14.0 and 6.0.0, computed automatically from their TypeScript types. A changed signature is a candidate for a breaking change, not a certainty.

Summary

Removed import paths	0
Removed exports	75
Changed signatures	1
Removed class or interface members	10
Changed class or interface members	1
Newly deprecated	4
Requirement changes (engines, peer dependencies)	1
New exports	8

Removed exports

import	export	kind	Before
`@langfuse/core`	`Sort`	interface	`interface`
`@langfuse/core`	`Trace`	interface	`interface`
`@langfuse/core`	`Traces`	interface	`interface`
`@langfuse/core`	`legacy`	namespace	`namespace`
`@langfuse/core`	`ScoreV1`	type	`Numeric \| Categorical \| Boolean \| Text`
`@langfuse/core`	`Session`	interface	`interface`
`@langfuse/core`	`scoresV3`	namespace	`namespace`
`@langfuse/core`	`sessions`	namespace	`namespace`
`@langfuse/core`	`BaseEvent`	interface	`interface`
`@langfuse/core`	`TraceBody`	interface	`interface`
`@langfuse/core`	`ingestion`	namespace	`namespace`
`@langfuse/core`	`DatasetRun`	interface	`interface`
`@langfuse/core`	`ScoreEvent`	interface	`interface`
`@langfuse/core`	`SdkLogBody`	interface	`interface`
`@langfuse/core`	`TraceEvent`	interface	`interface`
`@langfuse/core`	`BaseScoreV1`	interface	`interface`
`@langfuse/core`	`Observation`	interface	`interface`
`@langfuse/core`	`SdkLogEvent`	interface	`interface`
`@langfuse/core`	`TextScoreV1`	interface	`interface`
`@langfuse/core`	`UsageDetails`	type	`Record<string, number> \| OpenAiCompletionUsageSchema \| OpenAiResponseUsageSchema`
`@langfuse/core`	`BooleanScoreV1`	interface	`interface`
`@langfuse/core`	`CreateSpanBody`	interface	`interface`
`@langfuse/core`	`DatasetRunItem`	interface	`interface`
`@langfuse/core`	`IngestionError`	interface	`interface`
`@langfuse/core`	`IngestionEvent`	type	`TraceCreate \| ScoreCreate \| SpanCreate \| SpanUpdate \| GenerationCreate \| GenerationUpdate \| EventCreate \| SdkLog \| ObservationCreate \| ObservationUpdate`
`@langfuse/core`	`IngestionUsage`	type	`Usage \| OpenAiUsage`
`@langfuse/core`	`NumericScoreV1`	interface	`interface`
`@langfuse/core`	`UpdateSpanBody`	interface	`interface`
`@langfuse/core`	`CreateEventBody`	interface	`interface`
`@langfuse/core`	`CreateSpanEvent`	interface	`interface`
`@langfuse/core`	`GetTraceRequest`	interface	`interface`
`@langfuse/core`	`ObservationBody`	interface	`interface`
`@langfuse/core`	`ObservationType`	type	`"SPAN" \| "GENERATION" \| "EVENT" \| "AGENT" \| "TOOL" \| "CHAIN" \| "RETRIEVER" \| "EVALUATOR" \| "EMBEDDING" \| "GUARDRAIL"`
`@langfuse/core`	`UpdateEventBody`	interface	`interface`
`@langfuse/core`	`UpdateSpanEvent`	interface	`interface`
`@langfuse/core`	`datasetRunItems`	namespace	`namespace`
`@langfuse/core`	`CreateEventEvent`	interface	`interface`
`@langfuse/core`	`GetScoresRequest`	interface	`interface`
`@langfuse/core`	`GetTracesRequest`	interface	`interface`
`@langfuse/core`	`IngestionRequest`	interface	`interface`
`@langfuse/core`	`IngestionSuccess`	interface	`interface`
`@langfuse/core`	`ObservationsView`	interface	`interface`
`@langfuse/core`	`TraceWithDetails`	interface	`interface`
`@langfuse/core`	`GetScoresResponse`	interface	`interface`
`@langfuse/core`	`IngestionResponse`	interface	`interface`
`@langfuse/core`	`PaginatedSessions`	interface	`interface`
`@langfuse/core`	`SessionWithTraces`	interface	`interface`
`@langfuse/core`	`CategoricalScoreV1`	interface	`interface`
`@langfuse/core`	`GetSessionsRequest`	interface	`interface`
`@langfuse/core`	`CreateScoreResponse`	interface	`interface`
`@langfuse/core`	`DatasetRunWithItems`	interface	`interface`
`@langfuse/core`	`CreateGenerationBody`	interface	`interface`
`@langfuse/core`	`PaginatedDatasetRuns`	interface	`interface`
`@langfuse/core`	`TraceWithFullDetails`	interface	`interface`
`@langfuse/core`	`UpdateGenerationBody`	interface	`interface`
`@langfuse/core`	`CreateGenerationEvent`	interface	`interface`
`@langfuse/core`	`GetDatasetRunsRequest`	interface	`interface`
`@langfuse/core`	`GetScoresResponseData`	type	`Numeric \| Categorical \| Boolean \| Correction \| Text`
`@langfuse/core`	`UpdateGenerationEvent`	interface	`interface`
`@langfuse/core`	`CreateObservationEvent`	interface	`interface`
`@langfuse/core`	`ObservationsViewSingle`	interface	`interface`
`@langfuse/core`	`UpdateObservationEvent`	interface	`interface`
`@langfuse/core`	`OptionalObservationBody`	interface	`interface`
`@langfuse/core`	`DeleteDatasetRunResponse`	interface	`interface`
`@langfuse/core`	`PaginatedDatasetRunItems`	interface	`interface`
`@langfuse/core`	`GetScoresResponseDataText`	interface	`interface`
`@langfuse/core`	`OpenAiResponseUsageSchema`	interface	`interface`
`@langfuse/core`	`GetScoresResponseTraceData`	interface	`interface`
`@langfuse/core`	`ListDatasetRunItemsRequest`	interface	`interface`
`@langfuse/core`	`CreateDatasetRunItemRequest`	interface	`interface`
`@langfuse/core`	`OpenAiCompletionUsageSchema`	interface	`interface`
`@langfuse/core`	`GetScoresResponseDataBoolean`	interface	`interface`
`@langfuse/core`	`GetScoresResponseDataNumeric`	interface	`interface`
`@langfuse/core`	`GetScoresResponseDataCorrection`	interface	`interface`
`@langfuse/core`	`GetScoresResponseDataCategorical`	interface	`interface`

Changed signatures

export	Before	After
`@langfuse/core · BlobStorageIntegrationType`	`"S3" \| "S3_COMPATIBLE" \| "AZURE_BLOB_STORAGE"`	`"S3" \| "S3_COMPATIBLE" \| "AZURE_BLOB_STORAGE" \| "GOOGLE_CLOUD_STORAGE"`

Removed class or interface members

member	import	Before
`LangfuseAPIClient.legacy`	`@langfuse/core`	`Legacy`
`LangfuseAPIClient._legacy`	`@langfuse/core`	`Legacy \| undefined`
`LangfuseAPIClient.scoresV3`	`@langfuse/core`	`ScoresV3`
`LangfuseAPIClient.sessions`	`@langfuse/core`	`Sessions`
`LangfuseAPIClient._scoresV3`	`@langfuse/core`	`ScoresV3 \| undefined`
`LangfuseAPIClient._sessions`	`@langfuse/core`	`Sessions \| undefined`
`LangfuseAPIClient.ingestion`	`@langfuse/core`	`Ingestion`
`LangfuseAPIClient._ingestion`	`@langfuse/core`	`Ingestion \| undefined`
`LangfuseAPIClient.datasetRunItems`	`@langfuse/core`	`DatasetRunItems`
`LangfuseAPIClient._datasetRunItems`	`@langfuse/core`	`DatasetRunItems \| undefined`

Changed class or interface members

member	Before	After
`PropagateAttributesParams.metadata`	`Record<string, string> \| undefined`	`Record<string, unknown> \| undefined`

Newly deprecated

export	@deprecated
`@langfuse/core · ApiKeySummary.note`	Use name instead.
`@langfuse/core · ApiKeyResponse.note`	Use name instead.
`@langfuse/core · OrganizationApiKey.note`	Use name instead.
`@langfuse/core · CreateApiKeyRequest.note`	Use name instead.

Requirement changes (engines, peer dependencies)

	Before	After
`engines.node`	`—`	`>=22`

New exports (8)

import	export	kind
`@langfuse/core`	`CreateScoresRequest`	type
`@langfuse/core`	`CreateScoresResponse`	type
`@langfuse/core`	`CreateScoreBatchError`	interface
`@langfuse/core`	`serializeMetadataValue`	function
`@langfuse/core`	`CreateScoreBatchResults`	interface
`@langfuse/core`	`CreateScoreBatchResponse`	interface
`@langfuse/core`	`createStableExperimentId`	function
`@langfuse/core`	`dropMetadataOverSpanAttributeLimit`	function

Give your AI agent these facts

Vigia is a free MCP server: your coding agent checks versions, breaking changes and vulnerabilities before it writes code. No signup, no API key.

claude mcp add --transport http vigia https://vigia.coredls.cloud/mcp

Add to Cursor Add to VS Code ★ Star on GitHub

Any other MCP client

{ "mcpServers": { "vigia": { "url": "https://vigia.coredls.cloud/mcp" } } }

Agent skill (SKILL.md): tells the agent when to use Vigia · GitHub Action for pull requests

Frequently asked questions

What are the breaking changes when upgrading @langfuse/core from 5 to 6?

Between @langfuse/core 5.14.0 and 6.0.0, Vigia found 75 removed exports, 1 changed signatures and 11 removed or changed class or interface members.

What became deprecated in @langfuse/core 6?

4 exports or members are newly marked as deprecated in @langfuse/core 6.0.0.

For agents

GET https://vigia.coredls.cloud/v1/packages/npm/@langfuse/core/upgrade?from=5.14.0&to=6.0.0