add streaming api doc

Author: AstaTus

docs/developer/ts-adapter.md

@@ -65,6 +65,25 @@ The `page` parameter provides browser interaction methods:
 - `page.click(selector)` — Click an element
 - `page.type(selector, text)` — Type text into an input
 
+### Streaming API Interception
+
+For capturing streaming responses (SSE / chunked transfer) — works in background tabs where DOM rendering is throttled but fetch streams and XHR progress events are not.
+
+```typescript
+await page.installStreamingInterceptor('StreamGenerate');
+// ... trigger the streaming request ...
+await page.waitForStreamCapture(60, { minChars: 100, waitForDone: true });
+const { text, events, done, errors } = await page.getStreamedResponses();
+// Or peek without clearing:
+const { text } = await page.getStreamedResponses({ clear: false });
+```
+
+| Method | Description |
+|--------|-------------|
+| `installStreamingInterceptor(pattern)` | Patch fetch + XHR to capture streaming responses |
+| `waitForStreamCapture(timeout, opts?)` | Poll until `minChars` reached and/or stream `done` |
+| `getStreamedResponses(opts?)` | Read captured text/events; pass `{ clear: false }` to peek |
+
 ## The `kwargs` Object
 
 Contains parsed CLI arguments as key-value pairs. Always destructure with defaults:

docs/developer/yaml-adapter.md

@@ -100,6 +100,27 @@ Download media files.
 ```
 :::
 
+### `stream-intercept`
+Capture streaming responses (SSE / chunked transfer) incrementally. Unlike `intercept`, this reads the response body as a stream — ideal for AI chat endpoints that stream replies, and works in background tabs where DOM rendering is throttled. Requires `browser: true`.
+
+::: v-pre
+```yaml
+- stream-intercept:
+    capture: "StreamGenerate"
+    trigger: "click:@send"
+    timeout: 60
+    waitForDone: true
+```
+:::
+
+| Param | Default | Description |
+|-------|---------|-------------|
+| `capture` | (required) | URL substring to match |
+| `trigger` | `""` | Action before capture: `click:@ref`, `navigate:url`, `evaluate:js`, `scroll` |
+| `timeout` | `60` | Max seconds to wait for stream data |
+| `waitForDone` | `true` | Wait until the stream completes (not just first bytes) |
+| `returnEvents` | `false` | Return parsed SSE events instead of raw text |
+
 ## Template Expressions
 
 ::: v-pre