Tool tree
gradeNot graded
list_pending_actionsAnswer
List everything on the treasury desk waiting to be actioned: vendor payments, renewals and agreements. Returns each item with the risk tier this site assigns it and the depth of human confirmation that tier requires. Read only.
View tool JSON
{
"name": "list_pending_actions",
"kind": "answer",
"impl": "imperative",
"description": "List everything on the treasury desk waiting to be actioned: vendor payments, renewals and agreements. Returns each item with the risk tier this site assigns it and the depth of human confirmation that tier requires. Read only.",
"inputSchema": {
"type": "object",
"properties": {
"query": {
"type": "string",
"description": "Optional filter over payee, memo, id or kind."
}
}
}
}inspect_actionAnswer
Read one pending action in full, including why it was placed in its risk tier and what would be required to confirm it. Read only.
View tool JSON
{
"name": "inspect_action",
"kind": "answer",
"impl": "imperative",
"description": "Read one pending action in full, including why it was placed in its risk tier and what would be required to confirm it. Read only.",
"inputSchema": {
"type": "object",
"properties": {
"action_id": {
"type": "string",
"description": "For example inv-2310."
}
},
"required": [
"action_id"
]
}
}stage_actionAction
Prepare a pending action for release: validate it, price it, and put it in front of the human at this desk. This is the whole of the work the agent can complete on its own. Staging moves no money and signs nothing, and can be undone by staging something else.
View tool JSON
{
"name": "stage_action",
"kind": "act",
"impl": "imperative",
"description": "Prepare a pending action for release: validate it, price it, and put it in front of the human at this desk. This is the whole of the work the agent can complete on its own. Staging moves no money and signs nothing, and can be undone by staging something else.",
"inputSchema": {
"type": "object",
"properties": {
"action_id": {
"type": "string",
"description": "The action to stage."
},
"reason": {
"type": "string",
"description": "Why this is being staged now, shown to the human."
}
},
"required": [
"action_id"
]
}
}release_fundsAction
Release a staged payment, or execute a staged signature. This tool is published so that its boundary is visible rather than discovered: it is real, it is understood, and it always refuses a non-human caller. Call request_human_confirmation instead.
View tool JSON
{
"name": "release_funds",
"kind": "act",
"impl": "imperative",
"description": "Release a staged payment, or execute a staged signature. This tool is published so that its boundary is visible rather than discovered: it is real, it is understood, and it always refuses a non-human caller. Call request_human_confirmation instead.",
"inputSchema": {
"type": "object",
"properties": {
"action_id": {
"type": "string"
},
"confirm": {
"type": "boolean",
"description": "Has no effect."
}
},
"required": [
"action_id"
]
}
}search_productsAnswer
Search the connected Shopify store and return matching products with title, price, image and variant id. Read only. Runs against the Storefront API when a store is connected, and a demo catalogue otherwise.
View tool JSON
{
"name": "search_products",
"kind": "answer",
"impl": "imperative",
"description": "Search the connected Shopify store and return matching products with title, price, image and variant id. Read only. Runs against the Storefront API when a store is connected, and a demo catalogue otherwise.",
"inputSchema": {
"type": "object",
"properties": {
"query": {
"type": "string",
"description": "What to search the catalogue for."
},
"limit": {
"type": "number",
"description": "Maximum results. Defaults to 5."
}
},
"required": [
"query"
]
}
}build_cartAction
Create a Shopify cart and add lines to it, then return the line items and subtotal. The cart checkout URL is deliberately withheld from this response: the Storefront Cart API cannot take a payment, and the checkout URL is the only route to one, so it is held in the page and released to the browser only after a human settles the gate. Call request_human_confirmation with the returned cart_id.
View tool JSON
{
"name": "build_cart",
"kind": "act",
"impl": "imperative",
"description": "Create a Shopify cart and add lines to it, then return the line items and subtotal. The cart checkout URL is deliberately withheld from this response: the Storefront Cart API cannot take a payment, and the checkout URL is the only route to one, so it is held in the page and released to the browser only after a human settles the gate. Call request_human_confirmation with the returned cart_id.",
"inputSchema": {
"type": "object",
"properties": {
"lines": {
"type": "array",
"description": "The variants to add.",
"items": {
"type": "object",
"properties": {
"variantId": {
"type": "string"
},
"quantity": {
"type": "number"
}
},
"required": [
"variantId"
]
}
}
},
"required": [
"lines"
]
}
}request_human_confirmationAction
Hand the staged action, or a built cart, to the human at this desk and open the confirmation gate in the page, at the depth the risk tier requires. Returns immediately with PENDING_HUMAN. The calling agent cannot resolve this itself. Poll check_confirmation to see the outcome. Pass action_id for a treasury action, or cart_id for a Shopify cart.
View tool JSON
{
"name": "request_human_confirmation",
"kind": "act",
"impl": "imperative",
"description": "Hand the staged action, or a built cart, to the human at this desk and open the confirmation gate in the page, at the depth the risk tier requires. Returns immediately with PENDING_HUMAN. The calling agent cannot resolve this itself. Poll check_confirmation to see the outcome. Pass action_id for a treasury action, or cart_id for a Shopify cart.",
"inputSchema": {
"type": "object",
"properties": {
"action_id": {
"type": "string"
},
"cart_id": {
"type": "string",
"description": "A cart id returned by build_cart."
},
"message": {
"type": "string",
"description": "A short note to show the human, in your own words."
}
}
}
}check_confirmationAnswer
Check whether the human has settled the open confirmation. Returns PENDING_HUMAN, CONFIRMED or DECLINED. Read only, and safe to poll.
View tool JSON
{
"name": "check_confirmation",
"kind": "answer",
"impl": "imperative",
"description": "Check whether the human has settled the open confirmation. Returns PENDING_HUMAN, CONFIRMED or DECLINED. Read only, and safe to poll.",
"inputSchema": {
"type": "object",
"properties": {}
}
}get_receiptAnswer
Retrieve the sealed record of a confirmed action: who confirmed it, at what depth, when, and the audit chain position it was written to. Read only.
View tool JSON
{
"name": "get_receipt",
"kind": "answer",
"impl": "imperative",
"description": "Retrieve the sealed record of a confirmed action: who confirmed it, at what depth, when, and the audit chain position it was written to. Read only.",
"inputSchema": {
"type": "object",
"properties": {}
}
}verify_recordAnswer
Recompute the audit chain for this session and report whether the record has been altered since it was written. Read only.
View tool JSON
{
"name": "verify_record",
"kind": "answer",
"impl": "imperative",
"description": "Recompute the audit chain for this session and report whether the record has been altered since it was written. Read only.",
"inputSchema": {
"type": "object",
"properties": {}
}
}