Repository navigation
Hashbrown 0.8.0
🧭 Migrating from 0.7
0.8 is a breaking release, and client and server must upgrade together: the Hashbrown run-input extension moves to forwardedProps.hashbrown, few-shot UI examples and the prompt template are removed, the OpenAI and Azure adapters move to the Responses API, and activities join the message list. Read the step-by-step guide for React or Angular, which includes a prompt you can hand to an AI coding assistant.
⚠️ Breaking Changes
- the Hashbrown run-input extension (
responseSchema,ui) moves from a top-levelhashbrownkey toforwardedProps.hashbrown, AG-UI's pass-through extension point; the client sends only the new shape and every adapter, both local transports and the conformance endpoint read only it, so a server that readsinput.hashbrownmust readinput.forwardedProps.hashbrown(#659, #661) - few-shot UI examples are removed: the
prompttagged template and its<ui>blocks, theSystemPrompt,HBTree,PromptDiagnostic,PromptDiagnosticCodeandPromptDiagnosticSeveritytypes, and everyexamplesoption (UI kits,useUiChat/useUiCompletion,uiChatResource/uiCompletionResource,createUiJsonSchema);systemis a plain string, and guidance moves into component and prop descriptions (#662) - openai, azure: the adapters stream from the Responses API instead of Chat Completions:
transformRequestOptionsreceivesResponseCreateParamsStreaming, Chat Completions-only servers are no longer supported, reasoning models get reasoning summaries by default (reasoning: falseturns them off), every request sendsstore: false, Azure'sclientOptions.deploymentis removed in favour ofmodel, and theopenaipeer dependency rises to^6.45.0(#667) Chat.Messagegains anActivityMessagevariant (role: 'activity') for AG-UI activities, and user and assistant messages carry a stableid; code that switches exhaustively onroleor compares whole messages needs updating (#669)- core: package
importssupport is required; upgrade older bundlers and test runners before installing v0.8. - openai, azure: incomplete responses finish with their partial answer and
lastRunFinishReasoninstead of raisingRUN_ERROR; check forlengthorcontent_filter(#690).
🚀 Features
- decisions: typed decision models over plain JSON, with per-option enumeration descriptions,
useDecision/decisionResource, UI selection withuseUiDecision/uiDecisionResource/hb-ui-decision(including chat-mode narrowing of an existing chat),createSelectionSchemato pin selection questions on a server, and the new@hashbrownai/typesafeadapter for TypeSafe Jev (#656, #664, #666) - core: decisions in agents: public
decodeDecision, andAgentRunError, which keeps aRUN_ERRORevent'scode(#665) - UI kits take
selectable: falseso their members remain available every turn and are excluded from selection questions (#670) - AG-UI activities:
ACTIVITY_*events become activity messages linked to their run, message and tool call,groupTurnsgroups a transcript into turns, and provider adapters take anactivitiescallback (#669) - openai, azure: reasoning summaries and stateless encrypted-reasoning replay on the Responses API (#667)
- core:
lastRunResultexposes AG-UI'sRUN_FINISHED.resultonChatRuntime, the React chat, completion and UI hooks and every Angular chat and completion resource; it is cleared when the next run starts and never set by interrupted, cancelled or failed runs;JsonValuebecomes a public core type (#655) - core:
markdownComponent, so a server can pin the full UI response schema (#654) - all six generative provider adapters report normalized finish reasons and available token usage through
lastRunFinishReasonandlastRunUsageon core, React, and Angular APIs; values describe the last completed run, not an entire tool-call turn (#690). - openai, azure: enable provider-run web search with
builtInTools.webSearch, with queries, sources, and answer citations (#691). - core: read
b4.stepmetadata and custom events intoserverToolCalls, exposing labels, outcomes, errors, timing, sources, and nested calls; assistant messages expose citations, sources, and required attribution (#691).
🩹 Fixes
-
core: preserve provider metadata and queued labels and sources in tool-step updates, normalize unknown statuses, and clear held steps when a run ends; verified against the shared B4 fixture corpus (#708, #709).
-
react, angular: component changes update the UI response schema, preserve earlier answers, and use the newest definition for a component name; Angular UI chat resources expose
componentsandsetComponents(#666). -
anthropic: accept thinking blocks interleaved with text and tool use (#684).
-
bedrock: combine parallel tool results into one user turn and keep server tool use from being dispatched as a client tool call (#684).
-
google: preserve function-call thought signatures when a signature-only part follows (#684).
-
openai, azure, ollama: return client tool errors to the model instead of dropping them (#684).
-
azure: support
reasoning: truefor deployments with custom names (#684). -
core: a
RUN_FINISHEDwithoutcome: { type: 'cancelled' }settles the run as cancelled, rolled back like a local stop with no retry and no error, instead of raising a protocol error (#653) -
core: activity messages are removed from AG-UI run input, as the spec requires (#668)
-
core: keep QuickJS types out of the public declarations (#637)
-
typesafe: a score's value is its most probable level, request size caps fit Jev, and errors carry the vendor's error type (#658, #660)
📖 Documentation
- Refresh the atc example and provide paired React and Angular examples throughout the v0.8 release post and migration guides.
❤️ Thank You
- Brian Love @blove
- Manfred Steyer — activity snapshot capabilities