Executor catalog

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.

The list below comes from 100 source manifests in the distribution: it describes capabilities, not their live admission. Every capability must pass Executor Birth before use. It does not include in-process capabilities, executors added by skills, or executors created within one installation. To see everything the instance can use right now, open Settings → Lifecycle → Executors in web chat.

First installation — candidate under test. On a new instance, the installer can adopt the exact catalog of an accepted distribution after checking integrity, structure, and authorization. Each item receives a local receipt distinguishing adoption from dynamic tests: this is not a new qualifying F5 admission. New or modified components follow the full Executor Birth checks.

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. The final receipt distinguishes a performed action from an already-satisfied state: an application that was already closed is neither counted nor announced as newly closed.

Choose once, until the PC restarts, or always until revoked. With either reusable choice, closing and reopening the application does not require another approval. Permission covers that application on that PC, including when switching between web chat and Telegram: it does not enable automatic startup, installation, or forced closure. Previous approvals are not converted automatically. Permanent permission can be revoked through the administrative grant registry; there is not yet a chat button for revocation.

Where to search for nearby places

For a search near you, Metnos uses your available location; when you ask for places near the server, it uses the server's location instead. Explicit city names and coordinates remain the requested centre. The server name is not searched as a city. Distances depend on location accuracy and the configured geographic services' results; an unreachable service does not mean there are no nearby places.

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.

Which actions can be undone

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?”

undoable: 26; not undoable: 20; not applicable: 54.

Executors declared undoable (26)

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

Domain: files (21)

ExecutorPurposeContractUndoLocation
change_files_formatconverts 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_filescompress files into a new zip/tar/gz archive.standard; any; linux, windowsundoable
restoration procedure: delete_created_paths
executors/compress_files/
compute_files_loccomputes source-code LOC statistics, walking directory trees in parallel.standard; any; linux, windowsnot applicable
no user state to restore
executors/compute_files_loc/
create_files_doccreates a new Google Doc.standard; any; -undoable
restoration procedure: delete_files_by_id
executors/create_files_doc/
create_files_spreadsheetcreates and populates a new local .xlsx.standard; any; linux, windowsundoable
restoration procedure: delete_created_paths, delete_files_by_id
executors/create_files_spreadsheet/
delete_filesdelete files after a verified backup.standard; any; linux, windowsundoable
restoration procedure: restore_blob_backup, restore_trashed_files
executors/delete_files/
find_filessearch files by pattern with a parallel recursive walk.standard; any; linux, windowsnot applicable
no user state to restore
executors/find_files/
find_files_hashfinds exact duplicates through complete SHA-256; broad file types expand into globs.standard; any; linux, windowsnot applicable
no user state to restore
executors/find_files_hash/
get_filesgets size, dates, and EXIF for KNOWN files.standard; any; linux, windowsnot applicable
no user state to restore
executors/get_files/
move_filesmove or rename files in batch.standard; any; linux, windowsundoable
restoration procedure: swap_src_dst, restore_blob_backup, delete_created_dirs
executors/move_files/
organize_filesorganizes files with a closed policy, SHA-256, and a frozen plan.critical; server; linuxundoable
restoration procedure: module.reverse
the individual execution receipt determines actual reversibility
executors/organize_files/
read_filesreads local or remote files, including PDF/DOCX/XLSX/CSV.standard; any; linux, windowsnot applicable
no user state to restore
executors/read_files/
read_files_csvreads local CSV files (vectorial §2.1).standard; any; -not applicable
no user state to restore
executors/read_files_csv/
read_files_docreads text from Google Doc.standard; any; -not applicable
no user state to restore
executors/read_files_doc/
read_files_ocrextracts 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_spreadsheetreads a spreadsheet rows (local .xlsx/.csv or Google Sheet).standard; any; -not applicable
no user state to restore
executors/read_files_spreadsheet/
read_files_xlsxreads local Excel files (.xlsx) (vectorial §2.1).standard; any; -not applicable
no user state to restore
executors/read_files_xlsx/
share_filesgrants access permissions to Drive files without duplicating them.standard; any; -undoable
restoration procedure: module.reverse
executors/share_files/
write_filespersist records/text to local files (vectorial §2.1).standard; any; linux, windowsundoable
restoration procedure: restore_blob_backup, delete_created_paths
executors/write_files/
write_files_docappend text to an existing Google Doc (.doc).standard; any; -undoable
restoration procedure: module.reverse
executors/write_files_doc/
write_files_spreadsheetwrites a local sheet, creating it if missing.standard; any; -undoable
restoration procedure: restore_blob_backup, delete_created_paths
executors/write_files_spreadsheet/

Domain: dirs (4)

ExecutorPurposeContractUndoLocation
create_dirscreate directories (batch, even empty).standard; any; linux, windowsundoable
restoration procedure: delete_created_paths
executors/create_dirs/
delete_dirsdelete directories (empty or forced).standard; any; linux, windowsundoable
restoration procedure: module.reverse, restore_trashed_files
the individual execution receipt determines actual reversibility
executors/delete_dirs/
find_dirsfind directories and compute aggregate metadata with a parallel recursive walk.standard; any; linux, windowsnot applicable
no user state to restore
executors/find_dirs/
list_dirslists directories and files; recursive mode walks subdirectories in parallel.standard; any; linux, windowsnot applicable
no user state to restore
executors/list_dirs/

Domain: packages (2)

ExecutorPurposeContractUndoLocation
find_packageschecks installed software and resolves a human name to its registered id.standard; any; linux, windowsnot applicable
no user state to restore
executors/find_packages/
install_packagesinstalls a program on the machine.critical; any; windows, linuxnot undoable
no restoration procedure declared
executors/install_packages/

Domain: messages (4)

ExecutorPurposeContractUndoLocation
move_messagesmove messages between folders or labels.standard; server; linuxundoable
restoration procedure: swap_src_dst
executors/move_messages/
read_messagesreads IMAP messages combining time and text filters.standard; any; -not applicable
no user state to restore
executors/read_messages/
send_messagessend email/Telegram and reply in-thread on Gmail.standard; server; linuxnot undoable
no restoration procedure declared
executors/send_messages/
set_messagesadd or remove labels on identified Gmail messages and record the effective deltas for undo.standard; server; linuxundoable
restoration procedure: module.reverse
executors/set_messages/

Domain: events (4)

ExecutorPurposeContractUndoLocation
create_eventscreate calendar appointments.standard; any; -undoable
restoration procedure: delete_events_by_id
executors/create_events/
delete_eventsdelete calendar events, by ids or time window.standard; any; -undoable
restoration procedure: restore_event
executors/delete_events/
find_events_emptyfind free slots in the calendar.standard; any; -not applicable
no user state to restore
executors/find_events_empty/
read_eventsreads calendar events.standard; any; -not applicable
no user state to restore
executors/read_events/

Domain: contacts (2)

ExecutorPurposeContractUndoLocation
find_contactssearch contacts in an external address book by name/email/phone.standard; any; -not applicable
no user state to restore
executors/find_contacts/
read_contactsread one contact from external address book.standard; any; -not applicable
no user state to restore
executors/read_contacts/

Domain: places (2)

ExecutorPurposeContractUndoLocation
find_placesfind real-world places by text query.standard; server; linuxnot applicable
no user state to restore
executors/find_places/
get_placesgets place name from GPS coordinates.standard; server; linuxnot applicable
no user state to restore
executors/get_places/

Domain: processes (3)

ExecutorPurposeContractUndoLocation
get_processesprocesses and system health.standard; any; linux, windowsnot applicable
no user state to restore
executors/get_processes/
run_processesruns installed software with an exact receipt for the created process cohort.critical; any; windowsundoable
restoration procedure: module.reverse
the individual execution receipt determines actual reversibility
executors/run_processes/
set_processescloses registered Windows desktop applications.critical; any; windowsnot undoable
no restoration procedure declared
executors/set_processes/

Domain: urls (5)

ExecutorPurposeContractUndoLocation
find_urlsfind and discover URLs and documents on the web.standard; any; -not applicable
no user state to restore
executors/find_urls/
get_urlsgets data from HTTP/HTTPS URLs.standard; server; linuxnot applicable
no user state to restore
executors/get_urls/
login_urlsauthenticate HTTP on URLs, save 0600 cookies and an exact undo receipt.standard; server; linuxundoable
restoration procedure: module.reverse
the individual execution receipt determines actual reversibility
executors/login_urls/
read_urls_htmlreads web pages and extracts main text; PDF URLs extracted as text automatically.standard; server; linuxnot applicable
no user state to restore
executors/read_urls_html/
read_urls_pdfreads PDF documents from URLs and extracts text and metadata.standard; any; -not applicable
no user state to restore
executors/read_urls_pdf/

Domain: numbers (1)

ExecutorPurposeContractUndoLocation
describe_numberscalculates descriptive statistics on a list of numbers.standard; any; -not applicable
no user state to restore
executors/describe_numbers/

Domain: images (8)

ExecutorPurposeContractUndoLocation
create_images_indicesbuilds or refreshes the photo index through resumable LRE units; records undecodable images without stopping other photos.standard; any; -not undoable
no restoration procedure declared
executors/create_images_indices/
delete_images_indicesdelete the persistent unified image index.standard; any; -not undoable
no restoration procedure declared
executors/delete_images_indices/
find_images_google_photosfinds 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_indicessearch indexed photos by content, person or face.standard; server; linuxnot applicable
no user state to restore
executors/find_images_indices/
find_images_webfinds 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_photosdownloads photos from Google Photos into the workspace.standard; any; -undoable
restoration procedure: delete_created_paths
executors/get_images_google_photos/
get_images_indicesget unified image-index status for one corpus or all corpora.standard; server; linuxnot applicable
no user state to restore
executors/get_images_indices/
write_images_google_photosuploads local photos to Google Photos.critical; any; -not undoable
no restoration procedure declared
executors/write_images_google_photos/

Domain: signatures (3)

ExecutorPurposeContractUndoLocation
compute_signaturescompute or classify a signature; it can idempotently apply the safety seed.standard; any; -not applicable
no user state to restore
executors/compute_signatures/
get_signaturesquery safety-signature lists and status.standard; any; -not applicable
no user state to restore
executors/get_signatures/
set_signaturessets or removes signatures and records exact state for undo, except `forbidden`.standard; any; -undoable
restoration procedure: module.reverse
the individual execution receipt determines actual reversibility
executors/set_signatures/

Domain: texts (1)

ExecutorPurposeContractUndoLocation
filter_texts_linesfilter text lines by pattern.standard; any; -not applicable
no user state to restore
executors/filter_texts_lines/

Domain: proposals (1)

ExecutorPurposeContractUndoLocation
get_proposalsreads introvertive proposals, including historical categories.standard; server; linuxnot applicable
no user state to restore
executors/get_proposals/

Domain: persons (5)

ExecutorPurposeContractUndoLocation
delete_personsdeletes persons/enrollment from the biometric registry (purge or by name/slug).standard; any; -undoable
restoration procedure: restore_person
executors/delete_persons/
find_persons_indicessearch photos of a registered person.standard; server; linuxnot applicable
no user state to restore
executors/find_persons_indices/
get_personsreads the biometric persons registry.standard; server; linuxnot applicable
no user state to restore
executors/get_persons/
read_personsreads local identity profiles.standard; server; linuxnot applicable
no user state to restore
executors/read_persons/
set_personsenroll a person in the named registry.standard; any; -not undoable
no restoration procedure declared
executors/set_persons/

Domain: workflows (2)

ExecutorPurposeContractUndoLocation
find_workflowslist automation runs by state and branch.standard; any; linuxnot applicable
no user state to restore
executors/find_workflows/
run_workflowsstart an automation already present in the repository; NOT reversible.standard; any; linuxnot undoable
no restoration procedure declared
executors/run_workflows/

Domain: inputs (1)

ExecutorPurposeContractUndoLocation
get_inputsgets structured inputs (dialog/form).standard; server; linuxnot applicable
no user state to restore
executors/get_inputs/

Domain: approval (1)

ExecutorPurposeContractUndoLocation
get_approvalhuman consent (Approve/Reject), then runs the executor.standard; server; linuxnot applicable
no user state to restore
executors/get_approval/

Domain: credentials (3)

ExecutorPurposeContractUndoLocation
delete_credentialsdelete credentials from storage (purge or bindings).standard; any; -not undoable
no restoration procedure declared
executors/delete_credentials/
find_credentialslists configured accounts and services (mail, api, cloud): metadata-only credentials.standard; any; -not applicable
no user state to restore
executors/find_credentials/
set_credentialsencrypts credentials; defines the mandate.standard; any; -not undoable
no restoration procedure declared
executors/set_credentials/

Domain: issues (5)

ExecutorPurposeContractUndoLocation
create_issuesopen an issue in the repository.standard; any; linuxundoable
restoration procedure: delete_issues_by_id
executors/create_issues/
delete_issuesclose an issue by number; on GitHub an issue is closed, never deleted.standard; any; linuxnot undoable
no restoration procedure declared
executors/delete_issues/
find_issueslist the issues of a repository by state, labels and date.standard; any; linuxnot applicable
no user state to restore
executors/find_issues/
read_issuesread one issue by number, with its comments when requested.standard; any; linuxnot applicable
no user state to restore
executors/read_issues/
set_issueschange state, labels, assignees or milestone of an issue.standard; any; linuxnot undoable
no restoration procedure declared
executors/set_issues/

Domain: pulls (4)

ExecutorPurposeContractUndoLocation
change_pullsmerge a pull request into its target branch; NOT reversible.standard; any; linuxnot undoable
no restoration procedure declared
executors/change_pulls/
find_pullslist pull requests by state and branches.standard; any; linuxnot applicable
no user state to restore
executors/find_pulls/
read_pullsread one pull request by number, with the diff when requested.standard; any; linuxnot applicable
no user state to restore
executors/read_pulls/
set_pullsapprove a pull request, request changes, or change its state.standard; any; linuxnot undoable
no restoration procedure declared
executors/set_pulls/

Domain: comments (2)

ExecutorPurposeContractUndoLocation
create_commentswrite a comment on issues or pull requests.standard; any; linuxundoable
restoration procedure: delete_comments_by_id
executors/create_comments/
delete_commentsdelete one or more comments by identifier.standard; any; linuxnot undoable
no restoration procedure declared
executors/delete_comments/

Domain: calendars (2)

ExecutorPurposeContractUndoLocation
create_calendarscreate a NEW Google calendar container (not an event).standard; server; linuxundoable
restoration procedure: delete_calendars_by_id
executors/create_calendars/
delete_calendarsdelete Google calendar containers (DESTRUCTIVE: also removes the events inside); accepts the NAME.standard; server; linuxnot undoable
no restoration procedure declared
executors/delete_calendars/

Domain: entries (4)

ExecutorPurposeContractUndoLocation
compute_entriescompute an aggregated value (max/min/avg/sum/count) on entries.standard; any; -not applicable
no user state to restore
executors/compute_entries/
filter_entriesfilter entries by criteria.standard; any; -not applicable
no user state to restore
executors/filter_entries/
group_entriesmerges and deduplicates entries from multiple lists.standard; any; -not applicable
no user state to restore
executors/group_entries/
sort_entriessorts entries in memory.standard; any; -not applicable
no user state to restore
executors/sort_entries/

Domain: lists (1)

ExecutorPurposeContractUndoLocation
filter_listsops 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/

Domain: sites (5)

ExecutorPurposeContractUndoLocation
act_sitesreach a goal inside a web session, with consent when sensitive.critical; server; linuxnot undoable
no restoration procedure declared
executors/act_sites/
delete_sitescloses or revokes web sessions; all=true revokes all.standard; server; linuxnot undoable
no restoration procedure declared
executors/delete_sites/
login_sitesreaches sign-in and uses encrypted credentials never exposed to the agent. Tries supported local CAPTCHA solving, then requests intervention; OTP stays separate.critical; server; linuxnot undoable
no restoration procedure declared
executors/login_sites/
open_sitesopens a persistent browser session and records only newly created sessions for undo.standard; server; linuxundoable
restoration procedure: module.reverse
the individual execution receipt determines actual reversibility
executors/open_sites/
read_sitesreads text + REDACTED screenshot of an open web session (post-login if authenticated).standard; server; linuxnot applicable
no user state to restore
executors/read_sites/

Domain: system / cross-domain (4)

ExecutorPurposeContractUndoLocation
consult_frontierconsult an expert oracle for deep analysis.standard; server; linuxnot applicable
no user state to restore
executors/consult_frontier/
get_locationreads the geographical location of the user or server.standard; server; linuxnot applicable
no user state to restore
executors/get_location/
get_nowgets the current date and time in the configured timezone or an explicit IANA zone.standard; server; linux, windows, macosnot applicable
no user state to restore
executors/get_now/
undo_last_turncancel all reversible operations of the last user turn.standard; server; linuxnot undoable
no restoration procedure declared
executors/undo_last_turn/