feat(api): update API spec from langfuse/langfuse 99e2ce9

[langfuse-bot]

Greptile Summary

This generated API update marks deprecated v3 API operations and documents their v4 migration paths.

• Adds static deprecation metadata to synchronous, asynchronous, typed, and raw API methods.
• Adds typing-extensions as a direct dependency to support the decorators.
• Refreshes the lockfile dependency metadata and resolution cutoff.

Confidence Score: 5/5

The PR appears safe to merge; no changed-code-triggered correctness or security defects were identified.

The decorators preserve endpoint behavior while adding deprecation metadata, synchronous and asynchronous surfaces remain aligned, and the newly direct typing-extensions dependency supports all added imports.

_{Reviews (1): Last reviewed commit: "feat(api): update API spec from langfuse..." | Re-trigger Greptile}

Context used (5)

• Knowledge Base — API client and service surface
• Knowledge Base — Generated API service domains
• Knowledge Base — API compatibility and transport
• Knowledge Base — Datasets, experiments, and evaluation
• Knowledge Base — Dataset and run management

[github-actions]

@claude review

[claude]

Additional findings (outside the current diff — GitHub can't attach inline comments there):

• 🟡 langfuse/_client/client.py — Internal supported SDK methods (get_dataset_run, get_dataset_runs, delete_dataset_run in langfuse/_client/client.py:2513-2589, and BatchEvaluation's trace-listing in langfuse/batch_evaluation.py:1167) call self.api.datasets.get_run/get_runs/delete_run and api.trace.list, which this diff now decorates with @ typing_extensions.deprecated. sweep:self\.api\.(datasets\.(get_run|get_runs|delete_run)|trace\.list)\(

  Extended reasoning...

  These public Langfuse SDK convenience methods are not themselves being deprecated/removed, but static type checkers that honor PEP 702 (e.g. pyright, which surfaces reportDeprecated hints by default) will now flag these legitimate, still-supported internal call sites as using a deprecated API, misleading maintainers/downstream type-checking users into thinking normal SDK usage (run_experiment, get_dataset_run, batch evaluation trace fetch) relies on removed functionality, when a correct fix would keep the raw v3 client marked deprecated for direct external callers while not surfacing false-positive deprecation diagnostics for the SDK's own maintained wrapper implementations.

  Verification: nit. The candidate's facts are correct: the diff adds @ typing_extensions.deprecated("...", category=None) to DatasetsClient.get_run/get_runs/delete_run (langfuse/api/datasets/client.py:174,223,272 + async variants) and trace.list (langfuse/api/trace/client.py), and these are called by still-supported internal SDK methods — langfuse/_client/client.py:2528 (self.api.datasets.get_run),…