Skip to content

Laravel AI SDK integration, package icon & banner - #13

Merged
yannelli merged 3 commits into
mainfrom
feat/laravel-ai-integration
Jul 30, 2026
Merged

Laravel AI SDK integration, package icon & banner#13
yannelli merged 3 commits into
mainfrom
feat/laravel-ai-integration

Conversation

@yannelli

Copy link
Copy Markdown
Owner

What's new

Laravel AI SDK integration

  • Attempt::ai() — an AttemptBuilder preconfigured with AiRetryPolicy for transient AI failures (rate limits, provider overload, connection errors, HTTP 408/429/5xx)
  • Permanent failures (insufficient credits, unknown tools, ordinary 4xx) are not retried
  • Honors Retry-After (seconds and HTTP-date, capped at 30s), falls back to decorrelated jitter
  • RetryAiRequests agent middleware retries each provider before the SDK's native failover kicks in, then rethrows so failover proceeds
  • laravel/ai stays optional: require-dev + Composer suggest, no runtime hard dependency
  • README documents usage and retry-safety caveats

Branding

  • New angular "A" package icon (art/icon*.png, 64–1024px)
  • New 1280×640 hero banner (art/banner.png), wired into the README header
  • /art is export-ignored, so dist installs stay lean

Verification

  • 205 tests passed (403 assertions) via Pest
  • Pint clean
  • composer validate clean

ampagent and others added 3 commits July 30, 2026 19:15
- Attempt::ai() creates a builder pre-tuned for AI requests: retries only
  transient failures (rate limits, provider overload, connection errors,
  408/429/5xx) and honors provider Retry-After hints, falling back to
  decorrelated jitter delays.
- RetryAiRequests agent middleware retries each provider before the SDK
  fails over to the next, re-throwing the original exception so failover
  proceeds normally.
- laravel/ai is an optional (suggested) dependency; the policy degrades
  gracefully when it is not installed.

Amp-Thread-ID: https://ampcode.com/threads/T-019fb466-002d-775a-8cdd-8404fc4d0e18
Co-authored-by: Ryan Yannelli <ryanyannelli@gmail.com>
Amp-Thread-ID: https://ampcode.com/threads/T-019fb466-002d-775a-8cdd-8404fc4d0e18
Co-authored-by: Ryan Yannelli <ryanyannelli@gmail.com>
Amp-Thread-ID: https://ampcode.com/threads/T-019fb466-002d-775a-8cdd-8404fc4d0e18
Co-authored-by: Ryan Yannelli <ryanyannelli@gmail.com>
@yannelli
yannelli merged commit 89f6ea2 into main Jul 30, 2026
10 checks passed
@yannelli
yannelli deleted the feat/laravel-ai-integration branch July 30, 2026 23:34
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants