Packages

@flue/cli

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

Upgrading @flue/cli From 0.3.5 to 0.11.1

27 releases in betweennotes for 21

Other targets from 0.3.5Latest2.3.1
  1. 0.3.5yours
  2. 6 releases
  3. 0.4.0major
  4. 1 release
  5. 0.5.0major
  6. 3 releases
  7. 0.6.0major
  8. 2 releases
  9. 0.7.0major
  10. 1 release
  11. 0.8.0major
  12. 1 release
  13. 0.9.0major
  14. 2 releases
  15. 0.10.0major
  16. 2 releases
  17. 0.11.0major
  18. 0.11.1target
51+
changes to make
0
advisories fixed
57+
new
57+
fixes

Counted from 21 of 27 release notes. Advisories are counted from the advisory database, in full.

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
  • Breaking0.10.0
  • Breaking0.10.0
  • Breaking0.10.0
  • Breaking0.10.0
  • Breaking0.10.0

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).

  5. 0.10.0

    Migration needed8 Jun 20264 new · 5 fixes
    • Breaking

      Cloudflare durable deployments require a migration. Generated Durable Object bindings and class names changed to FLUE_<NAME>_AGENT, FLUE_<NAME>_WORKFLOW, FLUE_REGISTRY, Flue<Name>Agent, Flue<Name>Workflow, and FlueRegistry. Existing deployments must add authored Wrangler renamed_classes migrations for already-deployed agent and workflow classes, update direct binding access such as env.Assistant to env.FLUE_ASSISTANT_AGENT, and introduce fresh SQLite-backed agent classes through new_sqlite_classes; existing KV-backed classes cannot be converted in place. Install agents >=0.14.1 <0.15.0 for the audited Agents SDK behavior used by this release.

    • Breaking

      Runtime surface cleanup. Removed tool_execution_* event types, the @flue/runtime/app, @flue/runtime/client, and @flue/runtime/sandbox compat subpaths, public AgentConfig / DirectAgentPayload exports, public Cloudflare agent WebSocket adapters, store() from @flue/runtime/cloudflare, and the old Cloudflare shell migration stubs.

    • Breaking

      Persistence adapter contracts changed. Custom adapters now implement connectRunStore() and connectRunRegistry() on PersistenceAdapter, use SubmissionClaimRef for claimSubmission(), and provide renewLeases(), listExpiredSubmissions(), and deleteSession() on AgentSubmissionStore.

    • Breaking

      Session state changed. Ordinary session names beginning with task: are now reserved for framework-owned delegated-task history, and existing version-4 beta session state is rejected because provider affinity now uses one opaque aff_<ULID> key instead of derived instance/harness/session identifiers.

  6. 0.9.2

    3 Jun 20261 fix
    • Fixed

      Fixed agents' ability to activate skills autonomously with the activate_skill tool.

  7. 0.9.1

    2 Jun 202612 fixes
    • Fixed

      Fixed relative cwd double-scoping in custom sandbox connectors. Flue now applies a created agent's cwd exactly once during init(), relative to the connector's provider-owned base directory. SandboxFactory.createSessionEnv() now receives only { id }; connector implementations should stop consuming cwd there.

    • Fixed

      SDK: Export reusable option types. @flue/sdk now exports option types for direct agent invocation, socket prompts, workflow-run event retrieval and streaming, and admin run listing, plus the RunStatus type.

    • Fixed

      MCP tools discovered through paginated listings now preserve output-schema validation and required task-execution metadata across every page.

    • Fixed

      GET /admin/agents and client.admin.agents.list() return one unpaginated list of all built agents. The unused nextCursor response field was removed from the SDK and OpenAPI schema.

  8. 0.9.0

    Migration needed2 Jun 20266 new · 9 fixes
    • Breaking

      Move application routing imports out of @flue/runtime/app. Import flue, admin, and Fetchable from @flue/runtime/routing. Import provider APIs and observe from @flue/runtime, and Workers AI binding types from @flue/runtime/cloudflare. Rename the ProviderSettings type to ProviderConfiguration.

    • Breaking

      Check your authored source directory. Flue now selects exactly one source directory in priority order: .flue/, src/, then the project root. If your project already has a src/ directory, move root-level agents and workflows into the selected source directory so Flue continues to discover them.

    • Breaking

      Cloudflare: Own Cloudflare Durable Object migrations in your project Wrangler config. Flue still generates classes and bindings, but no longer appends migrations automatically. Before upgrading an existing deployment, copy its complete ordered flue-class-* migration history from the previously generated .flue-vite.wrangler.jsonc or built wrangler.json into the project-root Wrangler config. Keep deployed tags unchanged, and append a uniquely tagged new_sqlite_classes entry whenever you add an agent or workflow class.

    • Breaking

      Workflows: Retry interrupted Cloudflare workflows explicitly. Flue no longer starts a replacement workflow run automatically after an interruption. The interrupted run is recorded as failed; invoke the workflow again when retrying is appropriate. Restart-link fields and their legacy OpenTelemetry attributes were removed.

2 other lines we could not sort, mostly version bumps
  • With the new 'local' sandbox, the host shell is exposed directly. The agent's bash tool can run gh issue view, npm test, etc. with whatever's on $PATH and whatever env you launched flue with. The runner / container / VM is the isolation boundary.

    0.4.0
  • For non-'local' sandboxes, install the binaries inside the sandbox image, or wrap the operation as a custom tool with init({ tools: [...] }). Tools have a structured parameter schema, are visible to the model directly, and recover the "secrets stay on the host" property — the tool reads process.env, the agent only sees the tool's params and result.

    0.4.0

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.