cx-viewer 1.0.3 → 1.0.4

package/concepts/no/Tool-TaskUpdate.md

@@ -1,123 +0,0 @@
-# TaskUpdate
-
-## Definisjon
-
-Oppdaterer status, innhold eller avhengighetsforhold for en oppgave i oppgavelisten.
-
-## Parametere
-
-| Parameter | Type | Påkrevd | Beskrivelse |
-|-----------|------|---------|-------------|
-| `taskId` | string | Ja | ID-en til oppgaven som skal oppdateres |
-| `status` | enum | Nei | Ny status: `pending` / `in_progress` / `completed` / `deleted` |
-| `subject` | string | Nei | Ny tittel |
-| `description` | string | Nei | Ny beskrivelse |
-| `activeForm` | string | Nei | Tekst i presens partisipp som vises under utførelse |
-| `owner` | string | Nei | Ny oppgaveansvarlig (agent-navn) |
-| `metadata` | object | Nei | Metadata som skal flettes inn (sett til null for å slette nøkkel) |
-| `addBlocks` | string[] | Nei | Liste over oppgave-ID-er blokkert av denne oppgaven |
-| `addBlockedBy` | string[] | Nei | Liste over forutgående oppgave-ID-er som blokkerer denne oppgaven |
-
-## Statusflyt
-
-```
-pending → in_progress → completed
-```
-
-`deleted` kan nås fra enhver status og fjerner oppgaven permanent.
-
-## Bruksscenarioer
-
-**Egnet for bruk:**
-- Markere oppgave som `in_progress` når arbeidet starter
-- Markere oppgave som `completed` etter fullført arbeid
-- Sette avhengighetsforhold mellom oppgaver
-- Oppdatere oppgaveinnhold ved endrede krav
-
-**Viktige regler:**
-- Marker kun som `completed` når oppgaven er fullstendig ferdig
-- Ved feil eller blokkering, behold `in_progress`
-- Ikke marker som `completed` ved mislykkede tester, ufullstendig implementering eller uløste feil
-
-## Merknader
-
-- Før oppdatering bør du hente siste oppgavestatus via TaskGet for å unngå utdaterte data
-- Etter fullføring av oppgave, kall TaskList for å finne neste tilgjengelige oppgave
-
-## Originaltekst
-
-<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/no/Tool-TeamCreate.md

@@ -1,38 +0,0 @@
-# TeamCreate
-
-## Definisjon
-
-Oppretter et nytt team for å koordinere flere agenter som arbeider på et prosjekt. Team muliggjør parallell oppgavekjøring via en delt oppgaveliste og kommunikasjon mellom agenter.
-
-## Parametere
-
-| Parameter | Type | Påkrevd | Beskrivelse |
-|-----------|------|---------|-------------|
-| `team_name` | string | Ja | Navn på det nye teamet |
-| `description` | string | Nei | Teambeskrivelse / formål |
-| `agent_type` | string | Nei | Type / rolle for teamlederen |
-
-## Hva som opprettes
-
-- **Team-konfigurasjonsfil**: `~/.claude/teams/{team-name}/config.json` — lagrer medlemsliste og metadata
-- **Oppgavelistemappe**: `~/.claude/tasks/{team-name}/` — delt oppgaveliste for alle teammedlemmer
-
-Team har et 1:1-forhold til oppgavelister.
-
-## Team-arbeidsflyt
-
-1. **TeamCreate** — opprett teamet og dets oppgaveliste
-2. **TaskCreate** — definer oppgaver for teamet
-3. **Agent** (med `team_name` + `name`) — start teammedlemmer som slutter seg til teamet
-4. **TaskUpdate** — tildel oppgaver til teammedlemmer via `owner`
-5. Teammedlemmer arbeider med oppgaver og kommuniserer via **SendMessage**
-6. Avslutt teammedlemmer når ferdig, deretter **TeamDelete** for opprydding
-
-## Relaterte verktøy
-
-| Verktøy | Formål |
-|---------|--------|
-| `TeamDelete` | Fjern team og oppgavemapper |
-| `SendMessage` | Kommunikasjon mellom agenter i teamet |
-| `TaskCreate` / `TaskUpdate` / `TaskList` / `TaskGet` | Administrer den delte oppgavelisten |
-| `Agent` | Start teammedlemmer som slutter seg til teamet |

package/concepts/no/Tool-TeamDelete.md

@@ -1,30 +0,0 @@
-# TeamDelete
-
-## Definisjon
-
-Fjerner et team og tilhørende oppgavemapper når multi-agent-samarbeidsarbeidet er fullført. Dette er oppryddingsmotparten til TeamCreate.
-
-## Atferd
-
-- Fjerner team-mappen: `~/.claude/teams/{team-name}/`
-- Fjerner oppgavemappen: `~/.claude/tasks/{team-name}/`
-- Tømmer team-kontekst fra gjeldende økt
-
-**Viktig**: TeamDelete vil mislykkes hvis teamet fortsatt har aktive medlemmer. Teammedlemmer må først avsluttes på en kontrollert måte via SendMessage-avslutningsforespørsler.
-
-## Typisk bruk
-
-TeamDelete kalles på slutten av en team-arbeidsflyt:
-
-1. Alle oppgaver er fullført
-2. Teammedlemmer avsluttes via `SendMessage` med `shutdown_request`
-3. **TeamDelete** fjerner team- og oppgavemapper
-
-## Relaterte verktøy
-
-| Verktøy | Formål |
-|---------|--------|
-| `TeamCreate` | Opprett et nytt team og dets oppgaveliste |
-| `SendMessage` | Kommuniser med teammedlemmer / send avslutningsforespørsler |
-| `TaskCreate` / `TaskUpdate` / `TaskList` / `TaskGet` | Administrer den delte oppgavelisten |
-| `Agent` | Start teammedlemmer som slutter seg til teamet |

package/concepts/no/Tool-WebFetch.md

@@ -1,55 +0,0 @@
-# WebFetch
-
-## Definisjon
-
-Henter innhold fra en spesifisert URL, konverterer HTML til markdown og behandler innholdet med en AI-modell basert på promptet.
-
-## Parametere
-
-| Parameter | Type | Påkrevd | Beskrivelse |
-|-----------|------|---------|-------------|
-| `url` | string (URI) | Ja | Fullstendig URL som skal hentes |
-| `prompt` | string | Ja | Beskrivelse av hvilken informasjon som skal trekkes ut fra siden |
-
-## Bruksscenarioer
-
-**Egnet for bruk:**
-- Hente innhold fra offentlige nettsider
-- Slå opp nettbasert dokumentasjon
-- Trekke ut spesifikk informasjon fra nettsider
-
-**Ikke egnet for bruk:**
-- URL-er som krever autentisering (Google Docs, Confluence, Jira, GitHub osv.) — søk først etter et dedikert MCP-verktøy
-- GitHub-URL-er — foretrekk `gh` CLI
-
-## Merknader
-
-- URL-en må være en fullstendig gyldig URL
-- HTTP oppgraderes automatisk til HTTPS
-- Resultater kan bli oppsummert når innholdet er for stort
-- Inkluderer en selvrensende 15-minutters cache
-- Når URL-en omdirigerer til en annen vert, returnerer verktøyet den omdirigerte URL-en, og du må sende en ny forespørsel med den nye URL-en
-- Hvis et MCP-levert web fetch-verktøy er tilgjengelig, foretrekk det
-
-## Originaltekst
-
-<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/no/Tool-WebSearch.md

@@ -1,58 +0,0 @@
-# WebSearch
-
-## Definisjon
-
-Utfører søkemotorforespørsler og returnerer søkeresultater for å hente oppdatert informasjon.
-
-## Parametere
-
-| Parameter | Type | Påkrevd | Beskrivelse |
-|-----------|------|---------|-------------|
-| `query` | string | Ja | Søkeforespørsel (minst 2 tegn) |
-| `allowed_domains` | string[] | Nei | Inkluder kun resultater fra disse domenene |
-| `blocked_domains` | string[] | Nei | Ekskluder resultater fra disse domenene |
-
-## Bruksscenarioer
-
-**Egnet for bruk:**
-- Hente oppdatert informasjon utover modellens kunnskapsgrense
-- Søke etter aktuelle hendelser og nyeste data
-- Søke etter nyeste teknisk dokumentasjon
-
-## Merknader
-
-- Søkeresultater returneres i markdown-hyperlenkformat
-- Etter bruk må du legge til en "Sources:"-seksjon på slutten av responsen med relevante URL-er
-- Støtter domenefiltrering (inkluder/ekskluder)
-- Bruk gjeldende årstall i søkeforespørsler
-- Kun tilgjengelig i USA
-
-## Originaltekst
-
-<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/no/Tool-Write.md

@@ -1,39 +0,0 @@
-# Write
-
-## Definisjon
-
-Skriver innhold til det lokale filsystemet. Overskriver filen hvis den allerede eksisterer.
-
-## Parametere
-
-| Parameter | Type | Påkrevd | Beskrivelse |
-|-----------|------|---------|-------------|
-| `file_path` | string | Ja | Absolutt sti til filen (må være absolutt sti) |
-| `content` | string | Ja | Innholdet som skal skrives |
-
-## Bruksscenarioer
-
-**Egnet for bruk:**
-- Opprette nye filer
-- Når filinnholdet må skrives helt om
-
-**Ikke egnet for bruk:**
-- Endre deler av filinnholdet — bruk Edit
-- Bør ikke proaktivt opprette dokumentasjonsfiler (*.md) eller README, med mindre brukeren eksplisitt ber om det
-
-## Merknader
-
-- Hvis målfilen allerede eksisterer, må den først leses via Read, ellers mislykkes det
-- Overskriver alt eksisterende filinnhold
-- Foretrekk Edit for å redigere eksisterende filer, Write brukes kun for å opprette nye filer eller fullstendig omskriving
-
-## Originaltekst
-
-<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/no/Tool-executeCode.md

@@ -1,41 +0,0 @@
-# executeCode (mcp__ide__executeCode)
-
-## Definisjon
-
-Kjører Python-kode i Jupyter-kernelen for gjeldende notebook-fil.
-
-## Parametere
-
-| Parameter | Type | Påkrevd | Beskrivelse |
-|-----------|------|---------|-------------|
-| `code` | string | Ja | Python-koden som skal kjøres |
-
-## Bruksscenarioer
-
-**Egnet for bruk:**
-- Kjøre kode i Jupyter notebook-miljø
-- Teste kodesnutter
-- Dataanalyse og beregninger
-
-**Ikke egnet for bruk:**
-- Kodekjøring utenfor Jupyter-miljø — bruk Bash
-- Endre filer — bruk Edit eller Write
-
-## Merknader
-
-- Dette er et MCP-verktøy (Model Context Protocol), levert av IDE-integrasjonen
-- Koden kjøres i gjeldende Jupyter-kernel, og tilstanden vedvarer mellom kall
-- Med mindre brukeren eksplisitt ber om det, bør du unngå å deklarere variabler eller endre kernel-tilstand
-- Tilstanden går tapt etter omstart av kernelen
-
-## Originaltekst
-
-<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/no/Tool-getDiagnostics.md

@@ -1,32 +0,0 @@
-# getDiagnostics (mcp__ide__getDiagnostics)
-
-## Definisjon
-
-Henter språkdiagnostikk fra VS Code, inkludert syntaksfeil, typefeil, lint-advarsler osv.
-
-## Parametere
-
-| Parameter | Type | Påkrevd | Beskrivelse |
-|-----------|------|---------|-------------|
-| `uri` | string | Nei | Fil-URI. Hvis ikke angitt, hentes diagnostikk for alle filer |
-
-## Bruksscenarioer
-
-**Egnet for bruk:**
-- Sjekke syntaks-, type-, lint- og andre semantiske problemer i kode
-- Verifisere etter koderedigering at ingen nye feil er introdusert
-- Erstatte Bash-kommandoer for å sjekke kodekvalitet
-
-**Ikke egnet for bruk:**
-- Kjøre tester — bruk Bash
-- Sjekke kjøretidsfeil — bruk Bash for å kjøre koden
-
-## Merknader
-
-- Dette er et MCP-verktøy (Model Context Protocol), levert av IDE-integrasjonen
-- Kun tilgjengelig i VS Code / IDE-miljø
-- Foretrekk dette verktøyet fremfor Bash-kommandoer for å sjekke kodeproblemer
-
-## Originaltekst
-
-<textarea readonly>Get language diagnostics from VS Code</textarea>

package/concepts/no/Tools.md

@@ -1,67 +0,0 @@
-# Oversikt over Claude Code-verktøy
-
-Claude Code tilbyr en samling innebygde verktøy til modellen via tool_use-mekanismen i Anthropic API. `tools`-arrayen i hver MainAgent-forespørsel inneholder komplette JSON Schema-definisjoner for disse verktøyene, og modellen kaller dem i responsen via `tool_use` content blocks.
-
-Nedenfor er en kategorisert indeks over alle verktøy.
-
-## Agent-system
-
-| Verktøy | Formål |
-|---------|--------|
-| [Task](Tool-Task.md) | Starte en sub-agent (SubAgent) for å håndtere komplekse flerstegsoppgaver |
-| [TaskOutput](Tool-TaskOutput.md) | Hente utdata fra bakgrunnsoppgaver |
-| [TaskStop](Tool-TaskStop.md) | Stoppe en kjørende bakgrunnsoppgave |
-| [TaskCreate](Tool-TaskCreate.md) | Opprette et strukturert oppgavelisteelement |
-| [TaskGet](Tool-TaskGet.md) | Hente oppgavedetaljer |
-| [TaskUpdate](Tool-TaskUpdate.md) | Oppdatere oppgavestatus, avhengigheter osv. |
-| [TaskList](Tool-TaskList.md) | Liste alle oppgaver |
-
-## Filoperasjoner
-
-| Verktøy | Formål |
-|---------|--------|
-| [Read](Tool-Read.md) | Lese filinnhold (støtter tekst, bilder, PDF, Jupyter notebook) |
-| [Edit](Tool-Edit.md) | Redigere filer via nøyaktig strengerstatning |
-| [Write](Tool-Write.md) | Skrive eller overskrive filer |
-| [NotebookEdit](Tool-NotebookEdit.md) | Redigere Jupyter notebook-celler |
-
-## Søk
-
-| Verktøy | Formål |
-|---------|--------|
-| [Glob](Tool-Glob.md) | Søke etter filer med filnavnmønstermatching |
-| [Grep](Tool-Grep.md) | Innholdssøk i filer basert på ripgrep |
-
-## Terminal
-
-| Verktøy | Formål |
-|---------|--------|
-| [Bash](Tool-Bash.md) | Kjøre shell-kommandoer |
-
-## Web
-
-| Verktøy | Formål |
-|---------|--------|
-| [WebFetch](Tool-WebFetch.md) | Hente nettsidens innhold og behandle det med AI |
-| [WebSearch](Tool-WebSearch.md) | Søkemotorforespørsler |
-
-## Planlegging og interaksjon
-
-| Verktøy | Formål |
-|---------|--------|
-| [EnterPlanMode](Tool-EnterPlanMode.md) | Gå inn i planleggingsmodus for å designe implementeringsplan |
-| [ExitPlanMode](Tool-ExitPlanMode.md) | Gå ut av planleggingsmodus og sende planen til brukergodkjenning |
-| [AskUserQuestion](Tool-AskUserQuestion.md) | Stille spørsmål til brukeren for avklaring eller beslutninger |
-
-## Utvidelser
-
-| Verktøy | Formål |
-|---------|--------|
-| [Skill](Tool-Skill.md) | Kjøre ferdigheter (slash command) |
-
-## IDE-integrasjon
-
-| Verktøy | Formål |
-|---------|--------|
-| [getDiagnostics](Tool-getDiagnostics.md) | Hente språkdiagnostikk fra VS Code |
-| [executeCode](Tool-executeCode.md) | Kjøre kode i Jupyter kernel |

package/concepts/pl/CacheRebuild.md

@@ -1,36 +0,0 @@
-# Cache Rebuild (przebudowa cache)
-
-## Kontekst
-
-Mechanizm prompt caching Anthropic łączy system → tools → messages (do punktu przerwania cache) w klucz cache. Gdy klucz cache jest identyczny z poprzednim żądaniem, API zwraca `cache_read_input_tokens` (trafienie cache); gdy klucz cache się zmieni, API tworzy cache od nowa, zwracając dużą liczbę `cache_creation_input_tokens`, czyli przebudowę cache.
-
-Przebudowa cache oznacza dodatkowe koszty tokenów (cena cache creation jest wyższa niż cache read), dlatego identyfikacja przyczyn przebudowy ma bezpośrednią wartość dla optymalizacji kosztów.
-
-## Klasyfikacja przyczyn przebudowy cache
-
-cc-viewer porównuje treści dwóch kolejnych żądań MainAgent, aby precyzyjnie określić przyczynę przebudowy cache:
-
-| reason | Znaczenie | Sposób określenia |
-|--------|------|----------|
-| `ttl` | Cache wygasł | Od poprzedniego żądania MainAgent upłynęło ponad 5 minut |
-| `system_change` | Zmiana system prompt | `JSON.stringify(prev.system) !== JSON.stringify(curr.system)` |
-| `tools_change` | Zmiana definicji narzędzi | `JSON.stringify(prev.tools) !== JSON.stringify(curr.tools)` |
-| `model_change` | Zmiana modelu | `prev.model !== curr.model` |
-| `msg_truncated` | Obcięcie stosu wiadomości | Bieżące żądanie ma mniej wiadomości niż poprzednie, zazwyczaj z powodu obcięcia wywołanego przepełnieniem okna kontekstu |
-| `msg_modified` | Modyfikacja historii wiadomości | Treść wiadomości prefiksowych jest niespójna (przy normalnym dopisywaniu prefiks powinien być identyczny) |
-| `key_change` | Nieznana zmiana klucza | Fallback, gdy żaden z powyższych warunków nie pasuje |
-
-## Priorytet określania
-
-1. Najpierw sprawdzany jest odstęp czasowy — ponad 5 minut oznacza bezpośrednio `ttl`, bez porównywania treści
-2. Następnie kolejno sprawdzane są: model, system, tools, messages
-3. Jedno żądanie może jednocześnie spełniać wiele przyczyn (np. zmiana modelu + zmiana system prompt), wtedy tablica `reasons` zawiera wszystkie pasujące elementy, a tooltip wyświetla je w osobnych wierszach
-
-## Typowe scenariusze
-
-- **`ttl`**: użytkownik wstrzymał pracę na ponad 5 minut, cache naturalnie wygasł
-- **`system_change`**: Claude Code zaktualizował system prompt (np. załadowanie nowego CLAUDE.md, zmiana instrukcji projektu)
-- **`tools_change`**: połączenie/rozłączenie serwera MCP spowodowało zmianę listy dostępnych narzędzi
-- **`model_change`**: użytkownik przełączył model poleceniem `/model`
-- **`msg_truncated`**: zbyt długi dialog wywołał zarządzanie oknem kontekstu, Claude Code obciął wcześniejsze wiadomości
-- **`msg_modified`**: Claude Code edytował historyczne wiadomości (np. `/compact` zastąpił oryginalne wiadomości skompresowanym podsumowaniem)

package/concepts/pl/KVCacheContent.md

@@ -1,49 +0,0 @@
-# Zawartość pamięci podręcznej KV-Cache
-
-## Czym jest Prompt Caching?
-
-Gdy rozmawiasz z Claude, każde żądanie API wysyła pełny kontekst konwersacji (system prompt + definicje narzędzi + historia wiadomości). Mechanizm prompt caching Anthropica buforuje na serwerze już obliczoną zawartość prefiksu, a jeśli prefiks jest taki sam przy kolejnych żądaniach, wynik z pamięci podręcznej jest bezpośrednio wykorzystywany ponownie, pomijając powtórne obliczenia i znacząco redukując opóźnienia i koszty.
-
-W cc-viewer mechanizm ten nazywany jest "KV-Cache" i odpowiada prompt cachingowi na poziomie Anthropic API — a nie pamięci podręcznej key-value w warstwach uwagi transformera wewnątrz LLM.
-
-## Jak działa pamięć podręczna
-
-Prompt caching Anthropica łączy klucze pamięci podręcznej w stałej kolejności:
-
-```
-Tools → System Prompt → Messages (do cache breakpoint)
-```
-
-Dopóki ten prefiks jest całkowicie identyczny z dowolnym żądaniem w oknie TTL, API trafi w pamięć podręczną (zwraca `cache_read_input_tokens`) zamiast obliczać ponownie (`cache_creation_input_tokens`).
-
-> **Claude Code nie jest silnie zależny od atrybutu `cache_control` — serwer usuwa niektóre z tych atrybutów, ale nadal potrafi prawidłowo tworzyć pamięć podręczną, więc brak atrybutu `cache_control` nie oznacza, że zawartość nie jest buforowana**
->
-> Dla specjalnych klientów takich jak Claude Code, serwer Anthropica nie jest całkowicie zależny od atrybutu `cache_control` w żądaniu do określenia zachowania pamięci podręcznej. Serwer automatycznie stosuje strategie buforowania dla określonych pól (takich jak system prompt i definicje narzędzi), nawet gdy żądanie nie zawiera jawnie znaczników `cache_control`. Dlatego nie musisz się dziwić, gdy nie widzisz tego atrybutu w treści żądania — serwer już wykonał operację buforowania za kulisami, po prostu nie ujawnił tej informacji klientowi. Jest to milczące porozumienie między Claude Code a Anthropic API.
-
-## Czym jest "bieżąca zawartość pamięci podręcznej KV-Cache"?
-
-"Bieżąca zawartość pamięci podręcznej KV-Cache" wyświetlana w cc-viewer to zawartość wyodrębniona z ostatniego żądania MainAgent, znajdująca się przed granicą pamięci podręcznej (cache breakpoint). Obejmuje konkretnie:
-
-- **System Prompt**: Instrukcje systemowe Claude Code, w tym podstawowe instrukcje agenta, zasady korzystania z narzędzi, instrukcje projektu CLAUDE.md, informacje o środowisku itp.
-- **Tools**: Lista aktualnie dostępnych definicji narzędzi (takich jak Read, Write, Bash, Agent, narzędzia MCP itp.)
-- **Messages**: Buforowana część historii konwersacji (zwykle starsze wiadomości, do ostatniego znacznika `cache_control`)
-
-## Dlaczego warto przeglądać zawartość pamięci podręcznej?
-
-1. **Zrozumienie kontekstu**: Dowiedz się, jaką zawartość Claude aktualnie "pamięta", i oceń, czy jego zachowanie jest zgodne z oczekiwaniami
-2. **Optymalizacja kosztów**: Trafienie w pamięć podręczną kosztuje znacznie mniej niż ponowne obliczenia. Przeglądanie zawartości pamięci podręcznej pomaga zrozumieć, dlaczego niektóre żądania wyzwoliły przebudowę pamięci podręcznej (cache rebuild)
-3. **Debugowanie konwersacji**: Gdy odpowiedź Claude nie jest zgodna z oczekiwaniami, sprawdzenie zawartości pamięci podręcznej pozwala potwierdzić, czy system prompt i historia wiadomości są poprawne
-4. **Monitorowanie jakości kontekstu**: Podczas debugowania, modyfikacji konfiguracji lub dostosowywania promptów, KV-Cache-Text zapewnia scentralizowaną perspektywę, pomagającą szybko potwierdzić, czy kontekst główny nie uległ pogorszeniu lub nie został zanieczyszczony nieoczekiwaną zawartością — bez konieczności przeglądania oryginalnych wiadomości po kolei
-
-## Wielopoziomowa strategia pamięci podręcznej
-
-Pamięć KV-Cache odpowiadająca Claude Code nie jest pojedynczą pamięcią podręczną. Serwer generuje oddzielne pamięci podręczne dla Tools i System Prompt, niezależnie od pamięci podręcznej Messages. Zaletą tego projektu jest to, że gdy stos wiadomości zostaje zakłócony (np. obcinanie kontekstu, modyfikacja wiadomości) i wymaga przebudowy, nie unieważnia to jednocześnie pamięci podręcznych Tools i System Prompt, unikając pełnego ponownego obliczania.
-
-Jest to strategia optymalizacji po stronie serwera — ponieważ definicje Tools i System Prompt są stosunkowo stabilne podczas normalnego użytkowania i rzadko się zmieniają, oddzielne buforowanie ich maksymalizuje redukcję niepotrzebnych kosztów przebudowy. Dlatego obserwując pamięć podręczną, zauważysz, że oprócz przebudowy Tools, która wymaga pełnego odświeżenia wszystkich pamięci podręcznych, zniszczenie System Prompt i Messages nadal pozwala na dziedziczenie dostępnych pamięci podręcznych.
-
-## Cykl życia pamięci podręcznej
-
-- **Tworzenie**: Przy pierwszym żądaniu lub po wygaśnięciu pamięci podręcznej, API tworzy nową pamięć podręczną (`cache_creation_input_tokens`)
-- **Trafienie**: Kolejne żądania z identycznym prefiksem ponownie wykorzystują pamięć podręczną (`cache_read_input_tokens`)
-- **Wygaśnięcie**: Pamięć podręczna ma TTL (czas życia) wynoszący 5 minut i automatycznie wygasa po tym czasie
-- **Przebudowa**: Gdy system prompt, lista narzędzi, model lub zawartość wiadomości się zmienią, klucz pamięci podręcznej nie pasuje, wyzwalając przebudowę odpowiedniego poziomu