cc-viewer 1.7.22 → 1.8.0

package/concepts/it/Tool-PushNotification.md

@@ -14,6 +14,12 @@ Invia una notifica desktop dalla sessione corrente di Claude Code. Se Remote Con
 
 Non inviare notifiche per aggiornamenti di avanzamento di routine durante un'attività, né per confermare di aver risposto a qualcosa che l'utente ha appena chiesto e sta chiaramente attendendo. Non notificare al termine di un'attività breve — se l'utente l'ha appena inviata e sta aspettando, la notifica non aggiunge valore e riduce la fiducia nelle notifiche future. Propendi fortemente per non inviare.
 
+## Attivazione
+
+- Disattivato per default (feature flag lato server).
+- La consegna passa attraverso infrastruttura ospitata da Anthropic — non disponibile su Amazon Bedrock, Claude Platform on AWS, Google Cloud o Microsoft Foundry.
+- Il push sul telefono richiede inoltre un client Remote Control connesso.
+
 ## Parametri
 
 - `message` (stringa, obbligatorio): il corpo della notifica. Mantenerlo sotto i 200 caratteri; i sistemi operativi mobili troncano le stringhe più lunghe. Inizia con ciò su cui l'utente agirebbe: "build failed: 2 auth tests" è più utile di "task complete".

package/concepts/it/Tool-REPL.md

@@ -0,0 +1,47 @@
+# REPL
+
+Esegue JavaScript in un contesto vm Node.js persistente all'interno della sessione. L'`await` di primo livello è supportato, e le variabili/funzioni definite in una chiamata restano disponibili nelle chiamate successive.
+
+## Quando usare
+
+- Calcoli rapidi, trasformazione di dati o manipolazione di JSON che risultano più semplici in codice che in one-liner di shell.
+- Scripting multi-passo in cui lo stato intermedio deve persistere tra le chiamate (contatori, risultati accumulati).
+- Sondare interattivamente il comportamento di un'API o di una libreria prima di scriverlo in un file.
+
+## Attivazione
+
+- Disattivato per default — imposta `CLAUDE_CODE_REPL=true` per abilitarlo.
+- Nelle sessioni terminale (`cli`) e claude.ai (`remote`), un feature flag lato server può abilitarlo.
+- Quando è disattivato, REPL è nascosto dall'elenco degli strumenti del modello. Quando è attivo, `Read`, `Glob`, `Grep`, `Bash`, `PowerShell` e `NotebookEdit` sono sostituiti dalle scorciatoie REPL.
+
+## Parametri
+
+- `code` (string, obbligatorio): Codice JavaScript da eseguire. Supporta l'await di primo livello. Lo stato persiste tra le chiamate.
+- `description` (string, opzionale): Descrizione chiara e concisa di cosa fa questo script in forma attiva (5–10 parole), ad esempio "Trace upgrade message to its GrowthBook flag".
+- `timeout` (number, opzionale): Timeout in millisecondi. Default: 30000; massimo 600000.
+
+## Esempi
+
+### Esempio 1: Calcolare e riusare lo stato
+
+```
+REPL(code="const counts = new Map(); ['a','b','a'].forEach(k => counts.set(k, (counts.get(k)||0)+1)); counts.get('a')")
+```
+
+Restituisce `2`; `counts` resta definito per le chiamate REPL successive nella stessa sessione.
+
+### Esempio 2: Await di primo livello con un timeout più lungo
+
+```
+REPL(
+  code="const res = await fetch('https://example.com/api'); await res.json()",
+  description="Fetch example API and parse JSON",
+  timeout=60000
+)
+```
+
+## Note
+
+- Lo stato è per-sessione: riavviare la sessione azzera tutte le definizioni.
+- Questo è un ambiente JavaScript (Node) — usa Bash per comandi shell, lavoro intensivo sul filesystem o runtime non-JS.
+- Il codice a lunga esecuzione dovrebbe impostare un `timeout` esplicito; il default di 30s termina qualsiasi cosa più lenta.

package/concepts/it/Tool-ReadMcpResource.md

@@ -0,0 +1,32 @@
+# ReadMcpResource
+
+Legge una singola risorsa esposta da un server MCP (Model Context Protocol) connesso, indirizzata tramite la sua URI.
+
+## Quando usare
+
+- Un server MCP pubblicizza una risorsa (file, record, documento) il cui contenuto ti serve nel contesto.
+- Hai una URI di risorsa concreta — da `ListMcpResources`, dalla documentazione del server, o da un risultato di tool precedente.
+
+## Attivazione
+
+- Sempre abilitato, ma non esposto all'elenco degli strumenti del modello — pensato per l'uso thin-client / sidecar.
+
+## Parametri
+
+- `server` (string, obbligatorio): Il nome del server MCP.
+- `uri` (string, obbligatorio): La URI della risorsa da leggere.
+
+## Esempi
+
+### Esempio 1: Leggere una risorsa del server tramite URI
+
+```
+ReadMcpResource(server="github", uri="file:///repo/docs/architecture.md")
+```
+
+Restituisce il contenuto della risorsa come fornito dal server MCP `github`.
+
+## Note
+
+- Usa prima `ListMcpResources` se non sai quali risorse espone un server; usa `ReadMcpResourceDir` per elenchi in stile directory.
+- Lo schema della URI è specifico del server (`file://`, `https://`, schemi personalizzati) — controlla cosa pubblicizza il server di destinazione.

package/concepts/it/Tool-ReadMcpResourceDir.md

@@ -0,0 +1,32 @@
+# ReadMcpResourceDir
+
+Elenca le voci di una risorsa in stile directory esposta da un server MCP connesso, indirizzata tramite la sua URI.
+
+## Quando usare
+
+- Un server MCP organizza le risorse gerarchicamente e devi enumerare un livello di quella gerarchia.
+- Vuoi navigare prima di leggere singole risorse con `ReadMcpResource`.
+
+## Attivazione
+
+- Sempre abilitato, ma non esposto all'elenco degli strumenti del modello — pensato per l'uso thin-client / sidecar.
+
+## Parametri
+
+- `server` (string, obbligatorio): Il nome del server MCP.
+- `uri` (string, obbligatorio): La URI della risorsa directory da elencare.
+
+## Esempi
+
+### Esempio 1: Elencare una directory di risorse
+
+```
+ReadMcpResourceDir(server="filesystem", uri="file:///project/src/")
+```
+
+Restituisce le voci figlie che il server espone sotto quella URI di directory.
+
+## Note
+
+- Solo i server che modellano le proprie risorse come directory lo supportano; i server piatti restituiranno un errore o un elenco vuoto — ripiega su `ListMcpResources`.
+- Combina con `ReadMcpResource` per approfondire le voci che sembrano rilevanti.

package/concepts/it/Tool-ReadNotifications.md

@@ -0,0 +1,27 @@
+# ReadNotifications
+
+Legge le notifiche in coda per l'assistente nella sessione corrente — attività GitHub sulle PR sottoscritte (`github_webhook`), attivazioni di trigger pianificati (`trigger_fire`) e messaggi in arrivo da altre sessioni Claude (`mcp_send_message`).
+
+## Quando usare
+
+- Sei stato notificato che è successo qualcosa — una PR sottoscritta è stata aggiornata, un trigger pianificato si è attivato, un'altra sessione ti ha scritto un messaggio — e hai bisogno del payload effettivo.
+- Svuotare un arretrato: i lotti grandi vengono restituiti in parti, quindi continua a chiamare finché il risultato non riporta 0 `remaining`.
+
+## Parametri
+
+Questo tool non accetta parametri.
+
+## Esempi
+
+### Esempio 1: Svuotare le notifiche in attesa
+
+```
+ReadNotifications()
+```
+
+Restituisce le notifiche in coda partendo dalle più vecchie. Il risultato include un conteggio `remaining` delle notifiche ancora in coda dopo questo svuotamento — chiama di nuovo il tool per leggerle.
+
+## Note
+
+- Gli svuotamenti hanno un budget di dimensione: una chiamata successiva restituisce il resto della STESSA coda (più qualsiasi cosa arrivata nel frattempo), non solo i nuovi arrivi. Itera finché `remaining` è 0.
+- Le notifiche provengono dai webhook GitHub sulle PR sottoscritte, dai trigger pianificati e dai messaggi di altre sessioni Claude; non c'è alcun parametro di filtro nella versione corrente.

package/concepts/it/Tool-RemoteTrigger.md

@@ -10,6 +10,13 @@ Chiama l'API dei trigger remoti di claude.ai per gestire l'esecuzione di attivit
 - Elencare o verificare tutti i trigger correnti per esaminarne la configurazione e lo stato
 - Aggiornare le impostazioni di un trigger, come la pianificazione, il payload o la descrizione, senza doverlo ricreare
 
+## Attivazione
+
+- Richiede un piano claude.ai Pro, Max, Team o Enterprise.
+- Non disponibile su Amazon Bedrock, Claude Platform on AWS, Google Cloud o Microsoft Foundry.
+- Richiede feature flag lato server e le impostazioni di policy `allow_remote_sessions` / `allow_routines`.
+- Non per le sessioni remote stesse.
+
 ## Parametri
 
 - `action` (string, obbligatorio): l'operazione da eseguire — uno tra `list`, `get`, `create`, `update` o `run`

package/concepts/it/Tool-ScheduleWakeup.md

@@ -10,6 +10,11 @@ Pianifica quando riprendere il lavoro in modalità dinamica `/loop`. Lo strument
 - Per eseguire un loop autonomo senza prompt dell'utente — passare il sentinel letterale `<<autonomous-loop-dynamic>>` come `prompt`
 - Per interrogare un processo il cui stato sta per cambiare (usare un breve ritardo per mantenere la cache calda)
 
+## Attivazione
+
+- Non disponibile su Amazon Bedrock, Claude Platform on AWS, Google Cloud Agent Platform o Microsoft Foundry.
+- Disattivato anche quando il recupero dei feature flag è disabilitato (variabili d'ambiente di telemetria/traffico).
+
 ## Parametri
 
 - `delaySeconds` (numero, obbligatorio): Secondi fino alla ripresa. Il runtime limita automaticamente il valore a `[60, 3600]`, quindi non è necessario limitarlo manualmente.

package/concepts/it/Tool-SearchMcpRegistry.md

@@ -0,0 +1,31 @@
+# SearchMcpRegistry
+
+Cerca nel registry dei connector MCP per parola chiave per scoprire connector che potrebbero aiutare a completare il compito.
+
+## Quando usare
+
+- Il compito trarrebbe beneficio da un servizio esterno (un database, un issue tracker, un'API SaaS) e vuoi verificare se esiste un connector MCP per esso.
+- L'utente nomina un prodotto e chiede di connetterlo — cerca nel registry un connector corrispondente.
+
+## Attivazione
+
+- Disponibile solo nelle sessioni remote (claude.ai) sull'API first-party.
+
+## Parametri
+
+- `keywords` (array of strings, obbligatorio): Frasi chiave che descrivono l'intento dell'utente o un prodotto nominato. 1–8 elementi, ciascuno di 1–64 caratteri.
+
+## Esempi
+
+### Esempio 1: Trovare un connector per un prodotto nominato
+
+```
+SearchMcpRegistry(keywords=["linear", "issue tracker"])
+```
+
+Restituisce le voci del registry i cui connector corrispondono alle parole chiave. Risolvi i dettagli completi del connector con `SuggestConnectors`.
+
+## Note
+
+- In sola lettura e sicuro per la concorrenza; i risultati hanno una dimensione massima.
+- La ricerca non installa nulla — è pura scoperta.

package/concepts/it/Tool-SendFeedback.md

@@ -0,0 +1,38 @@
+# SendFeedback
+
+Invia feedback strutturato su Claude Code ad Anthropic — segnalazioni di bug, idee di funzionalità o capacità mancanti — senza lasciare la sessione.
+
+## Quando usare
+
+- L'utente chiede di segnalare un bug o inviare feedback su Claude Code stesso.
+- Incontri un chiaro difetto di prodotto (comando rotto, comportamento errato, crash) che merita di essere segnalato.
+- L'utente descrive una funzionalità che vorrebbe esistesse (un'idea o una capacità mancante).
+
+## Parametri
+
+- `type` (string, obbligatorio): Uno tra `bug`, `idea`, `missing_capability`.
+- `title` (string, obbligatorio): Riepilogo breve e specifico di una riga del problema.
+- `details` (string, obbligatorio): Elenco puntato etichettato, in ordine: **What happened:** (osservato vs. atteso, testo esatto dell'errore se breve); **What the user said:** (citato, oppure "User didn't comment; observed by the model."); **Repro:** (passi minimi); **Evidence:** (ID di richiesta, timestamp, percorsi, versioni — ometti se non ce ne sono); facoltativamente un **Cause:** finale solo se verificato in sessione. Da una a tre righe per punto; niente paragrafi narrativi, niente speculazioni, niente segreti.
+- `area` (string, opzionale): Tag breve che nomina la parte di Claude Code a cui si riferisce il feedback (ad esempio "hooks config", "/help", "file editing"). Lascia vuoto se non è chiaro.
+- `failure_mode` (string, opzionale): Per segnalazioni sul comportamento del modello, la modalità di fallimento più vicina (ad esempio `instruction_following`, `repetition_and_looping`, `context_and_memory`, `stopping_short`, oppure `other`). Ometti solo quando la segnalazione è un puro bug di prodotto/tool.
+- `task_category` (string, opzionale): Cosa stava facendo la sessione quando si è verificato il problema: `code_edit`, `debug`, `explain`, `plan`, `shell`, `search`, `review`, oppure `other`.
+
+## Esempi
+
+### Esempio 1: Segnalare un bug di prodotto
+
+```
+SendFeedback(
+  type="bug",
+  title="/export truncates the last message",
+  details="**What happened:** exported transcript is missing the final assistant message.\n**What the user said:** \"the last reply never shows up in the file\".\n**Repro:** run /export after any multi-turn session.\n**Evidence:** v2.1.233, macOS.",
+  area="/export",
+  task_category="other"
+)
+```
+
+## Note
+
+- Non includere mai segreti, token o dati privati dell'utente in `details`.
+- Cita le parole dell'utente quando disponibili; altrimenti dichiara che il modello ha osservato il problema.
+- Mantieni la segnalazione fattuale — la speculazione sulla causa radice appartiene a `**Cause:**` solo quando è verificata in sessione.

package/concepts/it/Tool-SendFile.md

@@ -0,0 +1,36 @@
+# SendFile
+
+Invia uno o più file a un'altra sessione di Claude Code — un peer elencato da `ListAgents`, oppure un indirizzo di sessione esplicito.
+
+## Quando usare
+
+- Una sessione peer ha bisogno di un file dalla tua directory di lavoro (un report, una patch, un fixture) per continuare il suo compito.
+- Stai coordinando lavoro tra sessioni e vuoi passare artefatti, non solo testo (usa `SendMessage` per il testo).
+
+## Attivazione
+
+- Il trasferimento di file tra sessioni deve essere disponibile nella sessione; quando non lo è, la validazione fallisce con "Cross-session file transfer is not available in this session."
+- Gated dalle stesse condizioni di messaggistica tra sessioni di `ListAgents` (feature flag lato server, disattivati per default).
+
+## Parametri
+
+- `to` (string, obbligatorio): Destinatario — un nome di sessione peer da `ListAgents`, oppure un indirizzo esplicito `uds:<socket>` / `bridge:<session id>`.
+- `files` (array of strings, obbligatorio): Percorsi di file (assoluti o relativi alla cwd) da inviare. Passa sempre un array, anche per un singolo file. 1–16 file, al massimo 30 MiB ciascuno.
+- `message` (string, opzionale): Breve messaggio consegnato insieme ai file.
+
+## Esempi
+
+### Esempio 1: Inviare un report a una sessione peer
+
+```
+SendFile(
+  to="teammate-a",
+  files=["./dist/report.html"],
+  message="The analysis you asked for"
+)
+```
+
+## Note
+
+- I trasferimenti verso macchine remote possono richiedere un'approvazione aggiuntiva.
+- Leggere il contenuto del file fa parte dell'invio — negato se la lettura dei file è disabilitata dalle regole di permesso.

package/concepts/it/Tool-SendMessage.md

@@ -10,6 +10,11 @@ Consegna un messaggio da un membro del team a un altro all'interno di un team at
 - Rispondere a un prompt di protocollo come una richiesta di shutdown o una richiesta di approvazione del piano dal team leader.
 - Chiudere il cerchio alla fine di un compito delegato così che il leader possa marcare l'elemento come completato.
 
+## Attivazione
+
+- Gated dalle stesse condizioni di messaggistica tra sessioni di `ListAgents` (feature flag lato server, disattivati per default).
+- I teammate richiedono inoltre l'abilitazione dei team di agenti sperimentali.
+
 ## Parametri
 
 - `to` (string, obbligatorio): Il `name` del teammate target come registrato nel team, oppure `*` per trasmettere a tutti i teammate contemporaneamente.

package/concepts/it/Tool-SendUserFile.md

@@ -0,0 +1,38 @@
+# SendUserFile
+
+Invia uno o più file all'utente — artefatti generati, screenshot, report — con controllo su come il client li presenta.
+
+## Quando usare
+
+- Hai prodotto un file di cui l'utente ha bisogno (un report, un'immagine, una pagina HTML) e vuoi farlo emergere, non solo menzionarne il percorso.
+- Rispondere con un allegato (`status="normal"`), oppure far emergere proattivamente qualcosa che l'utente non ha chiesto ma deve vedere ora (`status="proactive"`).
+
+## Attivazione
+
+- Disponibile solo quando un client Remote Control è connesso, o la sessione gira in un ambiente cloud gestito (ad esempio Claude Code sul web).
+- Non disponibile su Amazon Bedrock, Google Cloud o Microsoft Foundry.
+- Richiede che la sessione consenta l'invio di file (una capacità gated da impostazioni/feature); non offerta in brief mode.
+
+## Parametri
+
+- `files` (array of strings, obbligatorio): Percorsi di file (assoluti o relativi alla cwd) da inviare all'utente. Passa sempre un array, anche per un singolo file.
+- `caption` (string, opzionale): Breve didascalia per i file.
+- `status` (string, obbligatorio): `proactive` quando fai emergere un file che l'utente non ha chiesto e deve vedere ora — un artefatto generato, un report completato; `normal` quando rispondi a qualcosa che l'utente ha appena detto.
+- `display` (string, opzionale): `render` apre il file inline nel pannello laterale (HTML, SVG, Mermaid, immagini, PDF); `attach` mostra solo una scheda di download (deliverable che l'utente salverà e aprirà altrove). Ometti per lasciare decidere al client in base al tipo di file.
+
+## Esempi
+
+### Esempio 1: Consegnare un report generato
+
+```
+SendUserFile(
+  files=["./out/weekly-report.html"],
+  caption="Weekly usage report",
+  status="proactive",
+  display="render"
+)
+```
+
+## Note
+
+- Scegli `display="attach"` per file che l'utente salva e apre in un'altra app; `render` per qualsiasi cosa debba guardare immediatamente.

package/concepts/it/Tool-SendUserMessage.md

@@ -0,0 +1,38 @@
+# SendUserMessage
+
+Invia un messaggio all'utente — il canale di output visibile primario nelle sessioni in stile brief. Noto anche con il suo alias legacy `Brief`.
+
+## Quando usare
+
+- Rispondere a qualcosa che l'utente ha appena detto (`status="normal"`).
+- Far emergere proattivamente qualcosa che l'utente non ha chiesto e deve vedere ora — un compito che si completa mentre è assente, un blocco che hai incontrato, un aggiornamento di stato non richiesto (`status="proactive"`).
+
+## Attivazione
+
+- Nascosto per default nelle sessioni interattive; la maggior parte delle sessioni CLI interattive parla direttamente con l'utente.
+- Abilitato in brief mode o tramite feature flag lato server.
+
+## Parametri
+
+In brief mode:
+
+- `message` (string, obbligatorio): Il messaggio per l'utente. Supporta la formattazione markdown.
+- `attachments` (array, opzionale): Allegati mostrati insieme al messaggio. Ogni voce è o un percorso di file (assoluto o relativo alla cwd) per un file leggibile localmente, o un oggetto pre-risolto `{file_uuid, file_name, size, is_image}` ottenuto da un tool di dispositivo come `attach_file`.
+- `status` (string, obbligatorio): `proactive` per aggiornamenti non richiesti di cui l'utente ha bisogno ora; `normal` quando rispondi all'utente.
+
+Nelle build non-brief è disponibile solo `message`.
+
+## Esempi
+
+### Esempio 1: Avviso di completamento proattivo
+
+```
+SendUserMessage(
+  message="The migration finished — 42 files updated, tests green.",
+  status="proactive"
+)
+```
+
+## Note
+
+- Usa `proactive` con parsimonia — è pensato per cose che richiedono genuinamente l'attenzione dell'utente ora.

package/concepts/it/Tool-SuggestConnectors.md

@@ -0,0 +1,28 @@
+# SuggestConnectors
+
+Risolve i payload completi dei connector per i valori `directoryUuid` restituiti da `SearchMcpRegistry`, così che all'utente possano essere offerti connector concreti da abilitare.
+
+## Quando usare
+
+- Dopo che `SearchMcpRegistry` restituisce connector candidati, per recuperarne i dettagli completi per la presentazione.
+
+## Attivazione
+
+- Disponibile solo nelle sessioni remote (claude.ai) sull'API first-party.
+
+## Parametri
+
+- `uuids` (array of strings, obbligatorio): Valori `directoryUuid` o `server_id` da risolvere. 1–32 elementi, ciascuno di 1–64 caratteri.
+
+## Esempi
+
+### Esempio 1: Risolvere due risultati del registry
+
+```
+SuggestConnectors(uuids=["d290f1ee-6c54-4b01-90e6-d701748f0851", "a1b2c3d4-0000-4000-8000-abcdefabcdef"])
+```
+
+## Note
+
+- Non indovinare mai gli UUID — risolvi solo gli identificatori che sono tornati da `SearchMcpRegistry`.
+- Il tool non connette nulla di per sé; l'abilitazione di un connector avviene fuori banda.

package/concepts/it/Tool-SuggestPluginInstall.md

@@ -0,0 +1,39 @@
+# SuggestPluginInstall
+
+Mostra una scheda inline di installazione di plugin dai risultati di `SearchPlugins`, collegando i suggerimenti di plugin alla richiesta dell'utente.
+
+## Quando usare
+
+- Una ricerca di plugin ha fatto emergere plugin che corrispondono a ciò che l'utente sta cercando di fare, e vuoi offrirli per l'installazione.
+
+## Attivazione
+
+- Solo quando un client Remote Control è connesso, o la sessione gira in un ambiente cloud gestito.
+- Disabilitato nelle configurazioni enterprise HIPAA.
+- Non in brief mode.
+
+## Parametri
+
+- `contextLabel` (string, obbligatorio): Intestazione breve che collega il suggerimento alla richiesta dell'utente (massimo 128 caratteri).
+- `plugins` (array, obbligatorio): Plugin provenienti dai risultati di `SearchPlugins` — 1–16 voci, ciascuna con:
+  - `pluginId` (string, obbligatorio)
+  - `pluginName` (string, obbligatorio)
+  - `description` (string, obbligatorio)
+  - `skills` (array, opzionale): Fino a 32 voci `{name, description?}` che descrivono le skill del plugin.
+
+## Esempi
+
+### Esempio 1: Offrire un plugin corrispondente
+
+```
+SuggestPluginInstall(
+  contextLabel="For reviewing pull requests",
+  plugins=[{pluginId="pr-toolkit", pluginName="PR Toolkit", description="Review helpers"}]
+)
+```
+
+La scheda viene mostrata all'utente; l'abilitazione del plugin avviene fuori banda. Chiama `ListPlugins` in seguito per scoprire cosa è stato effettivamente installato.
+
+## Note
+
+- Includi solo plugin provenienti dai risultati di ricerca — non inventare mai voci di plugin.

package/concepts/it/Tool-SuggestSkills.md

@@ -0,0 +1,33 @@
+# SuggestSkills
+
+Mostra una scheda di skill autonome che l'utente può aggiungere (skill non ancora abilitate), in base a parole chiave sull'argomento.
+
+## Quando usare
+
+- La richiesta dell'utente corrisponde a skill che non ha abilitate (`trigger="user_asked"` quando le ha chieste, `trigger="proactive"` quando suggerisci senza che siano state richieste).
+
+## Attivazione
+
+- Solo quando un client Remote Control è connesso, o la sessione gira in un ambiente cloud gestito.
+- Disabilitato nelle configurazioni enterprise HIPAA.
+- Non in brief mode.
+
+## Parametri
+
+- `keywords` (array of strings, obbligatorio): Parole chiave sull'argomento tratte dalla richiesta dell'utente. 1–8 elementi, ciascuno di 1–64 caratteri.
+- `contextLabel` (string, opzionale): Etichetta breve che collega il suggerimento alla richiesta (massimo 128 caratteri).
+- `trigger` (string, opzionale): Come è iniziato questo suggerimento — `user_asked` oppure `proactive`.
+
+## Esempi
+
+### Esempio 1: Suggerire skill per argomento
+
+```
+SuggestSkills(keywords=["data visualization", "charts"], contextLabel="For building the dashboard", trigger="user_asked")
+```
+
+Le skill già abilitate vengono filtrate dal risultato.
+
+## Note
+
+- Mostra solo una scheda di suggerimento — l'aggiunta di una skill avviene fuori banda; chiama `ListSkills` in seguito per confermare.

package/concepts/it/Tool-TaskCreate.md

@@ -12,6 +12,12 @@ Crea un nuovo task nella lista dei task del team corrente (o nella lista dei tas
 
 Salta `TaskCreate` per azioni banali one-shot, pura conversazione o qualsiasi cosa completabile in due o tre chiamate tool dirette.
 
+## Attivazione
+
+- Disponibile per default sulla maggior parte dei modelli.
+- Non disponibile su Opus 4.8 / Sonnet 5 / Fable 5 / Mythos 5 e famiglie successive (v2.1.233+), salvo opt-in tramite `CLAUDE_CODE_ENABLE_TODO_TOOLS=1`, `--allowedTools` o `--tools`.
+- L'intero sistema dei task è disabilitato quando `CLAUDE_CODE_ENABLE_TASKS=false`.
+
 ## Parametri
 
 - `subject` (string, obbligatorio): Titolo imperativo breve, ad esempio `Fix login redirect on Safari`. Mantienilo sotto circa ottanta caratteri.

package/concepts/it/Tool-TaskGet.md

@@ -12,6 +12,12 @@ Recupera il record completo per un singolo task tramite ID, inclusa la sua descr
 
 Preferisci `TaskList` quando hai solo bisogno di una scansione ad alto livello; riserva `TaskGet` al record specifico che intendi leggere attentamente o modificare.
 
+## Attivazione
+
+- Disponibile per default sulla maggior parte dei modelli.
+- Non disponibile su Opus 4.8 / Sonnet 5 / Fable 5 / Mythos 5 e famiglie successive (v2.1.233+), salvo opt-in tramite `CLAUDE_CODE_ENABLE_TODO_TOOLS=1`, `--allowedTools` o `--tools`.
+- L'intero sistema dei task è disabilitato quando `CLAUDE_CODE_ENABLE_TASKS=false`.
+
 ## Parametri
 
 - `taskId` (string, obbligatorio): L'identificatore del task restituito da `TaskCreate` o `TaskList`. Gli ID sono stabili per tutta la vita del task.

package/concepts/it/Tool-TaskList.md

@@ -12,6 +12,12 @@ Restituisce ogni task nel team corrente (o sessione) in forma riassuntiva. Usalo
 
 `TaskList` è in sola lettura ed economico; chiamalo liberamente ogni volta che hai bisogno di una panoramica.
 
+## Attivazione
+
+- Disponibile per default sulla maggior parte dei modelli.
+- Non disponibile su Opus 4.8 / Sonnet 5 / Fable 5 / Mythos 5 e famiglie successive (v2.1.233+), salvo opt-in tramite `CLAUDE_CODE_ENABLE_TODO_TOOLS=1`, `--allowedTools` o `--tools`.
+- L'intero sistema dei task è disabilitato quando `CLAUDE_CODE_ENABLE_TASKS=false`.
+
 ## Parametri
 
 `TaskList` non accetta parametri. Restituisce sempre l'insieme completo dei task per il contesto attivo.

package/concepts/it/Tool-TaskUpdate.md

@@ -10,6 +10,12 @@ Modifica un task esistente — il suo stato, contenuto, proprietà, metadati o a
 - Registrare dipendenze appena scoperte con `addBlocks` / `addBlockedBy`.
 - Allegare `metadata` strutturati come ID di ticket esterni o suggerimenti di priorità.
 
+## Attivazione
+
+- Disponibile per default sulla maggior parte dei modelli.
+- Non disponibile su Opus 4.8 / Sonnet 5 / Fable 5 / Mythos 5 e famiglie successive (v2.1.233+), salvo opt-in tramite `CLAUDE_CODE_ENABLE_TODO_TOOLS=1`, `--allowedTools` o `--tools`.
+- L'intero sistema dei task è disabilitato quando `CLAUDE_CODE_ENABLE_TASKS=false`.
+
 ## Parametri
 
 - `taskId` (string, obbligatorio): Il task da modificare. Ottienilo da `TaskList` o `TaskCreate`.

package/concepts/it/Tool-TodoWrite.md

@@ -0,0 +1,43 @@
+# TodoWrite
+
+Scrive una lista todo strutturata per la sessione corrente, sostituendo la lista precedente. Ogni voce contiene il suo testo, uno stato e una forma al presente continuo mostrata negli indicatori di progresso.
+
+## Quando usare
+
+- Un compito ha diversi passi distinti e tracciarli aiuta te (e l'utente) a vedere il progresso.
+- L'utente chiede esplicitamente una lista todo.
+- Vuoi marcare esattamente una voce come in corso mentre le altre restano in attesa o completate.
+
+## Attivazione
+
+- Strumento legacy: disabilitato per default nelle sessioni che offrono gli strumenti Task (`TaskCreate`, `TaskUpdate`, `TaskList`).
+- Riabilitalo con `CLAUDE_CODE_ENABLE_TASKS=0`.
+
+## Parametri
+
+- `todos` (array, obbligatorio): La lista todo completa aggiornata. Ogni voce contiene:
+  - `content` (string): La descrizione del compito.
+  - `status` (string): Uno tra `pending`, `in_progress`, `completed`.
+  - `activeForm` (string): Testo al presente continuo mostrato mentre la voce è in corso (ad esempio "Running tests").
+
+## Esempi
+
+### Esempio 1: Tracciare una modifica in tre passi
+
+```
+TodoWrite(
+  todos=[
+    {content="Update the parser", status="in_progress", activeForm="Updating the parser"},
+    {content="Add unit tests", status="pending", activeForm="Adding unit tests"},
+    {content="Run the full test suite", status="pending", activeForm="Running the full test suite"}
+  ]
+)
+```
+
+L'intera lista viene riscritta a ogni chiamata — includi sempre tutte le voci, non solo quelle che sono cambiate.
+
+## Note
+
+- La lista viene sostituita integralmente a ogni chiamata; per aggiornare una voce, reinvia ogni voce con il nuovo stato.
+- Mantieni esattamente una voce `in_progress` alla volta.
+- Nelle sessioni in cui gli strumenti di task strutturati (`TaskCreate`/`TaskUpdate`/`TaskList`) sono abilitati, l'harness può offrire quelli al posto di `TodoWrite` — preferisci qualunque set di strumenti sia pubblicizzato.

package/concepts/it/Tool-ToolSearch.md

@@ -10,6 +10,11 @@ Recupera su richiesta le definizioni di schema complete degli «strumenti differ
 
 Se lo schema di uno strumento è già nel contesto, non cercare di nuovo — limitati a richiamarlo.
 
+## Attivazione
+
+- Attivo per default.
+- Disattivato quando `ANTHROPIC_BASE_URL` punta a un endpoint non-Anthropic (a meno che `ENABLE_TOOL_SEARCH` sia impostato), quando `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS` è impostato, quando il modello non supporta i riferimenti ai tool (modelli Vertex AI precedenti a Claude 4.5), o quando negato tramite `"deny": ["ToolSearch"]`.
+
 ## Parametri
 
 - `query` (string, obbligatorio): La query usata per localizzare gli strumenti differiti. Sono supportate tre forme:

package/concepts/it/Tool-WebSearch.md

@@ -10,6 +10,12 @@ Esegue una ricerca web live e restituisce risultati classificati che l'assistent
 - Verificare un fatto che potrebbe essere cambiato da quando il modello è stato addestrato.
 - Scoprire più prospettive su un argomento prima di recuperare qualsiasi singola pagina con `WebFetch`.
 
+## Attivazione
+
+- La disponibilità dipende da provider e modello: disponibile sull'Anthropic API e su Claude Platform on AWS; su Microsoft Foundry richiede un deployment ospitato da Anthropic; su Google Cloud funziona con i modelli Claude 4+.
+- Non disponibile su Amazon Bedrock.
+- Limita a 200 chiamate per sessione con `CLAUDE_CODE_MAX_WEB_SEARCHES_PER_SESSION`.
+
 ## Parametri
 
 - `query` (string, obbligatorio): La query di ricerca. Lunghezza minima 2 caratteri. Includi l'anno corrente quando chiedi informazioni "più recenti" o "recenti" così che i risultati siano freschi.