feat: add session end lifecycle callback by chenghao-mou · Pull Request #2387 · livekit/agents-js

chenghao-mou · 2026-08-31T10:35:04Z

Behavior: Add onSessionEnd after the primary session closes and before internal report generation. Bound the callback to 300 seconds, then flush final OTEL logs after shutdown callbacks.

Parity: Apply Python's 30-second connect and 900-second total deadlines to session report uploads. Retry only connection setup failures or responses with RetryInfo.

Validation: Agents tests, build, typecheck, lint, format, and throws checks pass. The API check still reports unrelated baseline drift.

Addresses AGT-3407
Addresses #2375

Initial prompt and agent context

Model: GPT-5.6

can you review the issue from #2375

okay, we should port over the relevant changes

session report should inherit the 30/900 timeout values, right?

okay, can you add them in the port as well?

okay, create a PR.

changeset-bot · 2026-08-31T10:35:08Z

🦋 Changeset detected

Latest commit: 73c27df

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 39 packages

Name	Type
@livekit/agents	Patch
@livekit/agents-plugin-anam	Patch
@livekit/agents-plugin-anthropic	Patch
@livekit/agents-plugin-assemblyai	Patch
@livekit/agents-plugin-azure	Patch
@livekit/agents-plugin-baseten	Patch
@livekit/agents-plugin-bey	Patch
@livekit/agents-plugin-cartesia	Patch
@livekit/agents-plugin-cerebras	Patch
@livekit/agents-plugin-deepgram	Patch
@livekit/agents-plugin-did	Patch
@livekit/agents-plugin-elevenlabs	Patch
@livekit/agents-plugin-fishaudio	Patch
@livekit/agents-plugin-google	Patch
@livekit/agents-plugin-hedra	Patch
@livekit/agents-plugin-hume	Patch
@livekit/agents-plugin-inworld	Patch
@livekit/agents-plugin-krisp	Patch
@livekit/agents-plugin-lemonslice	Patch
@livekit/agents-plugin-liveavatar	Patch
@livekit/agents-plugin-livekit	Patch
@livekit/agents-plugin-minimax	Patch
@livekit/agents-plugin-mistral	Patch
@livekit/agents-plugin-mistralai	Patch
@livekit/agents-plugin-neuphonic	Patch
@livekit/agents-plugin-openai	Patch
@livekit/agents-plugin-perplexity	Patch
@livekit/agents-plugin-phonic	Patch
@livekit/agents-plugin-protoface	Patch
@livekit/agents-plugin-resemble	Patch
@livekit/agents-plugin-rime	Patch
@livekit/agents-plugin-runway	Patch
@livekit/agents-plugin-sarvam	Patch
@livekit/agents-plugin-silero	Patch
@livekit/agents-plugin-soniox	Patch
@livekit/agents-plugin-tavus	Patch
@livekit/agents-plugins-test	Patch
@livekit/agents-plugin-trugen	Patch
@livekit/agents-plugin-xai	Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

Use SIGKILL when the supervisor must stop a child. Job processes consume SIGTERM, so the default Node kill signal cannot enforce shutdown or memory limits.

ProcPool.close could return while on-demand job children still ran, allowing CLI shutdown to cut off session-end cleanup. Await every unique executor close alongside watcher tasks.

Cloud session reports use the Python schema. Preserve room and agent_name instead of renaming these transport fields for log redaction.

Python emits the process exit reason under reason. Preserve that schema instead of applying a PII-specific field name in Node.

devin-ai-integration

Devin Review found 1 new potential issue.

devin-ai-integration · 2026-09-01T14:57:58Z

@@ -162,18 +153,28 @@ export abstract class SupervisedProc {
          this.#logger.child({ reason: msg.value.reason }).debug('job exiting');


🟨 Shutdown reasons bypass log redaction

Application-provided shutdown text enters reason without a PII marker. Redacted sessions can export customer content unchanged.

Was this helpful? React with 👍 or 👎 to provide feedback.

feat: add session end lifecycle callback

5fbdd49

chenghao-mou requested a review from a team as a code owner August 31, 2026 10:35