Freigeben
confirm_business_changeCommit exactly the change on a trusted human Owner card. App-only: models must never invoke this tool, construct proof or request hidden metadata in chat. A chat “yes” is not the card’s human confirmation; present the existing card instead.
Keep one card intact
The trusted UI returns that card’s kind and approvalToken together. For kind=goal, pass its proposalId: this covers stored goal and General/role-budget requests. For kind=policy, pass its exact signed candidate instead. Never combine two cards, supply both selectors, patch the displayed change or alter signed revision/deadline data.
Authority remains current
Requires policy:write and current Owner/module access; policies also need policy:read. Role-budget retirement additionally needs existing work:read/write, accounting:read and Workspace/Accounting write authority. Each workflow validates signature, tenant, principal, grant and expiry. Goal changes, budget archives and policies also validate revision.
Read the result without retrying
approved records a goal/budget commit; confirmed records a policy commit with revision/policyVersion. not_applied caused no new effect. not_verified or a lost reply may still mean a commit occurred. pending_owner, expired or not_found do not prove success.
Never retry confirmation. Read get_business_change(proposalId), then the goal/budget by resource ID. For policies use the separately authorized Policy connection to read get_policy(kind=policy,moduleKey,policyKey). Receipts do not prove current state, and current state alone cannot attribute this attempt’s effect.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| kind | Yes | Card variant from hidden metadata. goal covers stored goal and General/role-budget proposals; policy covers exact policy replacements. | |
| candidate | No | Exact candidate from the matching card's hidden metadata, including the change and expiry. The trusted UI copies every field unchanged; never reconstruct it from chat. | |
| proposalId | No | Goal variant only: exact proposal ID from the same card as approvalToken. | |
| approvalToken | Yes | Opaque signed proof from this same human card’s hidden metadata. The trusted UI returns it unchanged; never construct it or request it from chat. |