aiassist

Documentation

Overview

Package aiassist is an optional, bring-your-own-key bridge to an LLM that explains requests, suggests payloads, and summarizes findings. It is off until the user supplies an API key, and it only ever talks to the configured provider — captured traffic is sent only when the user explicitly asks.

Two providers are supported: Anthropic (native Messages API) and OpenRouter (OpenAI-compatible chat completions, which fronts many models).

Index

• Constants
• func ValidateOpenRouter(ctx context.Context, key, model string) error
• func ValidateOpenRouterKey(ctx context.Context, key string) error
• func ValidateOpenRouterModel(ctx context.Context, model string) error
• type AgentMessage
• type AgentTurn
• type Client
  • func New(provider, key, model string) *Client
  • func (c *Client) Complete(system, user string) (string, error)
  • func (c *Client) CompleteAgentTurn(ctx context.Context, system string, messages []AgentMessage, tools []Tool) (*AgentTurn, error)
  • func (c *Client) CompleteMessages(system string, messages []Message) (string, error)
  • func (c *Client) CompleteStream(ctx context.Context, system, user string, onDelta func(string)) error
  • func (c *Client) CompleteStreamAgentMessages(ctx context.Context, system string, messages []AgentMessage, ...) error
  • func (c *Client) CompleteStreamMessages(ctx context.Context, system string, messages []Message, onDelta func(string)) error
  • func (c *Client) SupportsAgentTools() bool
• type ContentBlock
• type Message
• type OpenRouterModel
  • func ListOpenRouterModels(ctx context.Context) ([]OpenRouterModel, error)
• type Tool
• type ToolCall

Constants

const (
	ProviderAnthropic  = "anthropic"
	ProviderOpenRouter = "openrouter"
)

Providers.

Functions

func ValidateOpenRouter

func ValidateOpenRouter(ctx context.Context, key, model string) error

ValidateOpenRouter checks key and model before saving OpenRouter settings.

func ValidateOpenRouterKey

func ValidateOpenRouterKey(ctx context.Context, key string) error

ValidateOpenRouterKey checks the API key against OpenRouter's auth endpoint. The public /models endpoint returns 200 even for invalid keys, so /auth/key is required.

func ValidateOpenRouterModel

func ValidateOpenRouterModel(ctx context.Context, model string) error

ValidateOpenRouterModel ensures model is non-empty and present in the catalog.

Types

type AgentMessage

type AgentMessage struct {
	Role    string
	Content any // string or []ContentBlock
}

AgentMessage is one turn in an agent conversation (user or assistant).

type AgentTurn

type AgentTurn struct {
	StopReason string
	Blocks     []ContentBlock
	ToolCalls  []ToolCall
	Text       string
}

AgentTurn is one non-streaming model reply that may include tool calls.

type Client

type Client struct {
	// contains filtered or unexported fields
}

Client calls a chosen LLM provider with a user-provided key.

func New

func New(provider, key, model string) *Client

New returns a client for the given provider (defaults to Anthropic for an unknown/empty value). An empty model uses that provider's default.

func (*Client) Complete

func (c *Client) Complete(system, user string) (string, error)

Complete sends a system + user prompt and returns the model's text reply.

func (*Client) CompleteAgentTurn

func (c *Client) CompleteAgentTurn(ctx context.Context, system string, messages []AgentMessage, tools []Tool) (*AgentTurn, error)

CompleteAgentTurn sends one agent turn with tools and returns the model reply.

func (*Client) CompleteMessages

func (c *Client) CompleteMessages(system string, messages []Message) (string, error)

CompleteMessages sends a system prompt and an ordered message history.

func (*Client) CompleteStream

func (c *Client) CompleteStream(ctx context.Context, system, user string, onDelta func(string)) error

CompleteStream sends the prompt and invokes onDelta for each incremental text chunk as the model generates it (Server-Sent Events). It returns when the stream ends, the provider reports an error, or ctx is cancelled. onDelta is always called from the calling goroutine.

func (*Client) CompleteStreamAgentMessages

func (c *Client) CompleteStreamAgentMessages(ctx context.Context, system string, messages []AgentMessage, onDelta func(string)) error

CompleteStreamAgentMessages streams a final agent reply (no tools) token by token.

func (*Client) CompleteStreamMessages

func (c *Client) CompleteStreamMessages(ctx context.Context, system string, messages []Message, onDelta func(string)) error

CompleteStreamMessages is the multi-turn streaming variant of CompleteMessages.

func (*Client) SupportsAgentTools

func (c *Client) SupportsAgentTools() bool

SupportsAgentTools reports whether this client can run tool-use agent loops.

type ContentBlock

type ContentBlock struct {
	Type      string         `json:"type"`
	Text      string         `json:"text,omitempty"`
	ID        string         `json:"id,omitempty"`
	Name      string         `json:"name,omitempty"`
	Input     map[string]any `json:"input,omitempty"`
	ToolUseID string         `json:"tool_use_id,omitempty"`
	Content   string         `json:"content,omitempty"`
	IsError   bool           `json:"is_error,omitempty"`
}

ContentBlock is one piece of an agent message (text, tool_use, or tool_result).

type Message

type Message struct {
	Role    string
	Content string
}

Message is one turn in a multi-message completion (user or assistant).

type OpenRouterModel

type OpenRouterModel struct {
	ID   string `json:"id"`
	Name string `json:"name"`
}

OpenRouterModel is one entry from the OpenRouter model catalog.

func ListOpenRouterModels

func ListOpenRouterModels(ctx context.Context) ([]OpenRouterModel, error)

ListOpenRouterModels returns chat models from the OpenRouter catalog.

type Tool

type Tool struct {
	Name        string
	Description string
	InputSchema map[string]any
}

Tool is one callable function exposed to the model during agent mode.

type ToolCall

type ToolCall struct {
	ID    string
	Name  string
	Input map[string]any
}

ToolCall is a tool invocation the model requested.