You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
Commit edd6e06
Browse filesBrowse the repository at this point in the historyBrowse files
fix(#336): historian children ride the age-gated orphan sweep instead of inline delete at publish — stale threshold covers timeout+retries+fallbacks+detached-writer grace; FK failures from late OpenCode part writes eliminated
Copy file name to clipboardExpand all lines: CONFIGURATION.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -167,7 +167,7 @@ Higher-tier models with longer cache windows benefit from a longer TTL. Setting
167
167
|`execute_threshold_percentage`|`number` (20–90) or `object`|`65`| Context usage that forces queued ops to execute. Capped at 90% of the output-reserved safe window, leaving about 10% for mid-turn input growth. Supports per-model maps. |
168
168
|`execute_threshold_tokens`|`object` (per-model map) | — |**Optional absolute-tokens variant of `execute_threshold_percentage`.** Per-model map (e.g. `{ "default": 150000, "github-copilot/gpt-5.2-codex": 40000 }`). When set for a model, overrides the percentage-based threshold for that model. Clamped to `90% × context_limit` with a warn log. Requires a resolvable context limit — falls through to percentage if unavailable. See below. |
169
169
|`clear_reasoning_age`|`number`|`50`| Clear thinking/reasoning blocks older than N tags. |
170
-
|`historian_timeout_ms`|`number`|`300000`| Timeout per historian call (ms). |
170
+
|`historian_timeout_ms`|`number`|`600000`| Timeout per historian call (ms). |
171
171
|`history_budget_percentage`|`number` (0.05–0.5) |`0.15`| Fraction of usable context (`context_limit × execute_threshold`) reserved for the history block. Triggers compression when exceeded. |
172
172
|`compaction.enabled`|`boolean`|`true`| When `false`, use compaction-off mode: keep Magic Context's knowledge layer and let native compaction (or nothing) own the context window. Boot-resolved; restart after changing it. See below. |
173
173
|`commit_cluster_trigger`|`object`| See below | Controls the commit-cluster historian trigger. |
Copy file name to clipboardExpand all lines: packages/docs/src/content/docs/reference/configuration.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -100,7 +100,7 @@ The background agent that condenses old conversation into compact history.
100
100
|`historian.two_pass`| boolean |`false`| Run a second editor pass over historian output to clean low-signal U: lines and cross-compartment duplicates. Adds ~1 extra API call and ~1.3x cost per historian run. Useful for models without extended thinking support. (default: false) |
101
101
|`historian.thinking_level`|`"off"`\\|`"minimal"`\\|`"low"`\\|`"medium"`\\|`"high"`\\|`"xhigh"`\\|`"max"`| — | Pi only: explicit thinking level passed as --thinking <level> to Pi historian subagent invocations. Required when using reasoning models (e.g. github-copilot/gpt-5.4) because Pi's default thinking-level resolution can pick a value the provider rejects. OpenCode users set variant instead. Valid: off \| minimal \| low \| medium \| high \| xhigh \| max |
102
102
|`historian.disallowed_tools`|`"*"`\\|`"read"`\\|`"aft_outline"`\\|`"aft_zoom"`\\|`"aft_search"`[]|`[]`| OpenCode only. Tools to REMOVE from the historian's default allow-list [read, aft_outline, aft_zoom, aft_search]. Applies to both historian and historian-editor agents. Use ["*"] to strip all tool definitions from the model request — this prevents weak instruction-following models (e.g. mistral-small-latest) from entering tool-calling loops. Individual tool names remove just that tool. Note: a user-supplied historian.permission override can re-allow a tool that disallowed_tools removed — disallowed_tools sets the baseline, permission overrides take precedence. (default: []) |
103
-
|`historian_timeout_ms`| number (60000–) |`300000`| Timeout for each historian prompt call in milliseconds (default: 300000) |
103
+
|`historian_timeout_ms`| number (60000–) |`600000`| Timeout for each historian prompt call in milliseconds (default: 600000) |
104
104
|`commit_cluster_trigger`| object | — | Commit-cluster trigger: fire historian when enough commit clusters accumulate in the unsummarized tail |
105
105
|`commit_cluster_trigger.enabled`| boolean |`true`| Enable commit-cluster based historian triggering (default: true) |
106
106
|`commit_cluster_trigger.min_clusters`| number (1–) |`3`| Minimum commit clusters required to trigger historian (min: 1, default: 3) |
// escalation derives above the effective threshold and the 95% wall stays fixed.
17
17
exportconstEXECUTE_THRESHOLD_CAP_MESSAGE=
18
18
"execute_threshold is capped at 90% for cache safety: output capacity is reserved from the usable context window, and the remaining 10% absorbs mid-turn growth before the absolute 95% emergency wall. Use a value between 20 and 90.";
0 commit comments