Dev

DESCRIPTION

@@ -1,13 +1,15 @@
 Package: EndpointR
 Title: Connects to various Machine Learning inference providers
-Version: 0.2
-Authors@R: 
-    person("Jack", "Penzer", , "Jack.penzer@sharecreative.com", role = c("aut", "cre"))
+Version: 0.2.1
+Authors@R: c(
+    person("Jack", "Penzer", , "Jack.penzer@sharecreative.com", role = c("aut", "cre")),
+    person("Claude", "AI", role = "aut")
+    )
 Description: EndpointR is a 'batteries included', open-source R package for connecting to various APIs for Machine Learning model predictions. EndpointR is built for company-specific use cases, so may not be useful to a wide audience.
 License: MIT + file LICENSE
 Encoding: UTF-8
 Roxygen: list(markdown = TRUE)
-RoxygenNote: 7.3.2
+RoxygenNote: 7.3.3
 Suggests:
     spelling, 
     broom,
@@ -33,7 +35,8 @@ Imports:
     tibble,
     S7,
     jsonvalidate,
-    arrow
+    arrow,
+    curl
 VignetteBuilder: knitr
 Depends: 
     R (>= 3.5)

NAMESPACE

@@ -22,6 +22,17 @@ export(hf_get_model_max_length)
 export(hf_perform_request)
 export(json_dump)
 export(json_schema)
+export(oai_batch_build_completions_req)
+export(oai_batch_build_embed_req)
+export(oai_batch_cancel)
+export(oai_batch_list)
+export(oai_batch_parse_completions)
+export(oai_batch_parse_embeddings)
+export(oai_batch_prepare_completions)
+export(oai_batch_prepare_embeddings)
+export(oai_batch_start)
+export(oai_batch_status)
+export(oai_batch_upload)
 export(oai_build_completions_request)
 export(oai_build_completions_request_list)
 export(oai_build_embedding_request)
@@ -32,6 +43,10 @@ export(oai_embed_batch)
 export(oai_embed_chunks)
 export(oai_embed_df)
 export(oai_embed_text)
+export(oai_file_content)
+export(oai_file_delete)
+export(oai_file_list)
+export(oai_file_upload)
 export(perform_requests_with_strategy)
 export(process_response)
 export(safely_from_json)

NEWS.md

@@ -1,4 +1,36 @@
-# EndpointR 0.2
+# EndpointR 0.2.1
+
+## OpenAI Batch API
+
+Adds support for OpenAI's asynchronous Batch API, offering 50% cost savings and higher rate limits compared to synchronous endpoints. Ideal for large-scale embeddings, classifications, and batch inference tasks.
+
+**Request preparation:**
+
+-   `oai_batch_build_embed_req()` - Build a single embedding request row
+-   `oai_batch_prepare_embeddings()` - Prepare an entire data frame for batch embeddings
+-   `oai_batch_build_completions_req()` - Build a single chat completions request row
+-   `oai_batch_prepare_completions()` - Prepare an entire data frame for batch completions (supports structured outputs via JSON schema)
+
+**Job management:**
+
+-   `oai_batch_upload()` - Upload prepared JSONL to OpenAI Files API
+-   `oai_batch_start()` - Trigger a batch job on an uploaded file
+-   `oai_batch_status()` - Check the status of a running batch job
+-   `oai_batch_list()` - List all batch jobs associated with your API key
+-   `oai_batch_cancel()` - Cancel an in-progress batch job
+
+**Results parsing:**
+
+-   `oai_batch_parse_embeddings()` - Parse batch embedding results into a tidy data frame
+-   `oai_batch_parse_completions()` - Parse batch completion results into a tidy data frame
+
+## OpenAI Files API
+
+-   `oai_file_list()` - List files uploaded to the OpenAI Files API
+-   `oai_file_content()` - Retrieve the content of a file (e.g., batch results)
+-   `oai_file_delete()` - Delete a file from the Files API
+
+# EndpointR 0.2.0
 
 -   error message and status propagation improvement. Now writes .error, .error_msg (standardised across package), and .status. Main change is preventing httr2 eating the errors before we can deal with them
 -   adds parquet writing to oai_complete_df and oai_embed_df