cc-viewer 1.7.21 → 1.7.23

package/concepts/pl/Tool-REPL.md

@@ -0,0 +1,47 @@
+# REPL
+
+Wykonuje JavaScript w trwałym kontekście vm Node.js wewnątrz sesji. Obsługiwane jest `await` na najwyższym poziomie, a zmienne/funkcje zdefiniowane w jednym wywołaniu pozostają dostępne w późniejszych wywołaniach.
+
+## Kiedy używać
+
+- Szybkie obliczenia, transformacje danych lub przekształcanie JSON, które są łatwiejsze w kodzie niż w jednolinijkowcach w shellu.
+- Wieloetapowe skrypty, w których stan pośredni powinien przetrwać między wywołaniami (liczniki, wyniki akumulowane).
+- Interaktywne badanie zachowania API lub biblioteki przed zapisaniem go w pliku.
+
+## Aktywacja
+
+- Domyślnie wyłączone — ustaw `CLAUDE_CODE_REPL=true`, aby je włączyć.
+- W sesjach terminalowych (`cli`) i claude.ai (`remote`) może je również włączyć flaga funkcji po stronie serwera.
+- Gdy wyłączone, REPL jest ukryte przed listą narzędzi modelu. Gdy włączone, `Read`, `Glob`, `Grep`, `Bash`, `PowerShell` i `NotebookEdit` są zastępowane skrótami REPL.
+
+## Parametry
+
+- `code` (string, wymagany): Kod JavaScript do wykonania. Obsługuje `await` na najwyższym poziomie. Stan utrzymuje się między wywołaniami.
+- `description` (string, opcjonalny): Jasny, zwięzły opis tego, co robi ten skrypt, w stronie czynnej (5–10 słów), np. "Trace upgrade message to its GrowthBook flag".
+- `timeout` (number, opcjonalny): Limit czasu w milisekundach. Domyślnie 30000; maksymalnie 600000.
+
+## Przykłady
+
+### Przykład 1: Obliczenie i ponowne wykorzystanie stanu
+
+```
+REPL(code="const counts = new Map(); ['a','b','a'].forEach(k => counts.set(k, (counts.get(k)||0)+1)); counts.get('a')")
+```
+
+Zwraca `2`; `counts` pozostaje zdefiniowane dla kolejnych wywołań REPL w tej samej sesji.
+
+### Przykład 2: `await` na najwyższym poziomie z dłuższym limitem czasu
+
+```
+REPL(
+  code="const res = await fetch('https://example.com/api'); await res.json()",
+  description="Fetch example API and parse JSON",
+  timeout=60000
+)
+```
+
+## Uwagi
+
+- Stan jest per sesja: ponowne uruchomienie sesji czyści wszystkie definicje.
+- To środowisko JavaScript (Node) — używaj Bash dla poleceń shell, pracy wymagającej systemu plików lub środowisk uruchomieniowych innych niż JS.
+- Długo działający kod powinien ustawić jawny `timeout`; domyślne 30 s zabija wszystko, co działa wolniej.

package/concepts/pl/Tool-ReadMcpResource.md

@@ -0,0 +1,32 @@
+# ReadMcpResource
+
+Odczytuje pojedynczy zasób udostępniany przez podłączony serwer MCP (Model Context Protocol), adresowany jego URI.
+
+## Kiedy używać
+
+- Serwer MCP reklamuje zasób (plik, rekord, dokument), którego zawartość potrzebujesz w kontekście.
+- Masz konkretny URI zasobu — z `ListMcpResources`, z dokumentacji serwera lub z poprzedniego wyniku narzędzia.
+
+## Aktywacja
+
+- Zawsze włączone, ale nieujawniane na liście narzędzi modelu — przeznaczone do użytku w cienkim kliencie / sidecar.
+
+## Parametry
+
+- `server` (string, wymagany): Nazwa serwera MCP.
+- `uri` (string, wymagany): URI zasobu do odczytu.
+
+## Przykłady
+
+### Przykład 1: Odczyt zasobu serwera po URI
+
+```
+ReadMcpResource(server="github", uri="file:///repo/docs/architecture.md")
+```
+
+Zwraca zawartość zasobu dostarczoną przez serwer MCP `github`.
+
+## Uwagi
+
+- Użyj najpierw `ListMcpResources`, jeśli nie wiesz, jakie zasoby udostępnia serwer; użyj `ReadMcpResourceDir` dla listowań w stylu katalogu.
+- Schemat URI jest specyficzny dla serwera (`file://`, `https://`, schematy własne) — sprawdź, co reklamuje serwer docelowy.

package/concepts/pl/Tool-ReadMcpResourceDir.md

@@ -0,0 +1,32 @@
+# ReadMcpResourceDir
+
+Wyświetla wpisy katalogowego zasobu udostępnianego przez podłączony serwer MCP, adresowanego jego URI.
+
+## Kiedy używać
+
+- Serwer MCP organizuje zasoby hierarchicznie, a Ty musisz wyliczyć jeden poziom tej hierarchii.
+- Chcesz przeglądać, zanim odczytasz poszczególne zasoby za pomocą `ReadMcpResource`.
+
+## Aktywacja
+
+- Zawsze włączone, ale nieujawniane na liście narzędzi modelu — przeznaczone do użytku w cienkim kliencie / sidecar.
+
+## Parametry
+
+- `server` (string, wymagany): Nazwa serwera MCP.
+- `uri` (string, wymagany): URI zasobu katalogu do wyświetlenia.
+
+## Przykłady
+
+### Przykład 1: Wyświetlenie katalogu zasobów
+
+```
+ReadMcpResourceDir(server="filesystem", uri="file:///project/src/")
+```
+
+Zwraca wpisy potomne, które serwer udostępnia pod tym URI katalogu.
+
+## Uwagi
+
+- Obsługują to tylko serwery modelujące swoje zasoby jako katalogi; serwery płaskie zwrócą błąd lub puste listowanie — wróć wtedy do `ListMcpResources`.
+- Łącz z `ReadMcpResource`, aby wgłębić się we wpisy, które wyglądają na istotne.

package/concepts/pl/Tool-ReadNotifications.md

@@ -0,0 +1,27 @@
+# ReadNotifications
+
+Odczytuje powiadomienia zakolejkowane dla asystenta w bieżącej sesji — aktywność GitHub na obserwowanych PR (`github_webhook`), wyzwolenia zaplanowanych wyzwalaczy (`trigger_fire`) oraz wiadomości nadchodzące z innych sesji Claude (`mcp_send_message`).
+
+## Kiedy używać
+
+- Zostałeś powiadomiony, że coś się wydarzyło — obserwowany PR został zaktualizowany, zaplanowany wyzwalacz został wyzwolony, inna sesja wysłała Ci wiadomość — i potrzebujesz faktycznej zawartości.
+- Opróżnianie zaległości: duże partie są zwracane w częściach, więc wywołuj narzędzie wielokrotnie, dopóki wynik nie zgłosi 0 `remaining`.
+
+## Parametry
+
+To narzędzie nie przyjmuje parametrów.
+
+## Przykłady
+
+### Przykład 1: Opróżnienie oczekujących powiadomień
+
+```
+ReadNotifications()
+```
+
+Zwraca zakolejkowane powiadomienia w kolejności od najstarszych. Wynik zawiera licznik `remaining` powiadomień wciąż zakolejkowanych po tym opróżnieniu — wywołaj narzędzie ponownie, aby je odczytać.
+
+## Uwagi
+
+- Opróżnienia są limitowane rozmiarem: kolejne wywołanie zwraca resztę TEJ SAMEJ kolejki (plus wszystko, co nadeszło nowo), a nie tylko nowe powiadomienia. Wywołuj w pętli, dopóki `remaining` nie wyniesie 0.
+- Powiadomienia pochodzą z webhooków GitHub na obserwowanych PR, zaplanowanych wyzwalaczy oraz wiadomości z innych sesji Claude; w bieżącej wersji nie ma parametru filtrowania.

package/concepts/pl/Tool-RemoteTrigger.md

@@ -10,6 +10,13 @@ Wywołuje API zdalnych wyzwalaczy claude.ai w celu zarządzania zaplanowanymi za
 - Wyświetlanie lub audytowanie wszystkich bieżących wyzwalaczy w celu przeglądu ich konfiguracji i stanu
 - Aktualizowanie ustawień wyzwalacza, takich jak harmonogram, ładunek lub opis, bez konieczności jego ponownego tworzenia
 
+## Aktywacja
+
+- Wymaga planu claude.ai Pro, Max, Team lub Enterprise.
+- Niedostępne na Amazon Bedrock, Claude Platform on AWS, Google Cloud i Microsoft Foundry.
+- Wymaga flag funkcji po stronie serwera oraz ustawień polityki `allow_remote_sessions` / `allow_routines`.
+- Niedostępne w samych sesjach zdalnych.
+
 ## Parametry
 
 - `action` (string, wymagany): operacja do wykonania — jedna z wartości `list`, `get`, `create`, `update` lub `run`

package/concepts/pl/Tool-ScheduleWakeup.md

@@ -10,6 +10,11 @@ Planuje moment wznowienia pracy w trybie dynamicznym `/loop`. Narzędzie pozwala
 - Przy uruchamianiu autonomicznej pętli bez promptu użytkownika — przekaż dosłowny sentinel `<<autonomous-loop-dynamic>>` jako `prompt`
 - Przy odpytywaniu procesu, którego stan za chwilę się zmieni (użyj krótkiego opóźnienia, aby utrzymać pamięć podręczną ciepłą)
 
+## Aktywacja
+
+- Niedostępne na Amazon Bedrock, Claude Platform on AWS, Google Cloud Agent Platform i Microsoft Foundry.
+- Również wyłączone, gdy pobieranie flag funkcji jest wyłączone (zmienne środowiskowe telemetrii/ruchu).
+
 ## Parametry
 
 - `delaySeconds` (liczba, wymagane): Sekundy do wznowienia. Środowisko uruchomieniowe automatycznie ogranicza wartość do `[60, 3600]`, więc ręczne ograniczanie nie jest konieczne.

package/concepts/pl/Tool-SearchMcpRegistry.md

@@ -0,0 +1,31 @@
+# SearchMcpRegistry
+
+Przeszukuje rejestr konektorów MCP po słowach kluczowych, aby odkryć konektory, które mogą pomóc w ukończeniu zadania.
+
+## Kiedy używać
+
+- Zadanie skorzystałoby na usłudze zewnętrznej (bazie danych, trackerze zgłoszeń, API SaaS), a Ty chcesz sprawdzić, czy istnieje dla niej konektor MCP.
+- Użytkownik wymienia produkt i prosi o jego podłączenie — przeszukaj rejestr w poszukiwaniu pasującego konektora.
+
+## Aktywacja
+
+- Dostępne tylko w sesjach zdalnych (claude.ai) na oficjalnym API (first-party).
+
+## Parametry
+
+- `keywords` (tablica stringów, wymagany): Frazy kluczowe opisujące intencję użytkownika lub wymieniony produkt. 1–8 elementów, każdy 1–64 znaki.
+
+## Przykłady
+
+### Przykład 1: Znalezienie konektora dla wymienionego produktu
+
+```
+SearchMcpRegistry(keywords=["linear", "issue tracker"])
+```
+
+Zwraca wpisy rejestru, których konektory pasują do słów kluczowych. Pełne szczegóły konektorów pobierz za pomocą `SuggestConnectors`.
+
+## Uwagi
+
+- Tylko do odczytu i bezpieczne przy współbieżności; wyniki mają ograniczony rozmiar.
+- Wyszukiwanie niczego nie instaluje — to czyste odkrywanie.

package/concepts/pl/Tool-SendFeedback.md

@@ -0,0 +1,38 @@
+# SendFeedback
+
+Wysyła ustrukturyzowaną opinię o Claude Code do Anthropic — zgłoszenia błędów, pomysły na funkcje lub brakujące możliwości — bez opuszczania sesji.
+
+## Kiedy używać
+
+- Użytkownik prosi o zgłoszenie błędu lub wysłanie opinii o samym Claude Code.
+- Natrafiasz na wyraźny defekt produktu (uszkodzona komenda, błędne zachowanie, awaria) wart zgłoszenia.
+- Użytkownik opisuje funkcję, którą chciałby, żeby istniała (pomysł lub brakująca możliwość).
+
+## Parametry
+
+- `type` (string, wymagany): Jedna z wartości `bug`, `idea`, `missing_capability`.
+- `title` (string, wymagany): Krótkie, konkretne jednowierszowe podsumowanie problemu.
+- `details` (string, wymagany): Oznakowane punktorami, w kolejności: **What happened:** (zaobserwowane vs oczekiwane, dokładny tekst błędu, jeśli jest krótki); **What the user said:** (cytat lub "User didn't comment; observed by the model."); **Repro:** (minimalne kroki); **Evidence:** (identyfikatory żądań, znaczniki czasu, ścieżki, wersje — pomiń, jeśli brak); opcjonalnie na końcu **Cause:** tylko jeśli zweryfikowane w trakcie sesji. Od jednej do trzech linii na punktor; bez akapitów narracyjnych, bez spekulacji, bez sekretów.
+- `area` (string, opcjonalny): Krótki tag nazywający część Claude Code, której dotyczy zgłoszenie (np. "hooks config", "/help", "file editing"). Pozostaw puste, jeśli niejasne.
+- `failure_mode` (string, opcjonalny): Dla raportów o zachowaniu modelu najbliższy tryb awarii (np. `instruction_following`, `repetition_and_looping`, `context_and_memory`, `stopping_short` lub `other`). Pomiń tylko wtedy, gdy raport dotyczy czysto produktowego błędu narzędzia.
+- `task_category` (string, opcjonalny): Co robiła sesja, gdy wystąpił problem: `code_edit`, `debug`, `explain`, `plan`, `shell`, `search`, `review` lub `other`.
+
+## Przykłady
+
+### Przykład 1: Zgłoszenie błędu produktu
+
+```
+SendFeedback(
+  type="bug",
+  title="/export truncates the last message",
+  details="**What happened:** exported transcript is missing the final assistant message.\n**What the user said:** \"the last reply never shows up in the file\".\n**Repro:** run /export after any multi-turn session.\n**Evidence:** v2.1.233, macOS.",
+  area="/export",
+  task_category="other"
+)
+```
+
+## Uwagi
+
+- Nigdy nie umieszczaj w `details` sekretów, tokenów ani prywatnych danych użytkownika.
+- Cytuj słowa użytkownika, gdy są dostępne; w przeciwnym razie wskaż, że problem zaobserwował model.
+- Utrzymuj raport rzeczowy — spekulacje na temat przyczyny źródłowej należą do `**Cause:**` tylko wtedy, gdy zostały zweryfikowane w trakcie sesji.

package/concepts/pl/Tool-SendFile.md

@@ -0,0 +1,36 @@
+# SendFile
+
+Wysyła jeden lub więcej plików do innej sesji Claude Code — sesji równorzędnej wylistowanej przez `ListAgents` lub jawnemu adresowi sesji.
+
+## Kiedy używać
+
+- Sesja równorzędna potrzebuje pliku z Twojego katalogu roboczego (raportu, łatki, fixture) do kontynuowania własnego zadania.
+- Koordynujesz pracę między sesjami i chcesz przekazać artefakty, nie tylko tekst (dla tekstu użyj `SendMessage`).
+
+## Aktywacja
+
+- Przesyłanie plików między sesjami musi być dostępne w sesji; gdy nie jest, walidacja kończy się komunikatem "Cross-session file transfer is not available in this session."
+- Bramkowane tymi samymi warunkami wysyłania wiadomości między sesjami co `ListAgents` (flagi funkcji po stronie serwera, domyślnie wyłączone).
+
+## Parametry
+
+- `to` (string, wymagany): Odbiorca — nazwa sesji równorzędnej z `ListAgents` lub jawny adres `uds:<socket>` / `bridge:<session id>`.
+- `files` (tablica stringów, wymagany): Ścieżki plików (bezwzględne lub względem katalogu roboczego) do wysłania. Zawsze przekazuj tablicę, nawet dla pojedynczego pliku. 1–16 plików, maksymalnie 30 MiB każdy.
+- `message` (string, opcjonalny): Krótka wiadomość dostarczana wraz z plikami.
+
+## Przykłady
+
+### Przykład 1: Wysłanie raportu do sesji równorzędnej
+
+```
+SendFile(
+  to="teammate-a",
+  files=["./dist/report.html"],
+  message="The analysis you asked for"
+)
+```
+
+## Uwagi
+
+- Transfery na zdalne maszyny mogą wymagać dodatkowego zatwierdzenia.
+- Odczyt zawartości pliku jest częścią wysyłania — odmówiony, jeśli odczyt plików jest zablokowany przez reguły uprawnień.

package/concepts/pl/Tool-SendMessage.md

@@ -10,6 +10,11 @@ Dostarcza wiadomość od jednego członka zespołu do drugiego w ramach aktywneg
 - Odpowiadanie na monit protokolarny, taki jak prośba o wyłączenie lub prośba o zatwierdzenie planu od lidera zespołu.
 - Zamykanie pętli na końcu delegowanego zadania, aby lider mógł oznaczyć element jako ukończony.
 
+## Aktywacja
+
+- Bramkowane tymi samymi warunkami wysyłania wiadomości między sesjami co `ListAgents` (flagi funkcji po stronie serwera, domyślnie wyłączone).
+- Współpracownicy dodatkowo wymagają włączonych eksperymentalnych zespołów agentów.
+
 ## Parametry
 
 - `to` (string, wymagany): Nazwa `name` docelowego współpracownika zarejestrowanego w zespole lub `*`, aby rozesłać do wszystkich współpracowników naraz.

package/concepts/pl/Tool-SendUserFile.md

@@ -0,0 +1,38 @@
+# SendUserFile
+
+Wysyła jeden lub więcej plików do użytkownika — wygenerowane artefakty, zrzuty ekranu, raporty — z kontrolą nad tym, jak klient je prezentuje.
+
+## Kiedy używać
+
+- Wygenerowałeś plik, którego użytkownik potrzebuje (raport, obraz, stronę HTML) i chcesz go pokazać, a nie tylko wspomnieć o jego ścieżce.
+- Odpowiadanie z załącznikiem (`status="normal"`) lub proaktywne pokazywanie czegoś, o co użytkownik nie prosił, ale co musi teraz zobaczyć (`status="proactive"`).
+
+## Aktywacja
+
+- Dostępne tylko wtedy, gdy podłączony jest klient Remote Control lub sesja działa w zarządzanym środowisku chmurowym (np. Claude Code w przeglądarce).
+- Niedostępne na Amazon Bedrock, Google Cloud i Microsoft Foundry.
+- Wymaga, aby sesja zezwalała na wysyłanie plików (możliwość bramkowana ustawieniami/funkcjami); nieoferowane w trybie brief.
+
+## Parametry
+
+- `files` (tablica stringów, wymagany): Ścieżki plików (bezwzględne lub względem katalogu roboczego) do wysłania do użytkownika. Zawsze przekazuj tablicę, nawet dla pojedynczego pliku.
+- `caption` (string, opcjonalny): Krótki podpis dla pliku/plików.
+- `status` (string, wymagany): `proactive`, gdy pokazujesz plik, o który użytkownik nie prosił i który musi teraz zobaczyć — wygenerowany artefakt, ukończony raport; `normal`, gdy odpowiadasz na coś, co użytkownik właśnie powiedział.
+- `display` (string, opcjonalny): `render` otwiera plik inline w panelu bocznym (HTML, SVG, Mermaid, obrazy, PDF-y); `attach` pokazuje tylko kartę pobierania (pliki końcowe, które użytkownik zapisze i otworzy gdzie indziej). Pomiń, aby klient zdecydował na podstawie typu pliku.
+
+## Przykłady
+
+### Przykład 1: Dostarczenie wygenerowanego raportu
+
+```
+SendUserFile(
+  files=["./out/weekly-report.html"],
+  caption="Weekly usage report",
+  status="proactive",
+  display="render"
+)
+```
+
+## Uwagi
+
+- Wybierz `display="attach"` dla plików, które użytkownik zapisuje i otwiera w innej aplikacji; `render` dla wszystkiego, co powinien obejrzeć od razu.

package/concepts/pl/Tool-SendUserMessage.md

@@ -0,0 +1,38 @@
+# SendUserMessage
+
+Wysyła wiadomość do użytkownika — główny kanał widocznego wyjścia w sesjach w stylu brief. Znane również pod swoim starszym aliasem `Brief`.
+
+## Kiedy używać
+
+- Odpowiadanie na coś, co użytkownik właśnie powiedział (`status="normal"`).
+- Proaktywne pokazywanie czegoś, o co użytkownik nie prosił i co musi teraz zobaczyć — zadanie kończące się pod jego nieobecność, blokada, na którą natrafiłeś, nieproszona aktualizacja stanu (`status="proactive"`).
+
+## Aktywacja
+
+- Domyślnie ukryte w sesjach interaktywnych; większość interaktywnych sesji CLI rozmawia z użytkownikiem bezpośrednio.
+- Włączone w trybie brief lub przez flagi funkcji po stronie serwera.
+
+## Parametry
+
+W trybie brief:
+
+- `message` (string, wymagany): Wiadomość dla użytkownika. Obsługuje formatowanie markdown.
+- `attachments` (tablica, opcjonalny): Załączniki pokazywane obok wiadomości. Każdy wpis to albo ścieżka pliku (bezwzględna lub względem katalogu roboczego) dla lokalnie czytelnego pliku, albo wcześniej rozwiązany obiekt `{file_uuid, file_name, size, is_image}` uzyskany z narzędzia urządzenia, takiego jak `attach_file`.
+- `status` (string, wymagany): `proactive` dla nieproszonych aktualizacji, których użytkownik potrzebuje teraz; `normal` przy odpowiadaniu użytkownikowi.
+
+W wersjach bez trybu brief dostępny jest tylko `message`.
+
+## Przykłady
+
+### Przykład 1: Proaktywne powiadomienie o ukończeniu
+
+```
+SendUserMessage(
+  message="The migration finished — 42 files updated, tests green.",
+  status="proactive"
+)
+```
+
+## Uwagi
+
+- Używaj `proactive` oszczędnie — jest przeznaczone do rzeczy, które naprawdę wymagają teraz uwagi użytkownika.

package/concepts/pl/Tool-SuggestConnectors.md

@@ -0,0 +1,28 @@
+# SuggestConnectors
+
+Rozwiązuje pełne ładunki konektorów dla wartości `directoryUuid` zwróconych przez `SearchMcpRegistry`, aby użytkownikowi można było zaoferować konkretne konektory do włączenia.
+
+## Kiedy używać
+
+- Po tym, jak `SearchMcpRegistry` zwróci konektory kandydujące, aby pobrać ich pełne szczegóły do prezentacji.
+
+## Aktywacja
+
+- Dostępne tylko w sesjach zdalnych (claude.ai) na oficjalnym API (first-party).
+
+## Parametry
+
+- `uuids` (tablica stringów, wymagany): Wartości `directoryUuid` lub `server_id` do rozwiązania. 1–32 elementy, każdy 1–64 znaki.
+
+## Przykłady
+
+### Przykład 1: Rozwiązanie dwóch trafień z rejestru
+
+```
+SuggestConnectors(uuids=["d290f1ee-6c54-4b01-90e6-d701748f0851", "a1b2c3d4-0000-4000-8000-abcdefabcdef"])
+```
+
+## Uwagi
+
+- Nigdy nie zgaduj UUID-ów — rozwiązuj tylko identyfikatory, które wróciły z `SearchMcpRegistry`.
+- Narzędzie samo niczego nie łączy; włączenie konektora odbywa się poza tym przepływem.

package/concepts/pl/Tool-SuggestPluginInstall.md

@@ -0,0 +1,39 @@
+# SuggestPluginInstall
+
+Renderuje wbudowaną kartę instalacji wtyczki na podstawie wyników `SearchPlugins`, wiążąc sugestie wtyczek z żądaniem użytkownika.
+
+## Kiedy używać
+
+- Wyszukiwanie wtyczek pokazało wtyczki pasujące do tego, co użytkownik próbuje zrobić, a Ty chcesz zaoferować je do instalacji.
+
+## Aktywacja
+
+- Tylko wtedy, gdy podłączony jest klient Remote Control lub sesja działa w zarządzanym środowisku chmurowym.
+- Wyłączone w konfiguracjach enterprise HIPAA.
+- Niedostępne w trybie brief.
+
+## Parametry
+
+- `contextLabel` (string, wymagany): Krótki nagłówek wiążący sugestię z żądaniem użytkownika (maksymalnie 128 znaków).
+- `plugins` (tablica, wymagany): Wtyczki pochodzące z wyników `SearchPlugins` — 1–16 wpisów, każdy z:
+  - `pluginId` (string, wymagany)
+  - `pluginName` (string, wymagany)
+  - `description` (string, wymagany)
+  - `skills` (tablica, opcjonalny): Do 32 wpisów `{name, description?}` opisujących skille wtyczki.
+
+## Przykłady
+
+### Przykład 1: Zaoferowanie pasującej wtyczki
+
+```
+SuggestPluginInstall(
+  contextLabel="For reviewing pull requests",
+  plugins=[{pluginId="pr-toolkit", pluginName="PR Toolkit", description="Review helpers"}]
+)
+```
+
+Karta jest renderowana dla użytkownika; włączenie wtyczki odbywa się poza tym przepływem. Wywołaj `ListPlugins` w dalszej części, aby odkryć, co faktycznie zostało zainstalowane.
+
+## Uwagi
+
+- Uwzględniaj tylko wtyczki, które pochodzą z wyników wyszukiwania — nigdy nie wymyślaj wpisów wtyczek.

package/concepts/pl/Tool-SuggestSkills.md

@@ -0,0 +1,33 @@
+# SuggestSkills
+
+Renderuje kartę samodzielnych skilli, które użytkownik może dodać (skilli, które nie są jeszcze włączone), na podstawie słów kluczowych tematu.
+
+## Kiedy używać
+
+- Żądanie użytkownika pasuje do skilli, których nie ma włączonych (`trigger="user_asked"`, gdy sam zapytał, `trigger="proactive"`, gdy sugerujesz bez prośby).
+
+## Aktywacja
+
+- Tylko wtedy, gdy podłączony jest klient Remote Control lub sesja działa w zarządzanym środowisku chmurowym.
+- Wyłączone w konfiguracjach enterprise HIPAA.
+- Niedostępne w trybie brief.
+
+## Parametry
+
+- `keywords` (tablica stringów, wymagany): Słowa kluczowe tematu z żądania użytkownika. 1–8 elementów, każdy 1–64 znaki.
+- `contextLabel` (string, opcjonalny): Krótka etykieta wiążąca sugestię z żądaniem (maksymalnie 128 znaków).
+- `trigger` (string, opcjonalny): Jak zaczęła się ta sugestia — `user_asked` lub `proactive`.
+
+## Przykłady
+
+### Przykład 1: Sugestia skilli według tematu
+
+```
+SuggestSkills(keywords=["data visualization", "charts"], contextLabel="For building the dashboard", trigger="user_asked")
+```
+
+Skille już włączone są odfiltrowywane z wyniku.
+
+## Uwagi
+
+- Renderuje tylko kartę sugestii — dodanie skilla odbywa się poza tym przepływem; wywołaj potem `ListSkills`, aby potwierdzić.

package/concepts/pl/Tool-TaskCreate.md

@@ -12,6 +12,12 @@ Tworzy nowe zadanie na liście zadań bieżącego zespołu (lub na liście zada
 
 Pomiń `TaskCreate` dla trywialnych, jednorazowych akcji, czystych rozmów lub czegokolwiek, co można ukończyć w dwóch lub trzech bezpośrednich wywołaniach narzędzi.
 
+## Aktywacja
+
+- Dostępne domyślnie na większości modeli.
+- Niedostępne na rodzinach Opus 4.8 / Sonnet 5 / Fable 5 / Mythos 5 i nowszych (v2.1.233+), chyba że włączone przez `CLAUDE_CODE_ENABLE_TODO_TOOLS=1`, `--allowedTools` lub `--tools`.
+- Cały system zadań jest wyłączony, gdy `CLAUDE_CODE_ENABLE_TASKS=false`.
+
 ## Parametry
 
 - `subject` (string, wymagany): Krótki tytuł w trybie rozkazującym, np. `Fix login redirect on Safari`. Utrzymuj poniżej około osiemdziesięciu znaków.

package/concepts/pl/Tool-TaskGet.md

@@ -12,6 +12,12 @@ Pobiera pełny rekord pojedynczego zadania po ID, wraz z jego opisem, bieżącym
 
 Preferuj `TaskList`, gdy potrzebujesz tylko przeglądu wysokiego poziomu; zarezerwuj `TaskGet` dla konkretnego rekordu, który zamierzasz dokładnie przeczytać lub zmodyfikować.
 
+## Aktywacja
+
+- Dostępne domyślnie na większości modeli.
+- Niedostępne na rodzinach Opus 4.8 / Sonnet 5 / Fable 5 / Mythos 5 i nowszych (v2.1.233+), chyba że włączone przez `CLAUDE_CODE_ENABLE_TODO_TOOLS=1`, `--allowedTools` lub `--tools`.
+- Cały system zadań jest wyłączony, gdy `CLAUDE_CODE_ENABLE_TASKS=false`.
+
 ## Parametry
 
 - `taskId` (string, wymagany): Identyfikator zadania zwrócony przez `TaskCreate` lub `TaskList`. Identyfikatory są stałe przez cały okres życia zadania.

package/concepts/pl/Tool-TaskList.md

@@ -12,6 +12,12 @@ Zwraca każde zadanie w bieżącym zespole (lub sesji) w formie podsumowania. U
 
 `TaskList` jest tylko do odczytu i tani; wywołuj swobodnie, gdy potrzebujesz przeglądu.
 
+## Aktywacja
+
+- Dostępne domyślnie na większości modeli.
+- Niedostępne na rodzinach Opus 4.8 / Sonnet 5 / Fable 5 / Mythos 5 i nowszych (v2.1.233+), chyba że włączone przez `CLAUDE_CODE_ENABLE_TODO_TOOLS=1`, `--allowedTools` lub `--tools`.
+- Cały system zadań jest wyłączony, gdy `CLAUDE_CODE_ENABLE_TASKS=false`.
+
 ## Parametry
 
 `TaskList` nie przyjmuje parametrów. Zawsze zwraca pełny zbiór zadań dla aktywnego kontekstu.

package/concepts/pl/Tool-TaskUpdate.md

@@ -10,6 +10,12 @@ Modyfikuje istniejące zadanie — jego status, treść, własność, metadane l
 - Zapisywanie nowo odkrytych zależności za pomocą `addBlocks` / `addBlockedBy`.
 - Dołączanie ustrukturyzowanych `metadata`, takich jak zewnętrzne ID ticketów lub wskazówki priorytetowe.
 
+## Aktywacja
+
+- Dostępne domyślnie na większości modeli.
+- Niedostępne na rodzinach Opus 4.8 / Sonnet 5 / Fable 5 / Mythos 5 i nowszych (v2.1.233+), chyba że włączone przez `CLAUDE_CODE_ENABLE_TODO_TOOLS=1`, `--allowedTools` lub `--tools`.
+- Cały system zadań jest wyłączony, gdy `CLAUDE_CODE_ENABLE_TASKS=false`.
+
 ## Parametry
 
 - `taskId` (string, wymagany): Zadanie do zmodyfikowania. Uzyskaj z `TaskList` lub `TaskCreate`.

package/concepts/pl/Tool-TodoWrite.md

@@ -0,0 +1,43 @@
+# TodoWrite
+
+Zapisuje strukturalną listę todo dla bieżącej sesji, zastępując poprzednią listę. Każdy element zawiera swój tekst, status oraz formę czasu teraźniejszego ciągłego wyświetlaną we wskaźnikach postępu.
+
+## Kiedy używać
+
+- Zadanie składa się z kilku wyraźnych kroków, a ich śledzenie pomaga Tobie (i użytkownikowi) widzieć postęp.
+- Użytkownik wprost prosi o listę todo.
+- Chcesz oznaczyć dokładnie jeden element jako w toku, podczas gdy reszta pozostaje oczekująca lub ukończona.
+
+## Aktywacja
+
+- Starsze narzędzie: domyślnie wyłączone w sesjach oferujących narzędzia zadań (`TaskCreate`, `TaskUpdate`, `TaskList`).
+- Włącz je ponownie przez `CLAUDE_CODE_ENABLE_TASKS=0`.
+
+## Parametry
+
+- `todos` (tablica, wymagany): Kompletna zaktualizowana lista todo. Każdy wpis zawiera:
+  - `content` (string): Opis zadania.
+  - `status` (string): Jedna z wartości `pending`, `in_progress`, `completed`.
+  - `activeForm` (string): Tekst w czasie teraźniejszym ciągłym wyświetlany, gdy element jest w toku (np. "Running tests").
+
+## Przykłady
+
+### Przykład 1: Śledzenie trzyetapowej zmiany
+
+```
+TodoWrite(
+  todos=[
+    {content="Update the parser", status="in_progress", activeForm="Updating the parser"},
+    {content="Add unit tests", status="pending", activeForm="Adding unit tests"},
+    {content="Run the full test suite", status="pending", activeForm="Running the full test suite"}
+  ]
+)
+```
+
+Cała lista jest przepisywana przy każdym wywołaniu — zawsze uwzględniaj wszystkie elementy, nie tylko te, które się zmieniły.
+
+## Uwagi
+
+- Lista jest zastępowana w całości przy każdym wywołaniu; aby zaktualizować jeden element, prześlij ponownie wszystkie elementy z nowym statusem.
+- Utrzymuj dokładnie jeden element w statusie `in_progress` w danym momencie.
+- W sesjach, w których włączone są narzędzia zadań strukturalnych (`TaskCreate`/`TaskUpdate`/`TaskList`), środowisko może zaoferować je zamiast `TodoWrite` — preferuj ten zestaw narzędzi, który jest reklamowany.

package/concepts/pl/Tool-ToolSearch.md

@@ -10,6 +10,11 @@ Pobiera na żądanie pełne definicje schematów „odroczonych narzędzi", aby
 
 Jeśli schemat narzędzia jest już w kontekście, nie szukaj ponownie — po prostu je wywołaj.
 
+## Aktywacja
+
+- Domyślnie włączone.
+- Wyłączone, gdy `ANTHROPIC_BASE_URL` wskazuje na punkt końcowy inny niż Anthropic (chyba że ustawione jest `ENABLE_TOOL_SEARCH`), gdy ustawione jest `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS`, gdy model nie obsługuje odwołań do narzędzi (modele Vertex AI sprzed Claude 4.5) lub gdy zablokowane przez `"deny": ["ToolSearch"]`.
+
 ## Parametry
 
 - `query` (string, wymagany): Zapytanie używane do zlokalizowania odroczonych narzędzi. Obsługiwane są trzy formy:

package/concepts/pl/Tool-WebSearch.md

@@ -10,6 +10,12 @@ Wykonuje wyszukiwanie internetowe na żywo i zwraca posortowane wyniki, których
 - Weryfikowanie faktu, który mógł się zmienić od czasu trenowania modelu.
 - Odkrywanie wielu perspektyw na temat przed pobraniem pojedynczej strony za pomocą `WebFetch`.
 
+## Aktywacja
+
+- Dostępność zależy od dostawcy i modelu: dostępne na Anthropic API i Claude Platform on AWS; na Microsoft Foundry wymaga wdrożenia hostowanego przez Anthropic; na Google Cloud działa z modelami Claude 4+.
+- Niedostępne na Amazon Bedrock.
+- Ogranicz do 200 wywołań na sesję przez `CLAUDE_CODE_MAX_WEB_SEARCHES_PER_SESSION`.
+
 ## Parametry
 
 - `query` (string, wymagany): Zapytanie wyszukiwania. Minimalna długość 2 znaki. Dołącz bieżący rok, gdy pytasz o "najnowsze" lub "ostatnie" informacje, aby wyniki były świeże.