@flue/sdk
2.3.1 · 18 Nov 2026Apache-2.0309.1k / weekRepositoryHomepagenpmAtom feed
Upgrading @flue/sdk From 2.0.1 to 2.0.2
1 release in betweenevery note read
- 0
- changes to make
- 0
- advisories fixed
- 0
- new
- 5
- fixes
Release by release
- Fixed
Conditional tool additions are now cache-safe on models with deferred tool loading. A tool mounted by the rerender that follows a settled tool batch is anchored to that batch's final tool result, so current first-party Anthropic models (Claude 4.5 and later, excluding Haiku) keep the added definition out of the cached prompt prefix instead of invalidating it; other providers ignore the anchor and their requests are unchanged. The anchor persists with the run and is restored on rehydration, so a rehydrated context matches the live loop exactly (the internal reduced-state format counter bumps to 2). The Tools guide now states the actual cache contract: tool-set changes rewrite the native tools array and invalidate the provider prompt cache, except additions unlocked by a completed tool call on the models above (#545).
- Fixed
The
cloudflare-shellblueprint is replaced bycloudflare-computer, built on@cloudflare/computer— the successor to@cloudflare/shellthat hosts a durable SQLite-backed workspace in the agent's own Durable Object with ajust-bashshell backend, and can escalate to a container backend where a JavaScript shell isn't enough. The adapter provides a realexec()and keeps the framework's standard tool set instead of substituting a code tool.flue add cloudflare-shelland the old docs URLs redirect to the successor. - Fixed
Cloudflare trace spans whose terminal event never arrives (their operation orphaned by deadline force-settlement or recovery) are force-closed when the submission settles, so the run's
invoke_agentroot span no longer vanishes from the trace. Forced closes carry aflue.span.forced_closeattribute, and span-close failures are reported instead of swallowed. - Fixed
The sandbox types are renamed to match their roles; the old names remain as deprecated aliases.
SessionEnv→Sandbox(the live environment handle behindharness.sandboxand the standard tools),SandboxApi→SandboxDriver(the per-provider interface a sandbox adapter implements),createSandboxSessionEnv()→sandboxFromDriver(),SessionToolFactory/SessionToolFactoryOptions→SandboxToolFactory/SandboxToolFactoryOptions, andSandboxFactory.createSessionEnv()→createSandbox(). No action is required: the old type names andcreateSandboxSessionEnvare exported as deprecated aliases, and a factory implementing only the legacycreateSessionEnv()method still initializes (with a one-time deprecation warning). Blueprints, examples, and docs emit the new names. - Fixed
New docs reference page: Agent Behavior — the out-of-the-box runtime contract in one place: the built-in tools' parameters and truncation limits, environment defaults, message admission and turn-boundary joining, context composition and compaction, and the enforced limits.
- Fixed
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.