cx-viewer 1.0.2 → 1.0.4

package/concepts/pl/Tool-TaskUpdate.md

@@ -1,123 +0,0 @@
-# TaskUpdate
-
-## Definicja
-
-Aktualizuje status, zawartość lub zależności zadania na liście zadań.
-
-## Parametry
-
-| Parametr | Typ | Wymagany | Opis |
-|------|------|------|------|
-| `taskId` | string | Tak | ID zadania do aktualizacji |
-| `status` | enum | Nie | Nowy status: `pending` / `in_progress` / `completed` / `deleted` |
-| `subject` | string | Nie | Nowy tytuł |
-| `description` | string | Nie | Nowy opis |
-| `activeForm` | string | Nie | Tekst w czasie teraźniejszym ciągłym wyświetlany podczas wykonywania |
-| `owner` | string | Nie | Nowy odpowiedzialny za zadanie (nazwa agenta) |
-| `metadata` | object | Nie | Metadane do scalenia (ustawienie na null usuwa klucz) |
-| `addBlocks` | string[] | Nie | Lista ID zadań zablokowanych przez to zadanie |
-| `addBlockedBy` | string[] | Nie | Lista ID zadań poprzedzających, które blokują to zadanie |
-
-## Przepływ statusów
-
-```
-pending → in_progress → completed
-```
-
-`deleted` może być ustawiony z dowolnego statusu, trwale usuwa zadanie.
-
-## Scenariusze użycia
-
-**Odpowiednie zastosowanie:**
-- Oznaczanie zadania jako `in_progress` przy rozpoczęciu pracy
-- Oznaczanie zadania jako `completed` po zakończeniu pracy
-- Ustawianie zależności między zadaniami
-- Aktualizacja zawartości zadania przy zmianie wymagań
-
-**Ważne zasady:**
-- Oznaczaj jako `completed` tylko po pełnym ukończeniu zadania
-- W przypadku błędów lub blokad zachowaj status `in_progress`
-- Nie oznaczaj jako `completed` gdy testy nie przechodzą, implementacja jest niepełna lub wystąpiły nierozwiązane błędy
-
-## Uwagi
-
-- Przed aktualizacją należy pobrać najnowszy stan zadania przez TaskGet, aby uniknąć przestarzałych danych
-- Po ukończeniu zadania wywołaj TaskList, aby znaleźć następne dostępne zadanie
-
-## Tekst oryginalny
-
-<textarea readonly>Use this tool to update a task in the task list.
-
-## When to Use This Tool
-
-**Mark tasks as resolved:**
-- When you have completed the work described in a task
-- When a task is no longer needed or has been superseded
-- IMPORTANT: Always mark your assigned tasks as resolved when you finish them
-- After resolving, call TaskList to find your next task
-
-- ONLY mark a task as completed when you have FULLY accomplished it
-- If you encounter errors, blockers, or cannot finish, keep the task as in_progress
-- When blocked, create a new task describing what needs to be resolved
-- Never mark a task as completed if:
-  - Tests are failing
-  - Implementation is partial
-  - You encountered unresolved errors
-  - You couldn't find necessary files or dependencies
-
-**Delete tasks:**
-- When a task is no longer relevant or was created in error
-- Setting status to `deleted` permanently removes the task
-
-**Update task details:**
-- When requirements change or become clearer
-- When establishing dependencies between tasks
-
-## Fields You Can Update
-
-- **status**: The task status (see Status Workflow below)
-- **subject**: Change the task title (imperative form, e.g., "Run tests")
-- **description**: Change the task description
-- **activeForm**: Present continuous form shown in spinner when in_progress (e.g., "Running tests")
-- **owner**: Change the task owner (agent name)
-- **metadata**: Merge metadata keys into the task (set a key to null to delete it)
-- **addBlocks**: Mark tasks that cannot start until this one completes
-- **addBlockedBy**: Mark tasks that must complete before this one can start
-
-## Status Workflow
-
-Status progresses: `pending` → `in_progress` → `completed`
-
-Use `deleted` to permanently remove a task.
-
-## Staleness
-
-Make sure to read a task's latest state using `TaskGet` before updating it.
-
-## Examples
-
-Mark task as in progress when starting work:
-```json
-{"taskId": "1", "status": "in_progress"}
-```
-
-Mark task as completed after finishing work:
-```json
-{"taskId": "1", "status": "completed"}
-```
-
-Delete a task:
-```json
-{"taskId": "1", "status": "deleted"}
-```
-
-Claim a task by setting owner:
-```json
-{"taskId": "1", "owner": "my-name"}
-```
-
-Set up task dependencies:
-```json
-{"taskId": "2", "addBlockedBy": ["1"]}
-```
-</textarea>

package/concepts/pl/Tool-TeamCreate.md

@@ -1,38 +0,0 @@
-# TeamCreate
-
-## Definicja
-
-Tworzy nowy zespół do koordynacji wielu agentów pracujących nad projektem. Zespoły umożliwiają równoległe wykonywanie zadań poprzez wspólną listę zadań i wymianę wiadomości między agentami.
-
-## Parametry
-
-| Parametr | Typ | Wymagany | Opis |
-|----------|-----|----------|------|
-| `team_name` | string | Tak | Nazwa nowego zespołu |
-| `description` | string | Nie | Opis / cel zespołu |
-| `agent_type` | string | Nie | Typ / rola lidera zespołu |
-
-## Co zostaje utworzone
-
-- **Plik konfiguracyjny zespołu**: `~/.claude/teams/{team-name}/config.json` — przechowuje listę członków i metadane
-- **Katalog listy zadań**: `~/.claude/tasks/{team-name}/` — wspólna lista zadań dla wszystkich członków zespołu
-
-Zespoły mają relację 1:1 z listami zadań.
-
-## Przepływ pracy zespołu
-
-1. **TeamCreate** — utwórz zespół i jego listę zadań
-2. **TaskCreate** — zdefiniuj zadania dla zespołu
-3. **Agent** (z `team_name` + `name`) — uruchom członków zespołu dołączających do zespołu
-4. **TaskUpdate** — przypisz zadania do członków przez `owner`
-5. Członkowie pracują nad zadaniami i komunikują się przez **SendMessage**
-6. Zamknij członków po zakończeniu, następnie **TeamDelete** dla porządku
-
-## Powiązane narzędzia
-
-| Narzędzie | Przeznaczenie |
-|-----------|---------------|
-| `TeamDelete` | Usuń zespół i katalogi zadań |
-| `SendMessage` | Komunikacja między agentami w zespole |
-| `TaskCreate` / `TaskUpdate` / `TaskList` / `TaskGet` | Zarządzanie wspólną listą zadań |
-| `Agent` | Uruchom członków zespołu dołączających do zespołu |

package/concepts/pl/Tool-TeamDelete.md

@@ -1,30 +0,0 @@
-# TeamDelete
-
-## Definicja
-
-Usuwa zespół i powiązane katalogi zadań po zakończeniu pracy w ramach współpracy wielu agentów. Jest to odpowiednik porządkujący dla TeamCreate.
-
-## Zachowanie
-
-- Usuwa katalog zespołu: `~/.claude/teams/{team-name}/`
-- Usuwa katalog listy zadań: `~/.claude/tasks/{team-name}/`
-- Czyści kontekst zespołu z bieżącej sesji
-
-**Ważne**: TeamDelete zakończy się błędem, jeśli zespół nadal ma aktywnych członków. Członkowie zespołu muszą najpierw zostać poprawnie zamknięci za pomocą żądań shutdown wysyłanych przez SendMessage.
-
-## Typowe użycie
-
-TeamDelete jest wywoływany na końcu przepływu pracy zespołu:
-
-1. Wszystkie zadania są ukończone
-2. Członkowie zespołu są zamykani przez `SendMessage` z `shutdown_request`
-3. **TeamDelete** usuwa katalogi zespołu i zadań
-
-## Powiązane narzędzia
-
-| Narzędzie | Przeznaczenie |
-|-----------|---------------|
-| `TeamCreate` | Utwórz nowy zespół i jego listę zadań |
-| `SendMessage` | Komunikacja z członkami zespołu / wysyłanie żądań shutdown |
-| `TaskCreate` / `TaskUpdate` / `TaskList` / `TaskGet` | Zarządzanie wspólną listą zadań |
-| `Agent` | Uruchom członków zespołu dołączających do zespołu |

package/concepts/pl/Tool-WebFetch.md

@@ -1,55 +0,0 @@
-# WebFetch
-
-## Definicja
-
-Pobiera zawartość strony internetowej pod podanym URL, konwertuje HTML na markdown i przetwarza zawartość za pomocą modelu AI zgodnie z promptem.
-
-## Parametry
-
-| Parametr | Typ | Wymagany | Opis |
-|------|------|------|------|
-| `url` | string (URI) | Tak | Pełny URL do pobrania |
-| `prompt` | string | Tak | Opis informacji do wyodrębnienia ze strony |
-
-## Scenariusze użycia
-
-**Odpowiednie zastosowanie:**
-- Pobieranie zawartości publicznych stron internetowych
-- Przeglądanie dokumentacji online
-- Wyodrębnianie określonych informacji ze stron internetowych
-
-**Nieodpowiednie zastosowanie:**
-- URL wymagające uwierzytelnienia (Google Docs, Confluence, Jira, GitHub itp.) — należy najpierw poszukać dedykowanego narzędzia MCP
-- URL GitHub — preferuj użycie `gh` CLI
-
-## Uwagi
-
-- URL musi być pełnym, prawidłowym URL
-- HTTP jest automatycznie aktualizowane do HTTPS
-- Zbyt duża zawartość może zostać podsumowana
-- Zawiera 15-minutowy samoczyszczący się cache
-- Gdy URL przekierowuje na inny host, narzędzie zwraca URL przekierowania — należy ponowić żądanie z nowym URL
-- Jeśli dostępne jest narzędzie web fetch dostarczane przez MCP, preferuj jego użycie
-
-## Tekst oryginalny
-
-<textarea readonly>IMPORTANT: WebFetch WILL FAIL for authenticated or private URLs. Before using this tool, check if the URL points to an authenticated service (e.g. Google Docs, Confluence, Jira, GitHub). If so, you MUST use ToolSearch first to find a specialized tool that provides authenticated access.
-
-- Fetches content from a specified URL and processes it using an AI model
-- Takes a URL and a prompt as input
-- Fetches the URL content, converts HTML to markdown
-- Processes the content with the prompt using a small, fast model
-- Returns the model's response about the content
-- Use this tool when you need to retrieve and analyze web content
-
-Usage notes:
-  - IMPORTANT: If an MCP-provided web fetch tool is available, prefer using that tool instead of this one, as it may have fewer restrictions.
-  - The URL must be a fully-formed valid URL
-  - HTTP URLs will be automatically upgraded to HTTPS
-  - The prompt should describe what information you want to extract from the page
-  - This tool is read-only and does not modify any files
-  - Results may be summarized if the content is very large
-  - Includes a self-cleaning 15-minute cache for faster responses when repeatedly accessing the same URL
-  - When a URL redirects to a different host, the tool will inform you and provide the redirect URL in a special format. You should then make a new WebFetch request with the redirect URL to fetch the content.
-  - For GitHub URLs, prefer using the gh CLI via Bash instead (e.g., gh pr view, gh issue view, gh api).
-</textarea>

package/concepts/pl/Tool-WebSearch.md

@@ -1,58 +0,0 @@
-# WebSearch
-
-## Definicja
-
-Wykonuje zapytanie do wyszukiwarki, zwracając wyniki wyszukiwania w celu uzyskania aktualnych informacji.
-
-## Parametry
-
-| Parametr | Typ | Wymagany | Opis |
-|------|------|------|------|
-| `query` | string | Tak | Zapytanie wyszukiwania (minimum 2 znaki) |
-| `allowed_domains` | string[] | Nie | Uwzględnij tylko wyniki z tych domen |
-| `blocked_domains` | string[] | Nie | Wyklucz wyniki z tych domen |
-
-## Scenariusze użycia
-
-**Odpowiednie zastosowanie:**
-- Uzyskiwanie najnowszych informacji wykraczających poza datę odcięcia wiedzy modelu
-- Wyszukiwanie bieżących wydarzeń i najnowszych danych
-- Wyszukiwanie najnowszej dokumentacji technicznej
-
-## Uwagi
-
-- Wyniki wyszukiwania są zwracane w formacie hiperłączy markdown
-- Po użyciu należy dołączyć sekcję "Sources:" na końcu odpowiedzi z listą odpowiednich URL
-- Obsługuje filtrowanie domen (uwzględnianie/wykluczanie)
-- W zapytaniach wyszukiwania należy używać bieżącego roku
-- Dostępne tylko w USA
-
-## Tekst oryginalny
-
-<textarea readonly>
-- Allows Claude to search the web and use the results to inform responses
-- Provides up-to-date information for current events and recent data
-- Returns search result information formatted as search result blocks, including links as markdown hyperlinks
-- Use this tool for accessing information beyond Claude's knowledge cutoff
-- Searches are performed automatically within a single API call
-
-CRITICAL REQUIREMENT - You MUST follow this:
-  - After answering the user's question, you MUST include a "Sources:" section at the end of your response
-  - In the Sources section, list all relevant URLs from the search results as markdown hyperlinks: [Title](URL)
-  - This is MANDATORY - never skip including sources in your response
-  - Example format:
-
-    [Your answer here]
-
-    Sources:
-    - [Source Title 1](https://example.com/1)
-    - [Source Title 2](https://example.com/2)
-
-Usage notes:
-  - Domain filtering is supported to include or block specific websites
-  - Web search is only available in the US
-
-IMPORTANT - Use the correct year in search queries:
-  - The current month is March 2026. You MUST use this year when searching for recent information, documentation, or current events.
-  - Example: If the user asks for "latest React docs", search for "React documentation" with the current year, NOT last year
-</textarea>

package/concepts/pl/Tool-Write.md

@@ -1,39 +0,0 @@
-# Write
-
-## Definicja
-
-Zapisuje zawartość do lokalnego systemu plików. Jeśli plik już istnieje, nadpisuje go.
-
-## Parametry
-
-| Parametr | Typ | Wymagany | Opis |
-|------|------|------|------|
-| `file_path` | string | Tak | Bezwzględna ścieżka do pliku (musi być bezwzględna) |
-| `content` | string | Tak | Zawartość do zapisania |
-
-## Scenariusze użycia
-
-**Odpowiednie zastosowanie:**
-- Tworzenie nowych plików
-- Gdy wymagane jest całkowite przepisanie zawartości pliku
-
-**Nieodpowiednie zastosowanie:**
-- Modyfikacja lokalnej zawartości pliku — należy użyć Edit
-- Nie należy proaktywnie tworzyć plików dokumentacji (*.md) ani README, chyba że użytkownik wyraźnie o to prosi
-
-## Uwagi
-
-- Jeśli plik docelowy już istnieje, należy go najpierw odczytać za pomocą Read, w przeciwnym razie operacja się nie powiedzie
-- Nadpisuje całą zawartość istniejącego pliku
-- Preferuj Edit do edycji istniejących plików, Write służy tylko do tworzenia nowych plików lub całkowitego przepisywania
-
-## Tekst oryginalny
-
-<textarea readonly>Writes a file to the local filesystem.
-
-Usage:
-- This tool will overwrite the existing file if there is one at the provided path.
-- If this is an existing file, you MUST use the Read tool first to read the file's contents. This tool will fail if you did not read the file first.
-- Prefer the Edit tool for modifying existing files — it only sends the diff. Only use this tool to create new files or for complete rewrites.
-- NEVER create documentation files (*.md) or README files unless explicitly requested by the User.
-- Only use emojis if the user explicitly requests it. Avoid writing emojis to files unless asked.</textarea>

package/concepts/pl/Tool-executeCode.md

@@ -1,41 +0,0 @@
-# executeCode (mcp__ide__executeCode)
-
-## Definicja
-
-Wykonuje kod Python w jądrze Jupyter bieżącego pliku notebook.
-
-## Parametry
-
-| Parametr | Typ | Wymagany | Opis |
-|------|------|------|------|
-| `code` | string | Tak | Kod Python do wykonania |
-
-## Scenariusze użycia
-
-**Odpowiednie zastosowanie:**
-- Wykonywanie kodu w środowisku Jupyter notebook
-- Testowanie fragmentów kodu
-- Analiza danych i obliczenia
-
-**Nieodpowiednie zastosowanie:**
-- Wykonywanie kodu poza środowiskiem Jupyter — należy użyć Bash
-- Modyfikacja plików — należy użyć Edit lub Write
-
-## Uwagi
-
-- To jest narzędzie MCP (Model Context Protocol), dostarczane przez integrację z IDE
-- Kod jest wykonywany w bieżącym jądrze Jupyter, stan jest zachowywany między wywołaniami
-- O ile użytkownik wyraźnie nie poprosi, należy unikać deklarowania zmiennych lub modyfikowania stanu jądra
-- Po restarcie jądra stan zostaje utracony
-
-## Tekst oryginalny
-
-<textarea readonly>Execute python code in the Jupyter kernel for the current notebook file.
-    
-    All code will be executed in the current Jupyter kernel.
-    
-    Avoid declaring variables or modifying the state of the kernel unless the user
-    explicitly asks for it.
-    
-    Any code executed will persist across calls to this tool, unless the kernel
-    has been restarted.</textarea>

package/concepts/pl/Tool-getDiagnostics.md

@@ -1,32 +0,0 @@
-# getDiagnostics (mcp__ide__getDiagnostics)
-
-## Definicja
-
-Pobiera informacje diagnostyczne języka z VS Code, w tym błędy składni, błędy typów, ostrzeżenia lint itp.
-
-## Parametry
-
-| Parametr | Typ | Wymagany | Opis |
-|------|------|------|------|
-| `uri` | string | Nie | URI pliku. Jeśli nie podano, pobiera diagnostykę wszystkich plików |
-
-## Scenariusze użycia
-
-**Odpowiednie zastosowanie:**
-- Sprawdzanie problemów semantycznych kodu: składnia, typy, lint itp.
-- Weryfikacja po edycji kodu, czy nie wprowadzono nowych błędów
-- Zastępowanie poleceń Bash do sprawdzania jakości kodu
-
-**Nieodpowiednie zastosowanie:**
-- Uruchamianie testów — należy użyć Bash
-- Sprawdzanie błędów runtime — należy użyć Bash do wykonania kodu
-
-## Uwagi
-
-- To jest narzędzie MCP (Model Context Protocol), dostarczane przez integrację z IDE
-- Dostępne tylko w środowisku VS Code / IDE
-- Preferuj użycie tego narzędzia zamiast poleceń Bash do sprawdzania problemów z kodem
-
-## Tekst oryginalny
-
-<textarea readonly>Get language diagnostics from VS Code</textarea>

package/concepts/pl/Tools.md

@@ -1,67 +0,0 @@
-# Przegląd narzędzi Claude Code
-
-Claude Code udostępnia modelowi zestaw wbudowanych narzędzi poprzez mechanizm tool_use API Anthropic. Tablica `tools` w każdym żądaniu MainAgent zawiera pełne definicje JSON Schema tych narzędzi, a model wywołuje je w odpowiedzi poprzez bloki content `tool_use`.
-
-Poniżej znajduje się kategoryzowany indeks wszystkich narzędzi.
-
-## System agentów
-
-| Narzędzie | Przeznaczenie |
-|------|------|
-| [Task](Tool-Task.md) | Uruchomienie sub-agenta (SubAgent) do obsługi złożonych wieloetapowych zadań |
-| [TaskOutput](Tool-TaskOutput.md) | Pobranie wyniku zadania w tle |
-| [TaskStop](Tool-TaskStop.md) | Zatrzymanie działającego zadania w tle |
-| [TaskCreate](Tool-TaskCreate.md) | Utworzenie wpisu na strukturalnej liście zadań |
-| [TaskGet](Tool-TaskGet.md) | Pobranie szczegółów zadania |
-| [TaskUpdate](Tool-TaskUpdate.md) | Aktualizacja statusu zadania, zależności itp. |
-| [TaskList](Tool-TaskList.md) | Wyświetlenie listy wszystkich zadań |
-
-## Operacje na plikach
-
-| Narzędzie | Przeznaczenie |
-|------|------|
-| [Read](Tool-Read.md) | Odczyt zawartości pliku (obsługa tekstu, obrazów, PDF, Jupyter notebook) |
-| [Edit](Tool-Edit.md) | Edycja pliku przez precyzyjne zastępowanie ciągów znaków |
-| [Write](Tool-Write.md) | Zapis lub nadpisanie pliku |
-| [NotebookEdit](Tool-NotebookEdit.md) | Edycja komórek Jupyter notebook |
-
-## Wyszukiwanie
-
-| Narzędzie | Przeznaczenie |
-|------|------|
-| [Glob](Tool-Glob.md) | Wyszukiwanie plików według wzorca nazwy |
-| [Grep](Tool-Grep.md) | Wyszukiwanie zawartości plików oparte na ripgrep |
-
-## Terminal
-
-| Narzędzie | Przeznaczenie |
-|------|------|
-| [Bash](Tool-Bash.md) | Wykonywanie poleceń shell |
-
-## Web
-
-| Narzędzie | Przeznaczenie |
-|------|------|
-| [WebFetch](Tool-WebFetch.md) | Pobieranie zawartości stron internetowych i przetwarzanie przez AI |
-| [WebSearch](Tool-WebSearch.md) | Zapytania do wyszukiwarki |
-
-## Planowanie i interakcja
-
-| Narzędzie | Przeznaczenie |
-|------|------|
-| [EnterPlanMode](Tool-EnterPlanMode.md) | Wejście w tryb planowania, projektowanie planu wdrożenia |
-| [ExitPlanMode](Tool-ExitPlanMode.md) | Wyjście z trybu planowania i przesłanie planu do zatwierdzenia przez użytkownika |
-| [AskUserQuestion](Tool-AskUserQuestion.md) | Zadanie pytania użytkownikowi w celu uzyskania wyjaśnienia lub decyzji |
-
-## Rozszerzenia
-
-| Narzędzie | Przeznaczenie |
-|------|------|
-| [Skill](Tool-Skill.md) | Wykonanie umiejętności (slash command) |
-
-## Integracja z IDE
-
-| Narzędzie | Przeznaczenie |
-|------|------|
-| [getDiagnostics](Tool-getDiagnostics.md) | Pobranie informacji diagnostycznych języka z VS Code |
-| [executeCode](Tool-executeCode.md) | Wykonanie kodu w jądrze Jupyter |

package/concepts/pt-BR/CacheRebuild.md

@@ -1,36 +0,0 @@
-# Cache Rebuild (Reconstrução de Cache)
-
-## Contexto
-
-O mecanismo de prompt caching da Anthropic concatena sequencialmente system → tools → messages (até o cache breakpoint) da requisição para formar a chave de cache. Quando a chave de cache é idêntica à da requisição anterior, a API retorna `cache_read_input_tokens` (acerto de cache); quando a chave de cache muda, a API recria o cache e retorna uma grande quantidade de `cache_creation_input_tokens`, ou seja, reconstrução de cache.
-
-A reconstrução de cache implica cobrança adicional de tokens (o preço de cache creation é maior que o de cache read), portanto identificar a causa da reconstrução tem valor direto para otimização de custos.
-
-## Classificação das Causas de Reconstrução de Cache
-
-O cc-viewer determina com precisão a causa da reconstrução de cache comparando os bodies de duas requisições MainAgent consecutivas:
-
-| reason | Significado | Método de Determinação |
-|--------|------|----------|
-| `ttl` | Cache expirado | Mais de 5 minutos desde a última requisição MainAgent |
-| `system_change` | Alteração do system prompt | `JSON.stringify(prev.system) !== JSON.stringify(curr.system)` |
-| `tools_change` | Alteração das definições de ferramentas | `JSON.stringify(prev.tools) !== JSON.stringify(curr.tools)` |
-| `model_change` | Troca de modelo | `prev.model !== curr.model` |
-| `msg_truncated` | Pilha de mensagens truncada | O número de mensagens da requisição atual é menor que o da anterior, geralmente causado por truncamento devido ao estouro da janela de contexto |
-| `msg_modified` | Mensagens históricas modificadas | Conteúdo das mensagens de prefixo inconsistente (em adição normal, o prefixo deve ser idêntico) |
-| `key_change` | Alteração de chave desconhecida | Fallback quando nenhuma das condições acima é correspondida |
-
-## Prioridade de Determinação
-
-1. Primeiro verifica o intervalo de tempo — se ultrapassar 5 minutos, determina diretamente como `ttl`, sem comparação de body
-2. Em seguida verifica sequencialmente model, system, tools, messages
-3. Uma requisição pode corresponder a múltiplas causas simultaneamente (ex: troca de modelo + alteração de system prompt), nesse caso o array `reasons` contém todos os itens correspondentes, e o tooltip exibe em linhas separadas
-
-## Cenários Comuns
-
-- **`ttl`**: O usuário pausou a operação por mais de 5 minutos e depois continuou, o cache expirou naturalmente
-- **`system_change`**: O Claude Code atualizou o system prompt (ex: carregou novo CLAUDE.md, alteração nas project instructions)
-- **`tools_change`**: Conexão/desconexão de MCP server causou alteração na lista de ferramentas disponíveis
-- **`model_change`**: O usuário trocou o modelo através do comando `/model`
-- **`msg_truncated`**: Conversa muito longa acionou o gerenciamento da janela de contexto, o Claude Code truncou mensagens anteriores
-- **`msg_modified`**: O Claude Code editou mensagens históricas (ex: `/compact` substituiu mensagens originais por resumo compactado)

package/concepts/pt-BR/KVCacheContent.md

@@ -1,49 +0,0 @@
-# Conteudo do KV-Cache
-
-## O que e Prompt Caching?
-
-Quando voce conversa com o Claude, cada requisicao da API envia o contexto completo da conversa (system prompt + definicoes de ferramentas + historico de mensagens). O mecanismo de prompt caching da Anthropic armazena no servidor o conteudo do prefixo ja calculado. Se requisicoes subsequentes tiverem o mesmo prefixo, os resultados armazenados sao reutilizados diretamente, pulando calculos redundantes e reduzindo significativamente a latencia e os custos.
-
-No cc-viewer, esse mecanismo e chamado de "KV-Cache" e corresponde ao prompt caching no nivel da API da Anthropic, nao ao key-value cache interno das camadas de atencao do transformer do LLM.
-
-## Como o caching funciona
-
-O prompt caching da Anthropic constroi a chave de cache em uma ordem fixa:
-
-```
-Tools → System Prompt → Messages (ate o cache breakpoint)
-```
-
-Desde que esse prefixo corresponda exatamente a uma requisicao anterior dentro da janela de TTL, a API retornara um cache hit (`cache_read_input_tokens`) em vez de recalcular (`cache_creation_input_tokens`).
-
-> **O Claude Code nao depende estritamente do atributo `cache_control`. O servidor remove parcialmente esses atributos, mas ainda consegue criar o cache de forma eficaz. Portanto, a ausencia do atributo `cache_control` nao significa que o conteudo nao foi armazenado em cache.**
->
-> Para clientes especiais como o Claude Code, o servidor da Anthropic nao depende completamente do atributo `cache_control` na requisicao para determinar o comportamento do cache. O servidor executa automaticamente estrategias de cache para campos especificos (como system prompt e definicoes de ferramentas), mesmo quando a requisicao nao contem marcadores `cache_control` explicitos. Portanto, se voce nao vir esse atributo no corpo da requisicao, nao ha motivo para confusao — o servidor ja completou a operacao de cache nos bastidores, simplesmente nao expoe essa informacao ao cliente. Isso e um entendimento tacito entre o Claude Code e a API da Anthropic.
-
-## O que e o "conteudo atual do KV-Cache"?
-
-O "conteudo atual do KV-Cache" exibido no cc-viewer e extraido da ultima requisicao do MainAgent e inclui o conteudo anterior ao limite do cache (cache breakpoint). Especificamente, ele compreende:
-
-- **System Prompt**: as instrucoes de sistema do Claude Code, incluindo instrucoes principais do agent, especificacoes de uso de ferramentas, instrucoes do projeto CLAUDE.md, informacoes do ambiente, etc.
-- **Tools**: a lista de definicoes de ferramentas atualmente disponiveis (como Read, Write, Bash, Agent, ferramentas MCP, etc.)
-- **Messages**: a parte armazenada do historico da conversa (tipicamente mensagens mais antigas, ate o ultimo marcador `cache_control`)
-
-## Por que visualizar o conteudo do cache?
-
-1. **Entender o contexto**: descubra quais conteudos o Claude tem atualmente "em memoria" para avaliar se seu comportamento corresponde as expectativas
-2. **Otimizacao de custos**: cache hits custam muito menos do que recalculos. Visualizar o conteudo do cache ajuda a entender por que certas requisicoes acionaram uma reconstrucao do cache (cache rebuild)
-3. **Debug de conversas**: quando as respostas do Claude nao correspondem as expectativas, verificar o conteudo do cache permite confirmar se o system prompt e o historico de mensagens estao corretos
-4. **Monitoramento da qualidade do contexto**: durante o debug, alteracao de configuracoes ou ajuste de prompts, o KV-Cache-Text oferece uma visao centralizada que ajuda a verificar rapidamente se o contexto principal se degradou ou foi contaminado por conteudo inesperado — sem precisar percorrer manualmente cada mensagem original
-
-## Estrategia de cache multinivel
-
-O KV-Cache do Claude Code nao e composto por um unico cache. O servidor gera caches separados para Tools e System Prompt, independentes do cache de Messages. A vantagem desse design e que quando a pilha de mensagens apresenta problemas (como truncamento de contexto, alteracoes de mensagens, etc.) e precisa ser reconstruida, os caches de Tools e System Prompt nao sao invalidados junto, evitando um recalculo completo.
-
-Esta e uma estrategia de otimizacao atual do servidor — como as definicoes de ferramentas e o system prompt sao relativamente estaveis durante o uso normal e raramente mudam, armazena-los separadamente em cache minimiza o overhead de reconstrucoes desnecessarias. Ao observar o cache, voce percebera que, alem da reconstrucao de Tools (que exige a atualizacao completa do cache), alteracoes no System Prompt e nas Messages ainda possuem caches herdaveis disponiveis.
-
-## Ciclo de vida do cache
-
-- **Criacao**: na primeira requisicao ou apos a invalidacao do cache, a API cria um novo cache (`cache_creation_input_tokens`)
-- **Hit**: requisicoes subsequentes com prefixo identico reutilizam o cache (`cache_read_input_tokens`)
-- **Expiracao**: o cache tem um TTL (Time to Live) de 5 minutos e expira automaticamente apos esse periodo
-- **Reconstrucao**: quando o system prompt, a lista de ferramentas, o modelo ou o conteudo das mensagens mudam, a chave de cache nao corresponde mais e aciona uma reconstrucao do cache no nivel correspondente