> ## Documentation Index
> Fetch the complete documentation index at: https://docs.oneshotagent.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Drivers and requirements

> Tell a goal quote how big each tool call is, and see what the account still needs.

## Set drivers

Add `drivers` to any use in `per_unit.uses` or `overhead.uses`:

```json theme={null}
{
  "per_unit": {
    "uses": [
      {
        "tool": "sms",
        "qty": 1,
        "max_attempts": 2,
        "drivers": { "recipients": 2, "segments": 3 }
      },
      {
        "tool": "voice",
        "qty": 1,
        "max_attempts": 3,
        "drivers": { "max_duration_minutes": 10 }
      }
    ]
  }
}
```

An omitted driver uses its default. An out-of-range value, an unknown driver or a tool the goal can't call returns `422 scope_unreadable` with `missing_fields`.

## Drivers by tool

| Tool | Driver | Default | Max |
| - | - | - | - |
| `email` | `recipients` | 1 | 500 |
| `sms` | `recipients` | 1 | 10 |
| `sms` | `segments` | 1 | 24 |
| `voice` | `max_duration_minutes` | 5 | 30 |
| `browser` | `max_steps` | 25 | 100 |
| `browser` | `login` | `false` | |
| `person_find` | `limit` | 25 | 500 |
| `person_find`, `person_profile`, `person_dossier` | `include_phone` | `false` | |
| `physical_mail` | `kind` | `postcard` | |
| `physical_mail` | `pages` | 1 | 60 |
| `physical_mail` | `color`, `double_sided` | `false` | |
| `build` | `sections` | 3 | 50 |
| `build` | `pages` | 0 | 8 |
| `predict` | `model` | `simulation` | |
| `predict` | `mode` | `pairwise` | |
| `predict` | `size` | 1 | |
| `predict` | `time_limit_s` | 20 | 120 |
| `solve` | `size` | 1 | |
| `solve` | `time_limit_s` | 30 | 300 |
| `commerce_buy` | `quantity` | 1 | 100 |

* `login`: `true` for a site the owner signed in to.
* `max_steps`: at least 25.
* `kind`: `postcard` or `letter`.
* `pages` on `build`: extra pages.
* `mode`: `pairwise` or `search`, for alignment.

### Size

| Model | `size` is | Max |
| - | - | - |
| `forecast` | Observations × horizon | 3,650,000 |
| `simulation` | Runs × (variables + outputs) | 6,000,000 |
| `alignment` | Total residues | 100,000 |
| Allocation | Items × options | |
| Packing | Item kinds × physical bins × dimensions | |
| Routing, scheduling | Estimated variables | |

## Unpriced

Build add-ons appear in `unpriced` as `quoted_tool`: live-quoted when the goal runs, capped by the remaining budget.

A `commerce_buy` use is priced only with [`purchase_limit_usdc`](https://docs.oneshotagent.com/api-reference/compute/create). Without it, the purchase runs only if the remaining budget covers its live price.

## Account requirements

Each entry in `context.requirements` has a `kind` and a `state`.

> [card] ready
>
> Nothing to do.

> [card] setup
>
> The owner pays or chooses at `action_url`.

> [card] owner
>
> Only the owner can act, at `action_url`.

| Kind | Reports |
| - | - |
| `sending_domain` | `setup.alternatives`: [registration](https://docs.oneshotagent.com/api-reference/email/domain-purchase.md) or [owner-managed setup](https://docs.oneshotagent.com/api-reference/email/domain-setup.md). `limit`: daily and remaining sends. `need_limit_exceeded` warns when the scope needs more. |
| `caller_number` | `setup`, with its own quote line. The goal holds until the owner buys the number. A goal never buys one. |
| `browser_login` | `owner` until the account has a logged-in browser profile. |
| `connection` | A system the objective names. `owner` until connected. |
| `specialist` | `owner`, with `need` and `question`. Starting the goal goes ahead on platform tools. |

A quote reserves and buys nothing. A caller without ownership proof gets `checked_at_payment: true` instead of account state.

### Browser logins

A `login` goal never browses logged out.

* A named `profile_id` must be the owner's logged-in profile.
* With none named, the goal uses the owner's only logged-in profile.
* If several could serve, the call is refused.
* If none is logged in, the goal holds.

### Specialists

`context.price.hires` lists matched specialists: `soul_slug`, `service_slug`, `need`, `price_usd`.

> [card] [Create a goal](https://docs.oneshotagent.com/api-reference/compute/create.md)

> [card] [Goal holds](https://docs.oneshotagent.com/api-reference/compute/status.md#setup-holds)

> [card] [Pricing](https://docs.oneshotagent.com/pricing.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.