Packages

@flue/sdk

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

Upgrading @flue/sdk From 0.10.0 to 0.11.1

4 releases in betweenevery note read

Other targets from 0.10.0Latest2.3.1
  1. 0.10.0yours
  2. 0.10.1
  3. 0.10.2breaking
  4. 0.11.0major
  5. 0.11.1target

Before you upgrade

Tick each one off as you go
  • Breaking0.10.2
  • Breaking0.10.2
  • Breaking0.10.2
  • Breaking0.10.2
  • Breaking0.10.2

Release by release

  1. 0.11.1

    11 Jun 20261 new · 2 fixes
    • New

      Direct agent HTTP requests and @flue/sdk prompts can include images with up to 14 MiB of encoded data per image. Node and Cloudflare SQLite persistence stores image data in safe chunks and restores it for future turns and after restarts.

    • Fixed

      The grep tool now uses ripgrep when available, falls back to grep, treats patterns as extended regular expressions by default, and supports literal matching.

    • Fixed

      SQL-backed sessions now store each history entry in its own row instead of rewriting the entire session history as one JSON value. Session saves remain transactional and preserve ordered history across Cloudflare Durable Object SQLite, Node SQLite, and PostgreSQL.

  2. 0.11.0

    10 Jun 20261 new · 2 fixes
    • New

      flue docs browses the documentation offline. The docs markdown already shipped inside @flue/cli is now reachable from the command line: flue docs lists every page, flue docs read <path> prints one page as Markdown, and flue docs search <query> prints ranked JSON results. Content requires no network access and always matches the installed CLI version. Designed for coding agents (search → read), per Documentation.

    • Fixed

      Runtime events no longer carry raw image bytes (#221). Image content blocks in session events (message_*, turn_request, turn_end, agent_end, tool_call) keep their mimeType but have data replaced with the exported IMAGE_DATA_OMITTED sentinel before events reach observers and persisted run history. Model context and persisted session history retain the real bytes. Events persisted before this change are unaffected.

    • Fixed
  3. 0.10.2

    Migration needed10 Jun 20262 new · 6 fixes
    • Breaking

      Durable Streams protocol replaces WebSocket and SSE transports. Agent instances and workflow runs are now URL-addressable durable event streams. Clients consume events via DS-compliant GET (catch-up, long-poll, SSE) with automatic offset-based reconnection. POST /agents/:name/:id now returns 202 { streamUrl, offset }; add ?wait=result for 200 { result, streamUrl, offset }. GET /agents/:name/:id reads the event stream. GET /runs/:runId replaces both /runs/:runId/events and /runs/:runId/stream. WebSocket transport, AgentSocket, WorkflowSocket, and all socket-related types are removed from @flue/runtime and @flue/sdk.

    • Breaking

      Named sessions removed from agent public API. The session parameter is removed from prompt submission, dispatch, SDK, and CLI. Agent instances always use the "default" session internally. An agent instance is now a single conversation with a single event stream.

    • Breaking

      SDK rewritten with @durable-streams/client. @flue/sdk now exports agents.prompt(), agents.send(), agents.stream(), runs.stream(), runs.events(), and workflows.invoke(). agents.prompt() waits for the result; agents.send() returns stream coordinates immediately. FlueEventStream<T> wraps the DS client's jsonStream() as an async iterable with cancel() and offset support.

    • Breaking

      connectEventStreamStore() is now required on PersistenceAdapter. Custom adapters must implement this method and provide durable event-stream storage. The built-in sqlite() and @flue/postgres adapters provide implementations.

  4. 0.10.1

    8 Jun 20261 new · 4 fixes
    • New

      Added deleted_classes and renamed_classes migration examples to the Cloudflare target documentation (#203).

    • Fixed

      Fixed generated Node and Cloudflare app entrypoints by avoiding collisions with application-owned app bindings.

    • Fixed
    • Fixed

      Fixed docs search dialog throwing InvalidStateError when Cmd/Ctrl+K is pressed while already open (#214).

    • Fixed

      Fixed SSE parser missing frame boundaries when CRLF is split across stream chunks or when using CR-only line endings (#216).

1 internal line (docs, tests, tooling) left out.

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.