ޠjSrSSKJr SSKrSSKJr SSKJr SSKJrJ r SSK J r J r SSK Jr S S jr\"S S 55rg) u``TranslatedSpan`` — the mutable draft handlers rewrite before export. Split out of :mod:`langsmith._internal.voice.base_span_processor` so the base processor stays focused on span lifecycle and export wiring. The framework subclasses (Pipecat, LiveKit) rewrite one of these per span while translating ``lk.*`` / ``pipecat.*`` data into LangSmith's ``gen_ai.*`` / ``langsmith.*`` namespaces. ) annotationsN)copy) dataclass)AnyOptional)Event ReadableSpan)rebuild_readable_spanc U(d0$UR5VVs0sH.up[U[[45(dM"U[U5_M0 snn$s snnf)zFKeep only the int-valued detail keys, dropping ``None`` / non-numeric.)items isinstanceintfloat)detailskvs c/var/www/html/gaurav/venv/lib/python3.13/site-packages/langsmith/_internal/voice/translated_span.py_clean_token_detailsrsA  ")--/ Q/$!ZC<5PIAs1vI/ QQ Qs AAc\rSrSr%SrS\S'S\S'S\S'\SS j5rSS jrSS jr SS jr S S jr S!Sjr S"Sjr S#SjrS$SjrS%SjrS&SjrSSSSSS.S'SjjrSSS.S(SjjrS)SjrS*SjrSrg)+TranslatedSpanuA span being translated into LangSmith's namespaces before export. Wraps a shallow copy of the original read-only OTel ``ReadableSpan`` with mutable ``attributes`` and ``events`` seeded from it. Handlers rewrite the draft while translating; :meth:`finalize` builds a fresh ``ReadableSpan`` from it — so the original span is never mutated. Created per span in :meth:`BaseLangSmithSpanProcessor.on_end` and threaded through dispatch — no global state. A processor that defers a span (see :meth:`BaseLangSmithSpanProcessor._dispatch`) simply holds the ``TranslatedSpan`` itself until it exports it later, so the in-progress translation outlives the originating ``on_end`` call. r spanzdict[str, Any] attributesz list[Event]eventscU"[U5[UR=(d 05[UR=(d /55$)z>Seed a draft from a span's own fields, attributes, and events.)rdictrlistr)clsrs rofTranslatedSpan.of1s: J &B ' " #  cT[URURURS9$)zDBuild the export span from the draft and its rewritten attrs/events.)rr)r rrrselfs rfinalizeTranslatedSpan.finalize:s"$ II$//$++  r!c$XRlg)z6Set the exported span's name (the LangSmith run name).N)r_name)r$names rset_nameTranslatedSpan.set_name@s  r!c$XRlg)uSet the exported span's end time (epoch ns). Lets a span merged from two sources report a duration that runs past its own end — e.g. a tool span spanning from the call to the result. N)r _end_time)r$ end_time_nss r set_end_timeTranslatedSpan.set_end_timeDs * r!c XRS'g)uCSet ``langsmith.span.kind`` (``llm`` / ``chain`` / ``tool`` / …).zlangsmith.span.kindNr)r$kinds rset_kindTranslatedSpan.set_kindLs15-.r!c XRS'g)zBSet ``langsmith.metadata.thread_id`` (the conversation/thread id).zlangsmith.metadata.thread_idNr2)r$ thread_ids r set_thread_idTranslatedSpan.set_thread_idPs:C67r!cLU(aXRS'XRS'gg)u+Set ``provider`` on both gen_ai.* provider keys (no-op if empty). LangSmith maps either ``gen_ai.provider.name`` (newer) or the legacy ``gen_ai.system`` to ``ls_provider``; writing both is version-agnostic. The caller passes an already-resolved slug — normalization is the integration's concern. zgen_ai.provider.namez gen_ai.systemNr2)r$providers r set_providerTranslatedSpan.set_providerTs% 6>OO2 3/7OOO , r!ctU(a1[U5URS'[U5URS'gg)zJSet the request model on ``gen_ai.request.model`` and its metadata mirror.zgen_ai.request.modelzlangsmith.metadata.model_nameN)strr)r$models r set_modelTranslatedSpan.set_model`s0 69%jDOO2 3?B5zDOO; < r!c"SURS'g)u Drop this span from the conversation Messages view (still in the tree). That view reconstructs the chat from ``llm``/``tool`` runs. STT/TTS spans are tagged ``llm``-kind for the tree but would otherwise add fake turns (raw transcripts, "Generated audio for: …"), so they opt out here. Tz*langsmith.metadata.ls_message_view_excludeNr2r#s rexclude_from_message_view(TranslatedSpan.exclude_from_message_viewfsIMDEr!c XRS'g)z:Mark the span as the trace root (``langsmith.root_span``).zlangsmith.root_spanNr2)r$is_roots r set_root_spanTranslatedSpan.set_root_spanos18-.r!c&X RSU3'g)u3Set ``langsmith.metadata.`` to the given value. LangSmith surfaces everything under ``langsmith.metadata.*`` as run metadata. Note ``langsmith.root_span`` and ``langsmith.span.kind`` are NOT metadata — they live in the top-level ``langsmith.*`` namespace and have their own setters / direct writes. zlangsmith.metadata.Nr2)r$keyvalues r set_metadataTranslatedSpan.set_metadatass8=-cU34r!N) input_tokens output_tokens total_tokensinput_token_detailsoutput_token_detailsc0nUb[U5US'Ub[U5US'Ub[U5US'[U5=n(aXvS'[U5=n(aXvS'U(a$[R"U5URS'gg)uWrite the given token usage as ``langsmith.usage_metadata`` (JSON). Callers pass the complete usage — it replaces the flat ``gen_ai.usage.*`` at ingest. No-op when nothing is given. NrOrPrQrRrSzlangsmith.usage_metadata)rrjsondumpsr)r$rOrPrQrRrSusagers r set_usageTranslatedSpan.set_usage}s!#  #$' $5E. !  $%(%7E/ "  #$' $5E. !*+>? ?7 ?+2' (*+?@ @7 @,3( ) :>**U:KDOO6 7 r!)prompt completioncUb%[R"SU05URS'Ub&[R"SU05URS'gg)zIWrite ``gen_ai.prompt``/``gen_ai.completion`` as ``{"messages": [...]}``.Nmessages gen_ai.promptgen_ai.completion)rUrVr)r$rZr[s r set_messagesTranslatedSpan.set_messagessN  /3zz:v:N/ODOOO ,  !37::z:>V3WDOO/ 0 "r!cx[U[5(aUO[R"U5URS'g)zWrite a tool run's input to ``gen_ai.prompt`` as raw I/O (not messages). A ``str`` is passed through unchanged; any other value is JSON-encoded. r^Nr r?rUrVr)r$ tool_inputs rset_tool_inputTranslatedSpan.set_tool_inputs, %Z55J4::j;Q (r!cx[U[5(aUO[R"U5URS'g)zWrite a tool run's output to ``gen_ai.completion`` as raw I/O (not messages). A ``str`` is passed through unchanged; any other value is JSON-encoded. r_Nrc)r$ tool_outputs rset_tool_outputTranslatedSpan.set_tool_outputs- &k377KTZZ =T +,r!)rr returnr)rlr )r)r?rlNone)r.rrlrm)r3r?rlrm)r7r?rlrm)r; Optional[str]rlrm)r@rnrlrm)rlrm)rGboolrlrm)rKr?rLrrlrm) rO Optional[int]rPrprQrprROptional[dict[str, int]]rSrqrlrm)rZOptional[list[dict]]r[rrrlrm)rdrrlrm)rhrrlrm)__name__ __module__ __qualname____firstlineno____doc____annotations__ classmethodrr%r*r/r4r8r<rArDrHrMrXr`reri__static_attributes__rkr!rrrs      *6D 8J M9='+'+&*8<9=L$L% L $ L 6 L7L L>(,+/ X% X) X  X  r!r)rzOptional[dict[str, Any]]rlzdict[str, int])rw __future__rrUr dataclassesrtypingrropentelemetry.sdk.tracerr $langsmith._internal.otel._span_utilsr rrrkr!rrsC# ! 7FR W W  W r!