Instrument LangGraph Platform background run submission and joining
Maintainer antworten meist innerhalb von 2 Tagen
Dieses Issue hat noch niemand übernommen.
Bewertung
- Schwierigkeit
- 5/5
- Geschätzter Aufwand
- Über eine Woche
- Anfängerfreundlichkeit
- 35/100
- Issue-Typ
- Feature
- Klarheit
- Größtenteils klar
- Aktivitätsstatus
- Aktiv
- Tech-Stack
- typescript
- Bereich
- backend-api-design, observability-sre, testing-qa
Rechercherichtung
Beginne damit, die Implementierung für Issue #2199 und die Instrumentierungsspezifikation zu lesen, und ordne dann die vier aufgeführten Run-APIs von @langchain/langgraph-sdk sowie deren typisierte Channels zu. Definiere Span-Lebensdauern und die prozessübergreifende Korrelation anhand der Run-/Thread-Identifier des Providers, ohne die Bestätigung der Übermittlung als Abschluss zu behandeln. Füge die angeforderte e2e-Abdeckung mit dem echten SDK, Span-Tree-Snapshots, Aktualisierungen der CI-Zusammenfassung, Replay-Prüfungen und Dokumentation hinzu.
Vom Indexierungsmodell aus dem Issue-Text verfasst.
Beschreibung
Follow-up to https://github.com/braintrustdata/braintrust-sdk-javascript/issues/2199.
The implementation for #2199 is intentionally limited to runs.wait and runs.stream: the caller starts execution and follows it through completion in the same call. Background execution was explicitly deferred.
Scope
Add Braintrust instrumentation for the background run workflow in @langchain/langgraph-sdk:
client.runs.create(threadId, assistantId, options): submit a background run.client.runs.createBatch(payloads, options): submit background runs in a batch.client.runs.join(threadId, runId, options): wait for an existing run.client.runs.joinStream(threadId, runId, options): consume an existing run's output.
A run may be submitted in one process and joined in another. Define how the resulting observations correlate using the provider's run/thread identifiers; do not depend solely on in-memory state. A submission acknowledgement must not be represented as completion of the remote agent execution.
Note: runs.wait(threadId, assistantId, options) starts a new run and returns its final state. It is already in the parent implementation's scope; it is not the API for joining an existing run.
Acceptance criteria
- Support automatic instrumentation and an explicit wrapper through shared typed channels, following the instrumentation specification.
- Define submission, batch, join, and joined-stream span semantics, including what each span's lifetime measures and how separate processes correlate.
- Capture useful inputs/results, errors, and allowlisted execution metadata without copying arbitrary configuration, headers, or credentials.
- Preserve promise/iterator behavior, cancellation, and user-visible errors; prevent duplicate spans when wrapper and automatic instrumentation are combined.
- Keep entity CRUD outside the instrumentation scope.
- Add e2e tests using the real SDK for submission followed by joining from a separate process/client, batch submissions, joined streaming, errors, and cancellation.
- Test pinned and separately named latest SDK aliases, ESM/CommonJS, and wrapped/automatic/combined/disabled modes. Assert paired span-tree snapshots, update the CI summary, and verify three consecutive replay runs.
- Document the supported APIs and cross-process tracing behavior.
- Vorherrschende Sprache
- TypeScript
- Sterne
- 28
- Forks
- 14
- Ø Merge
- 2 T. 20 Std.
- Gemergte PRs (30 T.)
- 66
Entwicklungsumgebung
- Enthält ein Dockerfile oder eine Docker-Compose-Datei
- Keine Pull-Request-Vorlage
- Kein Beitragsleitfaden
Erste Schritte
- Lesen Sie das ganze Issue und danach den Beitragsleitfaden des Projekts.
- Schreiben Sie ins Issue, dass Sie es übernehmen — das erspart doppelte Arbeit.
- Forken Sie das Repository und arbeiten Sie in einem Branch.
- Öffnen Sie einen Pull Request, der die Issue-Nummer nennt.
Mehr aus braintrustdata/braintrust-sdk-javascript
-
Schwierigkeit 3/5 1-2 Tage Anfängerfreundlichkeit 65/100
braintrustdata/braintrust-sdk-javascript#2511 · 1 Kommentar ·
Maintainer antworten meist innerhalb von 2 Tagen
-
Schwierigkeit 4/5 3-5 Tage Anfängerfreundlichkeit 56/100
braintrustdata/braintrust-sdk-javascript#2482 ·
Maintainer antworten meist innerhalb von 2 Tagen
-
Schwierigkeit 4/5 3-5 Tage Anfängerfreundlichkeit 68/100
braintrustdata/braintrust-sdk-javascript#2481 ·
Maintainer antworten meist innerhalb von 2 Tagen
-
Schwierigkeit 4/5 3-5 Tage Anfängerfreundlichkeit 58/100
braintrustdata/braintrust-sdk-javascript#2480 ·
Maintainer antworten meist innerhalb von 2 Tagen
-
Schwierigkeit 5/5 Über eine Woche Anfängerfreundlichkeit 25/100
braintrustdata/braintrust-sdk-javascript#2440 ·
Maintainer antworten meist innerhalb von 2 Tagen
Alle Issues in braintrustdata/braintrust-sdk-javascript
Ähnliche Issues
-
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 78/100
melgarafael/DeskcommCRM#1812 ·
Maintainer antworten meist innerhalb von 1 Tag
-
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 84/100
prisma/prisma-cli#309 ·
Maintainer antworten meist innerhalb von 1 Tag
-
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 78/100
gregwebs/pi-quota-dispatcher#26 ·
Maintainer antworten meist innerhalb von 1 Tag
-
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 74/100
openwatersio/slackwater.xyz#124 ·
Maintainer antworten meist innerhalb von 1 Tag
-
agent-reported area/browser area/docs documentation good first issue hacktoberfest help wanted P2
Schwierigkeit 1/5 Unter einer Stunde Anfängerfreundlichkeit 90/100
Maintainer antworten meist innerhalb von 2 Tagen