@langfuse/core を 5.x から 6.x へアップグレード

@langfuse/core 5.14.0 と 6.0.0 の公開 API を、TypeScript の型から自動的に比較したものです。シグネチャの変更は破壊的変更の候補であり、確定ではありません。

概要

削除されたインポートパス	0
削除されたエクスポート	75
変更されたシグネチャ	1
削除されたクラス／インターフェースのメンバー	10
変更されたクラス／インターフェースのメンバー	1
新たに非推奨	4
要件の変更（engines、peer 依存関係）	1
新しいエクスポート	8

削除されたエクスポート

import	export	kind	変更前
`@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`

変更されたシグネチャ

export	変更前	変更後
`@langfuse/core · BlobStorageIntegrationType`	`"S3" \| "S3_COMPATIBLE" \| "AZURE_BLOB_STORAGE"`	`"S3" \| "S3_COMPATIBLE" \| "AZURE_BLOB_STORAGE" \| "GOOGLE_CLOUD_STORAGE"`

削除されたクラス／インターフェースのメンバー

member	import	変更前
`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`

変更されたクラス／インターフェースのメンバー

member	変更前	変更後
`PropagateAttributesParams.metadata`	`Record<string, string> \| undefined`	`Record<string, unknown> \| undefined`

新たに非推奨

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.

要件の変更（engines、peer 依存関係）

	変更前	変更後
`engines.node`	`—`	`>=22`

新しいエクスポート (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

このデータを AI エージェントに渡す

Vigia は無料の MCP サーバーです。コーディングエージェントがコードを書く前に、バージョン・破壊的変更・脆弱性を確認できます。登録も API キーも不要です。

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

Cursor に追加 VS Code に追加 ★ GitHub でスターを付ける

その他の MCP クライアント

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

エージェント用スキル (SKILL.md)：Vigia を使うタイミングをエージェントに伝えます · プルリクエスト用 GitHub Action

よくある質問

@langfuse/core を 5 から 6 にアップグレードする際の破壊的変更は？

@langfuse/core 5.14.0 と 6.0.0 の間で、Vigia は削除されたエクスポートを 75 件、変更されたシグネチャを 1 件、削除または変更されたクラス／インターフェースのメンバーを 11 件検出しました。

@langfuse/core 6 で非推奨になったものは？

@langfuse/core 6.0.0 では 4 件のエクスポートまたはメンバーが新たに非推奨になりました。

エージェント向け

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