docs: document deploy list cursor

Author: MajorTal

cli/llms-cli.txt

@@ -280,7 +280,7 @@ run402 deploy resolve --project prj_123 --url https://example.com/events?utm=x#h
 run402 deploy resolve --project prj_123 --host example.com --path /events --method GET
 ```
 
-`list` returns `{ operations: [...], cursor }` (page through with `--cursor` against the gateway when the cursor is non-null). `events` returns the same `DeployEvent` shapes that `apply` emits inline.
+`list` returns `{ operations: [...], cursor }`; the SDK and MCP `deploy_list` surface accept that cursor for pagination when it is non-null. `events` returns the same `DeployEvent` shapes that `apply` emits inline.
 
 `release active` and `release get` return `{ "status": "ok", "release": ReleaseInventory }`. Inventories include release metadata, `state_kind` (`current_live`, `effective`, or `desired_manifest`), site paths (capped by `--site-limit`), `static_public_paths` when returned, functions, secret keys only, subdomains, materialized routes, applied migrations, `release_generation`, `static_manifest_sha256`, nullable `static_manifest_metadata`, and inventory warnings when returned. `site.paths` is the release static asset inventory; `static_public_paths[]` is the browser reachability inventory with `public_path`, `asset_path`, `reachability_authority`, `direct`, cache class, and content type. `static_manifest_metadata: null` means unavailable, not zero; when present it includes `file_count`, `total_bytes`, `cache_classes`, `cache_class_sources`, and `spa_fallback`.
 

llms-mcp.txt

@@ -257,7 +257,7 @@ For TypeScript autocomplete, `npm install @run402/functions` in your editor's pr
 - **`add_custom_domain`** / **`list_custom_domains`** / **`check_domain_status`** / **`remove_custom_domain`** — point your own domain at a Run402 subdomain.
 - **`deploy`** — the unified deploy primitive (v1.34+). Pass a `ReleaseSpec` with replace-vs-patch semantics per resource and value-free `secrets.require` / `secrets.delete`. Returns the deploy operation and structured warnings; stops before upload/commit on confirmation-required warnings unless `allow_warnings` is true.
 - **`deploy_resume`** — resume a deploy operation by `operation_id`.
-- **`deploy_list`** — list recent deploy operations. Params: `project_id`, `limit?`.
+- **`deploy_list`** — list recent deploy operations. Params: `project_id`, `limit?`, `cursor?`.
 - **`deploy_events`** — fetch recorded events for a deploy operation. Params: `project_id`, `operation_id`.
 - **`deploy_release_get`** — fetch release inventory by id. Params: `project_id`, `release_id`, `site_limit?`. Returns release metadata, state kind, site paths, `static_public_paths` browser reachability entries, functions, secret keys, subdomains, materialized routes, applied migrations, `release_generation`, `static_manifest_sha256`, nullable `static_manifest_metadata` (`file_count`, `total_bytes`, `cache_classes`, `cache_class_sources`, `spa_fallback`), and warnings when returned. `site.paths` is release static assets; `static_public_paths[]` carries `public_path`, `asset_path`, `reachability_authority`, and `direct`.
 - **`deploy_release_active`** — fetch the current-live release inventory. Params: `project_id`, `site_limit?`.

sdk/llms-sdk.txt

@@ -599,7 +599,7 @@ apply(spec, opts?): Promise<DeployResult>
 start(spec, opts?): Promise<DeployOperation>
 resume(operationId, opts?): Promise<DeployResult>
 status(operationId, opts?: { project? }): Promise<OperationSnapshot>
-list(opts: { project, limit? }): Promise<DeployListResponse>
+list(opts: { project, limit?, cursor? }): Promise<DeployListResponse>
 events(operationId, opts: { project }): Promise<DeployEventsResponse>   // recorded so far
 resolve(opts: DeployResolveOptions): Promise<DeployResolveResponse>     // URL-first or host/path public diagnostics
 getRelease(opts: { project, releaseId, siteLimit? }): Promise<ReleaseInventory>