more readme work

Author: 404Wolf

README.md

@@ -126,6 +126,8 @@ await client.files.create({
 
 ## Streaming Helpers
 
+The SDK makes it easy to stream responses, by providing an emitter helper via `.stream()`:
+
 ```ts
 import OpenAI from 'openai';
 
@@ -154,6 +156,10 @@ async function main() {
 main();
 ```
 
+With `.stream()` you get event handlers, accumulation, and an async iterable.
+
+Alternatively, you can use `client.chat.completions({ ..., stream: true })` which only returns an async iterable of the events in the stream and thus uses less memory (it does not build up a final message object for you).
+
 ## Tool Helpers
 
 The SDK makes it easy to create and run [function tools with the chats API](https://platform.openai.com/docs/guides/function-calling). You can use Zod schemas or direct JSON schemas to describe the shape of tool input, and then you can run the tools using the `client.beta.messages.toolRunner` method. This method will automatically handle passing the inputs generated by the model into your tools and providing the results back to the model.