SDK: reposition + should_pause soft pause

[tsouth89]

Summary

• LLM-first docs; monitor_llm uses rail=llm
• should_pause (fail-open, cached)
• examples/soft_pause_webhook.py

Test plan

• pytest 28 passed
• @coderabbitai review

[tsouth89]

@coderabbitai review

[coderabbitai]

✅ Action performed

Review finished.

Note: CodeRabbit is an incremental review system and does not re-review already reviewed commits. This command is applicable only when automatic reviews are paused.

[coderabbitai]

📝 Walkthrough

Walkthrough

BurnwatchClient now supports cached, fail-open agent pause-status queries. A stdlib-only webhook example verifies signed deliveries, rejects invalid requests, acknowledges valid requests, and triggers an application pause hook for matching events. LLM spend recordings now use the llm rail and include model and provider context. Tests cover pause lookup failure handling, response parsing, and caching.

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Title check	✅ Passed	The title matches the main changes by calling out the SDK repositioning and the new should_pause soft-pause behavior.
Description check	✅ Passed	The description covers the main changes: LLM-first docs, rail=llm, should_pause caching, and the webhook example.

---

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

[coderabbitai]

Actionable comments posted: 3

---

ℹ️ Review info

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro Plus

Run ID: f90c2e11-ae77-42c6-9d1f-e75a8588cf8e

📥 Commits

Reviewing files that changed from the base of the PR and between f31b6f0 and eba9287.

⛔ Files ignored due to path filters (1)

• README.md is excluded by !**/*.md

📒 Files selected for processing (4)

• burnwatch/client.py
• burnwatch/llm.py
• examples/soft_pause_webhook.py
• tests/test_client.py

[tsouth89]

@coderabbitai review

[coderabbitai]

✅ Action performed

Review finished.

Note: CodeRabbit is an incremental review system and does not re-review already reviewed commits. This command is applicable only when automatic reviews are paused.