Python SDK

What's Changed

• feat(api): update API spec from langfuse/langfuse 41f5847 by @langfuse-bot in https://github.com/langfuse/langfuse-python/pull/1677
• chore(deps): bump github/codeql-action from 4.35.5 to 4.36.0 in the github-actions group by @dependabot[bot] in https://github.com/langfuse/langfuse-python/pull/1678

Full Changelog: https://github.com/langfuse/langfuse-python/compare/v4.7.0...v4.7.1

What's Changed

• chore: add CODEOWNERS for GitHub config by @wochinge in https://github.com/langfuse/langfuse-python/pull/1652
• chore(deps): bump the github-actions group across 1 directory with 5 updates by @dependabot[bot] in https://github.com/langfuse/langfuse-python/pull/1645
• chore(deps): bump langsmith from 0.7.22 to 0.8.0 by @dependabot[bot] in https://github.com/langfuse/langfuse-python/pull/1653
• feat(span-processor): mark app root spans by @hassiebp in https://github.com/langfuse/langfuse-python/pull/1651
• feat(span-processor): simplify app root state and expand LLM scopes by @hassiebp in https://github.com/langfuse/langfuse-python/pull/1662
• chore(deps): bump zizmorcore/zizmor-action from 0.5.3 to 0.5.5 in the github-actions group by @dependabot[bot] in https://github.com/langfuse/langfuse-python/pull/1665
• ci: adjust zizmor advanced security handling by @wochinge in https://github.com/langfuse/langfuse-python/pull/1666
• chore(deps): bump github/codeql-action from 4.35.4 to 4.35.5 in the github-actions group by @dependabot[bot] in https://github.com/langfuse/langfuse-python/pull/1668
• chore(deps): bump idna from 3.11 to 3.15 by @dependabot[bot] in https://github.com/langfuse/langfuse-python/pull/1660
• chore(deps): bump urllib3 from 2.6.3 to 2.7.0 by @dependabot[bot] in https://github.com/langfuse/langfuse-python/pull/1669
• fix: add depth limit to EventSerializer to prevent hangs on complex objects by @BKDDFS in https://github.com/langfuse/langfuse-python/pull/1577
• chore(deps): bump zizmorcore/zizmor-action from 0.5.5 to 0.5.6 in the github-actions group by @dependabot[bot] in https://github.com/langfuse/langfuse-python/pull/1672

New Contributors

• @BKDDFS made their first contribution in https://github.com/langfuse/langfuse-python/pull/1577

Full Changelog: https://github.com/langfuse/langfuse-python/compare/v4.6.1...v4.7.0

What's Changed

• feat(scores): support text scores in v3 by @wochinge in https://github.com/langfuse/langfuse-python/pull/1661

Full Changelog: https://github.com/langfuse/langfuse-python/compare/v3.14.6...v3.15.0

What's Changed

• chore: improve agent development setup by @hassiebp in https://github.com/langfuse/langfuse-python/pull/1642
• feat(ci): add RunnerContext and RegressionError for experiment GH action by @wochinge in https://github.com/langfuse/langfuse-python/pull/1635
• ci: allow prerelease branch releases by @hassiebp in https://github.com/langfuse/langfuse-python/pull/1647
• fix(openai): handle Azure stream chunks without delta by @hassiebp in https://github.com/langfuse/langfuse-python/pull/1648

Full Changelog: https://github.com/langfuse/langfuse-python/compare/v4.5.1...v4.6.1

What's Changed

• chore: improve agent development setup by @hassiebp in https://github.com/langfuse/langfuse-python/pull/1642
• feat(ci): add RunnerContext and RegressionError for experiment GH action by @wochinge in https://github.com/langfuse/langfuse-python/pull/1635

Full Changelog: https://github.com/langfuse/langfuse-python/compare/v4.5.1...v4.6.0b1

What's Changed

• chore(ci): pin action version comments to immutable patch tags by @wochinge in https://github.com/langfuse/langfuse-python/pull/1636
• fix(experiments): flatten propagated metadata by @hassiebp in https://github.com/langfuse/langfuse-python/pull/1641

Full Changelog: https://github.com/langfuse/langfuse-python/compare/v4.5.0...v4.5.1

What's Changed

• fix(ci): disable zizmor advanced security to unblock releases by @wochinge in https://github.com/langfuse/langfuse-python/pull/1630
• fix(observe): preserve streaming context without output capture by @hassiebp in https://github.com/langfuse/langfuse-python/pull/1628
• ci: use explicit version for fetch-metadata version comment by @wochinge in https://github.com/langfuse/langfuse-python/pull/1633
• fix(observe): preserve streaming context without output capture by @hassiebp in https://github.com/langfuse/langfuse-python/pull/1634
• fix(langchain): preserve LangGraph control flow traces by @hassiebp in https://github.com/langfuse/langfuse-python/pull/1632
• fix(openai): preserve native v1 stream contract by @hassiebp in https://github.com/langfuse/langfuse-python/pull/1627

Full Changelog: https://github.com/langfuse/langfuse-python/compare/v4.3.1...v4.5.0

What's Changed

• fix(ci): disable zizmor advanced security to unblock releases by @wochinge in https://github.com/langfuse/langfuse-python/pull/1630

Full Changelog: https://github.com/langfuse/langfuse-python/compare/v4.3.1...v4.4.0b1

What's Changed

• feat(api): update API spec from langfuse/langfuse 07cae52 by @langfuse-bot in https://github.com/langfuse/langfuse-python/pull/1617
• chore(deps): bump actions/github-script from 8.0.0 to 9.0.0 in the github-actions group by @dependabot[bot] in https://github.com/langfuse/langfuse-python/pull/1616
• refactor(tests): split suites by execution level and speed up CI by @hassiebp in https://github.com/langfuse/langfuse-python/pull/1609
• ci: add 7-day dependabot cooldown by @wochinge in https://github.com/langfuse/langfuse-python/pull/1619
• ci: harden GitHub Actions workflows with zizmor by @wochinge in https://github.com/langfuse/langfuse-python/pull/1623
• ci: make uv action tag explicit by @wochinge in https://github.com/langfuse/langfuse-python/pull/1625
• fix(langchain): propagate trace name metadata by @hassiebp in https://github.com/langfuse/langfuse-python/pull/1626

Full Changelog: https://github.com/langfuse/langfuse-python/compare/v4.2.0...v4.3.1

What's Changed

• feat(api): update API spec from langfuse/langfuse 07cae52 by @langfuse-bot in https://github.com/langfuse/langfuse-python/pull/1617
• chore(deps): bump actions/github-script from 8.0.0 to 9.0.0 in the github-actions group by @dependabot[bot] in https://github.com/langfuse/langfuse-python/pull/1616
• refactor(tests): split suites by execution level and speed up CI by @hassiebp in https://github.com/langfuse/langfuse-python/pull/1609
• ci: add 7-day dependabot cooldown by @wochinge in https://github.com/langfuse/langfuse-python/pull/1619
• ci: harden GitHub Actions workflows with zizmor by @wochinge in https://github.com/langfuse/langfuse-python/pull/1623

Full Changelog: https://github.com/langfuse/langfuse-python/compare/v4.2.0...v4.3.0rc1

What's Changed

• feat(client): add custom span exporter support by @hassiebp in https://github.com/langfuse/langfuse-python/pull/1618

Full Changelog: https://github.com/langfuse/langfuse-python/compare/v4.1.0...v4.2.0

What's Changed

• chore(ci): move to blacksmith runners by @nimarb in https://github.com/langfuse/langfuse-python/pull/1613
• feat(api): update API spec from langfuse/langfuse 1999706 by @langfuse-bot in https://github.com/langfuse/langfuse-python/pull/1615

Full Changelog: https://github.com/langfuse/langfuse-python/compare/v4.0.6...v4.1.0

What's Changed

• chore(deps): bump langchain-core from 1.2.21 to 1.2.22 by @dependabot[bot] in https://github.com/langfuse/langfuse-python/pull/1601
• feat(langchain): mark LangChain root observations in metadata by @hassiebp in https://github.com/langfuse/langfuse-python/pull/1604

Full Changelog: https://github.com/langfuse/langfuse-python/compare/v4.0.5...v4.0.6

What's Changed

• chore(deps-dev): bump werkzeug from 3.1.5 to 3.1.6 by @dependabot[bot] in https://github.com/langfuse/langfuse-python/pull/1531
• chore: upgrade ruff + merge configurations by @akx in https://github.com/langfuse/langfuse-python/pull/1535
• fix(media): reuse httpx client for requests by @hassiebp in https://github.com/langfuse/langfuse-python/pull/1537
• feat(langchain): backport Langchain root metadata flag to v3-stable by @hassiebp in https://github.com/langfuse/langfuse-python/pull/1605

Full Changelog: https://github.com/langfuse/langfuse-python/compare/v3.14.5...v3.14.6

What's Changed

• build: set exclude-newer to 7 days by @wochinge in https://github.com/langfuse/langfuse-python/pull/1595
• ci(dependabot): add github-actions ecosystem with grouped updates by @wochinge in https://github.com/langfuse/langfuse-python/pull/1597
• ci: pin and bump GH actions by @wochinge in https://github.com/langfuse/langfuse-python/pull/1596
• chore(deps): bump the github-actions group across 1 directory with 3 updates by @dependabot[bot] in https://github.com/langfuse/langfuse-python/pull/1599
• fix(experiments): fix unstable local experiment IDs for local data by @hassiebp in https://github.com/langfuse/langfuse-python/pull/1600

New Contributors

• @wochinge made their first contribution in https://github.com/langfuse/langfuse-python/pull/1595

Full Changelog: https://github.com/langfuse/langfuse-python/compare/v4.0.4...v4.0.5

What's Changed

• chore: migrate repo from poetry to uv by @hassiebp in https://github.com/langfuse/langfuse-python/pull/1589

Full Changelog: https://github.com/langfuse/langfuse-python/compare/v4.0.3...v4.0.4

What's Changed

• chore(deps-dev): bump langchain-core from 1.2.11 to 1.2.22 by @dependabot[bot] in https://github.com/langfuse/langfuse-python/pull/1586
• fix(langchain): exit propagation context gracefully by @hassiebp in https://github.com/langfuse/langfuse-python/pull/1588

Full Changelog: https://github.com/langfuse/langfuse-python/compare/v4.0.2...v4.0.3

What's Changed

• fix(openai): correct token details field names for Response API usage by @zachrobo1 in https://github.com/langfuse/langfuse-python/pull/1564
• fix(openai): include responses instructions in captured prompt by @D-Joey-G in https://github.com/langfuse/langfuse-python/pull/1565
• fix(observe): Handle asyncio.CancelledError in exception blocks by @jinohkang-theori in https://github.com/langfuse/langfuse-python/pull/1566
• chore: relax packaging constraint to <27 by @hassiebp in https://github.com/langfuse/langfuse-python/pull/1570
• feat(api): update API spec from langfuse/langfuse a6c38c6 by @langfuse-bot in https://github.com/langfuse/langfuse-python/pull/1574
• chore(deps): bump requests from 2.32.5 to 2.33.0 by @dependabot[bot] in https://github.com/langfuse/langfuse-python/pull/1579
• fix(scores): parse session ID correctly by @hassiebp in https://github.com/langfuse/langfuse-python/pull/1582
• chore: fix flaky langchain tests by @hassiebp in https://github.com/langfuse/langfuse-python/pull/1584
• fix(experiments): maintain propagated context in async experiments by @hassiebp in https://github.com/langfuse/langfuse-python/pull/1587

New Contributors

• @zachrobo1 made their first contribution in https://github.com/langfuse/langfuse-python/pull/1564
• @D-Joey-G made their first contribution in https://github.com/langfuse/langfuse-python/pull/1565
• @jinohkang-theori made their first contribution in https://github.com/langfuse/langfuse-python/pull/1566

Full Changelog: https://github.com/langfuse/langfuse-python/compare/v4.0.1...v4.0.2

What's Changed

• feat(api): update API spec from langfuse/langfuse e84ca45 by @langfuse-bot in https://github.com/langfuse/langfuse-python/pull/1562
• chore(deps-dev): bump orjson from 3.11.3 to 3.11.6 by @dependabot[bot] in https://github.com/langfuse/langfuse-python/pull/1563
• feat(api): update API spec from langfuse/langfuse b3adfc3 by @langfuse-bot in https://github.com/langfuse/langfuse-python/pull/1567

Full Changelog: https://github.com/langfuse/langfuse-python/compare/v4.0.0...v4.0.1

Breaking changes and migration guide

Please see our documentation.

Other changes

• chore(deps-dev): bump werkzeug from 3.1.5 to 3.1.6 by @dependabot[bot] in https://github.com/langfuse/langfuse-python/pull/1531
• chore: upgrade ruff + merge configurations by @akx in https://github.com/langfuse/langfuse-python/pull/1535
• fix(media): reuse httpx client for requests by @hassiebp in https://github.com/langfuse/langfuse-python/pull/1537
• feat!: prepare v4 release by @hassiebp in https://github.com/langfuse/langfuse-python/pull/1486
• feat(api): update API spec from langfuse/langfuse 784ab09 by @langfuse-bot in https://github.com/langfuse/langfuse-python/pull/1538
• fix(media): retry failed uploads by @hassiebp in https://github.com/langfuse/langfuse-python/pull/1540
• feat(api): update API spec from langfuse/langfuse 25b5139 by @langfuse-bot in https://github.com/langfuse/langfuse-python/pull/1543
• chore(deps-dev): bump langgraph-checkpoint from 3.0.0 to 4.0.0 by @dependabot[bot] in https://github.com/langfuse/langfuse-python/pull/1541
• feat(api): update API spec from langfuse/langfuse a93f65a by @langfuse-bot in https://github.com/langfuse/langfuse-python/pull/1545
• fix(langchain): skip priority-tier keys when subtracting token detail counts by @Br1an67 in https://github.com/langfuse/langfuse-python/pull/1549
• fix(experiment): replace escaped newlines with actual newlines in format output by @Br1an67 in https://github.com/langfuse/langfuse-python/pull/1547
• fix(openai): remove unreachable None type assignments for OpenAI classes by @Br1an67 in https://github.com/langfuse/langfuse-python/pull/1546
• Add handling for invalid tool calls in CallbackHandler by @deershark in https://github.com/langfuse/langfuse-python/pull/1550
• fix: apply stricter early routing for base64 media to prevent SSE dat… by @MoonSangJin in https://github.com/langfuse/langfuse-python/pull/1544
• chore: unify logging usage by @akx in https://github.com/langfuse/langfuse-python/pull/1539
• fix(client): pass release variable to span clients by @hassiebp in https://github.com/langfuse/langfuse-python/pull/1518
• feat(api): update API spec from langfuse/langfuse 2eaf041 by @langfuse-bot in https://github.com/langfuse/langfuse-python/pull/1556
• chore(deps-dev): bump langgraph from 1.0.9 to 1.0.10rc1 by @dependabot[bot] in https://github.com/langfuse/langfuse-python/pull/1560

New Contributors

• @akx made their first contribution in https://github.com/langfuse/langfuse-python/pull/1535
• @Br1an67 made their first contribution in https://github.com/langfuse/langfuse-python/pull/1549
• @deershark made their first contribution in https://github.com/langfuse/langfuse-python/pull/1550
• @MoonSangJin made their first contribution in https://github.com/langfuse/langfuse-python/pull/1544

Full Changelog: https://github.com/langfuse/langfuse-python/compare/v3.14.5...v4.0.0