Skip to content

Extract Citations and Scout toolkit packages - #17

Open
miguelenes wants to merge 3 commits into
shipfastlabs:mainfrom
miguelenes:extract-citations-and-scout
Open

Extract Citations and Scout toolkit packages#17
miguelenes wants to merge 3 commits into
shipfastlabs:mainfrom
miguelenes:extract-citations-and-scout

Conversation

@miguelenes

Copy link
Copy Markdown
Contributor

Summary

  • New src/Citations package with CitationValidator + Citations::all().
  • New src/Scout package with ScoutSearch + Scout::all().
  • Both read config from ai.toolkit.* and ship no config files/providers.

Citations

Generalized from an app-level article citation validator. Entity types, roles, and the token regex are configurable under ai.toolkit.citations.* instead of being hardcoded to catalog tag/category/performer shapes.

Scout

Allow-listed Scout search over configured model aliases. This package depends on laravel/scout in addition to laravel/ai. Please confirm that extra dependency is acceptable for the catalog; if not, we can drop Scout and keep Citations only.

Depends on

Please also merge #15 (laravel/ai constraint widen).

Labels

Please apply new-tool.

Test plan

  • composer test green (pint + rector + phpstan max + 100% type/code coverage)
  • 378 tests passing

Made with Cursor

miguelenes and others added 3 commits August 7, 2026 09:44
Consumers on laravel/ai 0.10 cannot install any toolkit package today
because every composer.json pins ^0.7. The Tool contract, Strict
attribute, Request accessors, and JsonSchema surface used by these
tools are unchanged in 0.10, and the full suite stays green after the
bump.

Co-authored-by: Cursor <cursoragent@cursor.com>
Introduces shipfastlabs/toolkit-brave with BraveSearch (GET
/res/v1/web/search via X-Subscription-Token) and a Brave::all()
registry. Credentials live in services.brave.key; defaults under
ai.toolkit.brave.search.*. News/image/local endpoints are deferred.

Co-authored-by: Cursor <cursoragent@cursor.com>
CitationValidator generalizes article citation checks behind
ai.toolkit.citations.* allow-lists. ScoutSearch provides allow-listed
Laravel Scout lookups; it depends on laravel/scout in addition to
laravel/ai and needs maintainer buy-in before release.

Co-authored-by: Cursor <cursoragent@cursor.com>
@vercel

vercel Bot commented Aug 7, 2026

Copy link
Copy Markdown

@miguelenes is attempting to deploy a commit to the Pushpak Chhajed's projects Team on Vercel.

A member of the Team first needs to authorize it.

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.

1 participant