Add OpenAI-compatible completion model to facade.

examples/basic/src/model-provider/openaicompatible/openaicompatible-fireworksai-completion-stream-text-example.ts

@@ -0,0 +1,26 @@
+import dotenv from "dotenv";
+import {
+  FireworksAIApiConfiguration,
+  openaicompatible,
+  streamText,
+} from "modelfusion";
+
+dotenv.config();
+
+async function main() {
+  const textStream = await streamText(
+    openaicompatible.CompletionTextGenerator({
+      api: new FireworksAIApiConfiguration(),
+      model: "accounts/fireworks/models/mistral-7b",
+      maxGenerationTokens: 500,
+    }),
+
+    "Write a story about a robot learning to love"
+  );
+
+  for await (const textPart of textStream) {
+    process.stdout.write(textPart);
+  }
+}
+
+main().catch(console.error);

packages/modelfusion/src/model-provider/openai-compatible/OpenAICompatibleFacade.ts

@@ -2,6 +2,35 @@ import {
   OpenAICompatibleChatModel,
   OpenAICompatibleChatSettings,
 } from "./OpenAICompatibleChatModel.js";
+import { OpenAICompatibleCompletionModel } from "./OpenAICompatibleCompletionModel.js";
+
+/**
+ * Create a text generation model that calls an API that is compatible with OpenAI's completion API.
+ *
+ * Please note that many providers implement the API with slight differences, which can cause
+ * unexpected errors and different behavior in less common scenarios.
+ *
+ * @see https://platform.openai.com/docs/api-reference/completions/create
+ *
+ * @example
+ * ```ts
+ * const model = openaicompatible.CompletionTextGenerator({
+ *   model: "provider-specific-model-name",
+ *   temperature: 0.7,
+ *   maxGenerationTokens: 500,
+ * });
+ *
+ * const text = await generateText(
+ *   model,
+ *   "Write a short story about a robot learning to love:"
+ * );
+ * ```
+ */
+export function CompletionTextGenerator(
+  settings: OpenAICompatibleChatSettings
+) {
+  return new OpenAICompatibleCompletionModel(settings);
+}
 
 /**
  * Create a text generation model that calls an API that is compatible with OpenAI's chat API.
@@ -12,18 +41,22 @@ import {
  * @see https://platform.openai.com/docs/api-reference/chat/create
  *
  * @example
+ * ```ts
  * const model = openaicompatible.ChatTextGenerator({
  *   model: "provider-specific-model-name",
  *   temperature: 0.7,
  *   maxGenerationTokens: 500,
  * });
  *
- * const text = await generateText([
+ * const text = await generateText(
  *   model,
- *   openai.ChatMessage.system(
- *     "Write a short story about a robot learning to love:"
- *   ),
- * ]);
+ *   [
+ *     openai.ChatMessage.user(
+ *       "Write a short story about a robot learning to love:"
+ *     ),
+ *   ]
+ * );
+ * ```
  */
 export function ChatTextGenerator(settings: OpenAICompatibleChatSettings) {
   return new OpenAICompatibleChatModel(settings);