Standard ACP can describe a change from one tool call. It has no complete file list for one prompt turn.
This adapter supports the version-1 agentFileChangeReport extension. The client and adapter must both advertise it in _meta.jetbrains.air.capabilities during initialize.
The client adds this object to session/prompt:
{
"_meta": {
"jetbrains": {
"air": {
"agentFileChangeReportRequest": {
"version": 1,
"requestId": "a-unique-request-id"
}
}
}
}
}The request identifier has 1 to 128 characters. It can contain ASCII letters, digits, ., _, :, and -.
The adapter runs a hidden, read-only Codex fork after the main turn. The fork reports files that the main turn changed. Its output does not enter the visible transcript.
The adapter sends one session_info_update before the PromptResponse:
{
"sessionUpdate": "session_info_update",
"_meta": {
"jetbrains": {
"air": {
"version": 1,
"agentFileChangeReport": {
"version": 1,
"requestId": "a-unique-request-id",
"status": "reported",
"paths": ["/workspace/src/App.ts"],
"declaredComplete": true,
"truncated": false,
"uncertainty": "Optional short explanation"
}
}
}
}
}Each path is an absolute normalized path in the working directory or an additional workspace directory. The report contains no file content, diff, line count, or path order guarantee.
The adapter sends at most 1,024 paths. Each path has at most 4,096 characters. The serialized report has at most 256 KiB. The optional uncertainty has at most 2,000 characters.
The adapter marks the result unavailable after 30 seconds. It can also use cancelled, invalidOutput, notReported, or providerError as the reason. The main prompt still completes.
The client must match the request identifier. It must ignore a duplicate, stale, malformed, or unavailable report.
Rollback is outside this extension. This adapter does not advertise an undo or rollback command.