"""
Slide 115: RunTree -- ручной контроль над деревом
Section 5: Экосистема
Source: slides/section5-ecosystem/slide-05.js

Сгенерировано автоматически из slide-NN.js / sectionN.pptx.
Паттерн провайдера скопирован из
bro-js/agents/teacher/assistant/src/angry_teacher/llm.py.

Запуск:
  cd langchain-evolution-deck
  cp .env.example .env   # заполни OPENAI_API_KEY
  python examples/slide-115/script.py
"""
import os
from dotenv import load_dotenv
from langchain_openai import ChatOpenAI

load_dotenv()

llm = ChatOpenAI(
    # model="openrouter/free",
    # model="qwen/qwen3.5-35b-a3b",
    model="openai/gpt-oss-20b",
    # model="nvidia/nemotron-3-nano",
    # model="qwen/qwen3.5-9b",
    base_url="https://llm.brojs.ru/v1",
    # base_url="https://api.minimax.io/v1",
    # base_url="http://0.0.0.0:8090/v1",
    # base_url="https://openrouter.ai/api/v1",
    # api_key=os.getenv("MINIMAX_API_KEY"),
    api_key=(os.getenv("OPENAI_API_KEY") or "").strip() or None,
    temperature=0.7,
    stream_usage=True,
)


# === Code from slide 115 ===
from langsmith.run_trees import RunTree

# RunTree -- explicit handle: создается руками, передается
# в код, потом post() отправляет в LangSmith. Нужно когда
# @traceable не подходит (динамич. дерево, не-Python, metadata).
parent = RunTree(
    name="agent_turn",
    run_type="chain",
    inputs={"q": "Who invented Python?"},
    project_name="my-agent-dev",
)
try:
    answer = my_agent(question, run_tree=parent)
    parent.end(outputs={"answer": answer})
except Exception as e:
    parent.end(error=str(e))          # ошибка логируется
    raise
finally:
    parent.post()                      # flush в LangSmith