more updates to readme

Author: leafo

README.md

@@ -4,6 +4,17 @@ Bindings to the OpenAI HTTP API for Lua. Compatible with any socket library
 that supports the LuaSocket request interface. Compatible with OpenResty using
 [`lapis.nginx.http`](https://leafo.net/lapis/reference/utilities.html#making-http-requests).
 
+<details>
+<summary>AI Generated Disclaimer</summary>
+
+Although this library was written by hand, large portions of the documentation
+and the test suite were fully generated by ChatGPT 4 by pasting the source code
+of the entire library in as a prompt and asking to generate documentation and
+tests. The final output was edited for clarity and syntax (in cases where GPT4
+struggled writing MoonScript)
+
+</details>
+
 ## Install
 
 Install using LuaRocks:
@@ -134,15 +145,21 @@ it. By default, the completion is appended to the history.
 Sends a request to the `/chat/completions` endpoint.
 
 - `messages`: An array of message objects.
-- `opts`: Additional options for the chat, such as model and temperature.
+- `opts`: Additional options for the chat, passed directly to the API (eg. model, temperature, etc.) https://platform.openai.com/docs/api-reference/chat
 - `chunk_callback`: A function to be called for parsed streaming output when `stream = true` is passed to `opts`.
 
+Returns HTTP status, response object, and output headers. The response object
+will be decoded from JSON if possible, otherwise the raw string is returned.
+
 ##### `client:completion(prompt, opts)`
 
 Sends a request to the `/completions` endpoint.
 
 - `prompt`: The prompt for the completion.
-- `opts`: Additional options for the completion.
+- `opts`: Additional options for the completion, passed directly to the API (eg. model, temperature, etc.) https://platform.openai.com/docs/api-reference/completions
+
+Returns HTTP status, response object, and output headers. The response object
+will be decoded from JSON if possible, otherwise the raw string is returned.
 
 #### ChatSession