Activity, notifications and file changes
On this page
Use activity to follow the work already started and retain cursors when reading later updates.
Use these tools
- Call the relevant read or status tool first.
- Review the target and required arguments.
- Run one intended action, with explicit human confirmation where required.
- Inspect status or re-read the affected resource afterward.
Inputs below describe the public contract. Your connected server’s current tool list is authoritative. Some tools require a particular host, target, inference mode or plan. Identifiers are values returned by earlier tools; do not invent them.
project_activity
What the project’s agent is doing.
Retain the returned activity position when asking for later events. Use detail only when you need more information.
| Argument | Required | Type or accepted values |
|---|
| projectId | No | string |
| after | No | string; maxLength 41 |
| limit | No | integer; minimum 1; maximum 200 |
| wait | No | integer; minimum 0; maximum 20 |
| detail | No | progress, thinking |
Operation: read-only.
Available setups: stdio, cloud project, cloud inference; stdio, cloud project, delegated inference; stdio, local project, cloud inference; stdio, local project, delegated inference; hosted HTTP.
The machine-readable tool contracts include nested argument schemas.
notifications
The organization’s notices.
Read account notices with the supported cursor and wait options; an empty update is normal.
| Argument | Required | Type or accepted values |
|---|
| after | No | string; maxLength 41 |
| wait | No | integer; minimum 0; maximum 20 |
Operation: read-only.
Available setups: stdio, cloud project, cloud inference; stdio, cloud project, delegated inference; stdio, local project, cloud inference; stdio, local project, delegated inference; hosted HTTP.
The machine-readable tool contracts include nested argument schemas.
file_changes
Files changed in the project’s preview.
Follow changed files for the intended project. Read relevant files before acting on a change notice.
| Argument | Required | Type or accepted values |
|---|
| projectId | No | string |
| after | No | string; maxLength 41 |
| wait | No | integer; minimum 0; maximum 20 |
Operation: read-only.
Available setups: stdio, cloud project, cloud inference; stdio, cloud project, delegated inference; hosted HTTP.
The machine-readable tool contracts include nested argument schemas.