This page answers a practical question: which actions come with Metnos, and what does each contract declare? Executors are grouped automatically from their canonical names; nobody copies and rearranges this inventory by hand.
An executor may follow a direct procedure or adapt some steps within a narrow mandate. Either way, it keeps the same public contract: purpose, arguments, authority, placement, and result shape.
In the Contract column, standard and critical indicate the risk class; server, any, and the platform names show where the executor may run. A dash means that the manifest does not explicitly restrict the platform.
Undo does not apply to every action in the same way:
The classification comes from the signed contract and, where required, the receipt for that particular execution. Metnos never invents an inverse from the executor's name.
Tutor can use this catalog to answer questions such as: “Which executors modify files, and which of those actions can I undo?”
change_files_format compress_files create_calendars create_dirs create_events create_files_doc create_files_spreadsheet create_images_indices delete_dirs delete_events delete_files delete_persons get_images_google_photos login_urls move_files move_messages open_sites run_processes set_messages set_signatures share_files write_files write_files_doc write_files_spreadsheet
files (20)| Executor | Purpose | Contract | Undo | Location |
|---|---|---|---|---|
change_files_format | converts files between formats (JPG/PNG/WEBP/GIF, MP4/WEBM, audio). | standard; any; - | undoable restoration procedure: restore_blob_backup, delete_created_paths | executors/change_files_format/ |
compress_files | compress files into a new zip/tar/gz archive. | standard; any; linux, windows | undoable restoration procedure: delete_created_paths | executors/compress_files/ |
compute_files_loc | computes source-code LOC statistics, walking directory trees in parallel. | standard; any; linux, windows | not applicable no user state to restore | executors/compute_files_loc/ |
create_files_doc | creates a new Google Doc. | standard; any; - | undoable restoration procedure: delete_files_by_id | executors/create_files_doc/ |
create_files_spreadsheet | creates and populates a new local .xlsx. | standard; any; linux, windows | undoable restoration procedure: delete_created_paths, delete_files_by_id | executors/create_files_spreadsheet/ |
delete_files | delete files after a verified backup. | standard; any; linux, windows | undoable restoration procedure: restore_blob_backup, restore_trashed_files | executors/delete_files/ |
find_files | search files by pattern with a parallel recursive walk. | standard; any; linux, windows | not applicable no user state to restore | executors/find_files/ |
find_files_hash | finds exact duplicates through complete SHA-256; broad file types expand into globs. | standard; any; linux, windows | not applicable no user state to restore | executors/find_files_hash/ |
get_files | gets size, dates, and EXIF for KNOWN files. | standard; any; linux, windows | not applicable no user state to restore | executors/get_files/ |
move_files | move or rename files in batch. | standard; any; linux, windows | undoable restoration procedure: swap_src_dst, restore_blob_backup, delete_created_dirs | executors/move_files/ |
read_files | reads mixed PDF/DOCX/XLSX/CSV and computes SHA-256 hash signatures. | standard; any; linux, windows | not applicable no user state to restore | executors/read_files/ |
read_files_csv | reads local CSV files (vectorial §2.1). | standard; any; - | not applicable no user state to restore | executors/read_files_csv/ |
read_files_doc | reads text from Google Doc. | standard; any; - | not applicable no user state to restore | executors/read_files_doc/ |
read_files_ocr | extracts text from images and scanned PDFs: local OCR first, bounded VLM only if insufficient. | standard; any; - | not applicable no user state to restore | executors/read_files_ocr/ |
read_files_spreadsheet | reads a spreadsheet rows (local .xlsx/.csv or Google Sheet). | standard; any; - | not applicable no user state to restore | executors/read_files_spreadsheet/ |
read_files_xlsx | reads local Excel files (.xlsx) (vectorial §2.1). | standard; any; - | not applicable no user state to restore | executors/read_files_xlsx/ |
share_files | grants access permissions to Drive files without duplicating them. | standard; any; - | undoable restoration procedure: module.reverse | executors/share_files/ |
write_files | persist records/text to local files (vectorial §2.1). | standard; any; linux, windows | undoable restoration procedure: restore_blob_backup, delete_created_paths | executors/write_files/ |
write_files_doc | append text to an existing Google Doc (.doc). | standard; any; - | undoable restoration procedure: module.reverse | executors/write_files_doc/ |
write_files_spreadsheet | writes a local sheet, creating it if missing. | standard; any; - | undoable restoration procedure: restore_blob_backup, delete_created_paths | executors/write_files_spreadsheet/ |
dirs (4)| Executor | Purpose | Contract | Undo | Location |
|---|---|---|---|---|
create_dirs | create directories (batch, even empty). | standard; any; linux, windows | undoable restoration procedure: delete_created_paths | executors/create_dirs/ |
delete_dirs | delete directories (empty or forced). | standard; any; linux, windows | undoable restoration procedure: module.reverse, restore_trashed_filesthe individual execution receipt determines actual reversibility | executors/delete_dirs/ |
find_dirs | find directories and compute aggregate metadata with a parallel recursive walk. | standard; any; linux, windows | not applicable no user state to restore | executors/find_dirs/ |
list_dirs | lists directories and files; recursive mode walks subdirectories in parallel. | standard; any; linux, windows | not applicable no user state to restore | executors/list_dirs/ |
packages (2)| Executor | Purpose | Contract | Undo | Location |
|---|---|---|---|---|
find_packages | checks installed software and resolves a human name to its registered id. | standard; any; linux, windows | not applicable no user state to restore | executors/find_packages/ |
install_packages | installs a program on the machine. | critical; any; windows, linux | not undoable no restoration procedure declared | executors/install_packages/ |
messages (4)| Executor | Purpose | Contract | Undo | Location |
|---|---|---|---|---|
move_messages | move messages between folders or labels. | standard; server; linux | undoable restoration procedure: swap_src_dst | executors/move_messages/ |
read_messages | reads IMAP messages combining time and text filters. | standard; any; - | not applicable no user state to restore | executors/read_messages/ |
send_messages | send email/Telegram and reply in-thread on Gmail. | standard; server; linux | not undoable no restoration procedure declared | executors/send_messages/ |
set_messages | add or remove labels on identified Gmail messages and record the effective deltas for undo. | standard; server; linux | undoable restoration procedure: module.reverse | executors/set_messages/ |
events (4)| Executor | Purpose | Contract | Undo | Location |
|---|---|---|---|---|
create_events | create calendar appointments. | standard; any; - | undoable restoration procedure: delete_events_by_id | executors/create_events/ |
delete_events | delete calendar events, by ids or time window. | standard; any; - | undoable restoration procedure: restore_event | executors/delete_events/ |
find_events_empty | find free slots in the calendar. | standard; any; - | not applicable no user state to restore | executors/find_events_empty/ |
read_events | reads calendar events. | standard; any; - | not applicable no user state to restore | executors/read_events/ |
contacts (2)| Executor | Purpose | Contract | Undo | Location |
|---|---|---|---|---|
find_contacts | search contacts in an external address book by name/email/phone. | standard; any; - | not applicable no user state to restore | executors/find_contacts/ |
read_contacts | read one contact from external address book. | standard; any; - | not applicable no user state to restore | executors/read_contacts/ |
places (2)| Executor | Purpose | Contract | Undo | Location |
|---|---|---|---|---|
find_places | find real-world places by text query. | standard; server; linux | not applicable no user state to restore | executors/find_places/ |
get_places | gets place name from GPS coordinates. | standard; server; linux | not applicable no user state to restore | executors/get_places/ |
processes (2)| Executor | Purpose | Contract | Undo | Location |
|---|---|---|---|---|
get_processes | processes and system health. | standard; any; linux, windows | not applicable no user state to restore | executors/get_processes/ |
run_processes | runs installed software with an exact receipt for the created process cohort. | critical; any; windows | undoable restoration procedure: module.reversethe individual execution receipt determines actual reversibility | executors/run_processes/ |
urls (5)| Executor | Purpose | Contract | Undo | Location |
|---|---|---|---|---|
find_urls | find and discover URLs and documents on the web. | standard; any; - | not applicable no user state to restore | executors/find_urls/ |
get_urls | gets data from HTTP/HTTPS URLs. | standard; server; linux | not applicable no user state to restore | executors/get_urls/ |
login_urls | authenticate HTTP on URLs, save 0600 cookies and an exact undo receipt. | standard; server; linux | undoable restoration procedure: module.reversethe individual execution receipt determines actual reversibility | executors/login_urls/ |
read_urls_html | reads web pages and extracts main text; PDF URLs extracted as text automatically. | standard; server; linux | not applicable no user state to restore | executors/read_urls_html/ |
read_urls_pdf | reads PDF documents from URLs and extracts text and metadata. | standard; any; - | not applicable no user state to restore | executors/read_urls_pdf/ |
numbers (1)| Executor | Purpose | Contract | Undo | Location |
|---|---|---|---|---|
describe_numbers | calculates descriptive statistics on a list of numbers. | standard; any; - | not applicable no user state to restore | executors/describe_numbers/ |
images (8)| Executor | Purpose | Contract | Undo | Location |
|---|---|---|---|---|
create_images_indices | index photos in `base_path` (incremental or rebuild). | standard; any; - | undoable restoration procedure: module.reverse | executors/create_images_indices/ |
delete_images_indices | delete the persistent unified image index. | standard; any; - | not undoable no restoration procedure declared | executors/delete_images_indices/ |
find_images_google_photos | finds photos/albums on Google Photos, ONLY those uploaded by Metnos. | standard; any; - | not applicable no user state to restore | executors/find_images_google_photos/ |
find_images_indices | search indexed photos by content, person or face. | standard; server; linux | not applicable no user state to restore | executors/find_images_indices/ |
find_images_web | finds web images from text or an image. Uses deterministic signals; local semantic ranking runs only without lexical signals. | standard; any; - | not applicable no user state to restore | executors/find_images_web/ |
get_images_google_photos | downloads photos from Google Photos into the workspace. | standard; any; - | undoable restoration procedure: delete_created_paths | executors/get_images_google_photos/ |
get_images_indices | gets unified image-index status for one corpus or all corpora. | standard; server; linux | not applicable no user state to restore | executors/get_images_indices/ |
write_images_google_photos | uploads local photos to Google Photos. | critical; any; - | not undoable no restoration procedure declared | executors/write_images_google_photos/ |
signatures (3)| Executor | Purpose | Contract | Undo | Location |
|---|---|---|---|---|
compute_signatures | compute or classify a signature; it can idempotently apply the safety seed. | standard; any; - | not applicable no user state to restore | executors/compute_signatures/ |
get_signatures | query safety-signature lists and status. | standard; any; - | not applicable no user state to restore | executors/get_signatures/ |
set_signatures | sets or removes signatures and records exact state for undo, except `forbidden`. | standard; any; - | undoable restoration procedure: module.reversethe individual execution receipt determines actual reversibility | executors/set_signatures/ |
texts (1)| Executor | Purpose | Contract | Undo | Location |
|---|---|---|---|---|
filter_texts_lines | filter text lines by pattern. | standard; any; - | not applicable no user state to restore | executors/filter_texts_lines/ |
proposals (1)| Executor | Purpose | Contract | Undo | Location |
|---|---|---|---|---|
get_proposals | reads introvertive proposals, including historical categories. | standard; server; linux | not applicable no user state to restore | executors/get_proposals/ |
persons (5)| Executor | Purpose | Contract | Undo | Location |
|---|---|---|---|---|
delete_persons | deletes persons/enrollment from the biometric registry (purge or by name/slug). | standard; any; - | undoable restoration procedure: restore_person | executors/delete_persons/ |
find_persons_indices | search photos of a registered person. | standard; server; linux | not applicable no user state to restore | executors/find_persons_indices/ |
get_persons | reads the biometric persons registry. | standard; server; linux | not applicable no user state to restore | executors/get_persons/ |
read_persons | reads local identity profiles. | standard; server; linux | not applicable no user state to restore | executors/read_persons/ |
set_persons | enroll a person in the named registry. | standard; any; - | not undoable no restoration procedure declared | executors/set_persons/ |
inputs (1)| Executor | Purpose | Contract | Undo | Location |
|---|---|---|---|---|
get_inputs | gets structured inputs (dialog/form). | standard; server; linux | not applicable no user state to restore | executors/get_inputs/ |
approval (1)| Executor | Purpose | Contract | Undo | Location |
|---|---|---|---|---|
get_approval | human consent (Approve/Reject), then runs the executor. | standard; server; linux | not applicable no user state to restore | executors/get_approval/ |
credentials (3)| Executor | Purpose | Contract | Undo | Location |
|---|---|---|---|---|
delete_credentials | delete credentials from storage (purge or bindings). | standard; any; - | not undoable no restoration procedure declared | executors/delete_credentials/ |
find_credentials | lists configured accounts and services (mail, api, cloud): metadata-only credentials. | standard; any; - | not applicable no user state to restore | executors/find_credentials/ |
set_credentials | encrypts credentials; defines the mandate. | standard; any; - | not undoable no restoration procedure declared | executors/set_credentials/ |
calendars (2)| Executor | Purpose | Contract | Undo | Location |
|---|---|---|---|---|
create_calendars | create a NEW Google calendar container (not an event). | standard; server; linux | undoable restoration procedure: delete_calendars_by_id | executors/create_calendars/ |
delete_calendars | delete Google calendar containers (DESTRUCTIVE: also removes the events inside); accepts the NAME. | standard; server; linux | not undoable no restoration procedure declared | executors/delete_calendars/ |
entries (4)| Executor | Purpose | Contract | Undo | Location |
|---|---|---|---|---|
compute_entries | compute an aggregated value (max/min/avg/sum/count) on entries. | standard; any; - | not applicable no user state to restore | executors/compute_entries/ |
filter_entries | filter entries by criteria. | standard; any; - | not applicable no user state to restore | executors/filter_entries/ |
group_entries | merges and deduplicates entries from multiple lists. | standard; any; - | not applicable no user state to restore | executors/group_entries/ |
sort_entries | sorts entries in memory. | standard; any; - | not applicable no user state to restore | executors/sort_entries/ |
lists (1)| Executor | Purpose | Contract | Undo | Location |
|---|---|---|---|---|
filter_lists | ops between TWO lists (A=from_step, B=with_step) on on_keys; delta = monitor dedup. | standard; any; - | not applicable no user state to restore | executors/filter_lists/ |
sites (5)| Executor | Purpose | Contract | Undo | Location |
|---|---|---|---|---|
act_sites | reach a goal inside a web session, with consent when sensitive. | critical; server; linux | not undoable no restoration procedure declared | executors/act_sites/ |
delete_sites | closes or revokes web sessions; all=true revokes all. | standard; server; linux | not undoable no restoration procedure declared | executors/delete_sites/ |
login_sites | autonomously reaches the sign-in area and uses encrypted credentials never exposed to the agent. | critical; server; linux | not undoable no restoration procedure declared | executors/login_sites/ |
open_sites | opens a persistent browser session and records only newly created sessions for undo. | standard; server; linux | undoable restoration procedure: module.reversethe individual execution receipt determines actual reversibility | executors/open_sites/ |
read_sites | reads text + REDACTED screenshot of an open web session (post-login if authenticated). | standard; server; linux | not applicable no user state to restore | executors/read_sites/ |
system / cross-domain (4)| Executor | Purpose | Contract | Undo | Location |
|---|---|---|---|---|
consult_frontier | consult an expert oracle for deep analysis. | standard; server; linux | not applicable no user state to restore | executors/consult_frontier/ |
get_location | tells where the current actor is. | standard; server; linux | not applicable no user state to restore | executors/get_location/ |
get_now | gets the current date and time in the configured timezone or an explicit IANA zone. | standard; server; linux, windows, macos | not applicable no user state to restore | executors/get_now/ |
undo_last_turn | cancel all reversible operations of the last user turn. | standard; server; linux | not undoable no restoration procedure declared | executors/undo_last_turn/ |