Price a pull call
pull_costPrices a call without making it: give the arguments of pull_twin (a twin document, or condition, coupling, planted, field, sessions as a number and seed; nothing at all is the default twin), of pull_analyse (a sessions document, with prereg, replication, surrogates and pairs) or of pull_lab (a theory, one-dimensional or with a model, or reference skyrme or hopfion). The engine counts the document without running it: a twin's or an analysis's sessions, events, draws, work and an estimate of CPU-seconds (cpu_pairs and cpu_note say which part of a group's estimate repeats for each pair), a lab theory's lattice, the steps priced and its CPU-seconds. The answer adds what this service makes of the count: for, the call it priced; units, what that call would be charged, null when it would be refused (a queued call's price is the engine's count, so a lattice or a system generator, which the formula that routes a call cannot see, is priced as it will be); queued, whether it would be queued (202) rather than answer at once; within_limits, and when it is false the limit it breaks. A one-dimensional theory is counted too and is queued like any theory (an ordinary one at 1 unit), and the one-dimensional references, which are not counted, are refused here by name. Runs and renders nothing. Costs no units.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "pull_cost"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| seed | No | A whole number that makes the run reproducible: the same seed and inputs give the same answer. | |
| twin | No | A twin document written inline, as for pull_twin. | |
| field | No | The field to price in, by name. | |
| pairs | No | True to price the pair analysis as well. | |
| prereg | No | A pre-registration, to price an analysis under it. | |
| theory | No | A theory document, to price a lab run. | |
| planted | No | The planted effect as a pair of numbers between -2 and 2. | |
| coupling | No | Coupling to price at, 0 to 1. | |
| sessions | No | A session count for a twin run, or the sessions of an analysis to price. | |
| condition | No | The condition to price: P or R followed by 1 to 4. | |
| reference | No | True, or a reference name, to price the lab's reference run. | |
| surrogates | No | Surrogate runs to price, 19 to 9999. | |
| replication | No | Replication sessions, to price an analysis with them. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ms | No | Milliseconds the run took. | |
| job | Yes | The job id; the job tool reads it. | |
| verb | No | The tool that made it. | |
| files | No | Files made, each with a name, type, size and a signed URL. | |
| units | No | Units this call cost. | |
| result | No | The engine's own answer, a JSON document. | |
| status | No | queued when the job runs in the background. |