Who these pages are for
The operator
You run your own deployment. You set the host environment switches, the
budgets in
agent.config.json, and which harnesses exist at all.The owner
You want to know, before you rely on it, exactly what an agent can and
cannot do with your store, your ad accounts and your money.
The roles
The full tool list for each is on Tool permissions.
Rules every tool decision follows
Absent beats refusing
Absent beats refusing
A tool the operator did not enable is not registered at all. A tool that is
described to the model but refuses when called is an invitation the model
keeps accepting, so the code removes the tool instead. There are two
deliberate exceptions, listed on the permissions page, where a tool stays
registered and refuses.
Fail closed on money and secrets
Fail closed on money and secrets
A budget that is zero, negative, not a number, or unreadable is an error,
never “unlimited”. A spend ledger that cannot be read stops the session
rather than reading as empty.
A person approves each write, one at a time
A person approves each write, one at a time
Writes to the outside world (a store change, a commit, an email, a sheet)
and spends above a threshold wait for a person to approve that specific
call. Silence denies. Unattended runs have no one to ask, so the writes
that need asking are not available to them.
Budgets are caps, not targets
Budgets are caps, not targets
Every session has a dollar cap and a turn cap. Every coworker run has its
own. The model spend for the month has a cap per brand, and each paid
connector has its own monthly cap in its own currency.
Measured is not the same as reasoned
Measured is not the same as reasoned
The code keeps two kinds of note: what was observed against the real
service, with a date, and what is reasoned from documentation. These pages
keep the same distinction. A passing test suite is evidence about the
test fakes, not about the vendor.
These pages describe the code at the commit they were built from. Where a
behaviour has never been exercised against the real service, the page says
so.