Code examples accompany major API methods

Prose API documentation without working code examples asks developers to mentally simulate execution from a description — an error-prone process that slows integration and increases incorrect usage. The iso-25010:2011 analysability principle is clear: documentation that enables correct use without reading source is the standard. Pseudocode and incomplete snippets (missing imports, unrealistic parameter values, no expected output) fail this standard. Outdated examples that use deprecated APIs are actively harmful: they send developers down dead-end integration paths using methods that no longer exist.

Add at least one complete, runnable example for each major method — one that includes imports, realistic parameter values, and shows expected output:

### `client.query(prompt, options?)`

Sends a query and returns the completion.

```ts
import { createClient } from 'your-package'

const client = createClient({ apiKey: process.env.API_KEY })
const response = await client.query('Summarize this text', {
  model: 'gpt-4',
  maxTokens: 200
})
console.log(response.text) // "Here is a summary..."

Examples must use the current API signatures. If an example would fail when copy-pasted into a new file, it fails this check.