cx-viewer 1.0.3 → 1.0.4

package/concepts/tr/Tool-TaskOutput.md

@@ -1,40 +0,0 @@
-# TaskOutput
-
-## Tanım
-
-Çalışan veya tamamlanmış arka plan görevinin çıktısını alır. Arka plan shell'leri, asenkron agent'lar ve uzak oturumlar için uygundur.
-
-## Parametreler
-
-| Parametre | Tür | Zorunlu | Açıklama |
-|-----------|-----|---------|----------|
-| `task_id` | string | Evet | Görev ID'si |
-| `block` | boolean | Evet | Görev tamamlanana kadar beklenip beklenmeyeceği, varsayılan `true` |
-| `timeout` | number | Evet | Maksimum bekleme süresi (milisaniye), varsayılan 30000, maksimum 600000 |
-
-## Kullanım Senaryoları
-
-**Kullanıma uygun:**
-- Task (`run_in_background: true`) ile başlatılan arka plan agent'ının ilerlemesini kontrol etme
-- Arka plan Bash komutunun çalıştırma sonucunu alma
-- Asenkron görevin tamamlanmasını bekleyip çıktısını alma
-
-**Kullanıma uygun değil:**
-- Ön plan görevleri — ön plan görevleri doğrudan sonuç döndürür, bu araca gerek yoktur
-
-## Dikkat Edilecekler
-
-- `block: true` görev tamamlanana veya zaman aşımına uğrayana kadar engeller
-- `block: false` mevcut durumu engellemeden kontrol etmek için kullanılır
-- Görev ID'si `/tasks` komutuyla bulunabilir
-- Tüm görev türleri için geçerlidir: arka plan shell, asenkron agent, uzak oturum
-
-## Orijinal Metin
-
-<textarea readonly>- Retrieves output from a running or completed task (background shell, agent, or remote session)
-- Takes a task_id parameter identifying the task
-- Returns the task output along with status information
-- Use block=true (default) to wait for task completion
-- Use block=false for non-blocking check of current status
-- Task IDs can be found using the /tasks command
-- Works with all task types: background shells, async agents, and remote sessions</textarea>

package/concepts/tr/Tool-TaskStop.md

@@ -1,32 +0,0 @@
-# TaskStop
-
-## Tanım
-
-Çalışan bir arka plan görevini durdurur.
-
-## Parametreler
-
-| Parametre | Tür | Zorunlu | Açıklama |
-|-----------|-----|---------|----------|
-| `task_id` | string | Hayır | Durdurulacak arka plan görev ID'si |
-| `shell_id` | string | Hayır | Kullanımdan kaldırıldı, `task_id` kullanın |
-
-## Kullanım Senaryoları
-
-**Kullanıma uygun:**
-- Artık gerekli olmayan uzun süreli görevleri sonlandırma
-- Yanlışlıkla başlatılan arka plan görevlerini iptal etme
-
-## Dikkat Edilecekler
-
-- Başarı veya başarısızlık durumu döndürür
-- `shell_id` parametresi kullanımdan kaldırılmıştır, `task_id` kullanılmalıdır
-
-## Orijinal Metin
-
-<textarea readonly>
-- Stops a running background task by its ID
-- Takes a task_id parameter identifying the task to stop
-- Returns a success or failure status
-- Use this tool when you need to terminate a long-running task
-</textarea>

package/concepts/tr/Tool-TaskUpdate.md

@@ -1,123 +0,0 @@
-# TaskUpdate
-
-## Tanım
-
-Görev listesindeki bir görevin durumunu, içeriğini veya bağımlılık ilişkilerini günceller.
-
-## Parametreler
-
-| Parametre | Tür | Zorunlu | Açıklama |
-|-----------|-----|---------|----------|
-| `taskId` | string | Evet | Güncellenecek görev ID'si |
-| `status` | enum | Hayır | Yeni durum: `pending` / `in_progress` / `completed` / `deleted` |
-| `subject` | string | Hayır | Yeni başlık |
-| `description` | string | Hayır | Yeni açıklama |
-| `activeForm` | string | Hayır | Devam ederken gösterilen şimdiki zaman metni |
-| `owner` | string | Hayır | Yeni görev sorumlusu (agent adı) |
-| `metadata` | object | Hayır | Birleştirilecek meta veriler (null olarak ayarlamak anahtarı siler) |
-| `addBlocks` | string[] | Hayır | Bu görev tarafından engellenen görev ID listesi |
-| `addBlockedBy` | string[] | Hayır | Bu görevi engelleyen ön koşul görev ID listesi |
-
-## Durum Geçişi
-
-```
-pending → in_progress → completed
-```
-
-`deleted` herhangi bir durumdan geçilebilir ve görevi kalıcı olarak kaldırır.
-
-## Kullanım Senaryoları
-
-**Kullanıma uygun:**
-- Çalışmaya başlarken görevi `in_progress` olarak işaretleme
-- Çalışma tamamlandığında görevi `completed` olarak işaretleme
-- Görevler arası bağımlılık ilişkilerini ayarlama
-- Gereksinimler değiştiğinde görev içeriğini güncelleme
-
-**Önemli kurallar:**
-- Yalnızca görev tamamen tamamlandığında `completed` olarak işaretleyin
-- Hata veya engelle karşılaşıldığında `in_progress` olarak bırakın
-- Test başarısız, uygulama eksik veya çözülmemiş hatalarla karşılaşıldığında `completed` olarak işaretlemeyin
-
-## Dikkat Edilecekler
-
-- Güncellemeden önce TaskGet ile görevin en son durumunu alın, eski verileri önleyin
-- Görevi tamamladıktan sonra TaskList ile bir sonraki mevcut görevi bulun
-
-## Orijinal Metin
-
-<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/tr/Tool-TeamCreate.md

@@ -1,38 +0,0 @@
-# TeamCreate
-
-## Tanım
-
-Bir proje üzerinde çalışan birden fazla agent'ı koordine etmek için yeni bir takım oluşturur. Takımlar, paylaşılan bir görev listesi ve agent'lar arası mesajlaşma aracılığıyla paralel görev yürütmeyi mümkün kılar.
-
-## Parametreler
-
-| Parametre | Tür | Zorunlu | Açıklama |
-|-----------|-----|---------|----------|
-| `team_name` | string | Evet | Yeni takımın adı |
-| `description` | string | Hayır | Takım açıklaması / amacı |
-| `agent_type` | string | Hayır | Takım liderinin türü / rolü |
-
-## Oluşturulanlar
-
-- **Takım yapılandırma dosyası**: `~/.claude/teams/{team-name}/config.json` — üye listesini ve meta verileri saklar
-- **Görev listesi dizini**: `~/.claude/tasks/{team-name}/` — tüm takım üyeleri için paylaşılan görev listesi
-
-Takımlar ile görev listeleri arasında 1:1 ilişki vardır.
-
-## Takım İş Akışı
-
-1. **TeamCreate** — takımı ve görev listesini oluştur
-2. **TaskCreate** — takım için görevleri tanımla
-3. **Agent** (`team_name` + `name` ile) — takıma katılan takım üyelerini başlat
-4. **TaskUpdate** — `owner` aracılığıyla görevleri takım üyelerine ata
-5. Takım üyeleri görevler üzerinde çalışır ve **SendMessage** ile iletişim kurar
-6. İşlem bitince takım üyelerini kapat, ardından **TeamDelete** ile temizlik yap
-
-## İlgili Araçlar
-
-| Araç | Amaç |
-|------|------|
-| `TeamDelete` | Takımı ve görev dizinlerini kaldır |
-| `SendMessage` | Takım içi agent'lar arası iletişim |
-| `TaskCreate` / `TaskUpdate` / `TaskList` / `TaskGet` | Paylaşılan görev listesini yönet |
-| `Agent` | Takıma katılan takım üyelerini başlat |

package/concepts/tr/Tool-TeamDelete.md

@@ -1,30 +0,0 @@
-# TeamDelete
-
-## Tanım
-
-Çok agent'lı işbirliği çalışması tamamlandığında bir takımı ve ilişkili görev dizinlerini kaldırır. Bu, TeamCreate'in temizlik karşılığıdır.
-
-## Davranış
-
-- Takım dizinini kaldırır: `~/.claude/teams/{team-name}/`
-- Görev dizinini kaldırır: `~/.claude/tasks/{team-name}/`
-- Mevcut oturumdan takım bağlamını temizler
-
-**Önemli**: Takımın hâlâ aktif üyeleri varsa TeamDelete başarısız olur. Takım üyeleri önce SendMessage kapatma istekleri aracılığıyla düzgün şekilde kapatılmalıdır.
-
-## Tipik Kullanım
-
-TeamDelete, bir takım iş akışının sonunda çağrılır:
-
-1. Tüm görevler tamamlanır
-2. Takım üyeleri `shutdown_request` ile `SendMessage` aracılığıyla kapatılır
-3. **TeamDelete** takım ve görev dizinlerini kaldırır
-
-## İlgili Araçlar
-
-| Araç | Amaç |
-|------|------|
-| `TeamCreate` | Yeni bir takım ve görev listesi oluştur |
-| `SendMessage` | Takım üyeleriyle iletişim kur / kapatma istekleri gönder |
-| `TaskCreate` / `TaskUpdate` / `TaskList` / `TaskGet` | Paylaşılan görev listesini yönet |
-| `Agent` | Takıma katılan takım üyelerini başlat |

package/concepts/tr/Tool-WebFetch.md

@@ -1,55 +0,0 @@
-# WebFetch
-
-## Tanım
-
-Belirtilen URL'nin web sayfası içeriğini çeker, HTML'yi markdown'a dönüştürür ve prompt'a göre AI modeli ile içeriği işler.
-
-## Parametreler
-
-| Parametre | Tür | Zorunlu | Açıklama |
-|-----------|-----|---------|----------|
-| `url` | string (URI) | Evet | Çekilecek tam URL |
-| `prompt` | string | Evet | Sayfadan hangi bilginin çıkarılacağını açıklar |
-
-## Kullanım Senaryoları
-
-**Kullanıma uygun:**
-- Herkese açık web sayfalarının içeriğini alma
-- Çevrimiçi belgelere başvurma
-- Web sayfasından belirli bilgileri çıkarma
-
-**Kullanıma uygun değil:**
-- Kimlik doğrulama gerektiren URL'ler (Google Docs, Confluence, Jira, GitHub vb.) — önce özel MCP aracı aranmalıdır
-- GitHub URL'leri — öncelikle `gh` CLI kullanılmalıdır
-
-## Dikkat Edilecekler
-
-- URL tam ve geçerli bir URL olmalıdır
-- HTTP otomatik olarak HTTPS'ye yükseltilir
-- İçerik çok büyükse sonuçlar özetlenebilir
-- 15 dakikalık otomatik temizlenen önbellek içerir
-- URL farklı bir ana bilgisayara yönlendirildiğinde, araç yönlendirme URL'sini döndürür ve yeni URL ile tekrar istek yapılması gerekir
-- MCP tarafından sağlanan web fetch aracı mevcutsa, onu tercih edin
-
-## Orijinal Metin
-
-<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/tr/Tool-WebSearch.md

@@ -1,58 +0,0 @@
-# WebSearch
-
-## Tanım
-
-Arama motoru sorgusu çalıştırır ve güncel bilgi almak için arama sonuçlarını döndürür.
-
-## Parametreler
-
-| Parametre | Tür | Zorunlu | Açıklama |
-|-----------|-----|---------|----------|
-| `query` | string | Evet | Arama sorgusu (en az 2 karakter) |
-| `allowed_domains` | string[] | Hayır | Yalnızca bu alan adlarından sonuçları dahil et |
-| `blocked_domains` | string[] | Hayır | Bu alan adlarından sonuçları hariç tut |
-
-## Kullanım Senaryoları
-
-**Kullanıma uygun:**
-- Modelin bilgi kesme tarihini aşan güncel bilgileri alma
-- Güncel olayları ve en son verileri bulma
-- En güncel teknik belgeleri arama
-
-## Dikkat Edilecekler
-
-- Arama sonuçları markdown köprü formatında döndürülür
-- Kullanımdan sonra yanıtın sonuna "Sources:" bölümü eklenmeli ve ilgili URL'ler listelenmelidir
-- Alan adı filtrelemeyi destekler (dahil etme/hariç tutma)
-- Arama sorgusunda güncel yıl kullanılmalıdır
-- Yalnızca ABD'de kullanılabilir
-
-## Orijinal Metin
-
-<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/tr/Tool-Write.md

@@ -1,39 +0,0 @@
-# Write
-
-## Tanım
-
-İçeriği yerel dosya sistemine yazar. Dosya zaten mevcutsa üzerine yazar.
-
-## Parametreler
-
-| Parametre | Tür | Zorunlu | Açıklama |
-|-----------|-----|---------|----------|
-| `file_path` | string | Evet | Dosyanın mutlak yolu (mutlak yol olmalıdır) |
-| `content` | string | Evet | Yazılacak içerik |
-
-## Kullanım Senaryoları
-
-**Kullanıma uygun:**
-- Yeni dosya oluşturma
-- Dosya içeriğinin tamamen yeniden yazılması gerektiğinde
-
-**Kullanıma uygun değil:**
-- Dosyadaki kısmi içeriği değiştirme — Edit kullanılmalıdır
-- Kullanıcı açıkça istemediği sürece proaktif olarak belge dosyaları (*.md) veya README oluşturulmamalıdır
-
-## Dikkat Edilecekler
-
-- Hedef dosya zaten mevcutsa, önce Read ile okunmuş olmalıdır, aksi takdirde başarısız olur
-- Mevcut dosyanın tüm içeriğini üzerine yazar
-- Mevcut dosyaları düzenlemek için Edit'i tercih edin; Write yalnızca yeni dosya oluşturma veya tamamen yeniden yazma için kullanılır
-
-## Orijinal Metin
-
-<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/tr/Tool-executeCode.md

@@ -1,41 +0,0 @@
-# executeCode (mcp__ide__executeCode)
-
-## Tanım
-
-Mevcut notebook dosyasının Jupyter kernel'ında Python kodu çalıştırır.
-
-## Parametreler
-
-| Parametre | Tür | Zorunlu | Açıklama |
-|-----------|-----|---------|----------|
-| `code` | string | Evet | Çalıştırılacak Python kodu |
-
-## Kullanım Senaryoları
-
-**Kullanıma uygun:**
-- Jupyter notebook ortamında kod çalıştırma
-- Kod parçacıklarını test etme
-- Veri analizi ve hesaplama
-
-**Kullanıma uygun değil:**
-- Jupyter dışı ortamda kod çalıştırma — Bash kullanılmalıdır
-- Dosya değiştirme — Edit veya Write kullanılmalıdır
-
-## Dikkat Edilecekler
-
-- Bu bir MCP (Model Context Protocol) aracıdır ve IDE entegrasyonu tarafından sağlanır
-- Kod mevcut Jupyter kernel'ında çalıştırılır, durum çağrılar arasında kalıcıdır
-- Kullanıcı açıkça istemediği sürece değişken tanımlamaktan veya kernel durumunu değiştirmekten kaçınılmalıdır
-- Kernel yeniden başlatıldığında durum kaybolur
-
-## Orijinal Metin
-
-<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/tr/Tool-getDiagnostics.md

@@ -1,32 +0,0 @@
-# getDiagnostics (mcp__ide__getDiagnostics)
-
-## Tanım
-
-VS Code'dan sözdizimi hataları, tür hataları, lint uyarıları gibi dil tanılama bilgilerini alır.
-
-## Parametreler
-
-| Parametre | Tür | Zorunlu | Açıklama |
-|-----------|-----|---------|----------|
-| `uri` | string | Hayır | Dosya URI'si. Belirtilmezse tüm dosyaların tanılama bilgilerini alır |
-
-## Kullanım Senaryoları
-
-**Kullanıma uygun:**
-- Kodun sözdizimi, tür, lint gibi anlamsal sorunlarını kontrol etme
-- Kod düzenledikten sonra yeni hata oluşup oluşmadığını doğrulama
-- Kod kalitesini kontrol etmek için Bash komutlarının yerine kullanma
-
-**Kullanıma uygun değil:**
-- Test çalıştırma — Bash kullanılmalıdır
-- Çalışma zamanı hatalarını kontrol etme — kodu çalıştırmak için Bash kullanılmalıdır
-
-## Dikkat Edilecekler
-
-- Bu bir MCP (Model Context Protocol) aracıdır ve IDE entegrasyonu tarafından sağlanır
-- Yalnızca VS Code / IDE ortamında kullanılabilir
-- Kod sorunlarını kontrol etmek için Bash komutları yerine bu aracı tercih edin
-
-## Orijinal Metin
-
-<textarea readonly>Get language diagnostics from VS Code</textarea>

package/concepts/tr/Tools.md

@@ -1,67 +0,0 @@
-# Claude Code Araç Listesi
-
-Claude Code, Anthropic API'nin tool_use mekanizması aracılığıyla modele bir dizi yerleşik araç sunar. Her MainAgent isteğinin `tools` dizisi bu araçların tam JSON Schema tanımlarını içerir ve model yanıtında `tool_use` content block aracılığıyla bunları çağırır.
-
-Aşağıda tüm araçların kategorize edilmiş dizini bulunmaktadır.
-
-## Agent Sistemi
-
-| Araç | Kullanım Amacı |
-|------|----------------|
-| [Task](Tool-Task.md) | Karmaşık çok adımlı görevleri işlemek için alt agent (SubAgent) başlatma |
-| [TaskOutput](Tool-TaskOutput.md) | Arka plan görevinin çıktısını alma |
-| [TaskStop](Tool-TaskStop.md) | Çalışan arka plan görevini durdurma |
-| [TaskCreate](Tool-TaskCreate.md) | Yapılandırılmış görev listesi girdisi oluşturma |
-| [TaskGet](Tool-TaskGet.md) | Görev detaylarını alma |
-| [TaskUpdate](Tool-TaskUpdate.md) | Görev durumunu, bağımlılıkları vb. güncelleme |
-| [TaskList](Tool-TaskList.md) | Tüm görevleri listeleme |
-
-## Dosya İşlemleri
-
-| Araç | Kullanım Amacı |
-|------|----------------|
-| [Read](Tool-Read.md) | Dosya içeriğini okuma (metin, resim, PDF, Jupyter notebook desteği) |
-| [Edit](Tool-Edit.md) | Kesin dize değiştirme ile dosya düzenleme |
-| [Write](Tool-Write.md) | Dosya yazma veya üzerine yazma |
-| [NotebookEdit](Tool-NotebookEdit.md) | Jupyter notebook hücresini düzenleme |
-
-## Arama
-
-| Araç | Kullanım Amacı |
-|------|----------------|
-| [Glob](Tool-Glob.md) | Dosya adı kalıp eşleştirmesiyle dosya arama |
-| [Grep](Tool-Grep.md) | ripgrep tabanlı dosya içeriği arama |
-
-## Terminal
-
-| Araç | Kullanım Amacı |
-|------|----------------|
-| [Bash](Tool-Bash.md) | Shell komutu çalıştırma |
-
-## Web
-
-| Araç | Kullanım Amacı |
-|------|----------------|
-| [WebFetch](Tool-WebFetch.md) | Web sayfası içeriğini çekme ve AI ile işleme |
-| [WebSearch](Tool-WebSearch.md) | Arama motoru sorgusu |
-
-## Planlama ve Etkileşim
-
-| Araç | Kullanım Amacı |
-|------|----------------|
-| [EnterPlanMode](Tool-EnterPlanMode.md) | Planlama moduna girme, uygulama planı tasarlama |
-| [ExitPlanMode](Tool-ExitPlanMode.md) | Planlama modundan çıkma ve planı kullanıcı onayına sunma |
-| [AskUserQuestion](Tool-AskUserQuestion.md) | Açıklama veya karar almak için kullanıcıya soru sorma |
-
-## Eklentiler
-
-| Araç | Kullanım Amacı |
-|------|----------------|
-| [Skill](Tool-Skill.md) | Beceri (slash command) çalıştırma |
-
-## IDE Entegrasyonu
-
-| Araç | Kullanım Amacı |
-|------|----------------|
-| [getDiagnostics](Tool-getDiagnostics.md) | VS Code dil tanılama bilgilerini alma |
-| [executeCode](Tool-executeCode.md) | Jupyter kernel'da kod çalıştırma |

package/concepts/uk/CacheRebuild.md

@@ -1,36 +0,0 @@
-# Cache Rebuild (Перебудова кешу)
-
-## Передумови
-
-Механізм prompt caching від Anthropic послідовно об'єднує system → tools → messages (до cache breakpoint) у запиті для формування ключа кешу. Коли ключ кешу повністю збігається з попереднім запитом, API повертає `cache_read_input_tokens` (влучання в кеш); коли ключ кешу змінюється, API створює кеш заново і повертає велику кількість `cache_creation_input_tokens`, тобто відбувається перебудова кешу.
-
-Перебудова кешу означає додаткову тарифікацію токенів (ціна cache creation вища за cache read), тому визначення причини перебудови має пряму цінність для оптимізації витрат.
-
-## Класифікація причин перебудови кешу
-
-cc-viewer порівнює тіла двох послідовних запитів MainAgent для точного визначення причини перебудови кешу:
-
-| reason | Значення | Спосіб визначення |
-|--------|----------|-------------------|
-| `ttl` | Кеш протермінувався | З моменту попереднього запиту MainAgent минуло більше 5 хвилин |
-| `system_change` | Зміна system prompt | `JSON.stringify(prev.system) !== JSON.stringify(curr.system)` |
-| `tools_change` | Зміна визначень інструментів | `JSON.stringify(prev.tools) !== JSON.stringify(curr.tools)` |
-| `model_change` | Зміна моделі | `prev.model !== curr.model` |
-| `msg_truncated` | Стек повідомлень обрізано | Кількість messages у поточному запиті менша за попередній, зазвичай спричинено переповненням контекстного вікна |
-| `msg_modified` | Історичні повідомлення змінено | Вміст префіксних повідомлень не збігається (при нормальному додаванні префікс повинен бути ідентичним) |
-| `key_change` | Невідома зміна ключа | Fallback, коли жодна з вищезазначених умов не збігається |
-
-## Пріоритет визначення
-
-1. Спочатку перевіряється часовий інтервал — якщо минуло більше 5 хвилин, одразу визначається як `ttl`, порівняння body не виконується
-2. Потім послідовно перевіряються model, system, tools, messages
-3. Один запит може одночасно мати кілька причин (наприклад, зміна моделі + зміна system prompt), у цьому випадку масив `reasons` містить усі збіги, tooltip відображає їх порядково
-
-## Типові сценарії
-
-- **`ttl`**: Користувач призупинив роботу більш ніж на 5 хвилин і потім продовжив, кеш природно протермінувався
-- **`system_change`**: Claude Code оновив system prompt (наприклад, завантажено новий CLAUDE.md, змінилися project instructions)
-- **`tools_change`**: Підключення/відключення MCP server призвело до зміни списку доступних інструментів
-- **`model_change`**: Користувач змінив модель командою `/model`
-- **`msg_truncated`**: Занадто довга розмова спричинила управління контекстним вікном, Claude Code обрізав ранні повідомлення
-- **`msg_modified`**: Claude Code відредагував історичні повідомлення (наприклад, `/compact` стиснення замінило оригінальні повідомлення зведенням)

package/concepts/uk/KVCacheContent.md

@@ -1,49 +0,0 @@
-# Вміст кешу KV-Cache
-
-## Що таке Prompt Caching?
-
-Коли ви спілкуєтесь з Claude, кожен запит API надсилає повний контекст розмови (system prompt + визначення інструментів + історія повідомлень). Механізм prompt caching від Anthropic кешує на сервері вже обчислений вміст префікса, і якщо префікс залишається тим самим у наступних запитах, результат кешу використовується повторно напряму, пропускаючи повторні обчислення та значно зменшуючи затримку і витрати.
-
-У cc-viewer цей механізм називається "KV-Cache" і відповідає prompt caching на рівні Anthropic API, а не key-value кешу в шарах уваги трансформера всередині LLM.
-
-## Як працює кеш
-
-Prompt caching від Anthropic об'єднує ключі кешу у фіксованому порядку:
-
-```
-Tools → System Prompt → Messages (до cache breakpoint)
-```
-
-Поки цей префікс повністю ідентичний будь-якому запиту у вікні TTL, API влучає в кеш (повертає `cache_read_input_tokens`), а не перераховує (`cache_creation_input_tokens`).
-
-> **Claude Code не є сильно залежним від атрибута `cache_control` — сервер видаляє деякі з цих атрибутів, але все одно добре створює кеш, тому відсутність атрибута `cache_control` не означає, що вміст не кешується**
->
-> Для спеціальних клієнтів на кшталт Claude Code сервер Anthropic не повністю залежить від атрибута `cache_control` у запиті для визначення поведінки кешу. Сервер автоматично застосовує стратегії кешування для певних полів (таких як system prompt і визначення інструментів), навіть коли запит явно не містить маркерів `cache_control`. Тому не дивуйтеся, коли не бачите цей атрибут у тілі запиту — сервер вже виконав операцію кешування за лаштунками, просто не розкрив цю інформацію клієнту. Це негласна домовленість між Claude Code та Anthropic API.
-
-## Що таке "поточний вміст кешу KV-Cache"?
-
-"Поточний вміст кешу KV-Cache", що відображається в cc-viewer, — це вміст, витягнутий з останнього запиту MainAgent, що знаходиться перед межею кешу (cache breakpoint). Конкретно включає:
-
-- **System Prompt**: Системні інструкції Claude Code, включаючи основні інструкції агента, правила використання інструментів, інструкції проєкту CLAUDE.md, інформацію про середовище тощо
-- **Tools**: Список доступних визначень інструментів (таких як Read, Write, Bash, Agent, інструменти MCP тощо)
-- **Messages**: Кешована частина історії розмови (зазвичай старіші повідомлення, до останнього маркера `cache_control`)
-
-## Чому варто переглядати вміст кешу?
-
-1. **Розуміння контексту**: Дізнайтеся, який вміст Claude наразі "пам'ятає", і оцініть, чи його поведінка відповідає очікуванням
-2. **Оптимізація витрат**: Влучення в кеш коштує набагато менше, ніж перерахунок. Перегляд вмісту кешу допомагає зрозуміти, чому певні запити спричинили перебудову кешу (cache rebuild)
-3. **Налагодження розмови**: Коли відповідь Claude не відповідає очікуванням, перевірка вмісту кешу дозволяє підтвердити, чи system prompt та історія повідомлень правильні
-4. **Моніторинг якості контексту**: Під час налагодження, зміни конфігурації або коригування промптів, KV-Cache-Text забезпечує централізовану перспективу, яка допомагає швидко підтвердити, чи основний контекст не погіршився або не був забруднений неочікуваним вмістом — без необхідності переглядати оригінальні повідомлення одне за одним
-
-## Багаторівнева стратегія кешування
-
-KV-Cache, що відповідає Claude Code, — це не єдиний кеш. Сервер генерує окремі кеші для Tools та System Prompt, незалежно від кешу Messages. Перевага такого дизайну: коли стек повідомлень порушується (наприклад, обрізання контексту, зміна повідомлень) і потребує перебудови, це не інвалідує одночасно кеші Tools та System Prompt, уникаючи повного перерахунку.
-
-Це стратегія оптимізації на стороні сервера — оскільки визначення Tools та System Prompt відносно стабільні під час звичайного використання і рідко змінюються, окреме кешування їх максимізує зменшення непотрібних витрат на перебудову. Тому, спостерігаючи за кешем, ви помітите, що окрім перебудови Tools, яка потребує повного оновлення всіх кешів, руйнування System Prompt та Messages все ще дозволяє успадковувати доступні кеші.
-
-## Життєвий цикл кешу
-
-- **Створення**: При першому запиті або після закінчення терміну дії кешу, API створює новий кеш (`cache_creation_input_tokens`)
-- **Влучення**: Наступні запити з ідентичним префіксом повторно використовують кеш (`cache_read_input_tokens`)
-- **Закінчення**: Кеш має TTL (час життя) 5 хвилин і автоматично закінчується після цього часу
-- **Перебудова**: Коли system prompt, список інструментів, модель або вміст повідомлень змінюються, ключ кешу не збігається, що спричиняє перебудову відповідного рівня