@flue/runtime
2.3.1 · 18 Nov 2026Apache-2.0524.4k / weekRepositoryHomepagenpmAtom feed
2.3.1 is the newest release of 2.x.
In short
4 new1 fixed
Release note
Minor Changes
Add bounded conversation history reads so long-running chats no longer transfer the whole transcript on every page load or reconnect.
client.history({ limit })reads only the newest messages. The snapshot keeps the headoffset, theincarnation, and every settlement, and adds abeforecursor.client.historyBefore(cursor, { limit })reads older messages one page at a time. The page size is required.client.observe({ limit })hydrates only the newest messages, then grows forward with live updates. Rehydration after a reconnect reads from the window's oldest message, so no gap opens. The runtime cutsconversation-resetsnapshots to the same window. The observed state'sbeforecursor feedshistoryBefore(), and a changed cursor means the window re-based.A window never cuts out a message that can still receive live updates, such as a response still streaming above messages delivered after it. It may hold more than
limitmessages.Cursors are opaque and bound to one stream generation. After the stream is reset and regrown, reads with an old cursor are rejected with
history_cursor_not_found(410), even when message ids repeat, andobserve()re-bases.readSubmissionReply()now requiressettlements, so history pages are not accepted. It falls back to the latest assistant message only on a complete conversation, never on a bounded window where that message may belong to another submission.
Unbounded reads are unchanged.
@flue/reactstill observes the whole conversation.Support document attachments (PDFs) on user messages.
DeliveredAttachmentis now a union of image and document attachments —{ type: 'document', data, mimeType: 'application/pdf', filename? }— accepted ondispatch(), theinit()handle, and direct HTTP prompts.session.prompt(),skill(), andtask()gain adocumentsoption alongsideimages, and@flue/react'ssendMessage()gains adocumentsoption. Documents are forwarded to the model as native document content: Anthropicdocumentblocks, OpenAI (and Azure OpenAI) Responsesinput_fileparts, and GoogleinlineData. On other model APIs the document is replaced in model context with a text placeholder saying it was omitted. Documents are stored like images — as canonical attachments projected asfileparts withmediaType: 'application/pdf'— so existing conversations and persistence adapters need no migration. The SDK also exportsDeliveredImageAttachmentandDeliveredDocumentAttachment.Conversation messages now carry a server-authored
timestamp(ISO 8601 capture time of the underlying durable record) inhistory(),observe(), anduseFlueAgent. It works for every role and for existing conversations.metadataremains entirely agent-authored. Conversation settlements carry the sametimestampfor when the submission settled.
Patch Changes
Fix Cloudflare-routed Anthropic models (
cloudflare/anthropic/*) failing withbetas: Extra inputs are not permittedwhenever the agent had tools. Anthropic beta features are now sent in theanthropic-betarequest header instead of the request body.Adds support for GPT-6 Sol, GPT-6 Luna, and Claude Opus 5.5. Flue now uses Pi 0.87.1, so you can pass these models to
useModel()without extra configuration. The model list athttps://flueframework.com/models.jsonalso includes them now. There are no public API changes.
A whole project to check? Paste its package.json in the dependency check: every deprecated, outdated or vulnerable dependency, with what to upgrade to. Free, no account.