reorganize examples

Author: leafo

examples/example1.lua examples/chat_completions/basic.luaexamples/example1.lua renamed to examples/chat_completions/basic.lua

@@ -0,0 +1,40 @@
+-- Example: Using Gemini with a chat session
+-- Requires GEMINI_API_KEY environment variable
+
+local Gemini = require("openai.compat.gemini")
+local client = Gemini.new(os.getenv("GEMINI_API_KEY"))
+
+-- Create a chat session with an initial system message
+local chat = client:new_chat_session({
+  messages = {
+    {role = "system", content = "You are a helpful assistant who gives concise answers."}
+  }
+})
+
+-- Send a message and print the response
+print("User: What is the capital of France?")
+local response = chat:send("What is the capital of France?")
+print("Assistant:", response)
+print()
+
+-- The chat history is maintained, so follow-up questions have context
+print("User: What is its population?")
+response = chat:send("What is its population?")
+print("Assistant:", response)
+print()
+
+-- You can stream responses with a callback
+print("User: Tell me a fun fact about that city.")
+print("Assistant: ", "")
+chat:send("Tell me a fun fact about that city.", function(chunk)
+  io.stdout:write(chunk.content or "")
+  io.stdout:flush()
+end)
+print()
+print()
+
+-- View the full conversation history
+print("--- Full conversation history ---")
+for idx, message in ipairs(chat.messages) do
+  print(string.format("[%s]: %s", message.role, message.content:sub(1, 80) .. (message.content:len() > 80 and "..." or "")))
+end

examples/example5.lua …es/chat_completions/function_calling.luaexamples/example5.lua renamed to examples/chat_completions/function_calling.lua examples/example5.lua renamed to examples/chat_completions/function_calling.lua

@@ -0,0 +1,40 @@
+-- Example: Using Gemini embeddings
+-- Requires GEMINI_API_KEY environment variable
+
+local Gemini = require("openai.compat.gemini")
+local client = Gemini.new(os.getenv("GEMINI_API_KEY"))
+
+-- Generate an embedding for a single text
+local status, response = client:embedding("Lua is the best programming language ever", {
+  model = "text-embedding-004"
+})
+
+if status == 200 then
+  local embedding = response.data[1].embedding
+  print("Embedding dimensions:", #embedding)
+  print("First 5 values:", table.concat({embedding[1], embedding[2], embedding[3], embedding[4], embedding[5]}, ", "))
+else
+  print("Error:", status)
+  if response and response.error then
+    print(response.error.message)
+  end
+end
+
+-- Generate embeddings for multiple texts at once
+print()
+print("--- Batch embeddings ---")
+local status2, response2 = client:embedding({
+  "The quick brown fox jumps over the lazy dog",
+  "A fast auburn canine leaps above a sleepy hound",
+  "Hello world in Lua"
+}, {
+  model = "text-embedding-004"
+})
+
+if status2 == 200 then
+  for i, item in ipairs(response2.data) do
+    print(string.format("Text %d: %d dimensions", i, #item.embedding))
+  end
+else
+  print("Error:", status2)
+end

examples/example2.lua examples/chat_completions/session.luaexamples/example2.lua renamed to examples/chat_completions/session.lua

@@ -0,0 +1,20 @@
+-- Example: List available Gemini models
+-- Requires GEMINI_API_KEY environment variable
+
+local Gemini = require("openai.compat.gemini")
+local client = Gemini.new(os.getenv("GEMINI_API_KEY"))
+
+local status, response = client:models()
+
+if status == 200 then
+  print("Available Gemini models:")
+  print()
+  for _, model in ipairs(response.data) do
+    print(string.format("  %s", model.id))
+  end
+else
+  print("Error:", status)
+  if response and response.error then
+    print(response.error.message)
+  end
+end

examples/example3.lua examples/chat_completions/streaming.luaexamples/example3.lua renamed to examples/chat_completions/streaming.lua

@@ -0,0 +1,64 @@
+local openai = require("openai")
+local cjson = require("cjson")
+local api_key = os.getenv("OPENAI_API_KEY")
+assert(api_key, "Set OPENAI_API_KEY in your environment before running.")
+local client = openai.new(api_key)
+print("== One-off response ==")
+local response, err, raw = client:create_response("Write one short sentence about Lua.")
+if not (response) then
+  io.stderr:write("Request failed: " .. tostring(err) .. "\n")
+  if raw then
+    io.stderr:write(cjson.encode(raw), "\n")
+  end
+  os.exit(1)
+end
+print("Response ID: " .. tostring(response.id))
+print("Output text: " .. tostring(response.output_text))
+print("Stop reason: " .. tostring(response.stop_reason or 'unknown'))
+print("\n== Streaming example ==")
+local streamed_text = nil
+response, err, raw = client:create_response("Stream a brief greeting.", {
+  stream = true
+}, function(chunk)
+  if chunk.text_delta then
+    io.write(chunk.text_delta)
+    io.flush()
+  end
+  if chunk.response then
+    return print("\n\nCompleted response ID: " .. tostring(chunk.response.id))
+  end
+end)
+streamed_text = response
+if not (streamed_text) then
+  io.stderr:write("Streaming request failed: " .. tostring(err) .. "\n")
+  if raw then
+    io.stderr:write(cjson.encode(raw), "\n")
+  end
+  os.exit(1)
+end
+print("Full streamed text: " .. tostring(streamed_text))
+print("\n== Stateful session ==")
+local session = client:new_response_session({
+  model = "gpt-4.1-mini",
+  instructions = "Keep answers concise."
+})
+local first
+first, err, raw = session:send("Introduce yourself in 5 words.")
+if not (first) then
+  io.stderr:write("Session request failed: " .. tostring(err) .. "\n")
+  if raw then
+    io.stderr:write(cjson.encode(raw), "\n")
+  end
+  os.exit(1)
+end
+print("First reply (" .. tostring(first.id) .. "): " .. tostring(first.output_text))
+local second
+second, err, raw = session:send("Now say goodbye in the same style.")
+if not (second) then
+  io.stderr:write("Second session request failed: " .. tostring(err) .. "\n")
+  if raw then
+    io.stderr:write(cjson.encode(raw), "\n")
+  end
+  os.exit(1)
+end
+return print("Second reply (" .. tostring(second.id) .. "): " .. tostring(second.output_text))