# run-session-breathhold

`station__microgram__run-session-breathhold` · external (needs EXECUTION_BACKEND_URL configured) · domain `microgram` · pv-relevance `pv-core`

Apnea — the productive hold between inhale and exhale. Measures mid-session gas exchange (context absorbed vs artifacts produced) to detect held breath (no output) or hyperventilation (too much output, no absorption)

> **Note:** This tool routes through an external execution backend. If `EXECUTION_BACKEND_URL` is unset on the server, calls return JSON-RPC error `-32603 "Tool execution backend not configured"`. Tools with `backend: native` execute in-process and are always callable.

## Agent metadata

- `idempotent`: unknown
- `read_only`: unknown
- `expected_latency_ms`: unknown (not yet contract-tested)
- `cost_tokens_estimate`: unknown

## Input schema

- `writes` *integer* (required) — Input parameter: writes
- `reads` *integer* (required) — Input parameter: reads
- `skills_invoked` *integer* (required) — Input parameter: skills_invoked
- `minutes_elapsed` *integer* (required) — Input parameter: minutes_elapsed
- `errors_encountered` *integer* (required) — Input parameter: errors_encountered
- `tools_so_far` *integer* (required) — Input parameter: tools_so_far
- `files_modified` *integer* (required) — Input parameter: files_modified

## Example call

```json
POST /api/mcp
Content-Type: application/json

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "station__microgram__run-session-breathhold",
    "arguments": {
      "writes": 0,
      "reads": 0,
      "skills_invoked": 0,
      "minutes_elapsed": 0,
      "errors_encountered": 0,
      "tools_so_far": 0,
      "files_modified": 0
    }
  }
}
```

## Related

- [/tools](/tools) — all 3062 tools
- [/tools/microgram__run-session-breathhold](/tools/microgram__run-session-breathhold) — HTML page
- [/tools/microgram__run-session-breathhold/json](/tools/microgram__run-session-breathhold/json) — JSON form (agent-friendly)
- [/api/mcp](/api/mcp) — endpoint
- [/AGENTS.md](/AGENTS.md) — agent guide