feat(ai): Add OpenAI-compatible provider examples for multiple services

- Add examples for Cerebras, Groq, Ollama, and OpenRouter
- Update OpenAI Completions provider to handle base URL properly
- Simplify README formatting
- All examples use the same OpenAICompletionsLLM provider with different base URLs

packages/ai/test/examples/cerebras-completions.ts

@@ -0,0 +1,65 @@
+import chalk from "chalk";
+import { Context, Tool } from "../../src/types";
+import { OpenAICompletionsLLM, OpenAICompletionsLLMOptions } from "../../src/providers/openai-completions";
+
+// Define a simple calculator tool
+const tools: Tool[] = [
+    {
+        name: "calculate",
+        description: "Perform a mathematical calculation",
+        parameters: {
+            type: "object" as const,
+            properties: {
+                expression: {
+                    type: "string",
+                    description: "The mathematical expression to evaluate"
+                }
+            },
+            required: ["expression"]
+        }
+    }
+];
+
+const options: OpenAICompletionsLLMOptions = {
+    onText: (t, complete) => process.stdout.write(t + (complete ? "\n" : "")),
+    onThinking: (t, complete) => process.stdout.write(chalk.dim(t + (complete ? "\n" : ""))),
+    reasoningEffort: "medium",
+    toolChoice: "auto"
+};
+const ai = new OpenAICompletionsLLM("gpt-oss-120b", process.env.CEREBRAS_API_KEY, "https://api.cerebras.ai/v1");
+const context: Context = {
+        systemPrompt: "You are a helpful assistant that can use tools to answer questions.",
+        messages: [
+        {
+            role: "user",
+            content: "Think about birds briefly. Then give me a list of 10 birds. Finally, calculate 42 * 17 + 123 and 453 + 434 in parallel using the calculator tool. You must use the tool to answer both math questions.",
+        }
+    ],
+    tools
+}
+
+while (true) {
+    let msg = await ai.complete(context, options)
+    context.messages.push(msg);
+    console.log();
+
+    for (const toolCall of msg.toolCalls || []) {
+        if (toolCall.name === "calculate") {
+            const expression = toolCall.arguments.expression;
+            const result = eval(expression);
+            context.messages.push({
+                role: "toolResult",
+                content: `The result of ${expression} is ${result}.`,
+                toolCallId: toolCall.id,
+                isError: false
+            });
+        }
+    }
+    if (msg.stopReason != "toolUse") break;
+}
+console.log();
+console.log(chalk.yellow(JSON.stringify(context.messages, null, 2)));
+
+
+
+

packages/ai/test/examples/groq-completions.ts

@@ -0,0 +1,66 @@
+import chalk from "chalk";
+import { Context, Tool } from "../../src/types";
+import { OpenAICompletionsLLM, OpenAICompletionsLLMOptions } from "../../src/providers/openai-completions";
+
+// Define a simple calculator tool
+const tools: Tool[] = [
+    {
+        name: "calculate",
+        description: "Perform a mathematical calculation",
+        parameters: {
+            type: "object" as const,
+            properties: {
+                expression: {
+                    type: "string",
+                    description: "The mathematical expression to evaluate"
+                }
+            },
+            required: ["expression"]
+        }
+    }
+];
+
+const options: OpenAICompletionsLLMOptions = {
+    onText: (t, complete) => process.stdout.write(t + (complete ? "\n" : "")),
+    onThinking: (t, complete) => process.stdout.write(chalk.dim(t + (complete ? "\n" : ""))),
+    reasoningEffort: "medium",
+    toolChoice: "auto"
+};
+const ai = new OpenAICompletionsLLM("openai/gpt-oss-20b", process.env.GROQ_API_KEY, "https://api.groq.com/openai/v1");
+const context: Context = {
+        systemPrompt: "You are a helpful assistant that can use tools to answer questions.",
+        messages: [
+        {
+            role: "user",
+            content: "Think about birds briefly. Then give me a list of 10 birds. Finally, calculate 42 * 17 + 123 and 453 + 434 in parallel using the calculator tool.",
+        }
+    ],
+    tools
+}
+
+while (true) {
+    let msg = await ai.complete(context, options)
+    context.messages.push(msg);
+    console.log();
+    console.log(chalk.yellow(JSON.stringify(msg, null, 2)));
+
+    for (const toolCall of msg.toolCalls || []) {
+        if (toolCall.name === "calculate") {
+            const expression = toolCall.arguments.expression;
+            const result = eval(expression);
+            context.messages.push({
+                role: "toolResult",
+                content: `The result of ${expression} is ${result}.`,
+                toolCallId: toolCall.id,
+                isError: false
+            });
+        }
+    }
+    if (msg.stopReason != "toolUse") break;
+}
+console.log();
+console.log(chalk.yellow(JSON.stringify(context.messages, null, 2)));
+
+
+
+

packages/ai/test/examples/ollama-completions.ts

@@ -0,0 +1,66 @@
+import chalk from "chalk";
+import { Context, Tool } from "../../src/types";
+import { OpenAICompletionsLLM, OpenAICompletionsLLMOptions } from "../../src/providers/openai-completions";
+
+// Define a simple calculator tool
+const tools: Tool[] = [
+    {
+        name: "calculate",
+        description: "Perform a mathematical calculation",
+        parameters: {
+            type: "object" as const,
+            properties: {
+                expression: {
+                    type: "string",
+                    description: "The mathematical expression to evaluate"
+                }
+            },
+            required: ["expression"]
+        }
+    }
+];
+
+const options: OpenAICompletionsLLMOptions = {
+    onText: (t, complete) => process.stdout.write(t + (complete ? "\n" : "")),
+    onThinking: (t, complete) => process.stdout.write(chalk.dim(t + (complete ? "\n" : ""))),
+    reasoningEffort: "medium",
+    toolChoice: "auto"
+};
+const ai = new OpenAICompletionsLLM("gpt-oss:20b", "dummy", "http://localhost:11434/v1");
+const context: Context = {
+        systemPrompt: "You are a helpful assistant that can use tools to answer questions.",
+        messages: [
+        {
+            role: "user",
+            content: "Think about birds briefly. Then give me a list of 10 birds. Finally, calculate 42 * 17 + 123 and 453 + 434 in parallel using the calculator tool.",
+        }
+    ],
+    tools
+}
+
+while (true) {
+    let msg = await ai.complete(context, options)
+    context.messages.push(msg);
+    console.log();
+    console.log(chalk.yellow(JSON.stringify(msg, null, 2)));
+
+    for (const toolCall of msg.toolCalls || []) {
+        if (toolCall.name === "calculate") {
+            const expression = toolCall.arguments.expression;
+            const result = eval(expression);
+            context.messages.push({
+                role: "toolResult",
+                content: `The result of ${expression} is ${result}.`,
+                toolCallId: toolCall.id,
+                isError: false
+            });
+        }
+    }
+    if (msg.stopReason == "stop") break;
+}
+console.log();
+console.log(chalk.yellow(JSON.stringify(context.messages, null, 2)));
+
+
+
+

packages/ai/test/examples/openrouter-completions.ts

@@ -0,0 +1,65 @@
+import chalk from "chalk";
+import { Context, Tool } from "../../src/types";
+import { OpenAICompletionsLLM, OpenAICompletionsLLMOptions } from "../../src/providers/openai-completions";
+
+// Define a simple calculator tool
+const tools: Tool[] = [
+    {
+        name: "calculate",
+        description: "Perform a mathematical calculation",
+        parameters: {
+            type: "object" as const,
+            properties: {
+                expression: {
+                    type: "string",
+                    description: "The mathematical expression to evaluate"
+                }
+            },
+            required: ["expression"]
+        }
+    }
+];
+
+const options: OpenAICompletionsLLMOptions = {
+    onText: (t, complete) => process.stdout.write(t + (complete ? "\n" : "")),
+    onThinking: (t, complete) => process.stdout.write(chalk.dim(t + (complete ? "\n" : ""))),
+    reasoningEffort: "medium",
+    toolChoice: "auto"
+};
+const ai = new OpenAICompletionsLLM("z-ai/glm-4.5", process.env.OPENROUTER_API_KEY, "https://openrouter.ai/api/v1");
+const context: Context = {
+        systemPrompt: "You are a helpful assistant that can use tools to answer questions.",
+        messages: [
+        {
+            role: "user",
+            content: "Think about birds briefly. Then give me a list of 10 birds. Finally, calculate 42 * 17 + 123 and 453 + 434 in parallel using the calculator tool.",
+        }
+    ],
+    tools
+}
+
+while (true) {
+    let msg = await ai.complete(context, options)
+    context.messages.push(msg);
+    console.log();
+
+    for (const toolCall of msg.toolCalls || []) {
+        if (toolCall.name === "calculate") {
+            const expression = toolCall.arguments.expression;
+            const result = eval(expression);
+            context.messages.push({
+                role: "toolResult",
+                content: `The result of ${expression} is ${result}.`,
+                toolCallId: toolCall.id,
+                isError: false
+            });
+        }
+    }
+    if (msg.stopReason != "toolUse") break;
+}
+console.log();
+console.log(chalk.yellow(JSON.stringify(context.messages, null, 2)));
+
+
+
+