cloudflare/agents agents@0.10.0

on GitHub

Minor Changes

• #1256 dfab937 Thanks @threepointone! - Add durable fiber execution to the Agent base class.

  runFiber(name, fn) registers work in SQLite, holds a keepAlive ref, and enables recovery via onFiberRecovered after DO eviction. ctx.stash() and this.stash() checkpoint progress that survives eviction.

  AIChatAgent gains unstable_chatRecovery — when enabled, each chat turn is wrapped in a fiber. onChatRecovery provides provider-specific recovery (Workers AI continuation, OpenAI response retrieval, Anthropic synthetic message). continueLastTurn() appends to the interrupted assistant message seamlessly.

  Think now extends Agent directly (no mixin). Fiber support is inherited from the base class.

  Breaking (experimental APIs only):

  • Removed withFibers mixin (agents/experimental/forever)
  • Removed withDurableChat mixin (@cloudflare/ai-chat/experimental/forever)
  • Removed ./experimental/forever export from both packages
  • Think no longer has a fibers flag — recovery is automatic via alarm housekeeping

Patch Changes

• #1259 1933eb4 Thanks @threepointone! - Run fiber recovery eagerly in onStart() instead of deferring to the next alarm. Interrupted fibers are now detected immediately on the first request after DO wake, with the alarm path as a fallback. A re-entrancy guard prevents double recovery.

• #1263 e3ceb82 Thanks @threepointone! - Fix routeAgentEmail() keeping the target DO non-hibernatable for ~100-120s after onEmail() returns. Replaces bare closure RPC targets with a single RpcTarget bridge (EmailBridge) that has explicit Symbol.dispose lifecycle, allowing the runtime to tear down the bidirectional RPC session promptly instead of tying it to the caller's execution context lifetime.

• c5ca556 Thanks @threepointone! - Cap vite peer dependency at >=6.0.0 <9.0.0 to avoid silently accepting untested future major versions.

• #1271 0cc2dae Thanks @threepointone! - Add optional MCPServerFilter parameter to getAITools(), listTools(), listPrompts(), listResources(), and listResourceTemplates() for scoping results to specific MCP servers by ID, name, or connection state.

• #1267 d1ee61a Thanks @dmmulroy! - Fix MCP streamable HTTP client session lifecycle so closing connections explicitly terminates active sessions and persists session IDs across reconnects/restores.

• #1270 87b4512 Thanks @threepointone! - Wire Session into Think as the storage layer, achieving full feature parity with AIChatAgent plus Session-backed advantages.

  Think (@cloudflare/think):

  • Session integration: this.messages backed by session.getHistory(), tree-structured messages, context blocks, compaction, FTS5 search
  • configureSession() override for context blocks, compaction, search, skills (sync or async)
  • assembleContext() returns { system, messages } with context block composition
  • onChatResponse() lifecycle hook fires from all turn paths
  • Non-destructive regeneration via trigger: "regenerate-message" with Session branching
  • saveMessages() for programmatic turn entry (scheduled responses, webhooks, proactive agents)
  • continueLastTurn() for extending the last assistant response
  • Custom body persistence across hibernation
  • sanitizeMessageForPersistence() hook for PII redaction
  • messageConcurrency strategies (queue/latest/merge/drop/debounce)
  • resetTurnState() extracted as protected method
  • unstable_chatRecovery with runFiber wrapping on all 4 turn paths
  • onChatRecovery() hook with ChatRecoveryContext
  • hasPendingInteraction() / waitUntilStable() for quiescence detection
  • Re-export Session from @cloudflare/think
  • Constructor wraps onStart — subclasses never need super.onStart()

  agents (agents/chat):

  • Extract AbortRegistry, applyToolUpdate + builders, parseProtocolMessage into shared agents/chat layer
  • Add applyChunkToParts export for fiber recovery

  AIChatAgent (@cloudflare/ai-chat):

  • Refactor to use shared AbortRegistry from agents/chat
  • Add continuation flag to OnChatMessageOptions
  • Export getAgentMessages() and tool part helpers
  • Add getHttpUrl() to useAgent return value