Q: extending instrument_claude_agent_sdk() — scope review + landing strategy
Los mantenedores suelen responder en 1 día
Nadie ha tomado este issue todavía.
Evaluación
- Dificultad
- 5/5
- Tiempo estimado
- Más de una semana
- Aptitud para principiantes
- 25/100
- Tipo de issue
- Nueva funcionalidad
- Claridad
- Bastante claro
- Estado de actividad
- Tranquilo
- Stack tecnológico
- python
- Área
- observability
Línea de trabajo
Empieza leyendo logfire/_internal/integrations/claude_agent_sdk.py y los semconv, scrubbing, tests, VCR cassettes y la documentación relacionada mencionados en el issue. Confirma el alcance y la estrategia de landing preferidos por el maintainer; el trabajo se considera terminado cuando haya un conjunto acordado de cambios y una estructura de PR antes de que comience la implementación.
Escrito por el modelo de indexación a partir del texto del issue.
Descripción
Hi @alexmojaki — I've been using instrument_claude_agent_sdk() for a few weeks and built out coverage in my fork
(oneryalcin/logfire@main) for gaps I hit (see: https://github.com/oneryalcin/logfire/pulls?q=is%3Apr+is%3Aclosed) . Before opening a PR I want to check scope and landing strategy with you, since you own the integration (#1799 / #1809).
Inventory
12 scoped changes, all under logfire/_internal/integrations/claude_agent_sdk.py plus adjacent semconv / scrubbing / docs / tests:
Stream-source coverage
- Server-side tool blocks (
web_search,web_fetch,code_execution,advisor, ...) astool_call/tool_call_responseparts on thechatspan — currently dropped. RateLimitEventstate transitions andMirrorErrorMessageas logs underinvoke_agent.
Root invoke_agent span enrichment
ClaudeAgentOptionssession config (model / permission_mode / max_turns / effort / cwd / system_prompt / ...).- Per-turn identifiers from
AssistantMessageonchatspans. ResultMessageagent-run metadata closing the root span (subtype, errors, structured_output, model_usage, tools_used, ...).
Hook coverage — the 5 SDK hooks the integration doesn't surface today
UserPromptSubmit,Stop,PreCompact,Notification,PermissionRequestas logfire log records underinvoke_agent.can_use_tooloutcomes (PermissionResultallow/deny) andPreToolUse.updatedInputmutations reflected on theexecute_toolspan'sgen_ai.tool.call.arguments.
Lifecycle + control methods (none currently traced)
connect,disconnect,set_model,set_permission_mode,rewind_files,stop_task,interrupt,mcp.reconnect,mcp.toggle.receive_messagesparity withreceive_response(currently a black hole).
Subagents (Task tool)
subagent {agent_type}span keyed byagent_id(opens onSubagentStart, closes onSubagentStop).Task started/Task progress/Task {status}SystemMessage events as logs.AgentDefinitionmetadata when configured (claude.agent.model,.system_prompt,.tools, ...).- Tool calls and per-turn
chatspans inside a subagent re-parented under the subagent envelope (viaagent_id/parent_tool_use_id).
Plumbing
- New
claude.*semconv constants in_internal/integrations/llm_providers/semconv.py. - Allowlist additions in
BaseScrubber.SAFE_KEYSfor model-generated and operator-set fields (text / errors / structured_output / usage / etc). claude-agent-sdk>=0.1.62dev pin +[tool.uv.exclude-newer-package]entry, matching the existing pattern.- New + refreshed VCR cassettes; ~3,500 lines of test additions; new section in
docs/integrations/llms/claude-agent-sdk.md.
Size
~+6,000 / -400 against pydantic/logfire@main, scoped entirely to
this integration + plumbing. 98 tests pass, make format / make lint
/ make typecheck clean.
Two questions
- Scope — any of these you'd reject on principle? Specific ones I'd flag for sanity-check:
claude.stop.last_assistant_message/claude.subagent.last_assistant_messageare captured via defensive.get()on undocumented wire fields (the SDK type definitions don't declare them; the integration silently skips if a future SDK release renames them).- Hook-event surfacing as logs adds noise to traces; some teams may
want it gated behind a flag rather than always-on. - The
gen_ai.tool.call.argumentsoverwrite onPreToolUse
updatedInputmutation matches OTel Gen AI semconv (arguments =
what the tool actually saw) but the original is preserved under
claude.tool_call.arguments.original— wanted to flag the
semantic choice.
- Cadence — happy to ship as one big PR or as a series of 4–6
mapped to the groups above (stream → root-span → hooks → lifecycle
→ subagents → glue), each 200–800 lines. Recent feature PRs in this
repo trend in that range, so the series probably matches your
review rhythm better, but I'll defer to your preference.
No urgency on my side. Thanks for the original integration — solid
foundation to build on.
- Lenguaje dominante
- Python
- Estrellas
- 4.6k
- Forks
- 376
- Merge medio
- 1 d 21 h
- PR fusionados (30 d)
- 124
Preparar el entorno
- Sin Dockerfile ni archivo de Docker Compose
- Sin plantilla de pull request
- Leer la guía de contribución
Primeros pasos
- Lee el issue completo y luego la guía de contribución del proyecto.
- Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
- Haz un fork del repositorio y trabaja en una rama.
- Abre un pull request que haga referencia al número del issue.
Más de pydantic/logfire
-
numpy.bytes_ attributes are recorded as a truncated repr instead of their contentPosiblemente ocupada @JoeyTan21 la tomó hoy. Abierto
Dificultad 2/5 1-3 horas Aptitud para principiantes 72/100
Los mantenedores suelen responder en 1 día
-
Windows: 16 tests in `tests/test_cli.py` fail, and the CI test job only runs on LinuxQuizá libre de nuevo Un pull request para esta issue se cerró sin fusionarse. Abierto
Dificultad 2/5 1-3 horas Aptitud para principiantes 78/100
Los mantenedores suelen responder en 1 día
-
Docs: update the Playground cost estimate note for Gateway custom pricesPosiblemente ocupada @henricop la tomó hace 20 días. Abierto
Dificultad 1/5 Menos de una hora Aptitud para principiantes 72/100
Los mantenedores suelen responder en 1 día
-
Dificultad 2/5 1-3 horas Aptitud para principiantes 75/100
Los mantenedores suelen responder en 1 día
-
Pydantic fields with a custom serializer get the wrong JSON schema, which crashes the verbose console exporterPosiblemente ocupada @MaiAditya la tomó hoy. Abierto
Dificultad 4/5 3-5 días Aptitud para principiantes 42/100
Los mantenedores suelen responder en 1 día
Todos los issues de pydantic/logfire
Issues similares
-
A new VOLTTRON_HOME starts with agent isolation mode on (string comparison of a boolean default)Abierto
Dificultad 2/5 1-3 horas Aptitud para principiantes 68/100
-
llm translation
Dificultad 2/5 1-3 horas Aptitud para principiantes 82/100
Los mantenedores suelen responder en 1 día
-
Dificultad 2/5 1-3 horas Aptitud para principiantes 78/100
FAIRmat-NFDI/sand#239 ·
Los mantenedores suelen responder en 1 día
-
bug P2
Dificultad 2/5 1-3 horas Aptitud para principiantes 72/100
coco-research/coco#539 ·
Los mantenedores suelen responder en 1 día
-
dependencies
Dificultad 2/5 1-3 horas Aptitud para principiantes 62/100
JustBeanie/hass-volcano-hybrid#34 ·
Los mantenedores suelen responder en 1 día