Release: Main to build.cloudflare.dev

[AshishKumar4]

Summary

Release PR merging main to release-live for deployment to build.cloudflare.dev. This release includes version 1.4.0 with significant SDK enhancements (retry logic, blueprint parsing, connection state tracking), improved rate limiting with detailed error messages, and updated model configurations.

Changes

SDK Enhancements (/sdk)

• HTTP Retry Logic: Added exponential backoff with jitter for transient failures (5xx errors, network issues)
• Blueprint Utilities: New BlueprintStreamParser for parsing streaming JSON/Markdown blueprints into readable Markdown
• Timeout Utilities: New withTimeout helper for promise timeout handling
• Session State Tracking: Enhanced SessionStateStore with connection states (disconnected, connecting, connected) and file generation progress tracking (filesGenerated, currentFile)
• WebSocket Refactoring: Extracted retry utilities to shared retry.ts module

Worker Improvements (/worker)

• Rate Limiting Enhancements: Added exceededLimit, limitValue, and periodSeconds to RateLimitResult for better error messaging
• Model Configuration Updates: Updated AGENT_CONFIG with new model assignments and fallback configurations
• Inference Handling: Enhanced executeInference with improved model validation and constraint checking

Version Bumps

• Main package: 1.1.0 → 1.4.0
• SDK package: 0.0.2 → 0.0.3

Configuration

• Updated wrangler.jsonc compatibility date

Motivation

This release consolidates multiple features and improvements from the main branch for production deployment, including improved reliability through retry mechanisms and better user feedback through enhanced rate limiting error messages.

Testing

• SDK HTTP retry tests added (sdk/test/http.test.ts)
• Existing test suites should pass
• Manual testing on staging recommended before production rollout

Breaking Changes

None - all changes are backwards compatible.

Related Issues

See CHANGELOG.md for full list of features, bug fixes, and reverts included in v1.4.0.

[github-actions]

Claude finished @AshishKumar4's task in 1m 55s —— View job

---

Code Quality & Security Review

Recommendation: APPROVE

PR Summary

Release PR merging main to release-live (v1.4.0) with SDK enhancements (retry logic, blueprint parsing, connection state tracking), improved rate limiting with detailed error messages, and updated model configurations.

PR Description

• Updated: Yes
• Notes: Generated comprehensive description covering all changes, motivation, and testing notes

Addressed Issues

• See CHANGELOG.md for full feature and bug fix list for v1.4.0

---

Code Quality

Critical: None

High: None

Medium: None

Low:

1. sdk/src/blueprint.ts:62 - The regex in extractJsonStringField doesn't handle escaped quotes within JSON strings (\" sequences). This is acceptable for partial JSON extraction where the goal is graceful degradation, not strict parsing.

2. sdk/src/http.ts:118 - TypeError is used as a proxy for network errors, which is common practice but could theoretically catch other TypeErrors. The implementation is reasonable for SDK usage.

---

Security

Critical: None

High: None

Medium: None

Low: None

The changes reviewed do not introduce security vulnerabilities:

• Rate limit enhancements properly sanitize error messages
• No user input is directly interpolated into sensitive contexts
• Token handling in HttpClient follows secure patterns with proper caching and expiration checks

---

Architecture Review

Positive Observations:

1. DRY Principle Applied - Retry utilities properly extracted to shared sdk/src/retry.ts module, reused by both HTTP client and WebSocket connection
2. Type Safety - All new code follows strict typing with no any usage
3. Consistent Patterns - State management in SessionStateStore follows existing event-driven patterns
4. Good Test Coverage - HTTP retry logic has dedicated tests with edge cases (retries on 5xx, no retry on 4xx, disabled retry)

Model Configuration Changes (worker/agents/inferutils/config.ts):

• Platform config updated to use Gemini 3 Flash Preview for phase implementation
• Default config maintains Gemini 2.5 Flash/Pro as fallbacks
• Changes appear intentional for production optimization

---

Testing

• HTTP Retry Tests: Comprehensive coverage added in sdk/test/http.test.ts
• Recommendation: Run full test suite before deployment (npm test)

---

Final Recommendation

APPROVE - This release PR consolidates well-tested features from main. Code quality is high, follows project conventions, and introduces no security concerns. The SDK enhancements (retry logic, state tracking) improve reliability and observability for SDK consumers.

---

Tasks Completed

• Read CLAUDE.md for project conventions
• Get PR diff and current description
• Update PR description
• Analyze code changes for quality issues
• Check for security vulnerabilities
• Post comprehensive review summary