adapters

package main

import (
	"context"
	"log"
	"os"
	"time"

	"github.com/maruel/genai"
	"github.com/maruel/genai/adapters"
	"github.com/maruel/genai/providers/gemini"
)

func main() {
	// Supported by Anthropic, Cerebras, Cloudflare, Cohere, DeepSeek, Gemini, Groq, HuggingFace, Mistral,
	// Ollama, OpenAI, TogetherAI.

	// Using a free small model for testing.
	// See https://ai.google.dev/gemini-api/docs/models/gemini?hl=en
	ctx := context.Background()
	c, err := gemini.New(ctx, genai.ProviderOptionModel("gemini-2.5-flash"))
	if c != nil {
		defer func() {
			if err := c.Close(); err != nil {
				log.Printf("Close: %v", err)
			}
		}()
	}
	if err != nil {
		log.Print(err)
		return
	}
	msgs := genai.Messages{genai.NewTextMessage("What season are we in?")}
	opts := genai.GenOptionTools{
		// GetTodayClockTime returns the current time and day in a format that the LLM
		// can understand. It includes the weekend.
		Tools: []genai.ToolDef{GetTodayClockTime},
		// Force the LLM to do a tool call first.
		Force: genai.ToolCallRequired,
	}
	fragments, finish := adapters.GenStreamWithToolCallLoop(ctx, c, msgs, &opts)
	for f := range fragments {
		_, _ = os.Stdout.WriteString(f.Text)
	}
	if _, _, err = finish(); err != nil {
		log.Print(err)
		return
	}
}

var GetTodayClockTime = genai.ToolDef{
	Name:        "get_today_date_current_clock_time",
	Description: "Get the current clock time and today's date.",
	Callback: func(ctx context.Context, e *empty) (string, error) {
		return time.Now().Format("Monday 2006-01-02 15:04:05"), nil
	},
}

type empty struct{}

Output:

package main

import (
	"context"
	"fmt"
	"log"
	"time"

	"github.com/maruel/genai"
	"github.com/maruel/genai/adapters"
	"github.com/maruel/genai/providers/gemini"
)

func main() {
	// Supported by Anthropic, Cerebras, Cloudflare, Cohere, DeepSeek, Gemini, Groq, HuggingFace, Mistral,
	// Ollama, OpenAI, TogetherAI.

	// Using a free small model for testing.
	// See https://ai.google.dev/gemini-api/docs/models/gemini?hl=en
	ctx := context.Background()
	c, err := gemini.New(ctx, genai.ProviderOptionModel("gemini-2.5-flash"))
	if c != nil {
		defer func() {
			if err := c.Close(); err != nil {
				log.Printf("Close: %v", err)
			}
		}()
	}
	if err != nil {
		log.Print(err)
		return
	}
	msgs := genai.Messages{genai.NewTextMessage("What season are we in?")}
	opts := genai.GenOptionTools{
		// GetTodayClockTime returns the current time and day in a format that the LLM
		// can understand. It includes the weekend.
		Tools: []genai.ToolDef{GetTodayClockTime},
		// Force the LLM to do a tool call first.
		Force: genai.ToolCallRequired,
	}
	newMsgs, _, err := adapters.GenSyncWithToolCallLoop(ctx, c, msgs, &opts)
	if err != nil {
		log.Print(err)
		return
	}
	fmt.Printf("%s\n", newMsgs[len(newMsgs)-1].String())
}

var GetTodayClockTime = genai.ToolDef{
	Name:        "get_today_date_current_clock_time",
	Description: "Get the current clock time and today's date.",
	Callback: func(ctx context.Context, e *empty) (string, error) {
		return time.Now().Format("Monday 2006-01-02 15:04:05"), nil
	},
}

type empty struct{}

Output:

package main

import (
	"context"
	"fmt"
	"log"
	"time"

	"github.com/maruel/genai"
	"github.com/maruel/genai/adapters"
	"github.com/maruel/genai/providers/openaichat"
)

func main() {
	ctx := context.Background()
	c, err := openaichat.New(ctx, genai.ProviderOptionModel("gpt-realtime-2.1"))
	if err != nil {
		log.Print(err)
		return
	}
	defer func() {
		if err := c.Close(); err != nil {
			log.Printf("Close: %v", err)
		}
	}()
	tools := []genai.ToolDef{GetTodayClockTime}
	s, err := c.ConnectRealtime(ctx, &genai.RealtimeOptionTools{Tools: tools}, genai.RealtimeTurnManual)
	if err != nil {
		log.Print(err)
		return
	}
	s = adapters.RealtimeWithToolCallLoop(s, tools)
	defer func() {
		if err := s.Close(); err != nil {
			log.Printf("Close: %v", err)
		}
	}()
	// The adapter uses these tools. Send RealtimeUpdate with new Tools to
	// replace the active set.
	if err := s.Send(ctx, genai.RealtimeInputContent{Text: "What time is it?", Generate: true}); err != nil {
		log.Print(err)
		return
	}
	for e, err := range s.Receive(ctx) {
		if err != nil {
			log.Print(err)
			return
		}
		switch e.Kind {
		case genai.RealtimeEventContentText:
			fmt.Print(e.Content.Text)
		case genai.RealtimeEventError:
			log.Printf("Provider rejected a command: %v", e.Error)
		case genai.RealtimeEventTurnDone:
			return
		default:
			// Audio and transcription events are ignored in this example.
		}
	}
}

var GetTodayClockTime = genai.ToolDef{
	Name:        "get_today_date_current_clock_time",
	Description: "Get the current clock time and today's date.",
	Callback: func(ctx context.Context, e *empty) (string, error) {
		return time.Now().Format("Monday 2006-01-02 15:04:05"), nil
	},
}

type empty struct{}

Output: