cx-viewer 1.0.3 → 1.0.4

package/concepts/ar/Tool-TeamCreate.md

@@ -1,38 +0,0 @@
-# TeamCreate
-
-## التعريف
-
-ينشئ فريقاً جديداً لتنسيق عمل عدة agent معاً. تتيح الفرق التنفيذ المتوازي للمهام من خلال قائمة مهام مشتركة وتبادل الرسائل بين الـ agent.
-
-## المعاملات
-
-| المعامل | النوع | مطلوب | الوصف |
-|---------|-------|-------|-------|
-| `team_name` | string | نعم | اسم الفريق الجديد |
-| `description` | string | لا | وصف الفريق / الغرض منه |
-| `agent_type` | string | لا | نوع / دور قائد الفريق |
-
-## ما يتم إنشاؤه
-
-- **ملف إعداد الفريق**: `~/.claude/teams/{team-name}/config.json` — يخزن قائمة الأعضاء والبيانات الوصفية
-- **دليل قائمة المهام**: `~/.claude/tasks/{team-name}/` — قائمة المهام المشتركة لجميع أعضاء الفريق
-
-يوجد تطابق 1:1 بين الفرق وقوائم المهام.
-
-## سير عمل الفريق
-
-1. **TeamCreate** — إنشاء الفريق وقائمة مهامه
-2. **TaskCreate** — تحديد المهام للفريق
-3. **Agent** (مع `team_name` + `name`) — توليد أعضاء ينضمون إلى الفريق
-4. **TaskUpdate** — تعيين المهام للأعضاء عبر `owner`
-5. يعمل الأعضاء على المهام ويتواصلون عبر **SendMessage**
-6. إيقاف تشغيل الأعضاء عند الانتهاء، ثم **TeamDelete** لتنظيف الموارد
-
-## الأدوات ذات الصلة
-
-| الأداة | الغرض |
-|--------|--------|
-| `TeamDelete` | حذف الفريق ومجلدات المهام |
-| `SendMessage` | التواصل بين الـ agent داخل الفريق |
-| `TaskCreate` / `TaskUpdate` / `TaskList` / `TaskGet` | إدارة قائمة المهام المشتركة |
-| `Agent` | توليد أعضاء ينضمون إلى الفريق |

package/concepts/ar/Tool-TeamDelete.md

@@ -1,30 +0,0 @@
-# TeamDelete
-
-## التعريف
-
-يحذف فريقاً ومجلدات المهام المرتبطة به عند اكتمال عمل التعاون متعدد الـ agent. يُعدّ هذا الأداة المقابلة لـ TeamCreate في مرحلة التنظيف.
-
-## السلوك
-
-- يحذف مجلد الفريق: `~/.claude/teams/{team-name}/`
-- يحذف مجلد المهام: `~/.claude/tasks/{team-name}/`
-- يمسح سياق الفريق من الجلسة الحالية
-
-**مهم**: سيفشل TeamDelete إذا كان الفريق لا يزال يضم أعضاء نشطين. يجب إيقاف تشغيل الأعضاء أولاً بشكل سلس عبر طلبات إيقاف التشغيل في SendMessage.
-
-## الاستخدام النموذجي
-
-يُستدعى TeamDelete في نهاية سير عمل الفريق:
-
-1. اكتمال جميع المهام
-2. إيقاف تشغيل الأعضاء عبر `SendMessage` مع `shutdown_request`
-3. **TeamDelete** يحذف مجلدات الفريق والمهام
-
-## الأدوات ذات الصلة
-
-| الأداة | الغرض |
-|--------|--------|
-| `TeamCreate` | إنشاء فريق جديد وقائمة مهامه |
-| `SendMessage` | التواصل مع الأعضاء / إرسال طلبات إيقاف التشغيل |
-| `TaskCreate` / `TaskUpdate` / `TaskList` / `TaskGet` | إدارة قائمة المهام المشتركة |
-| `Agent` | توليد أعضاء ينضمون إلى الفريق |

package/concepts/ar/Tool-WebFetch.md

@@ -1,55 +0,0 @@
-# WebFetch
-
-## التعريف
-
-جلب محتوى صفحة ويب من عنوان URL محدد، وتحويل HTML إلى markdown، ومعالجة المحتوى باستخدام نموذج ذكاء اصطناعي وفقاً للـ prompt.
-
-## المعاملات
-
-| المعامل | النوع | مطلوب | الوصف |
-|---------|-------|-------|-------|
-| `url` | string (URI) | نعم | عنوان URL الكامل المراد جلبه |
-| `prompt` | string | نعم | وصف المعلومات المراد استخلاصها من الصفحة |
-
-## سيناريوهات الاستخدام
-
-**مناسب للاستخدام:**
-- الحصول على محتوى صفحات الويب العامة
-- الاطلاع على التوثيق عبر الإنترنت
-- استخلاص معلومات محددة من صفحات الويب
-
-**غير مناسب للاستخدام:**
-- عناوين URL التي تتطلب مصادقة (Google Docs، Confluence، Jira، GitHub إلخ) — يجب البحث أولاً عن أداة MCP مخصصة
-- عناوين GitHub URL — يُفضل استخدام `gh` CLI
-
-## ملاحظات
-
-- يجب أن يكون URL كاملاً وصالحاً
-- يتم ترقية HTTP تلقائياً إلى HTTPS
-- قد يتم تلخيص النتائج عندما يكون المحتوى كبيراً جداً
-- يتضمن ذاكرة مؤقتة ذاتية التنظيف مدتها 15 دقيقة
-- عند إعادة توجيه URL إلى مضيف مختلف، تُرجع الأداة عنوان URL المُعاد توجيهه ويجب إعادة الطلب بالعنوان الجديد
-- إذا كانت أداة web fetch مقدمة من MCP متاحة، يُفضل استخدامها
-
-## النص الأصلي
-
-<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/ar/Tool-WebSearch.md

@@ -1,58 +0,0 @@
-# WebSearch
-
-## التعريف
-
-تنفيذ استعلامات محرك البحث، وإرجاع نتائج البحث للحصول على أحدث المعلومات.
-
-## المعاملات
-
-| المعامل | النوع | مطلوب | الوصف |
-|---------|-------|-------|-------|
-| `query` | string | نعم | استعلام البحث (حرفان على الأقل) |
-| `allowed_domains` | string[] | لا | تضمين نتائج من هذه النطاقات فقط |
-| `blocked_domains` | string[] | لا | استبعاد نتائج من هذه النطاقات |
-
-## سيناريوهات الاستخدام
-
-**مناسب للاستخدام:**
-- الحصول على أحدث المعلومات التي تتجاوز تاريخ قطع معرفة النموذج
-- البحث عن الأحداث الجارية وأحدث البيانات
-- البحث عن أحدث التوثيق التقني
-
-## ملاحظات
-
-- تُرجع نتائج البحث بتنسيق روابط markdown
-- بعد الاستخدام يجب إضافة قسم "Sources:" في نهاية الاستجابة مع قائمة عناوين URL ذات الصلة
-- يدعم تصفية النطاقات (تضمين/استبعاد)
-- يجب استخدام السنة الحالية في استعلامات البحث
-- متاح فقط في الولايات المتحدة
-
-## النص الأصلي
-
-<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/ar/Tool-Write.md

@@ -1,39 +0,0 @@
-# Write
-
-## التعريف
-
-كتابة المحتوى إلى نظام الملفات المحلي. إذا كان الملف موجوداً بالفعل فسيتم الكتابة فوقه.
-
-## المعاملات
-
-| المعامل | النوع | مطلوب | الوصف |
-|---------|-------|-------|-------|
-| `file_path` | string | نعم | المسار المطلق للملف (يجب أن يكون مسار مطلق) |
-| `content` | string | نعم | المحتوى المراد كتابته |
-
-## سيناريوهات الاستخدام
-
-**مناسب للاستخدام:**
-- إنشاء ملفات جديدة
-- عند الحاجة لإعادة كتابة محتوى الملف بالكامل
-
-**غير مناسب للاستخدام:**
-- تعديل محتوى جزئي في الملف — يجب استخدام Edit
-- لا ينبغي إنشاء ملفات توثيق (*.md) أو README بشكل استباقي، إلا إذا طلب المستخدم ذلك صراحة
-
-## ملاحظات
-
-- إذا كان الملف الهدف موجوداً بالفعل، يجب قراءته أولاً عبر Read وإلا سيفشل
-- يكتب فوق كامل محتوى الملف الموجود
-- يُفضل استخدام Edit لتحرير الملفات الموجودة، Write فقط لإنشاء ملفات جديدة أو إعادة الكتابة الكاملة
-
-## النص الأصلي
-
-<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/ar/Tool-executeCode.md

@@ -1,41 +0,0 @@
-# executeCode (mcp__ide__executeCode)
-
-## التعريف
-
-تنفيذ كود Python في Jupyter kernel الخاص بملف notebook الحالي.
-
-## المعاملات
-
-| المعامل | النوع | مطلوب | الوصف |
-|---------|-------|-------|-------|
-| `code` | string | نعم | كود Python المراد تنفيذه |
-
-## سيناريوهات الاستخدام
-
-**مناسب للاستخدام:**
-- تنفيذ الكود في بيئة Jupyter notebook
-- اختبار مقتطفات الكود
-- تحليل البيانات والحسابات
-
-**غير مناسب للاستخدام:**
-- تنفيذ الكود خارج بيئة Jupyter — يجب استخدام Bash
-- تعديل الملفات — يجب استخدام Edit أو Write
-
-## ملاحظات
-
-- هذه أداة MCP (Model Context Protocol)، مقدمة من تكامل IDE
-- يُنفذ الكود في Jupyter kernel الحالي، والحالة تستمر بين الاستدعاءات
-- ما لم يطلب المستخدم صراحة، يجب تجنب تعريف المتغيرات أو تعديل حالة kernel
-- تُفقد الحالة بعد إعادة تشغيل kernel
-
-## النص الأصلي
-
-<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/ar/Tool-getDiagnostics.md

@@ -1,32 +0,0 @@
-# getDiagnostics (mcp__ide__getDiagnostics)
-
-## التعريف
-
-الحصول على معلومات التشخيص اللغوي من VS Code، بما في ذلك أخطاء الصياغة وأخطاء الأنواع وتحذيرات lint وغيرها.
-
-## المعاملات
-
-| المعامل | النوع | مطلوب | الوصف |
-|---------|-------|-------|-------|
-| `uri` | string | لا | عنوان URI للملف. إذا لم يُحدد يتم الحصول على معلومات التشخيص لجميع الملفات |
-
-## سيناريوهات الاستخدام
-
-**مناسب للاستخدام:**
-- فحص مشاكل الصياغة والأنواع وlint وغيرها من المشاكل الدلالية في الكود
-- التحقق بعد تحرير الكود من عدم إدخال أخطاء جديدة
-- بديل لأوامر Bash لفحص جودة الكود
-
-**غير مناسب للاستخدام:**
-- تشغيل الاختبارات — يجب استخدام Bash
-- فحص أخطاء وقت التشغيل — يجب استخدام Bash لتنفيذ الكود
-
-## ملاحظات
-
-- هذه أداة MCP (Model Context Protocol)، مقدمة من تكامل IDE
-- متاحة فقط في بيئة VS Code / IDE
-- يُفضل استخدام هذه الأداة بدلاً من أوامر Bash لفحص مشاكل الكود
-
-## النص الأصلي
-
-<textarea readonly>Get language diagnostics from VS Code</textarea>

package/concepts/ar/Tools.md

@@ -1,67 +0,0 @@
-# نظرة عامة على أدوات Claude Code
-
-يوفر Claude Code مجموعة من الأدوات المدمجة للنموذج عبر آلية tool_use في Anthropic API. تحتوي مصفوفة `tools` في كل طلب MainAgent على تعريفات JSON Schema الكاملة لهذه الأدوات، ويستدعيها النموذج في الاستجابة عبر كتل محتوى `tool_use`.
-
-فيما يلي فهرس مصنف لجميع الأدوات.
-
-## نظام الوكلاء
-
-| الأداة | الغرض |
-|--------|--------|
-| [Task](Tool-Task.md) | بدء وكيل فرعي (SubAgent) لمعالجة المهام المعقدة متعددة الخطوات |
-| [TaskOutput](Tool-TaskOutput.md) | الحصول على مخرجات المهام الخلفية |
-| [TaskStop](Tool-TaskStop.md) | إيقاف مهمة خلفية قيد التشغيل |
-| [TaskCreate](Tool-TaskCreate.md) | إنشاء عنصر في قائمة المهام المنظمة |
-| [TaskGet](Tool-TaskGet.md) | الحصول على تفاصيل المهمة |
-| [TaskUpdate](Tool-TaskUpdate.md) | تحديث حالة المهمة والتبعيات وغيرها |
-| [TaskList](Tool-TaskList.md) | عرض جميع المهام |
-
-## عمليات الملفات
-
-| الأداة | الغرض |
-|--------|--------|
-| [Read](Tool-Read.md) | قراءة محتوى الملفات (يدعم النصوص والصور وPDF وJupyter notebook) |
-| [Edit](Tool-Edit.md) | تحرير الملفات عبر استبدال نصي دقيق |
-| [Write](Tool-Write.md) | كتابة أو الكتابة فوق الملفات |
-| [NotebookEdit](Tool-NotebookEdit.md) | تحرير خلايا Jupyter notebook |
-
-## البحث
-
-| الأداة | الغرض |
-|--------|--------|
-| [Glob](Tool-Glob.md) | البحث عن الملفات بمطابقة أنماط أسماء الملفات |
-| [Grep](Tool-Grep.md) | البحث في محتوى الملفات باستخدام ripgrep |
-
-## الطرفية
-
-| الأداة | الغرض |
-|--------|--------|
-| [Bash](Tool-Bash.md) | تنفيذ أوامر shell |
-
-## الويب
-
-| الأداة | الغرض |
-|--------|--------|
-| [WebFetch](Tool-WebFetch.md) | جلب محتوى صفحات الويب ومعالجته بالذكاء الاصطناعي |
-| [WebSearch](Tool-WebSearch.md) | استعلامات محرك البحث |
-
-## التخطيط والتفاعل
-
-| الأداة | الغرض |
-|--------|--------|
-| [EnterPlanMode](Tool-EnterPlanMode.md) | الدخول في وضع التخطيط لتصميم خطة التنفيذ |
-| [ExitPlanMode](Tool-ExitPlanMode.md) | الخروج من وضع التخطيط وتقديم الخطة لموافقة المستخدم |
-| [AskUserQuestion](Tool-AskUserQuestion.md) | طرح أسئلة على المستخدم للتوضيح أو اتخاذ القرارات |
-
-## الإضافات
-
-| الأداة | الغرض |
-|--------|--------|
-| [Skill](Tool-Skill.md) | تنفيذ المهارات (slash command) |
-
-## تكامل IDE
-
-| الأداة | الغرض |
-|--------|--------|
-| [getDiagnostics](Tool-getDiagnostics.md) | الحصول على معلومات التشخيص اللغوي من VS Code |
-| [executeCode](Tool-executeCode.md) | تنفيذ الكود في Jupyter kernel |

package/concepts/da/CacheRebuild.md

@@ -1,36 +0,0 @@
-# Cache Rebuild (cache-genopbygning)
-
-## Baggrund
-
-Anthropics prompt caching-mekanisme sammenkæder system → tools → messages (til cache breakpoint) fra requesten i rækkefølge som cache-nøgle. Når cache-nøglen er identisk med den forrige request, returnerer API'en `cache_read_input_tokens` (cache hit); når cache-nøglen ændres, genskaber API'en cachen og returnerer et stort antal `cache_creation_input_tokens`, dvs. cache-genopbygning.
-
-Cache-genopbygning medfører ekstra token-omkostninger (prisen for cache creation er højere end cache read), så det har direkte værdi for omkostningsoptimering at identificere årsagen til genopbygningen.
-
-## Klassificering af årsager til cache-genopbygning
-
-cc-viewer sammenligner body fra to på hinanden følgende MainAgent-requests for præcist at bestemme årsagen til cache-genopbygningen:
-
-| reason | Betydning | Bestemmelsesmetode |
-|--------|------|----------|
-| `ttl` | Cache udløbet | Der er gået mere end 5 minutter siden sidste MainAgent-request |
-| `system_change` | System prompt ændret | `JSON.stringify(prev.system) !== JSON.stringify(curr.system)` |
-| `tools_change` | Værktøjsdefinitioner ændret | `JSON.stringify(prev.tools) !== JSON.stringify(curr.tools)` |
-| `model_change` | Model skiftet | `prev.model !== curr.model` |
-| `msg_truncated` | Beskedstakken afkortet | Antallet af beskeder i den aktuelle request er mindre end i den forrige, normalt udløst af afkortning pga. kontekstvindue-overflow |
-| `msg_modified` | Historiske beskeder ændret | Præfiks-beskedernes indhold er inkonsistent (ved normal tilføjelse bør præfikset være identisk) |
-| `key_change` | Ukendt nøgleændring | Fallback når ingen af ovenstående betingelser matcher |
-
-## Bestemmelsesprioritering
-
-1. Først kontrolleres tidsintervallet — over 5 minutter bestemmes direkte som `ttl`, uden body-sammenligning
-2. Derefter kontrolleres i rækkefølge model, system, tools, messages
-3. En request kan matche flere årsager samtidigt (f.eks. modelskift + system prompt-ændring); i så fald indeholder `reasons`-arrayet alle matchende elementer, og tooltip'en viser dem på separate linjer
-
-## Almindelige scenarier
-
-- **`ttl`**: brugeren pauserede i mere end 5 minutter og fortsatte derefter, cachen udløb naturligt
-- **`system_change`**: Claude Code opdaterede system prompten (f.eks. indlæsning af ny CLAUDE.md, ændring af project instructions)
-- **`tools_change`**: tilslutning/frakobling af MCP-server medførte ændring af listen over tilgængelige værktøjer
-- **`model_change`**: brugeren skiftede model via `/model`-kommandoen
-- **`msg_truncated`**: en for lang samtale udløste kontekstvindue-styring, Claude Code afkortede tidlige beskeder
-- **`msg_modified`**: Claude Code redigerede historiske beskeder (f.eks. `/compact` erstattede originale beskeder med et komprimeret resumé)

package/concepts/da/KVCacheContent.md

@@ -1,49 +0,0 @@
-# KV-Cache cacheindhold
-
-## Hvad er Prompt Caching?
-
-Når du samtaler med Claude, sender hver API-anmodning den komplette samtalekontekst (system prompt + værktøjsdefinitioner + beskedhistorik). Anthropics prompt caching-mekanisme cacher allerede beregnet præfiksindhold på serversiden, og hvis præfikset er det samme ved efterfølgende anmodninger, genbruges cacheresultatet direkte, hvilket springer gentagne beregninger over og reducerer latens og omkostninger betydeligt.
-
-I cc-viewer omtales denne mekanisme som "KV-Cache", der svarer til prompt caching på Anthropic API-niveau — ikke key-value cachen i transformerens opmærksomhedslag internt i LLM'en.
-
-## Hvordan caching fungerer
-
-Anthropics prompt caching sammenkæder cachenøgler i en fast rækkefølge:
-
-```
-Tools → System Prompt → Messages (til cache breakpoint)
-```
-
-Så længe dette præfiks er helt identisk med en hvilken som helst anmodning inden for TTL-vinduet, rammer API'en cachen (returnerer `cache_read_input_tokens`) i stedet for at genberegne (`cache_creation_input_tokens`).
-
-> **Claude Code er ikke stærkt afhængig af `cache_control`-attributten — serveren fjerner nogle af disse attributter, men kan stadig oprette cache fint, så fraværet af `cache_control`-attributten betyder ikke, at indholdet ikke er cachet**
->
-> For specialklienter som Claude Code er Anthropics server ikke fuldstændig afhængig af `cache_control`-attributten i anmodningen til at bestemme cache-adfærd. Serveren udfører automatisk cache-strategier for specifikke felter (som system prompt og værktøjsdefinitioner), selv når anmodningen ikke eksplicit indeholder `cache_control`-markører. Derfor behøver du ikke undre dig, når du ikke ser denne attribut i anmodningens body — serveren har allerede udført cache-operationen bag kulisserne, den har bare ikke eksponeret denne information for klienten. Dette er en stiltiende aftale mellem Claude Code og Anthropic API.
-
-## Hvad er "aktuelt KV-Cache cacheindhold"?
-
-Det "aktuelle KV-Cache cacheindhold" vist i cc-viewer er indhold udtrukket fra den seneste MainAgent-anmodning, som befinder sig før cachegrænsen (cache breakpoint). Det omfatter specifikt:
-
-- **System Prompt**: Claude Codes systeminstruktioner, herunder kerne-agent-instruktioner, retningslinjer for værktøjsbrug, CLAUDE.md-projektinstruktioner, miljøinformation osv.
-- **Tools**: Listen over aktuelt tilgængelige værktøjsdefinitioner (såsom Read, Write, Bash, Agent, MCP-værktøjer osv.)
-- **Messages**: Den del af samtalehistorikken, der er cachet (normalt ældre beskeder, op til det sidste `cache_control`-mærke)
-
-## Hvorfor se cacheindholdet?
-
-1. **Forstå konteksten**: Vid hvad Claude i øjeblikket "husker", og hjælp dig med at vurdere, om dens adfærd matcher forventningerne
-2. **Omkostningsoptimering**: Cache-hit koster langt mindre end genberegning. At se cacheindholdet hjælper dig med at forstå, hvorfor visse anmodninger udløste cache-genopbygning (cache rebuild)
-3. **Fejlfinding af samtale**: Når Claudes svar ikke matcher forventningerne, kan kontrol af cacheindholdet bekræfte, om system prompt og beskedhistorik er korrekte
-4. **Overvågning af kontekstkvalitet**: Under fejlfinding, ændring af konfiguration eller justering af prompts giver KV-Cache-Text et centraliseret overblik, der hjælper dig med hurtigt at bekræfte, om kernekonteksten er forringet eller forurenet med uventet indhold — uden at skulle gennemgå rå beskeder én efter én
-
-## Flerlags cachestrategi
-
-KV-Cachen tilhørende Claude Code er ikke blot én enkelt cache. Serveren genererer separate cacher for Tools og System Prompt, uafhængigt af Messages-cacheen. Fordelen ved dette design er: når beskedstakken bliver forstyrret (f.eks. kontekstafkortning, beskedændringer) og kræver genopbygning, invaliderer det ikke samtidig Tools- og System Prompt-cacherne, hvilket undgår fuldstændig genberegning.
-
-Dette er en optimeringstrategi på serversiden — fordi Tools-definitioner og System Prompt er relativt stabile under normal brug og sjældent ændres, maksimerer separat caching af dem reduktionen af unødvendig genopbygningsomkostning. Så når du observerer cachen, vil du bemærke, at bortset fra Tools-genopbygning, som kræver fuldstændig genopfriskning af alle cacher, kan ødelæggelse af System Prompt og Messages stadig arve tilgængelige cacher.
-
-## Cache-livscyklus
-
-- **Oprettelse**: Ved første anmodning eller efter cache-udløb opretter API'en en ny cache (`cache_creation_input_tokens`)
-- **Hit**: Efterfølgende anmodninger med identisk præfiks genbruger cachen (`cache_read_input_tokens`)
-- **Udløb**: Cachen har en TTL (time-to-live) på 5 minutter og udløber automatisk derefter
-- **Genopbygning**: Når system prompt, værktøjsliste, model eller beskedindhold ændres, matcher cachenøglen ikke, hvilket udløser genopbygning af det tilsvarende niveau

package/concepts/da/Tool-Agent.md

@@ -1,125 +0,0 @@
-# Agent
-
-## Definition
-
-Starter en sub-agent (SubAgent) til selvstændigt at håndtere komplekse flertrinsopgaver. Sub-agenter er uafhængige underprocesser, hver med deres eget dedikerede værktøjssæt og kontekst. Agent er den omdøbte version af Task-værktøjet i nyere Claude Code-versioner.
-
-## Parametre
-
-| Parameter | Type | Påkrævet | Beskrivelse |
-|------|------|------|------|
-| `prompt` | string | Ja | Beskrivelse af opgaven sub-agenten skal udføre |
-| `description` | string | Ja | Kort resumé på 3-5 ord |
-| `subagent_type` | string | Ja | Sub-agent-type, bestemmer det tilgængelige værktøjssæt |
-| `model` | enum | Nej | Angiv model (sonnet / opus / haiku), standard arvet fra forælder |
-| `max_turns` | integer | Nej | Maksimalt antal agentiske ture |
-| `run_in_background` | boolean | Nej | Om den skal køre i baggrunden; baggrundsopgaver returnerer output_file-sti |
-| `resume` | string | Nej | Agent-ID der skal genoptages, fortsætter fra sidste udførelse. Nyttigt til at genoptage en tidligere sub-agent uden at miste kontekst |
-| `isolation` | enum | Nej | Isoleringstilstand, `worktree` opretter et midlertidigt git worktree |
-
-## Sub-agent-typer
-
-| Type | Formål | Tilgængelige værktøjer |
-|------|------|----------|
-| `Bash` | Kommandoudførelse, git-operationer | Bash |
-| `general-purpose` | Generelle flertrinsopgaver | Alle værktøjer |
-| `Explore` | Hurtig udforskning af kodebasen | Alle værktøjer undtagen Agent/Edit/Write/NotebookEdit/ExitPlanMode |
-| `Plan` | Design af implementeringsplan | Alle værktøjer undtagen Agent/Edit/Write/NotebookEdit/ExitPlanMode |
-| `claude-code-guide` | Q&A om Claude Code-brugsvejledning | Glob, Grep, Read, WebFetch, WebSearch |
-| `statusline-setup` | Konfiguration af statuslinje | Read, Edit |
-
-## Brugsscenarier
-
-**Egnet til:**
-- Komplekse opgaver der kræver selvstændig fuldførelse i flere trin
-- Udforskning af kodebasen og dybdegående research (brug Explore-type)
-- Parallelt arbejde der kræver isolerede miljøer
-- Langvarige opgaver der skal køre i baggrunden
-
-**Ikke egnet til:**
-- Læse en specifik filsti — brug direkte Read eller Glob
-- Søge i 2-3 kendte filer — brug direkte Read
-- Søge efter en specifik klassedefinition — brug direkte Glob
-
-## Bemærkninger
-
-- Ved fuldførelse returnerer sub-agenten en enkelt besked; dens resultat er ikke synligt for brugeren og skal videreformidles af hovedagenten
-- Man kan starte flere parallelle Agent-kald i en enkelt besked for at øge effektiviteten
-- Baggrundsopgaver overvåges via TaskOutput-værktøjet
-- Explore-typen er langsommere end direkte Glob/Grep-kald, brug den kun når simpel søgning ikke er tilstrækkelig
-- Brug `run_in_background: true` til langvarige opgaver der ikke kræver øjeblikkeligt resultat; brug forgrundstilstand (standard) når resultatet er nødvendigt før man fortsætter
-- `resume`-parameteren gør det muligt at fortsætte en tidligere startet sub-agent-session og bevare den akkumulerede kontekst
-
-## Originaltekst
-
-<textarea readonly>Launch a new agent to handle complex, multi-step tasks autonomously.
-
-The Agent tool launches specialized agents (subprocesses) that autonomously handle complex tasks. Each agent type has specific capabilities and tools available to it.
-
-Available agent types and the tools they have access to:
-- general-purpose: General-purpose agent for researching complex questions, searching for code, and executing multi-step tasks. When you are searching for a keyword or file and are not confident that you will find the right match in the first few tries use this agent to perform the search for you. (Tools: *)
-- statusline-setup: Use this agent to configure the user's Claude Code status line setting. (Tools: Read, Edit)
-- Explore: Fast agent specialized for exploring codebases. Use this when you need to quickly find files by patterns (eg. "src/components/**/*.tsx"), search code for keywords (eg. "API endpoints"), or answer questions about the codebase (eg. "how do API endpoints work?"). When calling this agent, specify the desired thoroughness level: "quick" for basic searches, "medium" for moderate exploration, or "very thorough" for comprehensive analysis across multiple locations and naming conventions. (Tools: All tools except Agent, ExitPlanMode, Edit, Write, NotebookEdit)
-- Plan: Software architect agent for designing implementation plans. Use this when you need to plan the implementation strategy for a task. Returns step-by-step plans, identifies critical files, and considers architectural trade-offs. (Tools: All tools except Agent, ExitPlanMode, Edit, Write, NotebookEdit)
-- claude-code-guide: Use this agent when the user asks questions ("Can Claude...", "Does Claude...", "How do I...") about: (1) Claude Code (the CLI tool) - features, hooks, slash commands, MCP servers, settings, IDE integrations, keyboard shortcuts; (2) Claude Agent SDK - building custom agents; (3) Claude API (formerly Anthropic API) - API usage, tool use, Anthropic SDK usage. **IMPORTANT:** Before spawning a new agent, check if there is already a running or recently completed claude-code-guide agent that you can resume using the "resume" parameter. (Tools: Glob, Grep, Read, WebFetch, WebSearch)
-
-When using the Agent tool, you must specify a subagent_type parameter to select which agent type to use.
-
-When NOT to use the Agent tool:
-- If you want to read a specific file path, use the Read or Glob tool instead of the Agent tool, to find the match more quickly
-- If you are searching for a specific class definition like "class Foo", use the Glob tool instead, to find the match more quickly
-- If you are searching for code within a specific file or set of 2-3 files, use the Read tool instead of the Agent tool, to find the match more quickly
-- Other tasks that are not related to the agent descriptions above
-
-Usage notes:
-- Always include a short description (3-5 words) summarizing what the agent will do
-- Launch multiple agents concurrently whenever possible, to maximize performance; to do that, use a single message with multiple tool uses
-- When the agent is done, it will return a single message back to you. The result returned by the agent is not visible to the user. To show the user the result, you should send a text message back to the user with a concise summary of the result.
-- You can optionally run agents in the background using the run_in_background parameter. When an agent runs in the background, you will be automatically notified when it completes — do NOT sleep, poll, or proactively check on its progress. Continue with other work or respond to the user instead.
-- **Foreground vs background**: Use foreground (default) when you need the agent's results before you can proceed — e.g., research agents whose findings inform your next steps. Use background when you have genuinely independent work to do in parallel.
-- Agents can be resumed using the `resume` parameter by passing the agent ID from a previous invocation. When resumed, the agent continues with its full previous context preserved. When NOT resuming, each invocation starts fresh and you should provide a detailed task description with all necessary context.
-- When the agent is done, it will return a single message back to you along with its agent ID. You can use this ID to resume the agent later if needed for follow-up work.
-- Provide clear, detailed prompts so the agent can work autonomously and return exactly the information you need.
-- Agents with "access to current context" can see the full conversation history before the tool call. When using these agents, you can write concise prompts that reference earlier context (e.g., "investigate the error discussed above") instead of repeating information. The agent will receive all prior messages and understand the context.
-- The agent's outputs should generally be trusted
-- Clearly tell the agent whether you expect it to write code or just to do research (search, file reads, web fetches, etc.), since it is not aware of the user's intent
-- If the agent description mentions that it should be used proactively, then you should try your best to use it without the user having to ask for it first. Use your judgement.
-- If the user specifies that they want you to run agents "in parallel", you MUST send a single message with multiple Agent tool use content blocks. For example, if you need to launch both a build-validator agent and a test-runner agent in parallel, send a single message with both tool calls.
-- You can optionally set `isolation: "worktree"` to run the agent in a temporary git worktree, giving it an isolated copy of the repository. The worktree is automatically cleaned up if the agent makes no changes; if changes are made, the worktree path and branch are returned in the result.
-
-Example usage:
-
-<example_agent_descriptions>
-"test-runner": use this agent after you are done writing code to run tests
-"greeting-responder": use this agent to respond to user greetings with a friendly joke
-</example_agent_descriptions>
-
-<example>
-user: "Please write a function that checks if a number is prime"
-assistant: Sure let me write a function that checks if a number is prime
-assistant: First let me use the Write tool to write a function that checks if a number is prime
-assistant: I'm going to use the Write tool to write the following code:
-<code>
-function isPrime(n) {
-  if (n <= 1) return false
-  for (let i = 2; i * i <= n; i++) {
-    if (n % i === 0) return false
-  }
-  return true
-}
-</code>
-<commentary>
-Since a significant piece of code was written and the task was completed, now use the test-runner agent to run the tests
-</commentary>
-assistant: Now let me use the test-runner agent to run the tests
-assistant: Uses the Agent tool to launch the test-runner agent
-</example>
-
-<example>
-user: "Hello"
-<commentary>
-Since the user is greeting, use the greeting-responder agent to respond with a friendly joke
-</commentary>
-assistant: "I'm going to use the Agent tool to launch the greeting-responder agent"
-</example>
-</textarea>