@flue/sdk
2.3.1 · 18 Nov 2026Apache-2.0309.1k / weekRepositoryHomepagenpmAtom feed
0.11.1 is the newest release of 0.8.x.
In short
5 breaking5 new2 fixed
- Breaking
Applications must adopt the agent/workflow split. Move one-shot request/result modules from
agents/toworkflows/; long-lived agent modules now default-exportcreateAgent(...). Workflows create harnesses withinit(agent)rather than inlineinit({ ... })configuration. - Breaking
Routing and run semantics changed. Public HTTP and WebSocket exposure is declared through
routeandwebsocketmiddleware exports. Runs,/runs, andflue logsnow describe workflows only; direct or dispatched agent interactions correlate by instance, session, operation, anddispatchIdinstead ofrunId. - Breaking
Roles and older agent definitions were replaced. Migrate roles and
task({ role })to nameddefineAgentProfile(...)subagents andtask({ agent }); migrate reusable agent definitions to profiles andToolDefimports toToolDefinition. - Breaking
Build and Cloudflare configuration changed. Node and Cloudflare builds now use a shared Vite graph; Cloudflare development follows
.dev.vars/.envandCLOUDFLARE_ENVconventions. Cloudflare workflows now receive per-workflow Durable Object bindings, so review generated Wrangler configuration when upgrading. - Breaking
Cloudflare Shell is connector-owned. Install it with
flue add @cloudflare/shelland import its workspace sandbox helpers from the generated connector rather than@flue/runtime/cloudflare.
Release note
This is a large pre-1.0 release that establishes Flue's model for building persistent agents and finite workflows. Rather than cataloging every intermediate beta change, this entry highlights the final APIs and the most important upgrade work. For guides and API reference, see the documentation.
New Features
Distinct agents and workflows. Files in
agents/now define persistent, addressable agent instances withcreateAgent(...); files inworkflows/define finite executions withrun(...). Agents maintain sessions across direct interactions and dispatched inputs, while workflows own persisted runs and results.Message-driven and live application surfaces. Agents support direct HTTP prompts, asynchronous
dispatch(...), and WebSocket conversations. Workflows support HTTP and WebSocket invocation, and@flue/sdknow includes typed clients for connecting to deployed Flue applications.Composable agent capabilities.
createAgent(...),defineAgentProfile(...),defineTool(...), and named subagents provide explicit reusable building blocks for model configuration, runtime resources, tools, skills, and delegation.Packaged Agent Skills and Markdown imports. Applications can import
SKILL.mddependencies as validatedSkillReferencevalues, bundle their supporting files for Node or Cloudflare, and import attributed Markdown through the shared Vite build pipeline.Observability and integrations. Public model-turn telemetry enables tracing integrations such as the new Braintrust example. This release also adds a documentation app and examples for Chat SDK, Node WebSockets, Cloudflare WebSockets, and imported skills.
Breaking Changes
- Breaking
Applications must adopt the agent/workflow split. Move one-shot request/result modules from
agents/toworkflows/; long-lived agent modules now default-exportcreateAgent(...). Workflows create harnesses withinit(agent)rather than inlineinit({ ... })configuration. - Breaking
Routing and run semantics changed. Public HTTP and WebSocket exposure is declared through
routeandwebsocketmiddleware exports. Runs,/runs, andflue logsnow describe workflows only; direct or dispatched agent interactions correlate by instance, session, operation, anddispatchIdinstead ofrunId. - Breaking
Roles and older agent definitions were replaced. Migrate roles and
task({ role })to nameddefineAgentProfile(...)subagents andtask({ agent }); migrate reusable agent definitions to profiles andToolDefimports toToolDefinition. - Breaking
Build and Cloudflare configuration changed. Node and Cloudflare builds now use a shared Vite graph; Cloudflare development follows
.dev.vars/.envandCLOUDFLARE_ENVconventions. Cloudflare workflows now receive per-workflow Durable Object bindings, so review generated Wrangler configuration when upgrading. - Breaking
Cloudflare Shell is connector-owned. Install it with
flue add @cloudflare/shelland import its workspace sandbox helpers from the generated connector rather than@flue/runtime/cloudflare.
Fixes & Other Changes
Improved durability and retry handling for Cloudflare workflow admission and interrupted direct agent prompts, preserved authored Cloudflare environment configuration during Vite builds, and reduced Workers AI streaming parse overhead.
Fixed model-invoked subagent task execution and expanded migrated examples and documentation for the new application model.
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.