Warp — otwarty klient terminala z funkcjami agentowymi
Warp był latami najlepszym terminalem, którego źródeł nie mogłeś zobaczyć. To się zmieniło — klient jest dziś otwarty na AGPL. Projekt sam rysuje przy tym granicę między tym, co otwarte, a tym, co zostało własnościowe, i robi to uczciwiej niż ktokolwiek w tej serii.
Warp miał latami reputację narzędzia, o którym mówiło się z dwuznacznym podziwem: najlepszy terminal, którego źródeł nie zobaczysz. Ładny, szybki, z pomysłami, których nie miał nikt inny — i całkowicie zamknięty, z obowiązkowym kontem.
To się zmieniło i przyznaję, że zabierając się za ten wpis, sprawdzałem repozytorium z założeniem, że znajdę w nim wyłącznie zgłoszenia błędów. Znalazłem pełne źródła klienta w Ruscie, dwa pliki licencji i jeden z najuczciwszych dokumentów, jakie w tej serii czytałem.
Bo „otwarte" jest tu słowem wymagającym mapy — i projekt sam tę mapę rysuje, zamiast liczyć, że nikt nie zapyta.
Stan projektu
warpdotdev/warp ma 64 935 gwiazdek i 5523 forki, a repozytorium istnieje od lipca 2021. Kod jest w Ruscie, commity z dnia powstania tego tekstu, a samo repozytorium waży kilkaset megabajtów — to nie jest atrapa z samym plikiem README.
Uczciwie o liczbie, która zwraca uwagę: 5214 otwartych zgłoszeń. To najwięcej, jakie w tej serii widziałem. Przy produkcie o takiej liczbie użytkowników jest to poniekąd naturalne, ale nie licz na to, że twoje zgłoszenie zostanie zauważone bez dodatkowego zabiegania.
Warto też odnotować, że projekt określa się dziś szerzej niż w tytule tego wpisu: nie jako terminal, ale jako środowisko programistyczne o charakterze agentowym, wyrosłe z terminala. Tytuł zostawiam, bo jest trafny — to wciąż klient terminala i tak go używa większość ludzi — ale kierunek rozwoju jest wyraźnie inny.
Co jest otwarte, a co nie
Tę część projekt opisuje w osobnym dokumencie z pytaniami i odpowiedziami, i robi to z rzadką precyzją. Przytaczam, bo to jedyne, co się liczy przy ocenie.
W repozytorium jest: aplikacja klienta, biblioteka interfejsu, testy integracyjne, umiejętności dla agentów oraz specyfikacje funkcji.
W repozytorium nie ma: serwera, zaplecza usługi synchronizacji, hostowanego uwierzytelniania oraz warstwy orkiestracji agentów. Te części — jak pisze projekt wprost — pozostają własnościowe.
Konsekwencja praktyczna jest opisana równie jasno: część funkcji działa w całości lokalnie, ale synchronizacja, agenci korzystający z modeli hostowanych oraz funkcje zespołowe wymagają zaplecza Warpa. Projekt dodaje przy tym, że pracuje nad wyraźniejszym pokazaniem, co da się uruchomić lokalnie — czyli przyznaje, że dziś ta granica nie jest dla użytkownika oczywista.
Na pytanie, czy serwer kiedyś zostanie otwarty, odpowiada zdaniem, które zapamiętałem: nie zobowiązali się do żadnej daty i nie chcą obiecywać za wiele, bo otwarcie klienta na AGPL było drzwiami w jedną stronę, a otwarcie serwera byłoby zobowiązaniem tego samego rodzaju. Tak wygląda uczciwa odpowiedź na niewygodne pytanie i wolę ją od zapewnień o „planach na przyszłość".
Osobno warto wiedzieć jedno: agenci korzystający z modeli hostowanych działają po stronie zaplecza. Znaczy to, że kontekst z twojego terminala — a więc fragmenty kodu, nazwy plików, treść poleceń — trafia na serwery dostawcy. Przy pracy na kodzie klienta objętym umową o poufności jest to decyzja, którą trzeba podjąć świadomie.
Dwie licencje i uzasadnienie warte przeczytania
Podział licencyjny jest prosty: biblioteka interfejsu na MIT, cała reszta na AGPL v3. Ciekawsze jest jednak to, że projekt wyjaśnia, dlaczego akurat tak — i jest to najlepsze uzasadnienie wyboru licencji, jakie w tej serii spotkałem.
Dla klienta wybrano AGPL, bo chciano, żeby modyfikacje pozostały otwarte. Licencja permisywna pozwoliłaby komuś odgałęzić klienta, zmienić go i wypuścić użytkownikom jako produkt zamknięty — a to, jak piszą, wzorzec, który widzieli już przy projektach otwartych skierowanych do użytkownika końcowego i którego nie chcą zasiewać. AGPL zamyka przy tym lukę użycia sieciowego, jaką zostawia zwykła GPL, więc hostowana odmiana klienta też jest objęta. Autorzy dodają, że AGPL jest surowsza, niż część firm akceptuje we własnych produktach — i to przyjmują, bo klient nie jest miejscem, w którym oczekują takiego wykorzystania.
Dla biblioteki interfejsu wybrano MIT z powodu odwrotnego: jest to infrastruktura ogólnego przeznaczenia, użyteczna daleko poza Warpem, więc chcą, by ludzie budujący niezwiązane aplikacje w Ruscie mogli ją wziąć bez tarcia, jakie wprowadza AGPL.
To rozumowanie jest warte przeniesienia do własnych projektów: surowa licencja tam, gdzie chcesz, by odgałęzienia pozostały otwarte, permisywna tam, gdzie chcesz maksymalnego zasięgu. Rzadko widzę, by ktoś tak jasno powiedział, czego od licencji oczekuje.
Odpowiedź, której szuka twój dział prawny
AGPL brzmi w firmach jak alarm i część działów prawnych ma politykę wykluczającą ją bez czytania. Dlatego wyróżniam odpowiedź, którą projekt daje wprost.
Na pytanie, czy wolno używać Warpa w firmie, odpowiada: tak — używanie go jako terminala albo środowiska pracy nie uruchamia żadnych obowiązków AGPL. Obowiązki pojawiają się wtedy, gdy zmodyfikujesz klienta i będziesz rozprowadzać albo hostować tę zmodyfikowaną wersję dla innych.
Jest to odczyt zgodny z literą licencji i wart zapamiętania, bo pokazuje coś ogólniejszego. Cztery dni wcześniej pisałem o innym projekcie na tej samej licencji, w którym opis oferty płatnej obejmował także narzędzia wewnętrzne — czyli wydawca zajmował stanowisko szersze niż tekst AGPL. Tutaj jest odwrotnie: wydawca sam zawęża odczyt do tego, co licencja rzeczywiście mówi.
Wniosek praktyczny: „to jest na AGPL" nie jest odpowiedzią, tylko początkiem pytania. Ta sama licencja przy dwóch różnych wydawcach oznacza dwie różne sytuacje, bo o wykładni i o ofercie płatnej decyduje właściciel praw. Przy każdym takim projekcie warto poszukać, czy zajął stanowisko — a jeśli tak, jak brzmi.
Agent jako pierwszy recenzent
A teraz element, którego nie widziałem dotąd w żadnym projekcie otwartym i który uważam za najciekawszą rzecz w całym tym repozytorium.
Gdy otwierasz zgłoszenie zmiany, automatycznie przypisywany jest agent, który wykonuje pierwszą recenzję. Dopiero po jego akceptacji sam prosi o recenzję kogoś z zespołu, kto zna dany obszar. Nie musisz nikogo przypisywać ręcznie.
Mechanizm ma dopracowane szczegóły. Po wprowadzeniu poprawek możesz komentarzem poprosić o ponowną recenzję — do trzech razy na zgłoszenie. Współpracownicy z dorobkiem scalonych zmian mogą kierować agenta wprost na gotowe zgłoszenia. Praca agenta na tym repozytorium jest przy tym opłacana przez wydawcę, więc uczestnictwo nie wymaga własnego konta ani płacenia za obliczenia.
Najważniejsze jest jednak zdanie o poprzeczce: zmiany napisane przez agenta podlegają tej samej recenzji i tym samym testom co pisane ręcznie. Cytując projekt: to, czy kod napisał człowiek, czy agent, nie zmienia progu jakości — zmienia tylko szybkość, z jaką da się do tego progu dojść.
Uważam to za rozwiązanie ustawione właściwie i wskazujące kierunek. Agent nie zastępuje recenzenta, ale przechwytuje pierwszą, najbardziej mechaniczną warstwę uwag, dzięki czemu człowiek dostaje zgłoszenie już uporządkowane. Przy pięciu tysiącach otwartych spraw to nie jest zabawka, ale konieczność.
Specyfikacja przed kodem
Druga rzecz z procesu, którą warto skopiować niezależnie od tego, czy używasz Warpa.
Zgłoszenia dostają etykiety gotowości: jedna oznacza, że problem jest zrozumiany, a projekt otwarty do zaprojektowania; druga, że projekt jest ustalony i można pisać kod; trzecia, że najpierw potrzebne są makiety. Każdy może wziąć oznaczone zgłoszenie.
Nowe funkcje przechodzą przy tym przez osobne zgłoszenie ze specyfikacją, zanim powstanie kod. Specyfikacja to dwa pliki: opis pożądanego zachowania oraz plan implementacji, składane w katalogu nazwanym numerem zgłoszenia. Uzasadnienie jest zdroworozsądkowe: specyfikacja pozwala ocenić zakres, zachowanie i architekturę osobno, zanim ktoś napisze kod, który trzeba będzie wyrzucić.
Kto prowadził projekt otwarty, wie, jak kosztowna jest sytuacja odwrotna — ktoś przysyła dwa tysiące linii, a okazuje się, że rozwiązał inny problem, niż był do rozwiązania. Rozdzielenie decyzji projektowej od implementacji jest najprostszym sposobem, by tego uniknąć.
Repozytorium dostarcza też kontekst dla agentów — umiejętności w osobnym katalogu, specyfikacje i plik z przewodnikiem inżynierskim — w formatach, które podchwyci dowolne narzędzie je obsługujące. Ten sam wzorzec widziałem przy szablonie FastAPI opisanym kilka dni wcześniej i coraz mocniej uważam go za nowy standard dobrego repozytorium.
Dwie deklaracje warte odnotowania
Pierwsza jest jednoznacznie dobra. Na pytanie, czy zgłoszenia, komentarze i kod z tego repozytorium będą używane do trenowania modeli, projekt odpowiada krótko: nie. Przy firmie rozwijającej narzędzia agentowe warto mieć to napisane.
Druga wymaga uwagi. Uczestnictwo wymaga podpisania umowy licencyjnej współtwórcy, a jej cel jest opisany jako przyznanie wydawcy praw potrzebnych do rozprowadzania wkładu na licencjach projektu oraz do zaspokojenia przyszłych potrzeb licencyjnych i zgodnościowych. Projekt zapewnia, że nie zmienia to licencji kodu wniesionego do repozytorium — i to jest prawda.
Warto jednak rozumieć, co taka umowa oznacza w ogólności: to właśnie ona jest mechanizmem, który umożliwia właścicielowi ewentualną zmianę licencji w przyszłości. Nie jest to zarzut, bo tak działa większość projektów firmowych, a bez takiej umowy zmiana licencji wymagałaby zgody każdego współtwórcy osobno. Jest to natomiast rzecz, którą przy planowaniu na lata warto mieć w świadomości — zwłaszcza czytając ją obok zdania o „drzwiach w jedną stronę".
Pułapki w jednym miejscu
- Otwarty jest klient, nie usługa. Serwer, zaplecze synchronizacji, hostowane uwierzytelnianie i orkiestracja agentów pozostają własnościowe.
- Nie da się dziś podłączyć własnego modelu ani subskrypcji. Warstwa agenta działa po stronie serwera; obsługa otwartego protokołu klienta agenta jest w planach, nie w produkcie.
- Agenci hostowani wysyłają kontekst z terminala na serwery dostawcy. Przy kodzie objętym poufnością to decyzja do podjęcia świadomie.
- Granica między funkcjami lokalnymi a chmurowymi nie jest oczywista — projekt sam to przyznaje i zapowiada poprawę.
- AGPL nie przeszkadza w używaniu, ale przeszkadza w osadzaniu. Jeśli chcesz wbudować klienta w zamknięty produkt, ta licencja jest odpowiedzią „nie".
- Umowa licencyjna współtwórcy jest warunkiem uczestnictwa i obejmuje przyszłe potrzeby licencyjne wydawcy.
- 5214 otwartych zgłoszeń. Bez oznaczenia gotowości i zabiegania sprawa może stać długo.
- Nowe funkcje wymagają najpierw specyfikacji. Wysłanie gotowego kodu bez tego etapu to ryzyko pracy do wyrzucenia.
Podsumowanie
Warp jest dziś przypadkiem szczególnym: produktem komercyjnym, który otworzył swoją najbardziej widoczną część i opisał tę decyzję lepiej, niż opisują ją projekty otwarte od początku. Nie jest to pełne otwarcie i nikt tu nie udaje, że jest.
- Pełne źródła klienta w Ruscie, z budowaniem z źródeł na trzech systemach.
- Jawna mapa tego, co otwarte, a co własnościowe, wraz z odmową obiecywania otwarcia serwera.
- Dwie licencje z uzasadnieniem — surowa dla klienta, permisywna dla biblioteki interfejsu.
- Jednoznaczna odpowiedź o użyciu firmowym: samo używanie nie uruchamia obowiązków AGPL.
- Agent jako pierwszy recenzent zgłoszeń, z tą samą poprzeczką jakości i bez kosztu dla uczestnika.
- Specyfikacja przed kodem jako obowiązkowy etap dla nowych funkcji.
- Deklaracja, że wkład nie służy do trenowania modeli.
O licencjach na koniec, bo ten przypadek dobrze pokazuje, po co w ogóle o nich piszę. Klient jest na AGPL v3, biblioteka interfejsu na MIT — i te dwie nazwy same z siebie nie mówią prawie nic. Dopiero po przeczytaniu, co jest w repozytorium, czego w nim nie ma i jak wydawca odczytuje własną licencję, wiadomo, z czym ma się do czynienia.
Dla firmy używającej Warpa jako narzędzia pracy sprawa jest prosta i wydawca sam ją rozstrzyga: używaj, żadne obowiązki się nie uruchamiają. Dla firmy, która chciałaby coś na tym zbudować i sprzedać jako zamknięte, odpowiedzią jest „nie" — i jest to odpowiedź zamierzona, nie skutek uboczny. A dla kogoś, kto szuka porządnej biblioteki interfejsu w Ruscie, w tym repozytorium leży, na MIT, warstwa napisana dla produktu z sześćdziesięcioma tysiącami gwiazdek. To ostatnie jest przy okazji najmniej oczywistą rzeczą, jaką znalazłem, i całkiem możliwe, że najbardziej przydatną.