docs: document bootstrap total cap and exec log/notify behavior

This commit is contained in:
Gustavo Madeira Santana
2026-02-14 18:36:35 -05:00
parent dec6859702
commit 5b23999404
5 changed files with 20 additions and 5 deletions
+4 -1
View File
@@ -46,6 +46,7 @@ Config (preferred):
- `tools.exec.timeoutSec` (default 1800)
- `tools.exec.cleanupMs` (default 1800000)
- `tools.exec.notifyOnExit` (default true): enqueue a system event + request heartbeat when a backgrounded exec exits.
- `tools.exec.notifyOnExitEmptySuccess` (default false): when true, also enqueue completion events for successful backgrounded runs that produced no output.
## process tool
@@ -66,7 +67,9 @@ Notes:
- Session logs are only saved to chat history if you run `process poll/log` and the tool result is recorded.
- `process` is scoped per agent; it only sees sessions started by that agent.
- `process list` includes a derived `name` (command verb + target) for quick scans.
- `process log` uses line-based `offset`/`limit` (omit `offset` to grab the last N lines).
- `process log` uses line-based `offset`/`limit`.
- When both `offset` and `limit` are omitted, it returns the last 200 lines and includes a paging hint.
- When `offset` is provided and `limit` is omitted, it returns from `offset` to the end (not capped to 200).
## Examples
+11
View File
@@ -581,6 +581,16 @@ Max characters per workspace bootstrap file before truncation. Default: `20000`.
}
```
### `agents.defaults.bootstrapTotalMaxChars`
Max total characters injected across all workspace bootstrap files. Default: `24000`.
```json5
{
agents: { defaults: { bootstrapTotalMaxChars: 24000 } },
}
```
### `agents.defaults.userTimezone`
Timezone for system prompt context (not message timestamps). Falls back to host timezone.
@@ -1387,6 +1397,7 @@ Controls elevated (host) exec access:
timeoutSec: 1800,
cleanupMs: 1800000,
notifyOnExit: true,
notifyOnExitEmptySuccess: false,
applyPatch: {
enabled: false,
allowModels: ["gpt-5.2"],