chat

type Caller struct {
	Login string
	Role  string // "admin" | "viewer"
}

type Config struct {
	// Provider is the LLM provider implementation. Must support tool use.
	Provider llm.ToolCapableProvider
	// Model is the provider-specific model identifier.
	Model string
	// APIKey authenticates the LLM call.
	APIKey string
	// Endpoint / Deployment are forwarded to llm.CallOptions for Azure.
	Endpoint   string
	Deployment string
	// MaxTurns caps the tool-loop iteration count. Falls back to 6.
	MaxTurns int
	// MaxTokens caps each turn's output. Falls back to 2048.
	MaxTokens int
	// Tools is the read-only tool surface available to the model.
	Tools Toolbox
	// Caller carries identity (login, role) for tool authorization decisions.
	Caller Caller
	// PageContext is an optional short string describing where the user is in
	// the UI ("/jobs/abc123"). It's included in the system prompt verbatim.
	PageContext string
}

type Message struct {
	Role    string `json:"role"` // "user" | "assistant"
	Content string `json:"content"`
}

type Sink interface {
	// Token is called for every text delta the model emits.
	Token(delta string)
	// ToolStart is called when a tool call begins (for UI signaling).
	ToolStart(name string, input json.RawMessage)
	// ToolEnd is called when a tool call completes. errMsg is empty on success.
	ToolEnd(name string, errMsg string)
}

type Toolbox struct {
	Queries *dbgen.Queries
	OrgID   pgtype.UUID
}