feat(workflow): opt-in settled result API

[Waishnav]

Summary

• add an opt-in settle(() => operation) workflow primitive
• preserve existing Claude-like defaults: agent() throws, parallel()/pipeline() map failures to null
• return provider-independent { ok, value } | { ok, error: { kind, message, retryable } }
• support wrapping agent() and nested workflow operations without caching failed outcomes as successes
• teach provider fallback and failure-aware fan-out in the Dynamic Workflows skill

Stack

• Base: pr/dw-9-resume-iteration-inspection (PR feat(workflow): script iteration, replay provenance, and call inspection #108)
• Branch: pr/dw-10-settled-results
• This is one of two sibling API experiments. Compare against the thrown-error-contract PR before choosing either approach.

Test plan

• npm run typecheck
• npm test
• npm run build
• git diff --check
• engine tests cover success, normalized provider failure, journaling, and settled branches inside parallel()
• sandbox/script tests cover injection and execution of settle()

[coderabbitai]

Important

Review skipped

Auto reviews are disabled on base/target branches other than the default branch.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Repository UI

Review profile: CHILL

Plan: Pro Plus

Run ID: 8c5f4321-f86c-4b89-9c97-425c3133a929

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch pr/dw-10-settled-results

---

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.}