---
title: "file_wait"
description: "Waits up to 20 seconds for a file's capabilities (`sql`, `search`, `diff`) to be ready and returns each one's status."
---

| Tool | Kind | Purpose |
| :-- | :-- | :-- |
| `file_wait` | read | Waits up to `timeoutSeconds` (1 to 20, default 20) for the named `capabilities` to be ready: `sql` (cells for `sql`), `search` (text for `document_search` and `document_read`) and `diff` (`sheet_diff`). Without `capabilities`, it waits for every capability the file's type has; naming one it lacks fails `invalid_input`. Returns `ready`, `timedOut`, the file's `status` and each named capability's `readiness`, with the same statuses as `get`. It returns at once when a capability reaches `too_large`, `limit_reached`, `failed` or `stored`. On `timedOut`, call it again. |