Skip to content

Action Taxonomy

The Action Taxonomy is a hierarchical vocabulary of action types, organized by domain. Each action type has a default risk level. Implementations may escalate risk levels based on context but must not downgrade them.

The canonical machine-readable taxonomy is defined in spec/taxonomy/action-types.json.

Action typeDescriptionDefault risk
filesystem.file.createCreate a filelow
filesystem.file.readRead a filelow
filesystem.file.modifyModify a filemedium
filesystem.file.deleteDelete a filehigh
filesystem.file.moveMove or rename a filemedium
filesystem.directory.createCreate a directorylow
filesystem.directory.deleteDelete a directoryhigh
Action typeDescriptionDefault risk
system.application.launchLaunch an applicationlow
system.application.controlControl an application via UI automationmedium
system.settings.modifyModify system or app settingshigh
system.command.executeExecute a shell commandhigh
system.browser.navigateNavigate to a URLlow
system.browser.form_submitSubmit a web formmedium
system.browser.authenticateLog into a servicehigh
Action typeDescriptionDefault risk
communication.email.sendSend an emailhigh
communication.email.draftCreate a draft emailmedium
communication.email.readRead email contentlow
communication.email.deleteDelete an emailhigh
communication.message.sendSend a chat message (Slack, Teams, etc.)high
communication.calendar.createCreate a calendar eventmedium
communication.calendar.modifyModify a calendar eventmedium
communication.calendar.deleteDelete a calendar eventhigh
Action typeDescriptionDefault risk
document.file.createCreate a new documentlow
document.file.modifyModify document contentmedium
document.file.deleteDelete a documenthigh
document.file.shareShare a document with othershigh
document.spreadsheet.modify_cellModify spreadsheet cell valuesmedium
document.spreadsheet.modify_formulaModify spreadsheet formulashigh
document.spreadsheet.modify_structureAdd/remove sheets, rows, columnsmedium
document.presentation.modify_slideModify presentation slide contentmedium
Action typeDescriptionDefault risk
financial.payment.initiateInitiate a payment or purchasecritical
financial.payment.authorizeAuthorize a pending paymentcritical
financial.subscription.createCreate a subscriptioncritical
financial.subscription.cancelCancel a subscriptionhigh
financial.booking.createBook travel, accommodation, etc.high
financial.booking.cancelCancel a bookinghigh
Action typeDescriptionDefault risk
data.api.readRead data from an external APIlow
data.api.writeWrite data to an external APImedium
data.api.deleteDelete data via an external APIhigh
data.database.queryQuery a databaselow
data.database.modifyModify database recordshigh

The unknown action type (default risk: medium) serves as a fallback for any action that cannot be classified. The original tool name or method identifier should be preserved in action.target for later classification.

Implementations may define action types beyond those listed above. Custom action types must use a reverse-domain prefix to avoid collisions with the standard taxonomy:

com.acme.crm.lead.create
io.example.ml.model.deploy

Custom types must declare a default risk level. The unknown fallback still applies for any action that cannot be classified.