All tools
ToolWrite
Execute discovered Prism action
execute_prism_actionExecute a discovered read action, or preview then commit a granular write action with its commit token.
When to use it
You need the user's accessible workspace map or a compact context pack.
Typical workflow
Orient first, then choose the smallest task-specific tool.
What it returns
Workspace availability, recent objects, tool routing, or query-focused context.
Avoid using it when
You already have the exact source, draft, post, artifact, or portfolio id.
Advanced input contract
Agent hosts use this JSON Schema to validate the exact input shape.
View JSON Schema
{
"type": "object",
"properties": {
"action": {
"type": "string"
},
"mode": {
"type": "string",
"enum": [
"execute",
"preview",
"commit"
]
},
"payload": {
"type": "object"
},
"idempotencyKey": {
"type": "string"
},
"operationId": {
"type": "string",
"format": "uuid"
},
"commitToken": {
"type": "string"
}
},
"required": [
"action",
"mode"
],
"additionalProperties": false
}