Un executor è il componente di Metnos che svolge una singola operazione. Questo catalogo descrive gli executor forniti con il prodotto: che cosa fanno, dove possono essere eseguiti e quali effetti si possono annullare.
Prima installazione: procedura in collaudo. Su un’istanza nuova, l’installer può adottare il catalogo esatto di una distribuzione già accettata, verificandone integrità, struttura e autorizzazioni. Ogni executor riceve una ricevuta locale di adozione. La ricevuta non equivale a una nuova esecuzione delle prove di funzionamento. Componenti nuovi o modificati devono seguire le verifiche complete di Executor Birth.
Alcuni executor seguono una procedura fissa; altri possono adattare alcuni passi entro limiti prestabiliti. Tutti devono rispettare il proprio contratto: scopo, dati accettati, permessi, luogo di esecuzione e risultato. La ricevuta finale distingue un’azione compiuta da una condizione già soddisfatta: un programma già chiuso, per esempio, non viene annunciato come appena chiuso.
L’amministratore può ritirare un executor con una procedura verificata: da quel momento non è più selezionabile per nuove operazioni. Il ritiro produce una ricevuta firmata e conserva codice storico, versioni e riferimenti necessari all’annullamento delle azioni precedenti. Non cancella la storia dell’executor.
Quando autorizzi l’avvio di un programma, puoi scegliere una sola volta, fino al prossimo riavvio del PC oppure sempre, fino a revoca. Negli ultimi due casi, chiudere e riaprire il programma non richiede un altro consenso. Il permesso vale per quel programma su quel PC, anche passando dalla chat web a Telegram. Non autorizza l’avvio automatico, l’installazione o la chiusura forzata. Le conferme precedenti non diventano automaticamente permessi riutilizzabili. L’amministratore può revocare un permesso permanente dal registro dei permessi; questa funzione non ha ancora un pulsante nella chat.
Per una ricerca vicino a te, Metnos usa la tua posizione disponibile; se chiedi vicino al server, usa invece quella del server. Nomi di città e coordinate esplicite restano il centro richiesto. Il nome del server non viene cercato come una città. Le distanze dipendono dalla precisione della posizione e dai risultati dei servizi geografici configurati; un servizio irraggiungibile non significa che non esistano luoghi vicini.
La colonna Contratto riporta la classe di rischio e il luogo di esecuzione. standard indica un’operazione ordinaria; critico segnala le maggiori restrizioni previste dal contratto. server indica il computer che ospita Metnos; any ammette anche altri dispositivi compatibili. Le piattaforme elencate precisano i sistemi supportati. Un trattino significa che la scheda tecnica non pone una restrizione esplicita sulla piattaforma.
La possibilità di annullare dipende dall’operazione e dal risultato:
Metnos ricava questa distinzione dal contratto firmato e, quando necessario, dalla ricevuta. Non inventa un’operazione inversa dal nome dell’executor.
Puoi chiedere al Tutor: «Quali operazioni modificano file e quali posso annullare?»
change_files_format compress_files create_calendars create_comments create_dirs create_events create_files_doc create_files_spreadsheet create_issues delete_dirs delete_events delete_files delete_persons get_images_google_photos login_urls move_files move_messages open_sites organize_files run_processes set_messages set_signatures share_files write_files write_files_doc write_files_spreadsheet
files (21)| Executor | Scopo | Contratto | Annullamento | Percorso |
|---|---|---|---|---|
change_files_format | converte file tra formati (JPG/PNG/WEBP/GIF, MP4/WEBM, audio). | standard; any; - | annullabile procedura di ripristino: restore_blob_backup, delete_created_paths | executors/change_files_format/ |
compress_files | comprime file in un nuovo archivio zip/tar/gz. | standard; any; linux, windows | annullabile procedura di ripristino: delete_created_paths | executors/compress_files/ |
compute_files_loc | calcola statistiche LOC su codice sorgente, visitando gli alberi in parallelo. | standard; any; linux, windows | non applicabile nessuno stato utente da ripristinare | executors/compute_files_loc/ |
create_files_doc | crea un nuovo Google Doc. | standard; any; - | annullabile procedura di ripristino: delete_files_by_id | executors/create_files_doc/ |
create_files_spreadsheet | crea e popola un nuovo .xlsx locale. | standard; any; linux, windows | annullabile procedura di ripristino: delete_created_paths, delete_files_by_id | executors/create_files_spreadsheet/ |
delete_files | cancella file dopo un backup verificato. | standard; any; linux, windows | annullabile procedura di ripristino: restore_blob_backup, restore_trashed_files | executors/delete_files/ |
find_files | cerca file per pattern con visita ricorsiva parallela. | standard; any; linux, windows | non applicabile nessuno stato utente da ripristinare | executors/find_files/ |
find_files_hash | trova duplicati esatti tramite SHA-256 completo; i tipi generali sono espansi in glob. | standard; any; linux, windows | non applicabile nessuno stato utente da ripristinare | executors/find_files_hash/ |
get_files | ottiene dimensione, date ed EXIF di file NOTI. | standard; any; linux, windows | non applicabile nessuno stato utente da ripristinare | executors/get_files/ |
move_files | sposta o rinomina file in batch. | standard; any; linux, windows | annullabile procedura di ripristino: swap_src_dst, restore_blob_backup, delete_created_dirs | executors/move_files/ |
organize_files | organizza file con una politica chiusa, SHA-256 e piano congelato. | critico; server; linux | annullabile procedura di ripristino: module.reversela ricevuta della singola esecuzione stabilisce l'annullabilità effettiva | executors/organize_files/ |
read_files | legge file locali o remoti, anche PDF/DOCX/XLSX/CSV. | standard; any; linux, windows | non applicabile nessuno stato utente da ripristinare | executors/read_files/ |
read_files_csv | legge file CSV locali (vettoriale §2.1). | standard; any; - | non applicabile nessuno stato utente da ripristinare | executors/read_files_csv/ |
read_files_doc | legge testo da Google Doc. | standard; any; - | non applicabile nessuno stato utente da ripristinare | executors/read_files_doc/ |
read_files_ocr | estrae testo da immagini e PDF scansionati: OCR locale prima, VLM bounded solo se insufficiente. | standard; any; - | non applicabile nessuno stato utente da ripristinare | executors/read_files_ocr/ |
read_files_spreadsheet | legge le righe di un foglio (.xlsx/.csv locale o Google Sheet). | standard; any; - | non applicabile nessuno stato utente da ripristinare | executors/read_files_spreadsheet/ |
read_files_xlsx | legge file Excel (.xlsx) locali (vettoriale §2.1). | standard; any; - | non applicabile nessuno stato utente da ripristinare | executors/read_files_xlsx/ |
share_files | concede permessi di accesso a file Drive senza duplicarli. | standard; any; - | annullabile procedura di ripristino: module.reverse | executors/share_files/ |
write_files | salva record/testo in file locali (vettoriale §2.1). | standard; any; linux, windows | annullabile procedura di ripristino: restore_blob_backup, delete_created_paths | executors/write_files/ |
write_files_doc | appendi testo a un Google Doc esistente (.doc). | standard; any; - | annullabile procedura di ripristino: module.reverse | executors/write_files_doc/ |
write_files_spreadsheet | scrive un foglio locale, creandolo se manca. | standard; any; - | annullabile procedura di ripristino: restore_blob_backup, delete_created_paths | executors/write_files_spreadsheet/ |
dirs (4)| Executor | Scopo | Contratto | Annullamento | Percorso |
|---|---|---|---|---|
create_dirs | crea directory (batch, anche vuote). | standard; any; linux, windows | annullabile procedura di ripristino: delete_created_paths | executors/create_dirs/ |
delete_dirs | cancella directory (vuote o forzate). | standard; any; linux, windows | annullabile procedura di ripristino: module.reverse, restore_trashed_filesla ricevuta della singola esecuzione stabilisce l'annullabilità effettiva | executors/delete_dirs/ |
find_dirs | trova directory e calcola metadati aggregati con visita ricorsiva parallela. | standard; any; linux, windows | non applicabile nessuno stato utente da ripristinare | executors/find_dirs/ |
list_dirs | elenca directory e file; in modalità ricorsiva visita le sottocartelle in parallelo. | standard; any; linux, windows | non applicabile nessuno stato utente da ripristinare | executors/list_dirs/ |
packages (2)| Executor | Scopo | Contratto | Annullamento | Percorso |
|---|---|---|---|---|
find_packages | verifica software installato e risolve un nome umano nell'id registrato. | standard; any; linux, windows | non applicabile nessuno stato utente da ripristinare | executors/find_packages/ |
install_packages | installa un programma sulla macchina. | critico; any; windows, linux | non annullabile nessuna procedura di ripristino dichiarata | executors/install_packages/ |
messages (4)| Executor | Scopo | Contratto | Annullamento | Percorso |
|---|---|---|---|---|
move_messages | sposta messaggi tra cartelle o etichette. | standard; server; linux | annullabile procedura di ripristino: swap_src_dst | executors/move_messages/ |
read_messages | legge messaggi IMAP combinando filtri temporali e testuali. | standard; any; - | non applicabile nessuno stato utente da ripristinare | executors/read_messages/ |
send_messages | invia mail/Telegram e risponde in-thread Gmail. | standard; server; linux | non annullabile nessuna procedura di ripristino dichiarata | executors/send_messages/ |
set_messages | aggiunge/rimuove etichette da messaggi Gmail e registra il delta effettivo per l'annullamento. | standard; server; linux | annullabile procedura di ripristino: module.reverse | executors/set_messages/ |
events (4)| Executor | Scopo | Contratto | Annullamento | Percorso |
|---|---|---|---|---|
create_events | crea appuntamenti in calendario. | standard; any; - | annullabile procedura di ripristino: delete_events_by_id | executors/create_events/ |
delete_events | cancella eventi dal calendario, per id o finestra temporale. | standard; any; - | annullabile procedura di ripristino: restore_event | executors/delete_events/ |
find_events_empty | trova slot liberi nel calendario. | standard; any; - | non applicabile nessuno stato utente da ripristinare | executors/find_events_empty/ |
read_events | legge eventi calendario. | standard; any; - | non applicabile nessuno stato utente da ripristinare | executors/read_events/ |
contacts (2)| Executor | Scopo | Contratto | Annullamento | Percorso |
|---|---|---|---|---|
find_contacts | cerca contatti nella rubrica esterna per nome/email/telefono. | standard; any; - | non applicabile nessuno stato utente da ripristinare | executors/find_contacts/ |
read_contacts | legge un contatto dalla rubrica esterna. | standard; any; - | non applicabile nessuno stato utente da ripristinare | executors/read_contacts/ |
places (2)| Executor | Scopo | Contratto | Annullamento | Percorso |
|---|---|---|---|---|
find_places | cerca luoghi reali per query testuale. | standard; server; linux | non applicabile nessuno stato utente da ripristinare | executors/find_places/ |
get_places | ottiene il nome del luogo da coordinate GPS. | standard; server; linux | non applicabile nessuno stato utente da ripristinare | executors/get_places/ |
processes (3)| Executor | Scopo | Contratto | Annullamento | Percorso |
|---|---|---|---|---|
get_processes | processi e salute del sistema. | standard; any; linux, windows | non applicabile nessuno stato utente da ripristinare | executors/get_processes/ |
run_processes | avvia software installato con ricevuta esatta della coorte di processi creata. | critico; any; windows | annullabile procedura di ripristino: module.reversela ricevuta della singola esecuzione stabilisce l'annullabilità effettiva | executors/run_processes/ |
set_processes | chiude applicazioni desktop Windows registrate. | critico; any; windows | non annullabile nessuna procedura di ripristino dichiarata | executors/set_processes/ |
urls (5)| Executor | Scopo | Contratto | Annullamento | Percorso |
|---|---|---|---|---|
find_urls | cerca e scopri URL e documenti sul web. | standard; any; - | non applicabile nessuno stato utente da ripristinare | executors/find_urls/ |
get_urls | ottiene dati da URL HTTP/HTTPS. | standard; server; linux | non applicabile nessuno stato utente da ripristinare | executors/get_urls/ |
login_urls | autentica HTTP su URLs, salva cookie 0600 e una ricevuta esatta per l'annullamento. | standard; server; linux | annullabile procedura di ripristino: module.reversela ricevuta della singola esecuzione stabilisce l'annullabilità effettiva | executors/login_urls/ |
read_urls_html | legge pagine web e ne estrae il testo; URL PDF estratti come testo automaticamente. | standard; server; linux | non applicabile nessuno stato utente da ripristinare | executors/read_urls_html/ |
read_urls_pdf | legge documenti PDF da URL e ne estrae testo e metadati. | standard; any; - | non applicabile nessuno stato utente da ripristinare | executors/read_urls_pdf/ |
numbers (1)| Executor | Scopo | Contratto | Annullamento | Percorso |
|---|---|---|---|---|
describe_numbers | calcola statistiche descrittive su una lista di numeri. | standard; any; - | non applicabile nessuno stato utente da ripristinare | executors/describe_numbers/ |
images (8)| Executor | Scopo | Contratto | Annullamento | Percorso |
|---|---|---|---|---|
create_images_indices | costruisce o aggiorna l'indice foto con unità LRE riprendibili; registra foto non decodificabili e continua. | standard; any; - | non annullabile nessuna procedura di ripristino dichiarata | executors/create_images_indices/ |
delete_images_indices | cancella l'indice persistente unificato delle immagini. | standard; any; - | non annullabile nessuna procedura di ripristino dichiarata | executors/delete_images_indices/ |
find_images_google_photos | cerca foto/album su Google Photos, SOLO i caricati da Metnos. | standard; any; - | non applicabile nessuno stato utente da ripristinare | executors/find_images_google_photos/ |
find_images_indices | cerca foto indicizzate per contenuto, persona o volto. | standard; server; linux | non applicabile nessuno stato utente da ripristinare | executors/find_images_indices/ |
find_images_web | cerca immagini sul web da testo o immagine. Usa segnali deterministici; il ranking semantico locale interviene solo senza segnali lessicali. | standard; any; - | non applicabile nessuno stato utente da ripristinare | executors/find_images_web/ |
get_images_google_photos | scarica foto da Google Photos nel workspace. | standard; any; - | annullabile procedura di ripristino: delete_created_paths | executors/get_images_google_photos/ |
get_images_indices | ottiene lo stato dell'indice immagini unificato per un corpus o per tutti. | standard; server; linux | non applicabile nessuno stato utente da ripristinare | executors/get_images_indices/ |
write_images_google_photos | carica foto locali su Google Photos. | critico; any; - | non annullabile nessuna procedura di ripristino dichiarata | executors/write_images_google_photos/ |
signatures (3)| Executor | Scopo | Contratto | Annullamento | Percorso |
|---|---|---|---|---|
compute_signatures | calcola o classifica signature; può applicare idempotentemente il seed di sicurezza. | standard; any; - | non applicabile nessuno stato utente da ripristinare | executors/compute_signatures/ |
get_signatures | consulta liste e stato delle signature di sicurezza. | standard; any; - | non applicabile nessuno stato utente da ripristinare | executors/get_signatures/ |
set_signatures | imposta/rimuove signature e salva lo stato per l'annullamento, salvo `forbidden`. | standard; any; - | annullabile procedura di ripristino: module.reversela ricevuta della singola esecuzione stabilisce l'annullabilità effettiva | executors/set_signatures/ |
texts (1)| Executor | Scopo | Contratto | Annullamento | Percorso |
|---|---|---|---|---|
filter_texts_lines | filtra righe di testo per pattern. | standard; any; - | non applicabile nessuno stato utente da ripristinare | executors/filter_texts_lines/ |
proposals (1)| Executor | Scopo | Contratto | Annullamento | Percorso |
|---|---|---|---|---|
get_proposals | legge proposte introvertive, incluse categorie storiche. | standard; server; linux | non applicabile nessuno stato utente da ripristinare | executors/get_proposals/ |
persons (5)| Executor | Scopo | Contratto | Annullamento | Percorso |
|---|---|---|---|---|
delete_persons | cancella persone/enrollment dal registro biometrico (purge o per nome/slug). | standard; any; - | annullabile procedura di ripristino: restore_person | executors/delete_persons/ |
find_persons_indices | cerca foto di persona registrata. | standard; server; linux | non applicabile nessuno stato utente da ripristinare | executors/find_persons_indices/ |
get_persons | legge il registro biometrico persone. | standard; server; linux | non applicabile nessuno stato utente da ripristinare | executors/get_persons/ |
read_persons | legge profili identitari locali. | standard; server; linux | non applicabile nessuno stato utente da ripristinare | executors/read_persons/ |
set_persons | registra persona nel registro nominale. | standard; any; - | non annullabile nessuna procedura di ripristino dichiarata | executors/set_persons/ |
workflows (2)| Executor | Scopo | Contratto | Annullamento | Percorso |
|---|---|---|---|---|
find_workflows | elenca le esecuzioni delle automazioni per stato e ramo. | standard; any; linux | non applicabile nessuno stato utente da ripristinare | executors/find_workflows/ |
run_workflows | avvia una automazione gia' presente nel repository; NON annullabile. | standard; any; linux | non annullabile nessuna procedura di ripristino dichiarata | executors/run_workflows/ |
inputs (1)| Executor | Scopo | Contratto | Annullamento | Percorso |
|---|---|---|---|---|
get_inputs | ottiene input strutturati (dialogo/form). | standard; server; linux | non applicabile nessuno stato utente da ripristinare | executors/get_inputs/ |
approval (1)| Executor | Scopo | Contratto | Annullamento | Percorso |
|---|---|---|---|---|
get_approval | consenso umano (Approva/Disapprova), poi esegue l'executor. | standard; server; linux | non applicabile nessuno stato utente da ripristinare | executors/get_approval/ |
credentials (3)| Executor | Scopo | Contratto | Annullamento | Percorso |
|---|---|---|---|---|
delete_credentials | cancella credenziali dallo storage (purge o binding). | standard; any; - | non annullabile nessuna procedura di ripristino dichiarata | executors/delete_credentials/ |
find_credentials | elenca account e servizi configurati (mail, api, cloud): credenziali metadata-only. | standard; any; - | non applicabile nessuno stato utente da ripristinare | executors/find_credentials/ |
set_credentials | cifra credenziali; definisce il mandato. | standard; any; - | non annullabile nessuna procedura di ripristino dichiarata | executors/set_credentials/ |
issues (5)| Executor | Scopo | Contratto | Annullamento | Percorso |
|---|---|---|---|---|
create_issues | apre una segnalazione nel repository. | standard; any; linux | annullabile procedura di ripristino: delete_issues_by_id | executors/create_issues/ |
delete_issues | chiude una segnalazione per numero; su GitHub non si cancella, si chiude. | standard; any; linux | non annullabile nessuna procedura di ripristino dichiarata | executors/delete_issues/ |
find_issues | elenca le segnalazioni di un repository per stato, etichette e data. | standard; any; linux | non applicabile nessuno stato utente da ripristinare | executors/find_issues/ |
read_issues | legge una segnalazione per numero, coi suoi commenti se richiesti. | standard; any; linux | non applicabile nessuno stato utente da ripristinare | executors/read_issues/ |
set_issues | cambia stato, etichette, assegnatari o traguardo di una segnalazione. | standard; any; linux | non annullabile nessuna procedura di ripristino dichiarata | executors/set_issues/ |
pulls (4)| Executor | Scopo | Contratto | Annullamento | Percorso |
|---|---|---|---|---|
change_pulls | unisce una proposta di modifica al ramo di destinazione; NON annullabile. | standard; any; linux | non annullabile nessuna procedura di ripristino dichiarata | executors/change_pulls/ |
find_pulls | elenca le proposte di modifica per stato e rami. | standard; any; linux | non applicabile nessuno stato utente da ripristinare | executors/find_pulls/ |
read_pulls | legge una proposta di modifica per numero, con la differenza se richiesta. | standard; any; linux | non applicabile nessuno stato utente da ripristinare | executors/read_pulls/ |
set_pulls | approva una proposta, chiede modifiche, o ne cambia stato. | standard; any; linux | non annullabile nessuna procedura di ripristino dichiarata | executors/set_pulls/ |
comments (2)| Executor | Scopo | Contratto | Annullamento | Percorso |
|---|---|---|---|---|
create_comments | scrive un commento su segnalazioni o proposte di modifica. | standard; any; linux | annullabile procedura di ripristino: delete_comments_by_id | executors/create_comments/ |
delete_comments | cancella uno o piu' commenti per identificativo. | standard; any; linux | non annullabile nessuna procedura di ripristino dichiarata | executors/delete_comments/ |
calendars (2)| Executor | Scopo | Contratto | Annullamento | Percorso |
|---|---|---|---|---|
create_calendars | crea un NUOVO calendario-contenitore Google (non un evento). | standard; server; linux | annullabile procedura di ripristino: delete_calendars_by_id | executors/create_calendars/ |
delete_calendars | cancella calendari-contenitore Google (DESTRUTTIVO: elimina anche gli eventi dentro); accetta il NOME. | standard; server; linux | non annullabile nessuna procedura di ripristino dichiarata | executors/delete_calendars/ |
entries (4)| Executor | Scopo | Contratto | Annullamento | Percorso |
|---|---|---|---|---|
compute_entries | calcola un valore aggregato (max/min/avg/sum/count) su entries. | standard; any; - | non applicabile nessuno stato utente da ripristinare | executors/compute_entries/ |
filter_entries | filtra entries per criteri. | standard; any; - | non applicabile nessuno stato utente da ripristinare | executors/filter_entries/ |
group_entries | unisce e deduplica entries da più liste. | standard; any; - | non applicabile nessuno stato utente da ripristinare | executors/group_entries/ |
sort_entries | ordina entries in memoria. | standard; any; - | non applicabile nessuno stato utente da ripristinare | executors/sort_entries/ |
lists (1)| Executor | Scopo | Contratto | Annullamento | Percorso |
|---|---|---|---|---|
filter_lists | opera fra DUE liste (A=from_step, B=with_step) su on_keys; delta = dedup monitor. | standard; any; - | non applicabile nessuno stato utente da ripristinare | executors/filter_lists/ |
sites (5)| Executor | Scopo | Contratto | Annullamento | Percorso |
|---|---|---|---|---|
act_sites | naviga a un fine dentro una sessione web, con conferma se sensibile. | critico; server; linux | non annullabile nessuna procedura di ripristino dichiarata | executors/act_sites/ |
delete_sites | chiude o revoca sessioni web; all=true le revoca tutte. | standard; server; linux | non annullabile nessuna procedura di ripristino dichiarata | executors/delete_sites/ |
login_sites | raggiunge l'accesso e usa credenziali cifrate, mai esposte all'agente. Tenta i CAPTCHA locali supportati, poi chiede intervento; OTP separato. | critico; server; linux | non annullabile nessuna procedura di ripristino dichiarata | executors/login_sites/ |
open_sites | apre una sessione browser persistente e registra soltanto quelle create per l'annullamento. | standard; server; linux | annullabile procedura di ripristino: module.reversela ricevuta della singola esecuzione stabilisce l'annullabilità effettiva | executors/open_sites/ |
read_sites | legge le pagine distinte osservate durante la raccolta; senza raccolta legge la pagina corrente della sessione (post-login se autenticata). Ogni fonte conserva URL e titolo propri. Moduli e screenshot REDATTO descrivono solo la pagina corrente, separata in current_pages se esterna alla raccolta. | standard; server; linux | non applicabile nessuno stato utente da ripristinare | executors/read_sites/ |
sistema / più domini (4)| Executor | Scopo | Contratto | Annullamento | Percorso |
|---|---|---|---|---|
consult_frontier | consulta un oracolo esperto per analisi profonda. | standard; server; linux | non applicabile nessuno stato utente da ripristinare | executors/consult_frontier/ |
get_location | legge la posizione geografica dell'utente o del server. | standard; server; linux | non applicabile nessuno stato utente da ripristinare | executors/get_location/ |
get_now | ottiene data e ora correnti nel fuso configurato o in un fuso IANA esplicito. | standard; server; linux, windows, macos | non applicabile nessuno stato utente da ripristinare | executors/get_now/ |
undo_last_turn | annulla le operazioni reversibili dell'ultimo turno utente. | standard; server; linux | non annullabile nessuna procedura di ripristino dichiarata | executors/undo_last_turn/ |