refactor: remove direct Gemini API integrations

Route F12 and audio transcription exclusively through Antigravity OAuth, and preserve cross-model history without reusing incompatible signatures.\n\nRemove direct Gemini API keys, web grounding, internal TTS, verified image generation, obsolete commands and configuration. Update documentation and restore the local voice workflow helpers required at runtime.
2026-09-03 12:52:13 +02:00
parent cde5aaa9b7
commit 4a88084b2b
13 changed files with 198 additions and 2197 deletions
@@ -1,89 +1,18 @@
-# Comandi Slash & Scorciatoie da Tastiera
+# Comandi e scorciatoie

-`agy-pi` mette a disposizione un ricco set di comandi slash interattivi e scorciatoie globali per interagire con l'estensione direttamente dal terminale di `pi`.
+## Comandi

---
+- `/agy <prompt>`: invia un task al subagent Antigravity.
+- `/agy:config [get|set|reset]`: gestisce la configurazione locale.
+- `/agy:status`: mostra stato di agy, modello e pipeline audio.
+- `/agy:record`: avvia/ferma la registrazione vocale.
+- `/agy:record:stop`: ferma una registrazione in corso.
+- `/agy:record:cancel`: annulla una registrazione in corso.
+- `/agy:refresh-models`: aggiorna il catalogo Antigravity.

-## Comandi Slash (Slash Commands)
+Non esistono comandi per inserire chiavi Gemini API, per TTS interno o per generazione immagini verificata.

-### Gestione Conversazione agy
+## Scorciatoie

-| Comando | Descrizione | Sintassi / Esempio |
-|---|---|---|
-| `/agy` | Invia un prompt diretto al subagent `agy` | `/agy Spiega la teoria della relatività` |
-| `/agy:new` | Forza la creazione di una nuova conversazione pulita | `/agy:new` |
-| `/agy:list` | Mostra l'ID della conversazione agy attiva | `/agy:list` |
-| `/agy:reset` | Azzera l'ID conversazione salvato in locale | `/agy:reset` |
-
---
-
-### Configurazione & Diagnostica TUI
-
-#### `/agy:config`
-Gestisce le opzioni di configurazione salvate in `~/.config/agy-pi/config.json`.
-
- `/agy:config`: Mostra l'elenco completo di tutte le opzioni con i valori attuali e le descrizioni.
- `/agy:config get <chiave>`: Stampa il valore di una singola chiave.
- `/agy:config set <chiave> <valore>`: Modifica il valore di una chiave e salva su disco.
- `/agy:config reset`: Ripristina le impostazioni predefinite di fabbrica.
-
-#### `/agy:key` (Dialog TUI Overlay)
-Apre una finestra di dialogo grafica in sovrimpressione nel terminale (`pi-tui` overlay) per inserire o modificare la chiave API Gemini:
-
-```
-┌────────────────────────────────────────────────────────┐
-│ 🔑 Chiave API Gemini                                   │
-│ Attuale: AIza...yfDY                                   │
-│                                                        │
-│ Nuova chiave: •••••••••••••••••••••••••••••••••••••    │
-│                                                        │
-│ Digita la chiave • Enter conferma • Esc annulla        │
-└────────────────────────────────────────────────────────┘
-```
- Input mascherato per prevenire il leak della chiave sul terminale o nella cronologia.
- Salva contemporaneamente la chiave in `~/.config/agy-pi/config.json` e in `~/.agy-chat/gemini-key` (permessi `0600`).
-
-#### `/agy:status` (Diagnostica TUI Overlay)
-Mostra una dashboard grafica centrata con lo stato di salute dell'estensione:
-
-```
-┌────────────────────────────────────────────────────────┐
-│ 📊 Stato agy-pi                                        │
-│                                                        │
-│ Binario agy: trovato /home/enne2/.local/bin/agy        │
-│ Versione: agy version 1.4.2                            │
-│ Chiave Gemini: ✅ valida                               │
-│ Chiave (mask): AIza...yfDY                             │
-│ Modello attivo: Gemini 3.1 Pro (High)                  │
-│ Backend STT: gemini                                    │
-│ Notifiche TTS: true                                    │
-│                                                        │
-│ Ultimo errore: (nessuno)                               │
-│                                                        │
-│ Enter o Esc per chiudere                               │
-└────────────────────────────────────────────────────────┘
-```
-
---
-
-### Registrazione Vocale & TTS
-
-| Comando | Descrizione |
-|---|---|
-| `/agy:record` | Avvia o ferma la registrazione vocale (equivalente al tasto **F12**). |
-| `/agy:record:stop` | Ferma la registrazione attiva ed elabora l'audio. |
-| `/agy:record:cancel` | Annulla la registrazione corrente senza inviare prompt. |
-| `/agy:speak <testo>` | Sintetizza ed esegue l'audio del testo specificato via Gemini TTS. |
-| `/agy:vocal [on\|off\|status]` | Attiva (`on`), disattiva (`off`) o mostra lo stato (`status`) del feedback vocale automatico TTS. |
-
---
-
-## Scorciatoie da Tastiera (Keybindings)
-
-### Tasto `F12` — Registrazione Vocale Toggle
- **Primo tocco (`F12`)**: Avvia la registrazione audio tramite `ffmpeg`, riproduce il suono sci-fi *Power Up* e mostra la barra di stato live `🔴 REGISTRAZIONE... MM:SS / MM:SS`.
- **Secondo tocco (`F12`)**: Interrompe la registrazione, riproduce il suono *Deactivate*, ottimizza l'audio (soppressione silenzio), invia la traccia a Gemini per la trascrizione e trasmette il prompt risultante a `pi`.
-
-### Tasto `Ctrl+Esc` — Annullamento Registrazione
- Durante una registrazione audio attiva, premere `Ctrl+Esc` abortisce immediatamente il processo `ffmpeg`, rimuove il file temporaneo, riproduce il tono acustico di cancellazione e cancella l'indicatore di stato.
- `Esc` da solo è riservato alla combinazione built-in di pi (`app.interrupt`), quindi l'estensione usa `Ctrl+Esc` per evitare il conflitto.
+- `F12`: avvia/ferma la registrazione vocale Antigravity.
+- `Ctrl+Esc`: annulla la registrazione attiva.