Expose SDK broker exit notifications

[khaliqgant]

Summary

• Add AgentRelayClient.onBrokerExit() and exported BrokerExitInfo for SDK-spawned brokers
• Capture exit code, signal, PID, and recent stderr, replaying the exit to late subscribers
• Clear brokerPid after managed broker exit and skip event/lease setup if the child dies during startup
• Document the hook and add changelog/test coverage

Fixes #945

Verification

• npm exec vitest run --config vitest.config.ts src/__tests__/client-broker-exit.test.ts
• npm exec vitest run --config vitest.config.ts src/__tests__/client-stdout-drain.test.ts
• npm --prefix packages/sdk run check
• npx tsc -p tsconfig.build.json
• git diff --check -- CHANGELOG.md packages/sdk/README.md packages/sdk/src/client.ts packages/sdk/src/index.ts packages/sdk/src/workers.ts packages/sdk/src/__tests__/client-broker-exit.test.ts

[coderabbitai]

Warning

Rate limit exceeded

@khaliqgant has exceeded the limit for the number of commits that can be reviewed per hour. Please wait 9 minutes and 46 seconds before requesting another review.

You’ve run out of usage credits. Purchase more in the billing tab.

⌛ How to resolve this issue?

After the wait time has elapsed, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

We recommend that you space out your commits to avoid hitting the rate limit.

🚦 How do rate limits work?

CodeRabbit enforces hourly rate limits for each developer per organization.

Our paid plans have higher rate limits than the trial, open-source and free plans. In all cases, we re-allow further reviews after a brief timeout.

Please see our FAQ for further information.

ℹ️ Review info

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro Plus

Run ID: 3a617531-36ec-49bf-8c07-dea3e32c0e0f

📥 Commits

Reviewing files that changed from the base of the PR and between 90dc1fa and cd6bde4.

📒 Files selected for processing (13)

• .trajectories/completed/2026-05/traj_dcl9hgoiuac5.json
• .trajectories/completed/2026-05/traj_dcl9hgoiuac5.md
• .trajectories/index.json
• CHANGELOG.md
• packages/openclaw/src/identity/files.ts
• packages/sdk/README.md
• packages/sdk/src/__tests__/client-broker-exit.test.ts
• packages/sdk/src/client.ts
• packages/sdk/src/index.ts
• packages/sdk/src/workers.ts
• src/cli/commands/core.test.ts
• web/content/docs/cli-broker-lifecycle.mdx
• web/content/docs/local-mode.mdx

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch codex/issue-945-broker-exit

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[cubic-dev-ai]

No issues found across 15 files

_{Re-trigger cubic}