Nowa wersja SDK Cline, oznaczona numerem 0.0.64, została udostępniona w repozytorium 17 lipca 2026 roku. Wprowadza dwie istotne poprawki dotyczące kompatybilności. Aktualizacja koncentruje się na ujednoliceniu obsługi maksymalnych tokenów wyjściowych w różnych ścieżkach providerów oraz na poprawnym parsowaniu plików zapisanych przez edytory Windows. Choć zmiany są technicznie niewielkie, eliminują uciążliwe błędy, które mogły zakłócić sesję agenta w nieoczekiwanym momencie.
Kluczowe zmiany
- Jednolita obsługa limitów tokenów dla trasowania przez bramkę, providera OpenAI i modeli reasoningowych
- Pliki z BOM-em UTF-8 są teraz poprawnie parsowane — dotyczy frontmatter w Markdown i plików z instrukcjami
- Automatyczna konwersja plików między Windows a innymi systemami — SDK radzi sobie z tym samodzielnie
- Poprawki na styku providerów eliminują niespójne zachowania przy generowaniu kodu i wywołaniach narzędzi
Tokeny pod kontrolą — bez względu na providera
Problem z maksymalną liczbą tokenów wyjściowych był uciążliwy. Gdy konfiguracja ustalała limit, ale SDK nie przekazywało go poprawnie do konkretnego providera, model mógł przestać generować odpowiedź w trakcie wywołania narzędzia. W niektórych przypadkach zachowywał się inaczej, w zależności od tego, czy żądanie szło bezpośrednio przez OpenAI, przez bramkę, czy do modelu reasoningowego.
Poprawka w wersji 0.0.64 nie zwiększa samego limitu, lecz zmienia sposób, w jaki SDK go przekazuje. Umożliwia to, aby skonfigurowana wartość docierała tam, gdzie powinna, i była respektowana przez każdą ścieżkę. Dla osób generujących długie pliki konfiguracyjne lub skomplikowane struktury kodu, ta zmiana oznacza mniej niespodzianek przy kompilacji.
Warto dodać, że późniejsze wydania SDK wprowadzały dodatkowe poprawki dla modeli reasoningowych, które mogły pomijać kompaktowanie, gdy system niewłaściwie honorował jawny limit. To pokazuje, że zarządzanie budżetem tokenów pozostaje aktualnym tematem w ekosystemie agentów AI.
BOM, którego już nie widać
Druga zmiana dotyczy znacznika kolejności bajtów (BOM) w plikach UTF-8, który jest często dodawany przez starsze edytory w systemie Windows. Ten niewidoczny znacznik może skutecznie zakłócić parsowanie.
Gdy plik z instrukcjami dla Cline zaczynał się od BOM-a, parser nie znajdował oczekiwanego delimitera frontmatter na pierwszej pozycji. W rezultacie odrzucał plik jako niepoprawny lub, co gorsza, interpretował go w sposób prowadzący do trudnych do zdiagnozowania błędów w działaniu agenta.
Od wersji 0.0.64 SDK usuwa BOM-a przed parsowaniem. Dotyczy to plików Markdown z frontmatter w YAML, plików z instrukcjami użytkownika oraz reguł i workflow. Użytkownicy nie muszą już ręcznie konwertować plików do UTF-8 bez BOM za każdym razem, gdy edytują je w notatniku i wrzucają do repozytorium.
Dlaczego to ma znaczenie
Cline SDK to open-source'owy runtime agenta, wykorzystywany zarówno w rozszerzeniach IDE, jak i przez zespoły budujące własne aplikacje agentowe. Dla osób pracujących w web dev i DevOps obie poprawki są istotne, ponieważ dotyczą kluczowych punktów styku między systemami.
Pierwszy problem dotyczy granicy między providerami modeli — niespójne limity tokenów mogą prowadzić do niekompletnego generowania kodu. Drugi problem to granica między systemami plików — pliki utworzone w Windows mogą nie działać poprawnie w środowisku linuksowym.
Te zmiany mogą być niewidoczne, dopóki coś się nie zepsuje. Jednak w momencie wystąpienia problemu mogą powodować więcej frustracji niż skomplikowane błędy.
Dodaj komentarz