fix more naming

Author: 404Wolf

src/lib/beta/BetaToolRunner.ts

@@ -31,10 +31,10 @@ function promiseWithResolvers<T>(): {
 }
 
 /**
- * A BetaToolRunner handles the automatic conversation loop between the assistant and tools.
+ * A `BetaToolRunner` handles the automatic conversation loop between the assistant and tools.
  *
- * A BetaToolRunner is an async iterable that yields either ChatCompletion or
- * ChatCompletionStream objects depending on the streaming configuration.
+ * A `BetaToolRunner` is an async iterable that yields either `ChatCompletion` or
+ * `ChatCompletionStream` objects depending on the streaming configuration.
  */
 export class BetaToolRunner<Stream extends boolean>
   implements AsyncIterable<Stream extends true ? ChatCompletionStream : ChatCompletion>
@@ -230,15 +230,15 @@ export class BetaToolRunner<Stream extends boolean>
    * Get the tool response for the last message from the assistant.
    * Avoids redundant tool executions by caching results.
    *
-   * @returns A promise that resolves to a BetaMessageParam containing tool results, or null if no tools need to be executed
+   * @returns A promise that resolves to a `ChatCompletionToolMessageParam` containing tool results, or null if no tools need to be executed
    *
    * @example
    * const toolResponse = await runner.generateToolResponse();
    * if (toolResponse) {
    *   console.log('Tool results:', toolResponse.content);
    * }
    */
-  async generateToolResponse() {
+  async generateToolResponse(): Promise<ChatCompletionToolMessageParam[] | null> {
     // The most recent message from the assistant.
     const message = await this.#message;
     if (!message) {
@@ -266,7 +266,7 @@ export class BetaToolRunner<Stream extends boolean>
    * Wait for the async iterator to complete. This works even if the async iterator hasn't yet started, and
    * will wait for an instance to start and go to completion.
    *
-   * @returns A promise that resolves to the final BetaMessage when the iterator completes
+   * @returns A promise that resolves to the final `ChatComletionMessage` when the iterator completes
    *
    * @example
    * // Start consuming the iterator
@@ -283,12 +283,14 @@ export class BetaToolRunner<Stream extends boolean>
   }
 
   /**
-   * Returns a promise indicating that the stream is done. Unlike .done(), this will eagerly read the stream:
-   * * If the iterator has not been consumed, consume the entire iterator and return the final message from the
-   * assistant.
-   * * If the iterator has been consumed, waits for it to complete and returns the final message.
+   * Returns a promise indicating that the stream is done. Unlike .done(), this
+   * will eagerly read the stream:
    *
-   * @returns A promise that resolves to the final BetaMessage from the conversation
+   * - If the iterator has not been consumed, consume the entire iterator and
+   *   return the final message from the assistant.
+   * - If the iterator has been consumed, waits for it to complete and returns the final message.
+   *
+   * @returns A promise that resolves to the final `ChatCompletionMessage` from the conversation
    * @throws {OpenAIError} If no messages were processed during the conversation
    *
    * @example