Sync upstream updates: sub-agent tool failures, Scout PostgreSQL full-text search and head Open Graph defaults
Merged
BI
8h ago+3341+3341+0123456789012345678901234567890123456789-482-482-012345678901234567890123456789
Upstream Updates
- laravel/ai#1223 — Run a failed broadcast agent's catch callbacks even when broadcasting the "stream_failed" event throws.
- laravel/ai#1226 — Let the moderation provider option override the "low" default for OpenAI gpt-image generations and edits and Azure OpenAI generations.
- laravel/ai#1228 — Handle a sub-agent that throws like any other failed tool call. The tool loop dispatches ToolFailed, reports the exception and gives the parent a failed tool result, hiding the message outside debug mode. Cancellation is never turned into a tool failure, and Hypervel's concurrent streamed tool calls recover the same way. The sub-agent docs point to the tool failure docs.
- laravel/ai#1189 — Continue stored Gemini interactions: with the store provider option, the next step sends previous_interaction_id and only the new function results.
- laravel/ai#1229 — Generate conversation titles with ConversationTitleAgent, resolved from the container so apps can bind their own, and fake it when the conversation's agent is faked, so titles don't use the agent's fake responses. The docs cover the title agent, titling conversations an app creates, binding a replacement and title fakes.
- laravel/ai#1213 — Reuse the Anthropic code execution container across tool loop steps unless provider options set one.
- laravel/scout#1016, laravel/docs@4cfebfe805 — Add native PostgreSQL full-text search to the Scout database engine: stored tsvector columns, tsquery modes including raw tsquery, language and ranking options, and pg_trgm trigram matching as a fallback or blended into the results. Options come from the SearchUsingFullText attribute and can be overridden per query. The searchable() and dropSearchable() Blueprint macros add or drop a generated, weighted tsvector column with its indexes. Hypervel binds the language as a parameter and caches the pg_trgm check on the engine and the attribute options per model.
- laravel/scout#1023 — Wrap Typesense filter values that contain &&, ||, parentheses, commas or backticks in backticks, removing any backticks from the value. Array where values are raw filter expressions again, so geo filters reach Typesense as location:(...) instead of the location:=(...) Typesense rejects.
- laravel/scout#1026 — Add the SearchableAs attribute for setting a model's index name. The name gets scout.prefix like the table name, and child models inherit it. A cached attribute check skips reflection for models without it, and the Scout docs show the attribute.
- laravel/wayfinder#329 — Collapse a generated function's multi-line arguments onto one line when an argument type contains parentheses, such as import('@/types').Key<...>.
- laravel/wayfinder#330 — Test the generated QUERY method on Route::redirect() routes, which register every verb. Hypervel already generated it.
- laravel/head#15 — Event::location() takes only a schema object, as merged upstream. Hypervel had ported the draft, which turned a string into a bare Place, but Google requires an address for a physical location. Online events pass a VirtualLocation.
- laravel/head#16 — Combine default Open Graph media from several defaults() calls instead of keeping only the last call's. Media a route, page or error defines still replaces it, and runtime default media still replaces registered default media, as the runtime defaults docs promise.
- laravel/head#17 — Add the protected currentContainer() extension point that state() and request() resolve through. It returns the injected container: a Hypervel worker keeps one container and scopes head state per coroutine, so upstream's per-request container lookup isn't needed.
- laravel/head#14 — Remove the og:url fallback from the head README's differences, since upstream now falls back to the canonical URL as Hypervel already did.
- laravel/docs#11431 — Name Mailtrap Email Sandbox in the mail docs' local development section.
- laravel/docs#11456 — Warn that Blade escapes HTML but not Markdown, so user input can inject Markdown into a Markdown mailable, and show Markdown::withSecuredEncoding().
- laravel/docs#11434 — Document afterQuery() callbacks. The example hides an attribute with makeHidden() instead of setting a new property, which would make each model dirty, and the local scope suggestion is left out because pluck() passes the plucked values to the callback.
- laravel/docs#11435 — Replace the Preferred Value Ordering section with upstream's Sequence Ordering section for inOrderOf().
- laravel/docs#11438 — Note that Fortify adds throttle middleware to its login route when a login rate limiter is configured.
- laravel/docs#11445 — Correct what a streamed parent response includes from its sub-agents. Sub-agent usage comes from the AgentStreamed event, or AgentPrompted for a sub-agent with structured output, which doesn't stream.
- laravel/docs#11421 — Link the MCP Security Best Practices guide.
- laravel/docs@4cfebfe805 — Replace the MCP structured content paragraph with upstream's assertion section and table.
- laravel/docs#11447 — Add a PHP requirements section to the deployment docs that links to the installation requirements instead of keeping its own list, which had drifted.
- laravel/docs#11450 — Document HtmlString for unescaped Blade output.
- laravel/docs#11454 — Use upstream's wording for inserting global and group middleware with insertBefore() and insertAfter().
- laravel/docs#11458 — Say that bearerToken() returns null when the request has no bearer token.
Additional Hypervel changes
- Stop continuing a provider-stored response after step middleware edits a step's messages, for Gemini, OpenAI and xAI. The provider stored the edited history, which later steps must not inherit.
- Keep the Anthropic container's continuation token when a step changes its history, model or instructions. Upstream dropped it, so a second-step withInstructions() opened a new container and lost its files.
- Pass the provider instance to the conversation title agent, so a provider created on demand keeps its credentials, and resolve the title agent inside the title fallback, so a failing binding doesn't lose the completed turn.
- Keep simple pagination of Scout PostgreSQL searches on full-text results. Upstream switched to trigram matching on an empty later page while full-text search had matches, mixing two result sets.
- Keep explicit operators on Typesense array where values. Upstream dropped them, so a != filter became a positive match.
- Keep rows with a null column in PostgreSQL multi-column whereFullText() searches and Scout expression searches. Each column's vector is wrapped in coalesce(..., ''::tsvector), and multi-column full-text indexes use the same expression so searches can use them. The porting guide notes that existing multi-column full-text indexes must be recreated.
- Read the columns that Scout's searchable() macro and nested set's schema macros add and drop in PHPStan's migration reader, so models on those tables keep typed attributes. An application macro with the same name stays unknown, and replacing a macro invalidates the migration cache.
- Add the PHP extensions that hypervel/framework's packages and dependencies require to the installation requirements: Ctype, DOM, iconv, libxml, PCRE, SimpleXML and Sockets.
[!NOTE]
Sync upstream: sub-agent tool failure handling, Scout PostgreSQL full-text search, and Open Graph default media
- Sub-agent failures now propagate as
ToolExecutionException from AgentTool and are converted to failed ToolResult values in TextGenerationLoop.streamedAgentToolResult(), so parent runs continue with a failed tool result and ToolFailed/AgentFailed events; the generic error message is used outside debug mode
- Adds Scout PostgreSQL full-text search with stored
tsvector columns: SearchableSchema registers searchable/dropSearchable Blueprint macros plus GIN and trigram indexes, and DatabaseEngine supports stored vectors, weighted ranking (ts_rank/ts_rank_cd), and trigram fallback/blend modes when a search returns no rows
- Adds
ConversationTitleAgent and uses it in RememberConversation.generateTitle(), replacing the inline AnonymousAgent prompt; fake-gateway agents now propagate faking to the title agent
- Open Graph media from multiple
defaults calls now merges via the defaults flag in OpenGraph.overlayOn(), and HeadManager.resolve() marks the merged result as defaults
- Gemini and Anthropic gateways carry continuation tokens (interaction IDs and code-execution containers) across steps; gateways implementing the new
ReplaysFullHistory marker keep tokens even when middleware edits history
- Risk:
Event.location() no longer accepts strings (schema objects only), multi-column PostgreSQL full-text indexes created by older grammar no longer match queries and need recreation, and Markdown secured encoding now also escapes ampersands and quotes
Macroscope summarized 2c6b923.
Summary by CodeRabbit
- New Features
- Added PostgreSQL Scout search with stored full-text vectors, configurable ranking, and trigram matching and fallback.
- Added model-level search index naming and configurable image-generation moderation.
- AI conversations can generate concise titles, and supported providers can reuse continuation data between steps.
- Bug Fixes
- PostgreSQL multi-column full-text searches now match rows with null values.
- Search filters handle special characters more reliably; sub-agent failures are recorded consistently.
- Documentation
- Expanded guidance for search, middleware, queries, deployment requirements, and other framework features.