Importer-backed adapters

[schustmi]

This PR adds importer-backed adapters: wrap an agent entrypoint that is already instrumented with an observability provider, and the adapter imports the provider trace of each run into Kitaru as a session. Adapters ship inside the provider importer packages for Langfuse, Braintrust, LangSmith, Logfire, and Phoenix behind an adapter extra, on top of the ImporterBackedAdapter base class in core. Run specs declare runtime_capabilities, and creating a replay or starting an experiment run rejects overrides and tool policies the agent version does not declare.

Example:

# agent.py
from kitaru_langfuse_importer.adapter import LangfuseAdapter

def run_agent(question: str) -> str:
    ...  # the Langfuse-instrumented agent

adapter = LangfuseAdapter()
result = adapter.run(run_agent, question="What is an AI agent?")

Register the entrypoint as an agent version to target it with session runs and replays:

kitaru agent version register langfuse-agent --spec version.yaml

# version.yaml
run_spec:
  command: python agent.py
  runtime_capabilities:
    overrides: false
    tool_policies: false

[socket-security]

Review the following changes in direct dependencies. Learn more about Socket for GitHub.

Diff	Package	Supply Chain Security	Vulnerability	Quality	Maintenance	License
	pypi/​braintrust@​0.35.0
	pypi/​logfire@​4.41.0
	pypi/​arize-phoenix-client@​3.3.0
	pypi/​langfuse@​4.15.1
	pypi/​kitaru-logfire-importer@​0.1.1
	pypi/​kitaru-braintrust-importer@​0.1.0
	pypi/​kitaru-langsmith-importer@​0.1.0
	pypi/​kitaru-phoenix-importer@​0.1.0

View full report

[greptile-apps]

Your trial has ended. Reactivate Greptile to resume code reviews.

[AlexejPenner]

🦭