port

type CompletionRequest struct {
	Messages      []domain.Message
	Tools         []domain.ToolSpec
	ForbidToolUse bool
	// RequireToolUse 는 이번 라운드에 도구를 반드시 하나 부르게 한다(조회 질문의 첫 라운드). ForbidToolUse 가
	// 참이면 그쪽이 이긴다.
	RequireToolUse bool
}

type Credentials map[string]string

type LLM interface {
	Complete(ctx context.Context, req CompletionRequest) (domain.Message, error)
}

type LLMFactory interface {
	New(s domain.Settings) (LLM, error)
}

type SettingsRepository interface {
	Get(ctx context.Context, orgID string) (*domain.Settings, error)
	Save(ctx context.Context, s domain.Settings) error
	Delete(ctx context.Context, orgID string) error
}

type ToolSession interface {
	ListTools(ctx context.Context) ([]domain.ToolSpec, error)
	// CallTool 은 도구를 부른다. isError 는 도구가 실패를 결과로 돌려준 것(권한 없음 · 없는 스택)이고,
	// err 는 도구를 부르지 못한 것이다.
	CallTool(ctx context.Context, name, arguments string) (output string, isError bool, err error)
	Close() error
}

type ToolSessionOpener interface {
	Open(ctx context.Context, creds Credentials) (ToolSession, error)
}