Packages

@flue/sdk

2.3.1 · 18 Nov 2026Apache-2.0309.1k / weekRepositoryHomepagenpmAtom feed

Your version

2.0.1

1 Aug 2026Where it was published

2.3.1 is the newest release of 2.x.

In short

2 fixed

Release note

Fixes & Other Changes

  • Reasoning effort sent through the Workers AI binding's Responses wire format is now clamped to the /run endpoint's none|low|medium|high ceiling. A gateway model whose catalog maps the xhigh/max thinking levels verbatim (for example openai/gpt-5.6-luna) previously hard-400ed after admission for a thinking level Flue itself accepts — those catalog mappings are written for the model's own API, which does accept them over the HTTP gateway path; the ceiling is the binding transport's, and the chat-completions path already applied it. The emitted effort now always comes from the catalog's own low/medium/high mappings (#544).

  • A durable submission can no longer sit unsettled forever behind a hung await. On Cloudflare the wake handler previously both executed and supervised — it awaited every attempt, so one stalled model stream or sandbox RPC wedged the only loop that evaluates durability timeouts, and a backstop alarm firing mid-drain was silently consumed without re-arming. The coordinator now separates the roles: supervisor passes run bounded and storage-only (arming their successor heartbeat before any failable work, so no pass failure breaks the wake chain), and attempt fibers run detached, settling their own submissions. Deadline enforcement is structural on both targets: each pass fires the attempt's abort controller at timeoutAt (or on an unhonored durable abort) so signal-aware awaits unwind through the normal settle paths, and once the first signal outlives a 60-second grace the pass force-settles the submission over the hung fiber, orphaning it — the Node coordinator gets the same sweep from its lease scan, whose expired-lease branch was previously unreachable while a live process renewed a hung attempt's lease forever. A new FlueEvent operation, enforce_deadline, marks the signaled grace window and the force; the per-drain attempt cap is retired as vestigial (#538).

  • The awaits that could stall an attempt now bound themselves, so a stall recovers in seconds-to-minutes instead of failing at the durability deadline. Model streams on the Workers AI binding provider get an idle deadline: a chunk gap past the cap fails the read as a retryable interruption — the exact reported shape, a 200 that never speaks again, becomes a retried turn under the transient-error budget. The default is 5 minutes (long-thinking models can be legitimately silent), configurable per provider via streamIdleTimeoutMs, with 0 disabling it, and the timer only runs while a source read is outstanding so consumer backpressure never trips it. GatewayOptions.requestTimeoutMs — previously declared but never sent — is now emitted as the cf-aig-request-timeout header, a gateway-enforced bound on time to first response. Tools are abandoned on abort: every tool run races the attempt signal, so a signal-deaf tool (a sandbox file operation with no abort plumbing) rejects at abort instead of wedging the turn past every deadline, under the same orphaned-work contract as an orphaned exec (#538).

  • Settlement events no longer vanish in an invocation's final moments. observe() subscriber deliveries were fire-and-forget on the emit path, so a submission_settled emitted late in a Cloudflare alarm invocation could be torn down mid-POST before a host's bridge saw it; in-flight deliveries are now handed to the platform at every invocation boundary (emission still never awaits subscribers). And a settlement reservation refused while its row stays unsettled — the class that used to loop the heartbeat with completely empty logs — now writes a structured error log and publishes a submission_recovery event on every occurrence, so the condition alerts at wake cadence instead of staying invisible (#538).

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.