From 47e2462511cbd04605612b4a76e692d635e3ef06 Mon Sep 17 00:00:00 2001 From: rgarcia <72655+rgarcia@users.noreply.github.com> Date: Mon, 27 Apr 2026 23:05:10 +0000 Subject: [PATCH 1/3] docs: show both raw streaming and buffered curl in routing example Mirror the Python SDK example by demonstrating both kernel.browsers.fetch (streaming, returns Response) and kernel.browsers.curl (buffered JSON envelope), with comments noting when to use each. Co-Authored-By: Claude Opus 4.7 --- examples/browser-routing.ts | 9 ++++++++- 1 file changed, 8 insertions(+), 1 deletion(-) diff --git a/examples/browser-routing.ts b/examples/browser-routing.ts index 0e4da96..2139911 100644 --- a/examples/browser-routing.ts +++ b/examples/browser-routing.ts @@ -4,9 +4,16 @@ async function main() { const kernel = new Kernel(); const browser = await kernel.browsers.create({}); - const response = await kernel.browsers.fetch(browser.session_id, 'https://example.com', { method: 'GET' }); + + // Raw browser curl: streams the response. Use for large responses, when you want to stream, + // or when you want Response semantics. + const response: Response = await kernel.browsers.fetch(browser.session_id, 'https://example.com', { method: 'GET' }); console.log('status', response.status); + // Buffered browser curl: returns the full response in a JSON envelope. Use for small responses. + const buffered = await kernel.browsers.curl(browser.session_id, { url: 'https://example.com', method: 'GET' }); + console.log('body', buffered.body); + await kernel.browsers.deleteByID(browser.session_id); } From 125c74db4b373d14b37ef898718dc2b18cf1d5ad Mon Sep 17 00:00:00 2001 From: rgarcia <72655+rgarcia@users.noreply.github.com> Date: Mon, 27 Apr 2026 23:07:46 +0000 Subject: [PATCH 2/3] docs: print response body and clarify fetch() / Response semantics Co-Authored-By: Claude Opus 4.7 --- examples/browser-routing.ts | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/examples/browser-routing.ts b/examples/browser-routing.ts index 2139911..933c29e 100644 --- a/examples/browser-routing.ts +++ b/examples/browser-routing.ts @@ -6,9 +6,9 @@ async function main() { const browser = await kernel.browsers.create({}); // Raw browser curl: streams the response. Use for large responses, when you want to stream, - // or when you want Response semantics. + // or when you want fetch() / Response semantics. const response: Response = await kernel.browsers.fetch(browser.session_id, 'https://example.com', { method: 'GET' }); - console.log('status', response.status); + console.log('body', await response.text()); // Buffered browser curl: returns the full response in a JSON envelope. Use for small responses. const buffered = await kernel.browsers.curl(browser.session_id, { url: 'https://example.com', method: 'GET' }); From d530ee341694c72f095fc12c1f417dbd5a5a7a51 Mon Sep 17 00:00:00 2001 From: rgarcia <72655+rgarcia@users.noreply.github.com> Date: Mon, 27 Apr 2026 23:13:18 +0000 Subject: [PATCH 3/3] chore: prettier format browser routing example Co-Authored-By: Claude Opus 4.7 --- examples/browser-routing.ts | 9 +++++++-- 1 file changed, 7 insertions(+), 2 deletions(-) diff --git a/examples/browser-routing.ts b/examples/browser-routing.ts index 933c29e..9f4c2c4 100644 --- a/examples/browser-routing.ts +++ b/examples/browser-routing.ts @@ -7,11 +7,16 @@ async function main() { // Raw browser curl: streams the response. Use for large responses, when you want to stream, // or when you want fetch() / Response semantics. - const response: Response = await kernel.browsers.fetch(browser.session_id, 'https://example.com', { method: 'GET' }); + const response: Response = await kernel.browsers.fetch(browser.session_id, 'https://example.com', { + method: 'GET', + }); console.log('body', await response.text()); // Buffered browser curl: returns the full response in a JSON envelope. Use for small responses. - const buffered = await kernel.browsers.curl(browser.session_id, { url: 'https://example.com', method: 'GET' }); + const buffered = await kernel.browsers.curl(browser.session_id, { + url: 'https://example.com', + method: 'GET', + }); console.log('body', buffered.body); await kernel.browsers.deleteByID(browser.session_id);