feat: full 0.9.0 resume/recovery parity

Bring the Vue port up to parity with @cloudflare/ai-chat 0.9.x on resume/recovery:

- Resume dedupe (0.8.5): fallback-ACK a resume offer at most once per socket,
  preventing duplicated assistant text when a stream resume is replayed twice.
- isRecovering (0.8.0): reactive flag driven by the cf_agent_chat_recovering frame,
  distinct from streaming; not cleared by ordinary message sync.
- cancelOnClientAbort (0.7.0): generic client aborts are local-only by default and the
  server turn keeps running and stays observable; explicit stop() always cancels via
  active-server-turn tracking (locally-initiated, resume-fallback-observed, and
  transport-resumed turns are all cancellable).
- cf_agent_stream_pending (0.9.0): extend the resume probe 5s -> 60s during the
  server's pre-stream window.
- connectionError (0.9.0): surface terminal WebSocket failures from the AgentClient.

Bumps the agents dependency to 0.17.0 and raises the peer floor to >=0.17.0 (the
version that first exports connectionError / onConnectionError / AgentConnectionError).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_012MmBgJB6Z7GT9ZffT79YhA

Author: ymansurozer

README.md

@@ -6,7 +6,7 @@ Vue 3 composable for [Cloudflare Agents](https://github.com/cloudflare/agents) 
 
 ## Status
 
-v0.1 — covers the surface needed for a working chat UI: streaming responses, client-side tools, tool approvals, stream resumption, broadcast handling. Deeper upstream features (the `useAgent` connection hook, initial-message HTTP cache, `isServerStreaming` flag) are on the roadmap.
+Covers the surface needed for a working chat UI — streaming responses, client-side tools, tool approvals, stream resumption, broadcast handling — at parity with upstream `@cloudflare/ai-chat` 0.9.x on resume/recovery: resume dedupe, `isRecovering`, `cancelOnClientAbort`, pre-stream `cf_agent_stream_pending`, and `connectionError`. Deeper upstream features (the `useAgent` connection hook, initial-message HTTP cache, `isServerStreaming` / `isStreaming` flags) are on the roadmap.
 
 ## Install
 
@@ -21,7 +21,7 @@ Peer dependencies (must also be installed):
 | `vue` | `^3.3.4` |
 | `@ai-sdk/vue` | `^3.0.0` |
 | `ai` | `^6.0.0` |
-| `agents` | `>=0.11.0 <1.0.0` |
+| `agents` | `>=0.17.0 <1.0.0` |
 
 ## Usage
 
@@ -78,7 +78,9 @@ Returns:
 | `addToolOutput` | `function` | Submit a tool result. Sends `cf_agent_tool_result` and triggers continuation if enabled. |
 | `addToolApprovalResponse` | `function` | Resolve a human-in-the-loop tool approval. Sends `cf_agent_tool_approval` and triggers continuation. |
 | `clearHistory` | `function` | Clear local state and broadcast `cf_agent_chat_clear` to the server. |
-| `stop` | `function` | Abort the active stream and any pending tool continuation. |
+| `stop` | `function` | Abort the active stream and any pending tool continuation. Always cancels the server turn (explicit cancel). |
+| `isRecovering` | `Ref<boolean>` | Reactive — `true` while the server is recovering a durable chat turn (distinct from streaming, so a UI can show "recovering…"). Driven by `cf_agent_chat_recovering`. |
+| `connectionError` | `Ref<AgentConnectionError \| null>` | Reactive — the terminal WebSocket connection failure, or `null`. Cleared on reconnect. |
 
 ### Options
 
@@ -91,6 +93,7 @@ Returns:
 | `onToolCall` | `({ toolCall, addToolOutput }) => void \| Promise<void>` | — | Custom tool-call handler. Overrides per-tool `execute`. |
 | `autoContinueAfterToolResult` | `boolean` | `true` | Server resumes the stream after a tool result. |
 | `resume` | `boolean` | `true` | Resume in-flight streams on socket reconnect. |
+| `cancelOnClientAbort` | `boolean` | `false` | When `true`, a generic client-side abort cancels the server turn; when `false` (default) such aborts are local-only and the server turn keeps running and can resume. Explicit `stop()` always cancels. |
 | `onOpen` | `(event: Event) => void` | — | WebSocket open. |
 | `onClose` | `(event: CloseEvent) => void` | — | WebSocket close. |
 | `onSocketError` | `(event: Event) => void` | — | Connection-level error. |
@@ -157,6 +160,11 @@ const transport = new WebSocketChatTransport({
 | Partial-hydration replay rebuild | ✅ |
 | Broadcast handling (multi-tab) | ✅ |
 | Tool approval continuation merge across broadcasts | ✅ |
+| Resume dedupe (fallback-ACK at most once per socket) | ✅ |
+| `isRecovering` durable-recovery hint (`cf_agent_chat_recovering`) | ✅ |
+| `cancelOnClientAbort` (local-only abort, default) | ✅ |
+| Pre-stream `cf_agent_stream_pending` (extended resume probe) | ✅ |
+| `connectionError` (terminal WebSocket close) | ✅ |
 | `useAgent` connection hook | 🚧 roadmap |
 | Initial-message HTTP cache | 🚧 roadmap |
 | `isServerStreaming` / `isStreaming` flags | 🚧 roadmap |
@@ -166,7 +174,7 @@ const transport = new WebSocketChatTransport({
 ```bash
 pnpm install
 pnpm exec playwright install chromium
-pnpm test       # 59 tests in chromium (vitest-browser-vue)
+pnpm test       # 79 tests in chromium (vitest-browser-vue)
 pnpm typecheck
 pnpm lint
 pnpm build

package.json

@@ -50,7 +50,7 @@
   },
   "peerDependencies": {
     "@ai-sdk/vue": "^3.0.0",
-    "agents": ">=0.11.0 <1.0.0",
+    "agents": ">=0.17.0 <1.0.0",
     "ai": "^6.0.0",
     "vue": "^3.3.4"
   },
@@ -60,7 +60,7 @@
     "@types/node": "^22.0.0",
     "@vitest/browser": "^4.1.5",
     "@vitest/browser-playwright": "^4.1.5",
-    "agents": "^0.11.4",
+    "agents": "^0.17.0",
     "ai": "^6.0.0",
     "changelogen": "^0.6.2",
     "eslint": "^9.0.0",