Analyse pull sessions
pull_analyseAnalyses the sessions of one condition (one session, a list, or {"sessions": [...]}) together, and each alone, and returns the report: its label (significant; null, with the smallest effect these sessions could have found; unlabelled, with what is missing; or not testable) and the sentence behind it, the mean signed shift against three surrogate families, the placebos, the four cells (deliberate, programmed, luck and sync), intended against unintended changes, recovery, locking, and the report's hash. prereg registers the run; replication analyses a second set under it, beside the first; measure is phase (timing, the default) or state (the stance along the leader's declared direction, for two agents); surrogates (19 to 9,999, default 199) sets an unregistered run's draws a family, a registered run taking its pre-registration's; seed fixes them; a session of three or more generators is tested pair by pair, every ordered pair with its own ledger and the correction for their number, unless pairs is false; detail adds every pull record. It costs one unit for each 40,000 session-draws over a thousand events (a session's own reading counts as 200 draws), at least 1. A group costs its ordered pairs' worth. A call priced at more than 2 units is queued: the answer is 202 with a job id and its price, GET /api/agents/jobs/ (or the MCP tool job) says when it is done, and the whole report comes back as report.json beside a short verdict. A queued call is refused on the free plan with 402: its units buy only calls that answer at once, and queued jobs need the subscription. Sessions are not kept.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"sessions": "<sessions>"
},
"name": "pull_analyse"
}
}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. | |
| pairs | No | True to analyse performer pairs as well. | |
| detail | No | True to return the fuller per-session detail. | |
| prereg | No | The pre-registration the sessions were run under, to check the analysis against it. | |
| measure | No | The measure to analyse, by name. | |
| sessions | Yes | One session, a list of sessions, or {"sessions": [...]} of one condition, as JSON documents. | |
| surrogates | No | How many surrogate runs to draw for the null, 19 to 9999. | |
| replication | No | Sessions of a replication, analysed against the first set. |
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. |