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.

helpers.md

@@ -304,7 +304,7 @@ See an example of streaming helpers in action in [`examples/stream.ts`](examples
 
 ### Automated function calls via Beta Tool Runner
 
-We now offer an easier to use tool calling approach via the `openai.beta.chat.completions.toolRunner({…})` helper. The SDK provides helper functions to create runnable tools that can be automatically invoked by the .toolRunner() method. These helpers simplify tool creation with JSON Schema or Zod validation.
+The SDK provides a convenient Beta Tool Runner at `openai.beta.chat.completions.toolRunner({…})` that simplifies [function tool calling](https://platform.openai.com/docs/guides/function-calling). This helper allows you to define functions with their associated schemas, and the SDK will automatically invoke them as the AI requests and validate the parameters for you.
 
 #### Usage