cc-viewer 1.7.21 → 1.7.23

package/concepts/it/Tool-ListConnectors.md

@@ -0,0 +1,34 @@
+# ListConnectors
+
+Elenca i connector MCP installati per l'organizzazione claude.ai dell'utente, opzionalmente filtrati per parola chiave.
+
+## Quando usare
+
+- Devi sapere quali connector sono già installati prima di suggerirne di nuovi.
+- L'utente chiede quali integrazioni ha la sua organizzazione.
+
+## Attivazione
+
+- Disponibile solo nelle sessioni remote (claude.ai) sull'API first-party.
+
+## Parametri
+
+- `keywords` (array of strings, opzionale): Filtra l'elenco — fino a 8 elementi, ciascuno di 1–64 caratteri. Ometti per elencare tutto.
+
+## Esempi
+
+### Esempio 1: Elencare tutti i connector installati
+
+```
+ListConnectors()
+```
+
+### Esempio 2: Filtrare per parola chiave
+
+```
+ListConnectors(keywords=["github"])
+```
+
+## Note
+
+- Abbina con `SearchMcpRegistry` (scoperta) e `SuggestConnectors` (dettagli) per il flusso completo trova-e-abilita.

package/concepts/it/Tool-ListMcpResources.md

@@ -0,0 +1,35 @@
+# ListMcpResources
+
+Elenca le risorse esposte dai server MCP connessi, opzionalmente filtrate a un singolo server.
+
+## Quando usare
+
+- Devi scoprire quali risorse (file, record, documenti) offre un server MCP prima di leggerle.
+- Vuoi una panoramica di tutte le risorse su ogni server connesso.
+
+## Attivazione
+
+- Sempre abilitato, ma non esposto all'elenco degli strumenti del modello — pensato per l'uso thin-client / sidecar.
+
+## Parametri
+
+- `server` (string, opzionale): Nome del server per filtrare le risorse. Ometti per elencare le risorse di tutti i server connessi.
+
+## Esempi
+
+### Esempio 1: Elencare tutto
+
+```
+ListMcpResources()
+```
+
+### Esempio 2: Elencare le risorse di un server
+
+```
+ListMcpResources(server="github")
+```
+
+## Note
+
+- Questo è il passo di scoperta: passa le URI interessanti a `ReadMcpResource` (singola risorsa) o `ReadMcpResourceDir` (elenchi di directory).
+- I server si connettono e si disconnettono durante la vita della sessione; ri-elenca se un server è stato appena aggiunto.

package/concepts/it/Tool-ListPlugins.md

@@ -0,0 +1,35 @@
+# ListPlugins
+
+Elenca i plugin claude.ai abilitati dell'utente, opzionalmente filtrati per parola chiave.
+
+## Quando usare
+
+- Devi sapere quali plugin sono già abilitati — ad esempio, per confermare cosa è stato installato dopo una scheda di `SuggestPluginInstall`.
+- L'utente chiede quali plugin ha.
+
+## Attivazione
+
+- Richiede il permesso di accesso al registro dei plugin.
+- La disponibilità dipende dal tipo di sessione e dal feature rollout — disabilitato negli ambienti HIPAA, sempre disponibile nelle sessioni remote.
+
+## Parametri
+
+- `keywords` (array of strings, opzionale): Filtra l'elenco — fino a 8 elementi, ciascuno di 1–64 caratteri. Ometti per elencare tutto.
+
+## Esempi
+
+### Esempio 1: Elencare i plugin abilitati
+
+```
+ListPlugins()
+```
+
+### Esempio 2: Filtrare per parola chiave
+
+```
+ListPlugins(keywords=["figma"])
+```
+
+## Note
+
+- Se il catalogo dei plugin è irraggiungibile (forbidden), il tool degrada a un elenco vuoto con un avviso invece di fallire.

package/concepts/it/Tool-ListSkills.md

@@ -0,0 +1,37 @@
+# ListSkills
+
+Elenca le skill claude.ai abilitate dell'utente, opzionalmente filtrate per parola chiave.
+
+## Quando usare
+
+- Hai bisogno dell'elenco autorevole delle skill attualmente abilitate — prima di invocarne una, o per confermare cosa ha aggiunto una scheda di `SuggestSkills`.
+- L'utente chiede quali skill ha.
+
+## Attivazione
+
+- Richiede il permesso di accesso al registro dei plugin.
+- Disabilitato negli ambienti HIPAA.
+- Sempre disponibile nelle sessioni remote.
+
+## Parametri
+
+- `keywords` (array of strings, opzionale): Filtra l'elenco — fino a 8 elementi, ciascuno di 1–64 caratteri. Ometti per elencare tutto.
+
+## Esempi
+
+### Esempio 1: Elencare le skill abilitate
+
+```
+ListSkills()
+```
+
+### Esempio 2: Filtrare per parola chiave
+
+```
+ListSkills(keywords=["review"])
+```
+
+## Note
+
+- Se il catalogo è irraggiungibile (forbidden), il tool degrada a un elenco vuoto con un avviso invece di fallire.
+- Questo elenca le skill *abilitate*; usa `SuggestSkills` per far emergere skill che l'utente potrebbe aggiungere.

package/concepts/it/Tool-Monitor.md

@@ -10,6 +10,13 @@ Avvia un monitor in background che trasmette eventi da uno script a lunga esecuz
 - Attendere una condizione specifica su molte iterazioni (ad esempio un traguardo di un passo di addestramento o lo svuotamento di una coda)
 - **Non** per un semplice "aspetta fino al completamento" — usare `Bash` con `run_in_background` per quello; emette una notifica di completamento quando il processo termina
 
+## Attivazione
+
+- Disattivato per default (feature flag lato server).
+- Non disponibile su Amazon Bedrock, Google Cloud e Microsoft Foundry.
+- Disattivato quando `DISABLE_TELEMETRY` o `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` è impostato.
+- La sorgente WebSocket richiede Claude Code 2.1.195+.
+
 ## Parametri
 
 - `command` (stringa, obbligatorio): Il comando shell o lo script da eseguire. Ogni riga scritta nello stdout diventa un evento di notifica separato. Il monitor termina quando il processo termina.

package/concepts/it/Tool-Projects.md

@@ -0,0 +1,46 @@
+# Projects
+
+Gestisce i documenti di progetto nella knowledge base del progetto Claude dell'utente: leggere, cercare, scrivere ed eliminare documenti, oppure ottenere informazioni sul progetto.
+
+## Quando usare
+
+- Persistire un documento (deliverable, note, materiale di riferimento) nel progetto dell'utente affinché sopravviva alla sessione.
+- Leggere o cercare documenti di progetto esistenti per fondare il compito corrente su contesto precedente.
+- Caricare un file locale nel progetto senza caricarne il contenuto nel contesto.
+- Rimuovere un documento di progetto obsoleto.
+
+## Parametri
+
+- `method` (string, obbligatorio): Uno tra `project_info`, `project_read`, `project_search`, `project_write`, `project_delete`.
+- `path` (string, opzionale): Per `project_read`/`project_write`/`project_delete`: il percorso del documento. Per `project_write`: un percorso esistente viene sostituito in loco; un nuovo semplice nome file (senza "/") viene collocato nel namespace `claude/<name>`.
+- `content` (string, opzionale): Per `project_write`: testo del documento inline. Mutuamente esclusivo con `local_path`.
+- `local_path` (string, opzionale): Per `project_write`: un file all'interno della directory di lavoro da caricare — il contenuto non entra mai nel tuo contesto. Mutuamente esclusivo con `content`.
+- `present_to_user` (boolean, opzionale): Per `project_write`: marca questo documento come il deliverable che l'utente deve vedere. Default: false; lascia non impostato per salvataggi di routine e scritture in blocco.
+- `query` (string, opzionale): Per `project_search`: query sulla knowledge base.
+- `n` (number, opzionale): Per `project_search`: numero di risultati (default 5).
+
+## Esempi
+
+### Esempio 1: Scrivere il deliverable nel progetto
+
+```
+Projects(
+  method="project_write",
+  path="claude/migration-plan.md",
+  local_path="./migration-plan.md",
+  present_to_user=true
+)
+```
+
+Carica il file locale senza portarne il contenuto nel contesto, e lo marca come deliverable dell'utente.
+
+### Esempio 2: Cercare nella knowledge base
+
+```
+Projects(method="project_search", query="authentication refresh tokens", n=5)
+```
+
+## Note
+
+- `content` è per testo che componi inline; `local_path` è per qualsiasi cosa già su disco — non mescolare mai i due.
+- Usa `present_to_user=true` con parsimonia: solo per l'unico documento che l'utente ha chiesto o su cui deve agire.

package/concepts/it/Tool-ProposeGoal.md

@@ -0,0 +1,43 @@
+# ProposeGoal
+
+Propone un obiettivo di completamento verificabile per la sessione. L'obiettivo viene mostrato all'utente in un dialogo di approvazione (di default) e, una volta impostato, guida il resto della conversazione verso un esito verificabile.
+
+## Quando usare
+
+- La sessione ha uno stato finale concreto che un valutatore potrebbe verificare dalla conversazione (ad esempio "all tests in test/auth pass").
+- Vuoi un'esplicita approvazione dell'utente su cosa significhi "fatto" prima di svolgere un lavoro sostanziale.
+- Le parole stesse dell'utente hanno già dichiarato l'esito e vuoi registrarlo come obiettivo della sessione.
+
+## Attivazione
+
+- Disattivato per default (feature flag lato server).
+- Escluso dalle sessioni interattive e in background.
+- Disattivato dalla chiave di impostazione `modelProposedGoals: "disabled"`.
+
+## Parametri
+
+- `condition` (string, obbligatorio): La condizione di completamento, scritta in modo che un valutatore separato possa verificarla dalla conversazione (ad esempio "all tests in test/auth pass (bun test exits 0)"). Al massimo 500 caratteri — l'utente deve poter leggere l'intera condizione nel dialogo di approvazione.
+- `ask_user` (boolean, opzionale): Se chiedere l'approvazione all'utente prima che l'obiettivo venga impostato. Default: true (viene mostrato un dialogo di approvazione). Imposta false SOLO quando le parole stesse dell'utente in questa conversazione hanno dichiarato questo esito come ciò che vuole; l'obiettivo viene quindi impostato direttamente con un avviso visibile, e l'utente può cancellarlo con `/goal clear`.
+
+## Esempi
+
+### Esempio 1: Proporre un obiettivo fondato sui test
+
+```
+ProposeGoal(condition="npm run test exits 0 with the new catalog cases included")
+```
+
+L'utente vede la condizione in un dialogo di approvazione e può accettarla, modificarla o rifiutarla.
+
+### Esempio 2: Adottare direttamente l'esito dichiarato dall'utente
+
+```
+ProposeGoal(condition="the login form validates email format and shows an inline error", ask_user=false)
+```
+
+Valido solo perché l'utente ha dichiarato esplicitamente quell'esito in precedenza nella conversazione.
+
+## Note
+
+- Mantieni `condition` breve e oggettivamente verificabile — obiettivi vaghi ("make it better") vanificano lo scopo.
+- `ask_user=false` è strettamente limitato agli esiti che l'utente stesso ha dichiarato; qualsiasi altra cosa deve passare dal dialogo di approvazione.

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.