SDK correctness and resilience improvements

[PastelStorm]

Note

Medium Risk
Touches core split-PDF execution and retry/timeout cleanup logic; mistakes could impact partition reliability or leak resources, though changes are well-covered by expanded unit/integration tests and logging.

Overview
Improves split-PDF correctness and debuggability by adding operation-aware observability (plan/batch/chunk lifecycle logs) and propagating split metadata via X-Unstructured-Split-* headers into errors/logs.

Hardens split execution: per-operation state is isolated, transport exceptions/cancellations are handled explicitly (with optional partial-results behavior via split_pdf_allow_failed), and timeout/cleanup paths now safely cancel in-flight work even when event loops are closed.

Preserves chunk-level transport retries by deriving a split-specific retry config that always retries httpx.TransportError for chunk calls, even when SDK-level connection retries are disabled. CI/test tooling is updated (new platform integration job/target, more verbose integration output, and bumped GitHub Action versions), and the package is released as 0.43.1.

^{Reviewed by Cursor Bugbot for commit e65ce5b. Bugbot is set up for automated code reviews on this repo. Configure here.}

[socket-security]

Review the following changes in direct dependencies. Learn more about Socket for GitHub.

Diff	Package	Supply Chain Security	Vulnerability	Quality	Maintenance	License
	github/​actions/​setup-python@​a26af69be951a213d495a4c3e4e4022e16d87065 ⏵ e797f83bcb11b83ae66e0230d6156d7c80228e7c	+1
	github/​astral-sh/​setup-uv@​d0d8abe699bfb85fec6de9f7adb5ae17292296ff ⏵ 0ca8f610542aa7f4acaf39e65cf4eb3c35091883
	github/​actions/​checkout@​93cb6efe18208431cddfb8368fd83d5badbf9bfd

View full report

[cursor]

Cursor Bugbot has reviewed your changes and found 1 potential issue.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

^{Reviewed by Cursor Bugbot for commit e65ce5b. Configure here.}

[cursor]

Unreachable ChunkExecutionError branch in allow-failed path

Low Severity

In run_tasks, when allow_failed=True, the isinstance(result, ChunkExecutionError) check is unreachable dead code. ChunkExecutionError is only raised by _order_keeper, which wraps coroutines — but _order_keeper is exclusively used in the allow_failed=False path (via asyncio.create_task(_order_keeper(...))). In the allow_failed=True path, armed_coroutines are gathered directly without _order_keeper, so exceptions will always be raw BaseException subclasses, never ChunkExecutionError. The subsequent elif isinstance(result, BaseException) branch handles all cases correctly, making the ChunkExecutionError branch dead code that adds unnecessary complexity.

Additional Locations (1)

• src/unstructured_client/_hooks/custom/split_pdf_hook.py#L186-L188

 

^{Reviewed by Cursor Bugbot for commit e65ce5b. Configure here.}