@ponythewhite/base-context 1.0.10 → 1.0.12

package/dist/core/session-tree.d.ts

@@ -6,6 +6,15 @@ export declare const DEFAULT_SESSION_TREE_LIMITS: Readonly<SessionHistoryReadLim
 export declare function buildSessionTreeFlatNodes(entries: readonly SessionEntry[]): SessionTreeFlatNode[];
 /** Extracted getTree policy: source-order roots and timestamp-ordered children. */
 export declare function buildSessionTreeFromFlatNodes(flatNodes: readonly SessionTreeFlatNode[]): SessionTreeNode[];
+/** UI projection limits cover visible entries, not excluded request/tool-intent bodies. */
+export declare function readVisibleSessionTreeFlatNodes(manager: ReadonlySessionManager, limits?: SessionHistoryReadLimits): Promise<{
+    flatNodes: SessionTreeFlatNode[];
+    leafId: string | null;
+}>;
+export declare function readVisibleSessionTree(manager: ReadonlySessionManager, limits?: SessionHistoryReadLimits): Promise<{
+    tree: SessionTreeNode[];
+    leafId: string | null;
+}>;
 /** Complete or refuse. Never widen a branch read or return a last-N tree. */
 export declare function readSessionTreeFlatNodes(manager: ReadonlySessionManager, limits?: SessionHistoryReadLimits): Promise<{
     flatNodes: SessionTreeFlatNode[];

package/dist/core/session-tree.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session-tree.d.ts","sourceRoot":"","sources":["../../src/core/session-tree.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AAC3E,OAAO,KAAK,EAAE,sBAAsB,EAAE,YAAY,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAGvH,2EAA2E;AAC3E,eAAO,MAAM,2BAA2B,EAAE,QAAQ,CAAC,wBAAwB,CAGzE,CAAC;AAEH,8FAA8F;AAC9F,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,SAAS,YAAY,EAAE,GAAG,mBAAmB,EAAE,CA+BjG;AAED,mFAAmF;AACnF,wBAAgB,6BAA6B,CAAC,SAAS,EAAE,SAAS,mBAAmB,EAAE,GAAG,eAAe,EAAE,CAqB1G;AAED,6EAA6E;AAC7E,wBAAsB,wBAAwB,CAC7C,OAAO,EAAE,sBAAsB,EAC/B,MAAM,GAAE,wBAAsD,GAC5D,OAAO,CAAC;IAAE,SAAS,EAAE,mBAAmB,EAAE,CAAC;IAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAAC,CA4BtE;AAED,wBAAsB,eAAe,CACpC,OAAO,EAAE,sBAAsB,EAC/B,MAAM,GAAE,wBAAsD,GAC5D,OAAO,CAAC;IAAE,IAAI,EAAE,eAAe,EAAE,CAAC;IAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAAC,CAG7D","sourcesContent":["import type { SessionHistoryReadLimits } from \"./session-history-index.js\";\nimport type { ReadonlySessionManager, SessionEntry, SessionTreeFlatNode, SessionTreeNode } from \"./session-manager.js\";\nimport { cloneUsage } from \"./usage.js\";\n\n/** Whole-source limits, including entries hidden from the visible tree. */\nexport const DEFAULT_SESSION_TREE_LIMITS: Readonly<SessionHistoryReadLimits> = Object.freeze({\n\tmaxEntries: 16_384,\n\tmaxSourceBytes: 64 * 1024 * 1024,\n});\n\n/** SessionManager's existing label and hidden-parent policy, on a complete bounded source. */\nexport function buildSessionTreeFlatNodes(entries: readonly SessionEntry[]): SessionTreeFlatNode[] {\n\tconst byId = new Map(entries.map((entry) => [entry.id, entry]));\n\tconst labelsById = new Map<string, string>();\n\tconst labelTimestampsById = new Map<string, string>();\n\tfor (const entry of entries) {\n\t\tif (entry.type !== \"label\") continue;\n\t\tif (entry.label) {\n\t\t\tlabelsById.set(entry.targetId, entry.label);\n\t\t\tlabelTimestampsById.set(entry.targetId, entry.timestamp);\n\t\t} else {\n\t\t\tlabelsById.delete(entry.targetId);\n\t\t\tlabelTimestampsById.delete(entry.targetId);\n\t\t}\n\t}\n\treturn entries\n\t\t.filter(\n\t\t\t(entry): entry is SessionTreeFlatNode[\"entry\"] => entry.type !== \"tool_intent\" && entry.type !== \"request\",\n\t\t)\n\t\t.map((entry) => {\n\t\t\tlet parentId = entry.parentId;\n\t\t\tlet parent = parentId ? byId.get(parentId) : undefined;\n\t\t\twhile (parent?.type === \"tool_intent\" || parent?.type === \"request\") {\n\t\t\t\tparentId = parent.parentId;\n\t\t\t\tparent = parentId ? byId.get(parentId) : undefined;\n\t\t\t}\n\t\t\treturn {\n\t\t\t\tentry: parentId === entry.parentId ? entry : { ...entry, parentId },\n\t\t\t\tlabel: labelsById.get(entry.id),\n\t\t\t\tlabelTimestamp: labelTimestampsById.get(entry.id),\n\t\t\t};\n\t\t});\n}\n\n/** Extracted getTree policy: source-order roots and timestamp-ordered children. */\nexport function buildSessionTreeFromFlatNodes(flatNodes: readonly SessionTreeFlatNode[]): SessionTreeNode[] {\n\tconst nodeMap = new Map<string, SessionTreeNode>();\n\tconst roots: SessionTreeNode[] = [];\n\tfor (const flatNode of flatNodes) nodeMap.set(flatNode.entry.id, { ...flatNode, children: [] });\n\tfor (const flatNode of flatNodes) {\n\t\tconst entry = flatNode.entry;\n\t\tconst node = nodeMap.get(entry.id)!;\n\t\tif (entry.parentId === null || entry.parentId === entry.id) roots.push(node);\n\t\telse {\n\t\t\tconst parent = nodeMap.get(entry.parentId);\n\t\t\tif (parent) parent.children.push(node);\n\t\t\telse roots.push(node);\n\t\t}\n\t}\n\tconst stack: SessionTreeNode[] = [...roots];\n\twhile (stack.length > 0) {\n\t\tconst node = stack.pop()!;\n\t\tnode.children.sort((a, b) => new Date(a.entry.timestamp).getTime() - new Date(b.entry.timestamp).getTime());\n\t\tstack.push(...node.children);\n\t}\n\treturn roots;\n}\n\n/** Complete or refuse. Never widen a branch read or return a last-N tree. */\nexport async function readSessionTreeFlatNodes(\n\tmanager: ReadonlySessionManager,\n\tlimits: SessionHistoryReadLimits = DEFAULT_SESSION_TREE_LIMITS,\n): Promise<{ flatNodes: SessionTreeFlatNode[]; leafId: string | null }> {\n\tconst capturedLimits = { ...limits };\n\tlet entries: SessionEntry[];\n\tlet leafId: string | null;\n\tif (manager.supportsCapturedHistoryReads()) {\n\t\tconst history = await manager.materializeSourceHistory(capturedLimits);\n\t\tentries = history.entries.map(({ entry }) => entry);\n\t\tleafId = history.source.leafId;\n\t\t// Preserve the Manager's resolved usage overlays on detached canonical entries.\n\t\tconst assistants = new Map(\n\t\t\tentries\n\t\t\t\t.filter((entry) => entry.type === \"message\" && entry.message.role === \"assistant\")\n\t\t\t\t.map((entry) => [entry.id, entry]),\n\t\t);\n\t\tfor (const entry of entries) {\n\t\t\tif (entry.type !== \"child_usage_attributed\") continue;\n\t\t\tconst target = assistants.get(entry.targetId);\n\t\t\tif (target?.type === \"message\" && target.message.role === \"assistant\")\n\t\t\t\ttarget.message.usage = cloneUsage(entry.aggregateUsage);\n\t\t}\n\t} else {\n\t\t// Explicit readonly/legacy/in-memory views keep their captured resident data.\n\t\t// Their byte limit counts serialized header/entry JSON, not canonical frames.\n\t\tconst history = manager.materializeResidentHistory(capturedLimits);\n\t\tentries = history.entries;\n\t\tleafId = history.leafId;\n\t}\n\treturn { flatNodes: buildSessionTreeFlatNodes(entries), leafId };\n}\n\nexport async function readSessionTree(\n\tmanager: ReadonlySessionManager,\n\tlimits: SessionHistoryReadLimits = DEFAULT_SESSION_TREE_LIMITS,\n): Promise<{ tree: SessionTreeNode[]; leafId: string | null }> {\n\tconst { flatNodes, leafId } = await readSessionTreeFlatNodes(manager, limits);\n\treturn { tree: buildSessionTreeFromFlatNodes(flatNodes), leafId };\n}\n"]}
+{"version":3,"file":"session-tree.d.ts","sourceRoot":"","sources":["../../src/core/session-tree.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AAC3E,OAAO,KAAK,EAAE,sBAAsB,EAAE,YAAY,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAGvH,2EAA2E;AAC3E,eAAO,MAAM,2BAA2B,EAAE,QAAQ,CAAC,wBAAwB,CAGzE,CAAC;AAEH,8FAA8F;AAC9F,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,SAAS,YAAY,EAAE,GAAG,mBAAmB,EAAE,CA+BjG;AAED,mFAAmF;AACnF,wBAAgB,6BAA6B,CAAC,SAAS,EAAE,SAAS,mBAAmB,EAAE,GAAG,eAAe,EAAE,CAqB1G;AAgBD,2FAA2F;AAC3F,wBAAsB,+BAA+B,CACpD,OAAO,EAAE,sBAAsB,EAC/B,MAAM,GAAE,wBAAsD,GAC5D,OAAO,CAAC;IAAE,SAAS,EAAE,mBAAmB,EAAE,CAAC;IAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAAC,CAgDtE;AAED,wBAAsB,sBAAsB,CAC3C,OAAO,EAAE,sBAAsB,EAC/B,MAAM,GAAE,wBAAsD,GAC5D,OAAO,CAAC;IAAE,IAAI,EAAE,eAAe,EAAE,CAAC;IAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAAC,CAG7D;AAED,6EAA6E;AAC7E,wBAAsB,wBAAwB,CAC7C,OAAO,EAAE,sBAAsB,EAC/B,MAAM,GAAE,wBAAsD,GAC5D,OAAO,CAAC;IAAE,SAAS,EAAE,mBAAmB,EAAE,CAAC;IAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAAC,CAiBtE;AAED,wBAAsB,eAAe,CACpC,OAAO,EAAE,sBAAsB,EAC/B,MAAM,GAAE,wBAAsD,GAC5D,OAAO,CAAC;IAAE,IAAI,EAAE,eAAe,EAAE,CAAC;IAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAAC,CAG7D","sourcesContent":["import { stringifyBoundedJson } from \"./bounded-json.js\";\nimport type { SessionHistoryReadLimits } from \"./session-history-index.js\";\nimport type { ReadonlySessionManager, SessionEntry, SessionTreeFlatNode, SessionTreeNode } from \"./session-manager.js\";\nimport { cloneUsage } from \"./usage.js\";\n\n/** Whole-source limits, including entries hidden from the visible tree. */\nexport const DEFAULT_SESSION_TREE_LIMITS: Readonly<SessionHistoryReadLimits> = Object.freeze({\n\tmaxEntries: 16_384,\n\tmaxSourceBytes: 64 * 1024 * 1024,\n});\n\n/** SessionManager's existing label and hidden-parent policy, on a complete bounded source. */\nexport function buildSessionTreeFlatNodes(entries: readonly SessionEntry[]): SessionTreeFlatNode[] {\n\tconst byId = new Map(entries.map((entry) => [entry.id, entry]));\n\tconst labelsById = new Map<string, string>();\n\tconst labelTimestampsById = new Map<string, string>();\n\tfor (const entry of entries) {\n\t\tif (entry.type !== \"label\") continue;\n\t\tif (entry.label) {\n\t\t\tlabelsById.set(entry.targetId, entry.label);\n\t\t\tlabelTimestampsById.set(entry.targetId, entry.timestamp);\n\t\t} else {\n\t\t\tlabelsById.delete(entry.targetId);\n\t\t\tlabelTimestampsById.delete(entry.targetId);\n\t\t}\n\t}\n\treturn entries\n\t\t.filter(\n\t\t\t(entry): entry is SessionTreeFlatNode[\"entry\"] => entry.type !== \"tool_intent\" && entry.type !== \"request\",\n\t\t)\n\t\t.map((entry) => {\n\t\t\tlet parentId = entry.parentId;\n\t\t\tlet parent = parentId ? byId.get(parentId) : undefined;\n\t\t\twhile (parent?.type === \"tool_intent\" || parent?.type === \"request\") {\n\t\t\t\tparentId = parent.parentId;\n\t\t\t\tparent = parentId ? byId.get(parentId) : undefined;\n\t\t\t}\n\t\t\treturn {\n\t\t\t\tentry: parentId === entry.parentId ? entry : { ...entry, parentId },\n\t\t\t\tlabel: labelsById.get(entry.id),\n\t\t\t\tlabelTimestamp: labelTimestampsById.get(entry.id),\n\t\t\t};\n\t\t});\n}\n\n/** Extracted getTree policy: source-order roots and timestamp-ordered children. */\nexport function buildSessionTreeFromFlatNodes(flatNodes: readonly SessionTreeFlatNode[]): SessionTreeNode[] {\n\tconst nodeMap = new Map<string, SessionTreeNode>();\n\tconst roots: SessionTreeNode[] = [];\n\tfor (const flatNode of flatNodes) nodeMap.set(flatNode.entry.id, { ...flatNode, children: [] });\n\tfor (const flatNode of flatNodes) {\n\t\tconst entry = flatNode.entry;\n\t\tconst node = nodeMap.get(entry.id)!;\n\t\tif (entry.parentId === null || entry.parentId === entry.id) roots.push(node);\n\t\telse {\n\t\t\tconst parent = nodeMap.get(entry.parentId);\n\t\t\tif (parent) parent.children.push(node);\n\t\t\telse roots.push(node);\n\t\t}\n\t}\n\tconst stack: SessionTreeNode[] = [...roots];\n\twhile (stack.length > 0) {\n\t\tconst node = stack.pop()!;\n\t\tnode.children.sort((a, b) => new Date(a.entry.timestamp).getTime() - new Date(b.entry.timestamp).getTime());\n\t\tstack.push(...node.children);\n\t}\n\treturn roots;\n}\n\nfunction applyTreeUsageOverlays(entries: SessionEntry[]): void {\n\tconst assistants = new Map(\n\t\tentries\n\t\t\t.filter((entry) => entry.type === \"message\" && entry.message.role === \"assistant\")\n\t\t\t.map((entry) => [entry.id, entry]),\n\t);\n\tfor (const entry of entries) {\n\t\tif (entry.type !== \"child_usage_attributed\") continue;\n\t\tconst target = assistants.get(entry.targetId);\n\t\tif (target?.type === \"message\" && target.message.role === \"assistant\")\n\t\t\ttarget.message.usage = cloneUsage(entry.aggregateUsage);\n\t}\n}\n\n/** UI projection limits cover visible entries, not excluded request/tool-intent bodies. */\nexport async function readVisibleSessionTreeFlatNodes(\n\tmanager: ReadonlySessionManager,\n\tlimits: SessionHistoryReadLimits = DEFAULT_SESSION_TREE_LIMITS,\n): Promise<{ flatNodes: SessionTreeFlatNode[]; leafId: string | null }> {\n\tconst { maxEntries, maxSourceBytes } = limits;\n\tif (\n\t\t!Number.isSafeInteger(maxEntries) ||\n\t\tmaxEntries <= 0 ||\n\t\t!Number.isSafeInteger(maxSourceBytes) ||\n\t\tmaxSourceBytes <= 0\n\t)\n\t\tthrow new Error(\"Invalid history materialization limits\");\n\tif (!manager.supportsCapturedHistoryReads())\n\t\treturn readSessionTreeFlatNodes(manager, { maxEntries, maxSourceBytes });\n\treturn manager.readSourceHistory(async (history) => {\n\t\tconst entries: SessionEntry[] = [];\n\t\tconst visibleIds = new Set<string>();\n\t\tlet sourceBytes = 0;\n\t\tlet after = 0;\n\t\tfor (;;) {\n\t\t\tconst page = await history.page(after);\n\t\t\tif (page.indexedThrough < history.source.sourceSequence)\n\t\t\t\tthrow new Error(\"Captured history has incomplete index coverage\");\n\t\t\tfor (const ref of page.events) {\n\t\t\t\tif (ref.kind === \"request\" || ref.kind === \"tool_intent\") continue;\n\t\t\t\tif (entries.length >= maxEntries) throw new Error(\"History entry budget exceeded\");\n\t\t\t\tif (sourceBytes + ref.locator.length > maxSourceBytes)\n\t\t\t\t\tthrow new Error(\"History source byte budget exceeded\");\n\t\t\t\tconst hydrated = await history.hydrateEntry(ref.id, maxSourceBytes - sourceBytes);\n\t\t\t\tif (!hydrated) throw new Error(\"Session tree entry source is unavailable\");\n\t\t\t\tsourceBytes += ref.locator.length;\n\t\t\t\tlet parentId = ref.parentId;\n\t\t\t\t// Resolve excluded parent chains as metadata; never retain or hydrate their bodies.\n\t\t\t\twhile (parentId !== null && !visibleIds.has(parentId)) {\n\t\t\t\t\tconst parent = await history.get(parentId);\n\t\t\t\t\tif (!parent || (parent.kind !== \"request\" && parent.kind !== \"tool_intent\")) break;\n\t\t\t\t\tparentId = parent.parentId;\n\t\t\t\t}\n\t\t\t\thydrated.entry.parentId = parentId;\n\t\t\t\tentries.push(hydrated.entry);\n\t\t\t\tvisibleIds.add(ref.id);\n\t\t\t}\n\t\t\tif (page.nextAfter === null) break;\n\t\t\tafter = page.nextAfter;\n\t\t}\n\t\tapplyTreeUsageOverlays(entries);\n\t\tconst result = { flatNodes: buildSessionTreeFlatNodes(entries), leafId: history.source.leafId };\n\t\t// Labels and resolved usage are also part of the bounded visible response.\n\t\tstringifyBoundedJson(result, maxSourceBytes);\n\t\treturn result;\n\t});\n}\n\nexport async function readVisibleSessionTree(\n\tmanager: ReadonlySessionManager,\n\tlimits: SessionHistoryReadLimits = DEFAULT_SESSION_TREE_LIMITS,\n): Promise<{ tree: SessionTreeNode[]; leafId: string | null }> {\n\tconst { flatNodes, leafId } = await readVisibleSessionTreeFlatNodes(manager, limits);\n\treturn { tree: buildSessionTreeFromFlatNodes(flatNodes), leafId };\n}\n\n/** Complete or refuse. Never widen a branch read or return a last-N tree. */\nexport async function readSessionTreeFlatNodes(\n\tmanager: ReadonlySessionManager,\n\tlimits: SessionHistoryReadLimits = DEFAULT_SESSION_TREE_LIMITS,\n): Promise<{ flatNodes: SessionTreeFlatNode[]; leafId: string | null }> {\n\tconst capturedLimits = { ...limits };\n\tlet entries: SessionEntry[];\n\tlet leafId: string | null;\n\tif (manager.supportsCapturedHistoryReads()) {\n\t\tconst history = await manager.materializeSourceHistory(capturedLimits);\n\t\tentries = history.entries.map(({ entry }) => entry);\n\t\tleafId = history.source.leafId;\n\t\tapplyTreeUsageOverlays(entries);\n\t} else {\n\t\t// Explicit readonly/legacy/in-memory views keep their captured resident data.\n\t\t// Their byte limit counts serialized header/entry JSON, not canonical frames.\n\t\tconst history = manager.materializeResidentHistory(capturedLimits);\n\t\tentries = history.entries;\n\t\tleafId = history.leafId;\n\t}\n\treturn { flatNodes: buildSessionTreeFlatNodes(entries), leafId };\n}\n\nexport async function readSessionTree(\n\tmanager: ReadonlySessionManager,\n\tlimits: SessionHistoryReadLimits = DEFAULT_SESSION_TREE_LIMITS,\n): Promise<{ tree: SessionTreeNode[]; leafId: string | null }> {\n\tconst { flatNodes, leafId } = await readSessionTreeFlatNodes(manager, limits);\n\treturn { tree: buildSessionTreeFromFlatNodes(flatNodes), leafId };\n}\n"]}

package/dist/core/session-tree.js

@@ -1,3 +1,4 @@
+import { stringifyBoundedJson } from "./bounded-json.js";
 import { cloneUsage } from "./usage.js";
 /** Whole-source limits, including entries hidden from the visible tree. */
 export const DEFAULT_SESSION_TREE_LIMITS = Object.freeze({
@@ -64,6 +65,75 @@ export function buildSessionTreeFromFlatNodes(flatNodes) {
     }
     return roots;
 }
+function applyTreeUsageOverlays(entries) {
+    const assistants = new Map(entries
+        .filter((entry) => entry.type === "message" && entry.message.role === "assistant")
+        .map((entry) => [entry.id, entry]));
+    for (const entry of entries) {
+        if (entry.type !== "child_usage_attributed")
+            continue;
+        const target = assistants.get(entry.targetId);
+        if (target?.type === "message" && target.message.role === "assistant")
+            target.message.usage = cloneUsage(entry.aggregateUsage);
+    }
+}
+/** UI projection limits cover visible entries, not excluded request/tool-intent bodies. */
+export async function readVisibleSessionTreeFlatNodes(manager, limits = DEFAULT_SESSION_TREE_LIMITS) {
+    const { maxEntries, maxSourceBytes } = limits;
+    if (!Number.isSafeInteger(maxEntries) ||
+        maxEntries <= 0 ||
+        !Number.isSafeInteger(maxSourceBytes) ||
+        maxSourceBytes <= 0)
+        throw new Error("Invalid history materialization limits");
+    if (!manager.supportsCapturedHistoryReads())
+        return readSessionTreeFlatNodes(manager, { maxEntries, maxSourceBytes });
+    return manager.readSourceHistory(async (history) => {
+        const entries = [];
+        const visibleIds = new Set();
+        let sourceBytes = 0;
+        let after = 0;
+        for (;;) {
+            const page = await history.page(after);
+            if (page.indexedThrough < history.source.sourceSequence)
+                throw new Error("Captured history has incomplete index coverage");
+            for (const ref of page.events) {
+                if (ref.kind === "request" || ref.kind === "tool_intent")
+                    continue;
+                if (entries.length >= maxEntries)
+                    throw new Error("History entry budget exceeded");
+                if (sourceBytes + ref.locator.length > maxSourceBytes)
+                    throw new Error("History source byte budget exceeded");
+                const hydrated = await history.hydrateEntry(ref.id, maxSourceBytes - sourceBytes);
+                if (!hydrated)
+                    throw new Error("Session tree entry source is unavailable");
+                sourceBytes += ref.locator.length;
+                let parentId = ref.parentId;
+                // Resolve excluded parent chains as metadata; never retain or hydrate their bodies.
+                while (parentId !== null && !visibleIds.has(parentId)) {
+                    const parent = await history.get(parentId);
+                    if (!parent || (parent.kind !== "request" && parent.kind !== "tool_intent"))
+                        break;
+                    parentId = parent.parentId;
+                }
+                hydrated.entry.parentId = parentId;
+                entries.push(hydrated.entry);
+                visibleIds.add(ref.id);
+            }
+            if (page.nextAfter === null)
+                break;
+            after = page.nextAfter;
+        }
+        applyTreeUsageOverlays(entries);
+        const result = { flatNodes: buildSessionTreeFlatNodes(entries), leafId: history.source.leafId };
+        // Labels and resolved usage are also part of the bounded visible response.
+        stringifyBoundedJson(result, maxSourceBytes);
+        return result;
+    });
+}
+export async function readVisibleSessionTree(manager, limits = DEFAULT_SESSION_TREE_LIMITS) {
+    const { flatNodes, leafId } = await readVisibleSessionTreeFlatNodes(manager, limits);
+    return { tree: buildSessionTreeFromFlatNodes(flatNodes), leafId };
+}
 /** Complete or refuse. Never widen a branch read or return a last-N tree. */
 export async function readSessionTreeFlatNodes(manager, limits = DEFAULT_SESSION_TREE_LIMITS) {
     const capturedLimits = { ...limits };
@@ -73,17 +143,7 @@ export async function readSessionTreeFlatNodes(manager, limits = DEFAULT_SESSION
         const history = await manager.materializeSourceHistory(capturedLimits);
         entries = history.entries.map(({ entry }) => entry);
         leafId = history.source.leafId;
-        // Preserve the Manager's resolved usage overlays on detached canonical entries.
-        const assistants = new Map(entries
-            .filter((entry) => entry.type === "message" && entry.message.role === "assistant")
-            .map((entry) => [entry.id, entry]));
-        for (const entry of entries) {
-            if (entry.type !== "child_usage_attributed")
-                continue;
-            const target = assistants.get(entry.targetId);
-            if (target?.type === "message" && target.message.role === "assistant")
-                target.message.usage = cloneUsage(entry.aggregateUsage);
-        }
+        applyTreeUsageOverlays(entries);
     }
     else {
         // Explicit readonly/legacy/in-memory views keep their captured resident data.

package/dist/core/session-tree.js.map

@@ -1 +1 @@
-{"version":3,"file":"session-tree.js","sourceRoot":"","sources":["../../src/core/session-tree.ts"],"names":[],"mappings":"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","sourcesContent":["import type { SessionHistoryReadLimits } from \"./session-history-index.js\";\nimport type { ReadonlySessionManager, SessionEntry, SessionTreeFlatNode, SessionTreeNode } from \"./session-manager.js\";\nimport { cloneUsage } from \"./usage.js\";\n\n/** Whole-source limits, including entries hidden from the visible tree. */\nexport const DEFAULT_SESSION_TREE_LIMITS: Readonly<SessionHistoryReadLimits> = Object.freeze({\n\tmaxEntries: 16_384,\n\tmaxSourceBytes: 64 * 1024 * 1024,\n});\n\n/** SessionManager's existing label and hidden-parent policy, on a complete bounded source. */\nexport function buildSessionTreeFlatNodes(entries: readonly SessionEntry[]): SessionTreeFlatNode[] {\n\tconst byId = new Map(entries.map((entry) => [entry.id, entry]));\n\tconst labelsById = new Map<string, string>();\n\tconst labelTimestampsById = new Map<string, string>();\n\tfor (const entry of entries) {\n\t\tif (entry.type !== \"label\") continue;\n\t\tif (entry.label) {\n\t\t\tlabelsById.set(entry.targetId, entry.label);\n\t\t\tlabelTimestampsById.set(entry.targetId, entry.timestamp);\n\t\t} else {\n\t\t\tlabelsById.delete(entry.targetId);\n\t\t\tlabelTimestampsById.delete(entry.targetId);\n\t\t}\n\t}\n\treturn entries\n\t\t.filter(\n\t\t\t(entry): entry is SessionTreeFlatNode[\"entry\"] => entry.type !== \"tool_intent\" && entry.type !== \"request\",\n\t\t)\n\t\t.map((entry) => {\n\t\t\tlet parentId = entry.parentId;\n\t\t\tlet parent = parentId ? byId.get(parentId) : undefined;\n\t\t\twhile (parent?.type === \"tool_intent\" || parent?.type === \"request\") {\n\t\t\t\tparentId = parent.parentId;\n\t\t\t\tparent = parentId ? byId.get(parentId) : undefined;\n\t\t\t}\n\t\t\treturn {\n\t\t\t\tentry: parentId === entry.parentId ? entry : { ...entry, parentId },\n\t\t\t\tlabel: labelsById.get(entry.id),\n\t\t\t\tlabelTimestamp: labelTimestampsById.get(entry.id),\n\t\t\t};\n\t\t});\n}\n\n/** Extracted getTree policy: source-order roots and timestamp-ordered children. */\nexport function buildSessionTreeFromFlatNodes(flatNodes: readonly SessionTreeFlatNode[]): SessionTreeNode[] {\n\tconst nodeMap = new Map<string, SessionTreeNode>();\n\tconst roots: SessionTreeNode[] = [];\n\tfor (const flatNode of flatNodes) nodeMap.set(flatNode.entry.id, { ...flatNode, children: [] });\n\tfor (const flatNode of flatNodes) {\n\t\tconst entry = flatNode.entry;\n\t\tconst node = nodeMap.get(entry.id)!;\n\t\tif (entry.parentId === null || entry.parentId === entry.id) roots.push(node);\n\t\telse {\n\t\t\tconst parent = nodeMap.get(entry.parentId);\n\t\t\tif (parent) parent.children.push(node);\n\t\t\telse roots.push(node);\n\t\t}\n\t}\n\tconst stack: SessionTreeNode[] = [...roots];\n\twhile (stack.length > 0) {\n\t\tconst node = stack.pop()!;\n\t\tnode.children.sort((a, b) => new Date(a.entry.timestamp).getTime() - new Date(b.entry.timestamp).getTime());\n\t\tstack.push(...node.children);\n\t}\n\treturn roots;\n}\n\n/** Complete or refuse. Never widen a branch read or return a last-N tree. */\nexport async function readSessionTreeFlatNodes(\n\tmanager: ReadonlySessionManager,\n\tlimits: SessionHistoryReadLimits = DEFAULT_SESSION_TREE_LIMITS,\n): Promise<{ flatNodes: SessionTreeFlatNode[]; leafId: string | null }> {\n\tconst capturedLimits = { ...limits };\n\tlet entries: SessionEntry[];\n\tlet leafId: string | null;\n\tif (manager.supportsCapturedHistoryReads()) {\n\t\tconst history = await manager.materializeSourceHistory(capturedLimits);\n\t\tentries = history.entries.map(({ entry }) => entry);\n\t\tleafId = history.source.leafId;\n\t\t// Preserve the Manager's resolved usage overlays on detached canonical entries.\n\t\tconst assistants = new Map(\n\t\t\tentries\n\t\t\t\t.filter((entry) => entry.type === \"message\" && entry.message.role === \"assistant\")\n\t\t\t\t.map((entry) => [entry.id, entry]),\n\t\t);\n\t\tfor (const entry of entries) {\n\t\t\tif (entry.type !== \"child_usage_attributed\") continue;\n\t\t\tconst target = assistants.get(entry.targetId);\n\t\t\tif (target?.type === \"message\" && target.message.role === \"assistant\")\n\t\t\t\ttarget.message.usage = cloneUsage(entry.aggregateUsage);\n\t\t}\n\t} else {\n\t\t// Explicit readonly/legacy/in-memory views keep their captured resident data.\n\t\t// Their byte limit counts serialized header/entry JSON, not canonical frames.\n\t\tconst history = manager.materializeResidentHistory(capturedLimits);\n\t\tentries = history.entries;\n\t\tleafId = history.leafId;\n\t}\n\treturn { flatNodes: buildSessionTreeFlatNodes(entries), leafId };\n}\n\nexport async function readSessionTree(\n\tmanager: ReadonlySessionManager,\n\tlimits: SessionHistoryReadLimits = DEFAULT_SESSION_TREE_LIMITS,\n): Promise<{ tree: SessionTreeNode[]; leafId: string | null }> {\n\tconst { flatNodes, leafId } = await readSessionTreeFlatNodes(manager, limits);\n\treturn { tree: buildSessionTreeFromFlatNodes(flatNodes), leafId };\n}\n"]}
+{"version":3,"file":"session-tree.js","sourceRoot":"","sources":["../../src/core/session-tree.ts"],"names":[],"mappings":"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","sourcesContent":["import { stringifyBoundedJson } from \"./bounded-json.js\";\nimport type { SessionHistoryReadLimits } from \"./session-history-index.js\";\nimport type { ReadonlySessionManager, SessionEntry, SessionTreeFlatNode, SessionTreeNode } from \"./session-manager.js\";\nimport { cloneUsage } from \"./usage.js\";\n\n/** Whole-source limits, including entries hidden from the visible tree. */\nexport const DEFAULT_SESSION_TREE_LIMITS: Readonly<SessionHistoryReadLimits> = Object.freeze({\n\tmaxEntries: 16_384,\n\tmaxSourceBytes: 64 * 1024 * 1024,\n});\n\n/** SessionManager's existing label and hidden-parent policy, on a complete bounded source. */\nexport function buildSessionTreeFlatNodes(entries: readonly SessionEntry[]): SessionTreeFlatNode[] {\n\tconst byId = new Map(entries.map((entry) => [entry.id, entry]));\n\tconst labelsById = new Map<string, string>();\n\tconst labelTimestampsById = new Map<string, string>();\n\tfor (const entry of entries) {\n\t\tif (entry.type !== \"label\") continue;\n\t\tif (entry.label) {\n\t\t\tlabelsById.set(entry.targetId, entry.label);\n\t\t\tlabelTimestampsById.set(entry.targetId, entry.timestamp);\n\t\t} else {\n\t\t\tlabelsById.delete(entry.targetId);\n\t\t\tlabelTimestampsById.delete(entry.targetId);\n\t\t}\n\t}\n\treturn entries\n\t\t.filter(\n\t\t\t(entry): entry is SessionTreeFlatNode[\"entry\"] => entry.type !== \"tool_intent\" && entry.type !== \"request\",\n\t\t)\n\t\t.map((entry) => {\n\t\t\tlet parentId = entry.parentId;\n\t\t\tlet parent = parentId ? byId.get(parentId) : undefined;\n\t\t\twhile (parent?.type === \"tool_intent\" || parent?.type === \"request\") {\n\t\t\t\tparentId = parent.parentId;\n\t\t\t\tparent = parentId ? byId.get(parentId) : undefined;\n\t\t\t}\n\t\t\treturn {\n\t\t\t\tentry: parentId === entry.parentId ? entry : { ...entry, parentId },\n\t\t\t\tlabel: labelsById.get(entry.id),\n\t\t\t\tlabelTimestamp: labelTimestampsById.get(entry.id),\n\t\t\t};\n\t\t});\n}\n\n/** Extracted getTree policy: source-order roots and timestamp-ordered children. */\nexport function buildSessionTreeFromFlatNodes(flatNodes: readonly SessionTreeFlatNode[]): SessionTreeNode[] {\n\tconst nodeMap = new Map<string, SessionTreeNode>();\n\tconst roots: SessionTreeNode[] = [];\n\tfor (const flatNode of flatNodes) nodeMap.set(flatNode.entry.id, { ...flatNode, children: [] });\n\tfor (const flatNode of flatNodes) {\n\t\tconst entry = flatNode.entry;\n\t\tconst node = nodeMap.get(entry.id)!;\n\t\tif (entry.parentId === null || entry.parentId === entry.id) roots.push(node);\n\t\telse {\n\t\t\tconst parent = nodeMap.get(entry.parentId);\n\t\t\tif (parent) parent.children.push(node);\n\t\t\telse roots.push(node);\n\t\t}\n\t}\n\tconst stack: SessionTreeNode[] = [...roots];\n\twhile (stack.length > 0) {\n\t\tconst node = stack.pop()!;\n\t\tnode.children.sort((a, b) => new Date(a.entry.timestamp).getTime() - new Date(b.entry.timestamp).getTime());\n\t\tstack.push(...node.children);\n\t}\n\treturn roots;\n}\n\nfunction applyTreeUsageOverlays(entries: SessionEntry[]): void {\n\tconst assistants = new Map(\n\t\tentries\n\t\t\t.filter((entry) => entry.type === \"message\" && entry.message.role === \"assistant\")\n\t\t\t.map((entry) => [entry.id, entry]),\n\t);\n\tfor (const entry of entries) {\n\t\tif (entry.type !== \"child_usage_attributed\") continue;\n\t\tconst target = assistants.get(entry.targetId);\n\t\tif (target?.type === \"message\" && target.message.role === \"assistant\")\n\t\t\ttarget.message.usage = cloneUsage(entry.aggregateUsage);\n\t}\n}\n\n/** UI projection limits cover visible entries, not excluded request/tool-intent bodies. */\nexport async function readVisibleSessionTreeFlatNodes(\n\tmanager: ReadonlySessionManager,\n\tlimits: SessionHistoryReadLimits = DEFAULT_SESSION_TREE_LIMITS,\n): Promise<{ flatNodes: SessionTreeFlatNode[]; leafId: string | null }> {\n\tconst { maxEntries, maxSourceBytes } = limits;\n\tif (\n\t\t!Number.isSafeInteger(maxEntries) ||\n\t\tmaxEntries <= 0 ||\n\t\t!Number.isSafeInteger(maxSourceBytes) ||\n\t\tmaxSourceBytes <= 0\n\t)\n\t\tthrow new Error(\"Invalid history materialization limits\");\n\tif (!manager.supportsCapturedHistoryReads())\n\t\treturn readSessionTreeFlatNodes(manager, { maxEntries, maxSourceBytes });\n\treturn manager.readSourceHistory(async (history) => {\n\t\tconst entries: SessionEntry[] = [];\n\t\tconst visibleIds = new Set<string>();\n\t\tlet sourceBytes = 0;\n\t\tlet after = 0;\n\t\tfor (;;) {\n\t\t\tconst page = await history.page(after);\n\t\t\tif (page.indexedThrough < history.source.sourceSequence)\n\t\t\t\tthrow new Error(\"Captured history has incomplete index coverage\");\n\t\t\tfor (const ref of page.events) {\n\t\t\t\tif (ref.kind === \"request\" || ref.kind === \"tool_intent\") continue;\n\t\t\t\tif (entries.length >= maxEntries) throw new Error(\"History entry budget exceeded\");\n\t\t\t\tif (sourceBytes + ref.locator.length > maxSourceBytes)\n\t\t\t\t\tthrow new Error(\"History source byte budget exceeded\");\n\t\t\t\tconst hydrated = await history.hydrateEntry(ref.id, maxSourceBytes - sourceBytes);\n\t\t\t\tif (!hydrated) throw new Error(\"Session tree entry source is unavailable\");\n\t\t\t\tsourceBytes += ref.locator.length;\n\t\t\t\tlet parentId = ref.parentId;\n\t\t\t\t// Resolve excluded parent chains as metadata; never retain or hydrate their bodies.\n\t\t\t\twhile (parentId !== null && !visibleIds.has(parentId)) {\n\t\t\t\t\tconst parent = await history.get(parentId);\n\t\t\t\t\tif (!parent || (parent.kind !== \"request\" && parent.kind !== \"tool_intent\")) break;\n\t\t\t\t\tparentId = parent.parentId;\n\t\t\t\t}\n\t\t\t\thydrated.entry.parentId = parentId;\n\t\t\t\tentries.push(hydrated.entry);\n\t\t\t\tvisibleIds.add(ref.id);\n\t\t\t}\n\t\t\tif (page.nextAfter === null) break;\n\t\t\tafter = page.nextAfter;\n\t\t}\n\t\tapplyTreeUsageOverlays(entries);\n\t\tconst result = { flatNodes: buildSessionTreeFlatNodes(entries), leafId: history.source.leafId };\n\t\t// Labels and resolved usage are also part of the bounded visible response.\n\t\tstringifyBoundedJson(result, maxSourceBytes);\n\t\treturn result;\n\t});\n}\n\nexport async function readVisibleSessionTree(\n\tmanager: ReadonlySessionManager,\n\tlimits: SessionHistoryReadLimits = DEFAULT_SESSION_TREE_LIMITS,\n): Promise<{ tree: SessionTreeNode[]; leafId: string | null }> {\n\tconst { flatNodes, leafId } = await readVisibleSessionTreeFlatNodes(manager, limits);\n\treturn { tree: buildSessionTreeFromFlatNodes(flatNodes), leafId };\n}\n\n/** Complete or refuse. Never widen a branch read or return a last-N tree. */\nexport async function readSessionTreeFlatNodes(\n\tmanager: ReadonlySessionManager,\n\tlimits: SessionHistoryReadLimits = DEFAULT_SESSION_TREE_LIMITS,\n): Promise<{ flatNodes: SessionTreeFlatNode[]; leafId: string | null }> {\n\tconst capturedLimits = { ...limits };\n\tlet entries: SessionEntry[];\n\tlet leafId: string | null;\n\tif (manager.supportsCapturedHistoryReads()) {\n\t\tconst history = await manager.materializeSourceHistory(capturedLimits);\n\t\tentries = history.entries.map(({ entry }) => entry);\n\t\tleafId = history.source.leafId;\n\t\tapplyTreeUsageOverlays(entries);\n\t} else {\n\t\t// Explicit readonly/legacy/in-memory views keep their captured resident data.\n\t\t// Their byte limit counts serialized header/entry JSON, not canonical frames.\n\t\tconst history = manager.materializeResidentHistory(capturedLimits);\n\t\tentries = history.entries;\n\t\tleafId = history.leafId;\n\t}\n\treturn { flatNodes: buildSessionTreeFlatNodes(entries), leafId };\n}\n\nexport async function readSessionTree(\n\tmanager: ReadonlySessionManager,\n\tlimits: SessionHistoryReadLimits = DEFAULT_SESSION_TREE_LIMITS,\n): Promise<{ tree: SessionTreeNode[]; leafId: string | null }> {\n\tconst { flatNodes, leafId } = await readSessionTreeFlatNodes(manager, limits);\n\treturn { tree: buildSessionTreeFromFlatNodes(flatNodes), leafId };\n}\n"]}

package/dist/core/settings-manager.d.ts

@@ -10,6 +10,8 @@ export interface CompactionSettings {
     enabled?: boolean;
     reserveTokens?: number;
     keepRecentTokens?: number;
+    /** Soft target; absent uses a model-aware working set, "model-limit" waits for the full window. */
+    targetTokens?: number | "model-limit";
     agentCallable?: boolean;
     /** Absent: inherit the main session model and its current thinking level. */
     model?: CompactionModelSettings;
@@ -303,6 +305,7 @@ export declare class SettingsManager {
         enabled: boolean;
         reserveTokens: number;
         keepRecentTokens: number;
+        targetTokens?: number | "model-limit";
     };
     /** Detached explicit configuration; the request path resolves and validates its model/effort. */
     getAutoRefineModel(): AutoRefineModelSettings | undefined;

package/dist/core/settings-manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"settings-manager.d.ts","sourceRoot":"","sources":["../../src/core/settings-manager.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ThinkingLevel } from \"@ponythewhite/base-context-agent\";\nimport type { ServiceTier, Transport } from \"@ponythewhite/base-context-ai\";\nimport { existsSync, mkdirSync, readFileSync, renameSync, unlinkSync, writeFileSync } from \"fs\";\nimport { homedir } from \"os\";\nimport { dirname, join } from \"path\";\nimport lockfile from \"proper-lockfile\";\nimport { CONFIG_DIR_NAME, getAgentDir } from \"../config.js\";\nimport { assertRlmMaxSubagents, DEFAULT_RLM_MAX_SUBAGENTS } from \"./rlm-max-subagents.js\";\n\nconst RECENT_MODELS_LIMIT = 20;\nexport const DEFAULT_IDLE_EVICTION_MINUTES = 90;\n\nexport interface CompactionModelSettings {\n\tprovider: string;\n\tmodelId: string;\n\tthinkingLevel: ThinkingLevel;\n}\n\nexport interface CompactionSettings {\n\tenabled?: boolean; // default: true\n\treserveTokens?: number; // default: 16384\n\tkeepRecentTokens?: number; // default: 20000\n\tagentCallable?: boolean; // default: true - expose the compact skill so the model can request compaction\n\t/** Absent: inherit the main session model and its current thinking level. */\n\tmodel?: CompactionModelSettings;\n}\n\nexport interface BranchSummaryModelSettings {\n\tprovider: string;\n\tmodelId: string;\n\tthinkingLevel: ThinkingLevel;\n}\n\nexport interface BranchSummarySettings {\n\treserveTokens?: number; // default: 16384 (tokens reserved for prompt + LLM response)\n\tskipPrompt?: boolean; // default: false - when true, skips \"Summarize branch?\" prompt and defaults to no summary\n\t/** Absent: inherit the main model and retain omitted request effort. */\n\tmodel?: BranchSummaryModelSettings;\n}\n\n/** One explicit learning-model selection, shared by the real reviewer and planner. */\nexport interface AutoRefineModelSettings {\n\tprovider: string;\n\tmodelId: string;\n\tthinkingLevel: ThinkingLevel;\n}\n\nexport interface AutoRefineSettings {\n\tenabled?: boolean; // default: true\n\tturnInterval?: number; // default: 25 assistant turns\n\tcompact?: boolean; // default: true\n\tcooldownMs?: number; // default: 20 minutes\n\t/** Absent: inherit the main model and retain legacy omitted request effort. */\n\tmodel?: AutoRefineModelSettings;\n}\n\nexport interface ProviderRetrySettings {\n\ttimeoutMs?: number; // SDK/provider request timeout in milliseconds\n\tmaxRetries?: number; // SDK/provider retry attempts\n\tmaxRetryDelayMs?: number; // default: 60000 (max server-requested delay before failing)\n}\n\nexport interface RetrySettings {\n\tenabled?: boolean; // default: true\n\tmaxRetries?: number; // default: 3\n\tbaseDelayMs?: number; // default: 2000 (exponential backoff: 2s, 4s, 8s)\n\tprovider?: ProviderRetrySettings;\n}\n\nexport interface TerminalSettings {\n\tshowImages?: boolean; // default: true (show image type and dimensions)\n\tclearOnShrink?: boolean; // default: false (clear empty rows when content shrinks)\n\tshowTerminalProgress?: boolean; // default: false (OSC 9;4 terminal progress indicators)\n\tfullscreen?: boolean; // default: true (alternate-screen rendering with scrollable transcript)\n\tfullscreenMouse?: boolean; // default: true\n}\n\nexport interface ImageSettings {\n\tautoResize?: boolean; // default: true (resize images to 2000x2000 max for better model compatibility)\n\tblockImages?: boolean; // default: false - when true, prevents all images from being sent to LLM providers\n}\n\nexport interface ThinkingBudgetsSettings {\n\tminimal?: number;\n\tlow?: number;\n\tmedium?: number;\n\thigh?: number;\n}\n\nexport type MermaidRenderingMode = \"off\" | \"final\" | \"streaming\";\n\nexport interface MarkdownSettings {\n\tcodeBlockIndent?: string; // default: \"  \"\n\tmermaid?: MermaidRenderingMode; // default: \"streaming\"\n}\n\nexport interface BundledSkillsSettings {\n\twebsearch?: boolean; // default: true\n}\n\nexport interface WarningSettings {\n\tanthropicExtraUsage?: boolean; // default: true\n}\n\nexport type TransportSetting = Transport;\n\n/**\n * Package source for npm/git packages.\n * - String form: load all resources from the package\n * - Object form: filter which resources to load\n */\nexport type PackageSource =\n\t| string\n\t| {\n\t\t\tsource: string;\n\t\t\textensions?: string[];\n\t\t\tskills?: string[];\n\t\t\tprompts?: string[];\n\t\t\tthemes?: string[];\n\t  };\n\n/**\n * Remote/local MCP server an integration connects to. Built-in integrations\n * (Linear/Notion) are defined in the ai/mcp catalog; this is for user-declared\n * servers. The kernel-side integration package reads creds from auth.json\n * (`mcp:<name>`); login/refresh run host-side.\n */\nexport type McpServerConfig =\n\t| {\n\t\t\ttype: \"http\";\n\t\t\turl: string;\n\t\t\theaders?: Record<string, string>;\n\t\t\t/** Env var holding a static bearer token (skips OAuth). */\n\t\t\tbearerTokenEnvVar?: string;\n\t\t\t/** Use the generic OAuth login flow for this server. */\n\t\t\toauth?: boolean;\n\t\t\t/** Force-disable even when credentials exist. */\n\t\t\tenabled?: boolean;\n\t\t\tenabledTools?: string[];\n\t\t\tdisabledTools?: string[];\n\t\t\tstartupTimeoutMs?: number;\n\t\t\tcallTimeoutMs?: number;\n\t  }\n\t| {\n\t\t\ttype: \"stdio\";\n\t\t\tcommand: string;\n\t\t\targs?: string[];\n\t\t\tcwd?: string;\n\t\t\t/** Environment variables resolved from the kernel environment. */\n\t\t\tenv?: Record<string, { env: string }>;\n\t\t\tenabled?: boolean;\n\t\t\tenabledTools?: string[];\n\t\t\tdisabledTools?: string[];\n\t\t\tstartupTimeoutMs?: number;\n\t\t\tcallTimeoutMs?: number;\n\t  };\n\nexport interface Settings {\n\tonboardingShown?: boolean;\n\tonboardingCompleted?: boolean;\n\tdefaultProvider?: string;\n\tdefaultModel?: string;\n\trecentModels?: string[]; // \"provider/id\" keys, most-recently-used first\n\tdefaultThinkingLevel?: \"off\" | \"minimal\" | \"low\" | \"medium\" | \"high\" | \"xhigh\" | \"max\";\n\tdefaultServiceTier?: ServiceTier;\n\trlmMaxDepth?: number; // default for new sessions; unset falls through to BASE_CONTEXT_RLM_MAX_DEPTH, then 2\n\trlmMaxSubagents?: number; // root-family live admission limit; default: 4\n\tidleEvictionMinutes?: number | \"off\"; // global daemon policy; default: 90\n\ttransport?: TransportSetting; // default: \"sse\"\n\tsteeringMode?: \"all\" | \"one-at-a-time\";\n\tfollowUpMode?: \"all\" | \"one-at-a-time\";\n\ttheme?: string;\n\t/** Resource caps on complete canonical reconstruction, not model/token/heap limits. */\n\tcanonicalContext?: { maxMessages?: number; maxSourceBytes?: number };\n\t/** Complete native invocation output, separate from the working context. */\n\tinvocationOutput?: { maxMessages?: number; maxSourceBytes?: number };\n\tcompaction?: CompactionSettings;\n\t/** Creation default; an existing session changes policy through its canonical owner. */\n\tcontext?: { mode?: \"on\" | \"off\" };\n\tautoRefine?: AutoRefineSettings;\n\t/** Automatic scoped error-fix notes; explicit memory CRUD remains independent. */\n\tlearning?: { enabled?: boolean };\n\tbranchSummary?: BranchSummarySettings;\n\tretry?: RetrySettings;\n\thideThinkingBlock?: boolean;\n\tshellPath?: string; // Custom shell path (e.g., for Cygwin users on Windows)\n\tquietStartup?: boolean;\n\tshellCommandPrefix?: string; // Prefix prepended to every bash command (e.g., \"shopt -s expand_aliases\" for alias support)\n\tnpmCommand?: string[]; // Command used for npm package lookup/install operations, argv-style (e.g., [\"mise\", \"exec\", \"node@20\", \"--\", \"npm\"])\n\tmcpServers?: Record<string, McpServerConfig>; // User-declared MCP servers (name → config); built-ins are in the ai/mcp catalog\n\tpackages?: PackageSource[];\n\t/** Imported declarations only; never resolved or installed until an explicit package install. */\n\tinactivePackages?: PackageSource[]; // Array of npm/git package sources (string or object with filtering)\n\textensions?: string[]; // Array of local extension file paths or directories\n\tskills?: string[]; // Array of local skill file paths or directories\n\tprompts?: string[]; // Array of local prompt template paths or directories\n\tthemes?: string[]; // Array of local theme file paths or directories\n\tenableSkillCommands?: boolean; // default: true - register skills as /skill:name commands\n\tbundledSkills?: BundledSkillsSettings; // Configure built-in skills shipped with Prime Agent\n\tenableBuiltinSkills?: boolean; // default: true - load built-in skills shipped with prime-agent\n\tterminal?: TerminalSettings;\n\timages?: ImageSettings;\n\tenabledModels?: string[]; // Model patterns for cycling (same format as --models CLI flag)\n\ttreeFilterMode?: \"default\" | \"no-tools\" | \"user-only\" | \"labeled-only\" | \"all\"; // Default: \"user-only\"\n\tthinkingBudgets?: ThinkingBudgetsSettings; // Custom token budgets for thinking levels\n\teditorPaddingX?: number; // Horizontal padding for input editor (default: 0)\n\tautocompleteMaxVisible?: number; // Max visible items in autocomplete dropdown (default: 5)\n\tshowHardwareCursor?: boolean; // Show terminal cursor while still positioning it for IME\n\tmarkdown?: MarkdownSettings;\n\twarnings?: WarningSettings;\n\tsessionDir?: string; // Custom session storage directory (same format as --session-dir CLI flag)\n}\n\n/** Deep merge settings: project/overrides take precedence, nested objects merge recursively */\nfunction deepMergeSettings(base: Settings, overrides: Settings): Settings {\n\tconst result: Settings = { ...base };\n\n\tfor (const key of Object.keys(overrides) as (keyof Settings)[]) {\n\t\tconst overrideValue = overrides[key];\n\t\tconst baseValue = base[key];\n\n\t\tif (overrideValue === undefined) {\n\t\t\tcontinue;\n\t\t}\n\t\tif (\n\t\t\ttypeof overrideValue === \"object\" &&\n\t\t\toverrideValue !== null &&\n\t\t\t!Array.isArray(overrideValue) &&\n\t\t\ttypeof baseValue === \"object\" &&\n\t\t\tbaseValue !== null &&\n\t\t\t!Array.isArray(baseValue)\n\t\t) {\n\t\t\t(result as Record<string, unknown>)[key] = { ...baseValue, ...overrideValue };\n\t\t} else {\n\t\t\t(result as Record<string, unknown>)[key] = overrideValue;\n\t\t}\n\t}\n\n\treturn result;\n}\n\nexport type SettingsScope = \"global\" | \"project\";\n\nexport interface SettingsStorage {\n\twithLock(scope: SettingsScope, fn: (current: string | undefined) => string | undefined): void;\n}\n\nexport interface SettingsError {\n\tscope: SettingsScope;\n\terror: Error;\n}\n\nexport class FileSettingsStorage implements SettingsStorage {\n\tprivate globalSettingsPath: string;\n\tprivate projectSettingsPath: string;\n\n\tconstructor(cwd: string, agentDir: string) {\n\t\tthis.globalSettingsPath = join(agentDir, \"settings.json\");\n\t\tthis.projectSettingsPath = join(cwd, CONFIG_DIR_NAME, \"settings.json\");\n\t}\n\n\tprivate acquireLockSyncWithRetry(path: string): () => void {\n\t\tconst maxAttempts = 10;\n\t\tconst delayMs = 20;\n\t\tlet lastError: unknown;\n\t\tlet compromisedError: Error | undefined;\n\n\t\tfor (let attempt = 1; attempt <= maxAttempts; attempt++) {\n\t\t\ttry {\n\t\t\t\tconst release = lockfile.lockSync(path, {\n\t\t\t\t\trealpath: false,\n\t\t\t\t\tonCompromised: (error) => {\n\t\t\t\t\t\tcompromisedError ??= error;\n\t\t\t\t\t},\n\t\t\t\t});\n\t\t\t\tif (compromisedError) {\n\t\t\t\t\trelease();\n\t\t\t\t\tthrow compromisedError;\n\t\t\t\t}\n\t\t\t\treturn release;\n\t\t\t} catch (error) {\n\t\t\t\tif (compromisedError) throw compromisedError;\n\t\t\t\tconst code =\n\t\t\t\t\ttypeof error === \"object\" && error !== null && \"code\" in error\n\t\t\t\t\t\t? String((error as { code?: unknown }).code)\n\t\t\t\t\t\t: undefined;\n\t\t\t\tif (code !== \"ELOCKED\" || attempt === maxAttempts) {\n\t\t\t\t\tthrow error;\n\t\t\t\t}\n\t\t\t\tlastError = error;\n\t\t\t\tconst start = Date.now();\n\t\t\t\twhile (Date.now() - start < delayMs) {\n\t\t\t\t\t// Sleep synchronously to avoid changing callers to async.\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\n\t\tthrow (lastError as Error) ?? new Error(\"Failed to acquire settings lock\");\n\t}\n\n\twithLock(scope: SettingsScope, fn: (current: string | undefined) => string | undefined): void {\n\t\tconst path = scope === \"global\" ? this.globalSettingsPath : this.projectSettingsPath;\n\t\tconst dir = dirname(path);\n\n\t\tlet release: (() => void) | undefined;\n\t\ttry {\n\t\t\tconst fileExists = existsSync(path);\n\t\t\tif (fileExists) {\n\t\t\t\trelease = this.acquireLockSyncWithRetry(path);\n\t\t\t}\n\t\t\tconst current = fileExists ? readFileSync(path, \"utf-8\") : undefined;\n\t\t\tconst next = fn(current);\n\t\t\tif (next !== undefined) {\n\t\t\t\tif (!existsSync(dir)) {\n\t\t\t\t\tmkdirSync(dir, { recursive: true });\n\t\t\t\t}\n\t\t\t\tif (!release) {\n\t\t\t\t\trelease = this.acquireLockSyncWithRetry(path);\n\t\t\t\t}\n\t\t\t\tconst temporaryPath = `${path}.${process.pid}.${Date.now()}.tmp`;\n\t\t\t\ttry {\n\t\t\t\t\twriteFileSync(temporaryPath, next, { encoding: \"utf-8\", mode: 0o600 });\n\t\t\t\t\trenameSync(temporaryPath, path);\n\t\t\t\t} finally {\n\t\t\t\t\tif (existsSync(temporaryPath)) unlinkSync(temporaryPath);\n\t\t\t\t}\n\t\t\t}\n\t\t} finally {\n\t\t\tif (release) {\n\t\t\t\trelease();\n\t\t\t}\n\t\t}\n\t}\n}\n\nexport class InMemorySettingsStorage implements SettingsStorage {\n\tprivate global: string | undefined;\n\tprivate project: string | undefined;\n\n\twithLock(scope: SettingsScope, fn: (current: string | undefined) => string | undefined): void {\n\t\tconst current = scope === \"global\" ? this.global : this.project;\n\t\tconst next = fn(current);\n\t\tif (next !== undefined) {\n\t\t\tif (scope === \"global\") {\n\t\t\t\tthis.global = next;\n\t\t\t} else {\n\t\t\t\tthis.project = next;\n\t\t\t}\n\t\t}\n\t}\n}\n\nexport class SettingsManager {\n\tprivate storage: SettingsStorage;\n\tprivate globalSettings: Settings;\n\tprivate projectSettings: Settings;\n\tprivate settings: Settings;\n\tprivate runtimeOverrides: Settings = {};\n\tprivate modifiedFields = new Set<keyof Settings>(); // Track global fields modified during session\n\tprivate modifiedNestedFields = new Map<keyof Settings, Set<string>>(); // Track global nested field modifications\n\tprivate modifiedProjectFields = new Set<keyof Settings>(); // Track project fields modified during session\n\tprivate modifiedProjectNestedFields = new Map<keyof Settings, Set<string>>(); // Track project nested field modifications\n\tprivate globalSettingsLoadError: Error | null = null; // Track if global settings file had parse errors\n\tprivate projectSettingsLoadError: Error | null = null; // Track if project settings file had parse errors\n\tprivate writeQueue: Promise<void> = Promise.resolve();\n\tprivate errors: SettingsError[];\n\n\tprivate constructor(\n\t\tstorage: SettingsStorage,\n\t\tinitialGlobal: Settings,\n\t\tinitialProject: Settings,\n\t\tglobalLoadError: Error | null = null,\n\t\tprojectLoadError: Error | null = null,\n\t\tinitialErrors: SettingsError[] = [],\n\t) {\n\t\tthis.storage = storage;\n\t\tthis.globalSettings = initialGlobal;\n\t\tthis.projectSettings = initialProject;\n\t\tthis.globalSettingsLoadError = globalLoadError;\n\t\tthis.projectSettingsLoadError = projectLoadError;\n\t\tthis.errors = [...initialErrors];\n\t\tthis.settings = deepMergeSettings(this.globalSettings, this.projectSettings);\n\t}\n\n\t/** Create a SettingsManager that loads from files */\n\tstatic create(cwd: string, agentDir: string = getAgentDir()): SettingsManager {\n\t\tconst storage = new FileSettingsStorage(cwd, agentDir);\n\t\treturn SettingsManager.fromStorage(storage);\n\t}\n\n\t/** Create a SettingsManager from an arbitrary storage backend */\n\tstatic fromStorage(storage: SettingsStorage): SettingsManager {\n\t\tconst globalLoad = SettingsManager.tryLoadFromStorage(storage, \"global\");\n\t\tconst projectLoad = SettingsManager.tryLoadFromStorage(storage, \"project\");\n\t\tconst initialErrors: SettingsError[] = [];\n\t\tif (globalLoad.error) {\n\t\t\tinitialErrors.push({ scope: \"global\", error: globalLoad.error });\n\t\t}\n\t\tif (projectLoad.error) {\n\t\t\tinitialErrors.push({ scope: \"project\", error: projectLoad.error });\n\t\t}\n\n\t\treturn new SettingsManager(\n\t\t\tstorage,\n\t\t\tglobalLoad.settings,\n\t\t\tprojectLoad.settings,\n\t\t\tglobalLoad.error,\n\t\t\tprojectLoad.error,\n\t\t\tinitialErrors,\n\t\t);\n\t}\n\n\t/** Create an in-memory SettingsManager (no file I/O) */\n\tstatic inMemory(settings: Partial<Settings> = {}): SettingsManager {\n\t\tconst storage = new InMemorySettingsStorage();\n\t\tconst initialSettings = SettingsManager.migrateSettings(structuredClone(settings) as Record<string, unknown>);\n\t\tstorage.withLock(\"global\", () => JSON.stringify(initialSettings, null, 2));\n\t\treturn SettingsManager.fromStorage(storage);\n\t}\n\n\tprivate static loadFromStorage(storage: SettingsStorage, scope: SettingsScope): Settings {\n\t\tlet content: string | undefined;\n\t\tstorage.withLock(scope, (current) => {\n\t\t\tcontent = current;\n\t\t\treturn undefined;\n\t\t});\n\n\t\tif (!content) {\n\t\t\treturn {};\n\t\t}\n\t\tconst settings = JSON.parse(content);\n\t\treturn SettingsManager.migrateSettings(settings);\n\t}\n\n\tprivate static tryLoadFromStorage(\n\t\tstorage: SettingsStorage,\n\t\tscope: SettingsScope,\n\t): { settings: Settings; error: Error | null } {\n\t\ttry {\n\t\t\treturn { settings: SettingsManager.loadFromStorage(storage, scope), error: null };\n\t\t} catch (error) {\n\t\t\treturn { settings: {}, error: error as Error };\n\t\t}\n\t}\n\n\t/** Migrate old settings format to new format */\n\tprivate static migrateSettings(settings: Record<string, unknown>): Settings {\n\t\tif (\"queueMode\" in settings && !(\"steeringMode\" in settings)) {\n\t\t\tsettings.steeringMode = settings.queueMode;\n\t\t\tdelete settings.queueMode;\n\t\t}\n\t\tif (!(\"transport\" in settings) && typeof settings.websockets === \"boolean\") {\n\t\t\tsettings.transport = settings.websockets ? \"websocket\" : \"sse\";\n\t\t\tdelete settings.websockets;\n\t\t}\n\t\tif (\n\t\t\t\"skills\" in settings &&\n\t\t\ttypeof settings.skills === \"object\" &&\n\t\t\tsettings.skills !== null &&\n\t\t\t!Array.isArray(settings.skills)\n\t\t) {\n\t\t\tconst skillsSettings = settings.skills as {\n\t\t\t\tenableSkillCommands?: boolean;\n\t\t\t\tcustomDirectories?: unknown;\n\t\t\t};\n\t\t\tif (skillsSettings.enableSkillCommands !== undefined && settings.enableSkillCommands === undefined) {\n\t\t\t\tsettings.enableSkillCommands = skillsSettings.enableSkillCommands;\n\t\t\t}\n\t\t\tif (Array.isArray(skillsSettings.customDirectories) && skillsSettings.customDirectories.length > 0) {\n\t\t\t\tsettings.skills = skillsSettings.customDirectories;\n\t\t\t} else {\n\t\t\t\tdelete settings.skills;\n\t\t\t}\n\t\t}\n\t\tif (\n\t\t\t\"retry\" in settings &&\n\t\t\ttypeof settings.retry === \"object\" &&\n\t\t\tsettings.retry !== null &&\n\t\t\t!Array.isArray(settings.retry)\n\t\t) {\n\t\t\tconst retrySettings = settings.retry as Record<string, unknown>;\n\t\t\tconst providerSettings =\n\t\t\t\ttypeof retrySettings.provider === \"object\" && retrySettings.provider !== null\n\t\t\t\t\t? (retrySettings.provider as Record<string, unknown>)\n\t\t\t\t\t: undefined;\n\t\t\tif (\n\t\t\t\ttypeof retrySettings.maxDelayMs === \"number\" &&\n\t\t\t\t(providerSettings?.maxRetryDelayMs === undefined || providerSettings?.maxRetryDelayMs === null)\n\t\t\t) {\n\t\t\t\tretrySettings.provider = {\n\t\t\t\t\t...(providerSettings ?? {}),\n\t\t\t\t\tmaxRetryDelayMs: retrySettings.maxDelayMs,\n\t\t\t\t};\n\t\t\t}\n\t\t\tdelete retrySettings.maxDelayMs;\n\t\t}\n\n\t\tif (\n\t\t\tsettings.markdown !== undefined &&\n\t\t\t(typeof settings.markdown !== \"object\" || settings.markdown === null || Array.isArray(settings.markdown))\n\t\t) {\n\t\t\tdelete settings.markdown;\n\t\t}\n\n\t\treturn settings as Settings;\n\t}\n\n\tgetGlobalSettings(): Settings {\n\t\treturn structuredClone(this.globalSettings);\n\t}\n\n\tgetProjectSettings(): Settings {\n\t\treturn structuredClone(this.projectSettings);\n\t}\n\n\tasync reload(): Promise<void> {\n\t\tawait this.writeQueue;\n\t\tconst globalLoad = SettingsManager.tryLoadFromStorage(this.storage, \"global\");\n\t\tif (!globalLoad.error) {\n\t\t\tthis.globalSettings = globalLoad.settings;\n\t\t\tthis.globalSettingsLoadError = null;\n\t\t} else {\n\t\t\tthis.globalSettingsLoadError = globalLoad.error;\n\t\t\tthis.recordError(\"global\", globalLoad.error);\n\t\t}\n\n\t\tthis.modifiedFields.clear();\n\t\tthis.modifiedNestedFields.clear();\n\t\tthis.modifiedProjectFields.clear();\n\t\tthis.modifiedProjectNestedFields.clear();\n\n\t\tconst projectLoad = SettingsManager.tryLoadFromStorage(this.storage, \"project\");\n\t\tif (!projectLoad.error) {\n\t\t\tthis.projectSettings = projectLoad.settings;\n\t\t\tthis.projectSettingsLoadError = null;\n\t\t} else {\n\t\t\tthis.projectSettingsLoadError = projectLoad.error;\n\t\t\tthis.recordError(\"project\", projectLoad.error);\n\t\t}\n\n\t\tthis.settings = deepMergeSettings(this.globalSettings, this.projectSettings);\n\t}\n\n\t/** Apply additional overrides on top of current settings */\n\tapplyOverrides(overrides: Partial<Settings>): void {\n\t\tthis.runtimeOverrides = deepMergeSettings(this.runtimeOverrides, overrides);\n\t\tthis.settings = deepMergeSettings(this.settings, overrides);\n\t}\n\n\t/** Mark a global field as modified during this session */\n\tprivate markModified(field: keyof Settings, nestedKey?: string): void {\n\t\tthis.modifiedFields.add(field);\n\t\tif (nestedKey) {\n\t\t\tif (!this.modifiedNestedFields.has(field)) {\n\t\t\t\tthis.modifiedNestedFields.set(field, new Set());\n\t\t\t}\n\t\t\tthis.modifiedNestedFields.get(field)!.add(nestedKey);\n\t\t}\n\t}\n\n\t/** Mark a project field as modified during this session */\n\tprivate markProjectModified(field: keyof Settings, nestedKey?: string): void {\n\t\tthis.modifiedProjectFields.add(field);\n\t\tif (nestedKey) {\n\t\t\tif (!this.modifiedProjectNestedFields.has(field)) {\n\t\t\t\tthis.modifiedProjectNestedFields.set(field, new Set());\n\t\t\t}\n\t\t\tthis.modifiedProjectNestedFields.get(field)!.add(nestedKey);\n\t\t}\n\t}\n\n\tprivate recordError(scope: SettingsScope, error: unknown): void {\n\t\tconst normalizedError = error instanceof Error ? error : new Error(String(error));\n\t\tthis.errors.push({ scope, error: normalizedError });\n\t}\n\n\tprivate clearModifiedScope(scope: SettingsScope): void {\n\t\tif (scope === \"global\") {\n\t\t\tthis.modifiedFields.clear();\n\t\t\tthis.modifiedNestedFields.clear();\n\t\t\treturn;\n\t\t}\n\n\t\tthis.modifiedProjectFields.clear();\n\t\tthis.modifiedProjectNestedFields.clear();\n\t}\n\n\tprivate enqueueWrite(scope: SettingsScope, task: () => void): void {\n\t\tthis.writeQueue = this.writeQueue\n\t\t\t.then(() => {\n\t\t\t\ttask();\n\t\t\t\tthis.clearModifiedScope(scope);\n\t\t\t})\n\t\t\t.catch((error) => {\n\t\t\t\tthis.recordError(scope, error);\n\t\t\t});\n\t}\n\n\tprivate cloneModifiedNestedFields(source: Map<keyof Settings, Set<string>>): Map<keyof Settings, Set<string>> {\n\t\tconst snapshot = new Map<keyof Settings, Set<string>>();\n\t\tfor (const [key, value] of source.entries()) {\n\t\t\tsnapshot.set(key, new Set(value));\n\t\t}\n\t\treturn snapshot;\n\t}\n\n\tprivate persistScopedSettings(\n\t\tscope: SettingsScope,\n\t\tsnapshotSettings: Settings,\n\t\tmodifiedFields: Set<keyof Settings>,\n\t\tmodifiedNestedFields: Map<keyof Settings, Set<string>>,\n\t): void {\n\t\tthis.storage.withLock(scope, (current) => {\n\t\t\tconst currentFileSettings = current\n\t\t\t\t? SettingsManager.migrateSettings(JSON.parse(current) as Record<string, unknown>)\n\t\t\t\t: {};\n\t\t\tconst mergedSettings: Settings = { ...currentFileSettings };\n\t\t\tfor (const field of modifiedFields) {\n\t\t\t\tconst value = snapshotSettings[field];\n\t\t\t\tif (modifiedNestedFields.has(field) && typeof value === \"object\" && value !== null) {\n\t\t\t\t\tconst nestedModified = modifiedNestedFields.get(field)!;\n\t\t\t\t\tconst baseNested = (currentFileSettings[field] as Record<string, unknown>) ?? {};\n\t\t\t\t\tconst inMemoryNested = value as Record<string, unknown>;\n\t\t\t\t\tconst mergedNested = { ...baseNested };\n\t\t\t\t\tfor (const nestedKey of nestedModified) {\n\t\t\t\t\t\tmergedNested[nestedKey] = inMemoryNested[nestedKey];\n\t\t\t\t\t}\n\t\t\t\t\t(mergedSettings as Record<string, unknown>)[field] = mergedNested;\n\t\t\t\t} else {\n\t\t\t\t\t(mergedSettings as Record<string, unknown>)[field] = value;\n\t\t\t\t}\n\t\t\t}\n\n\t\t\treturn JSON.stringify(mergedSettings, null, 2);\n\t\t});\n\t}\n\n\tprivate save(): void {\n\t\tthis.settings = deepMergeSettings(this.globalSettings, this.projectSettings);\n\n\t\tif (this.globalSettingsLoadError) {\n\t\t\tthis.recordError(\n\t\t\t\t\"global\",\n\t\t\t\tnew Error(\n\t\t\t\t\t`Global settings not saved: settings file failed to parse: ${this.globalSettingsLoadError.message}`,\n\t\t\t\t),\n\t\t\t);\n\t\t\treturn;\n\t\t}\n\n\t\tconst snapshotGlobalSettings = structuredClone(this.globalSettings);\n\t\tconst modifiedFields = new Set(this.modifiedFields);\n\t\tconst modifiedNestedFields = this.cloneModifiedNestedFields(this.modifiedNestedFields);\n\n\t\tthis.enqueueWrite(\"global\", () => {\n\t\t\tthis.persistScopedSettings(\"global\", snapshotGlobalSettings, modifiedFields, modifiedNestedFields);\n\t\t});\n\t}\n\n\tprivate saveProjectSettings(settings: Settings): void {\n\t\tthis.projectSettings = structuredClone(settings);\n\t\tthis.settings = deepMergeSettings(this.globalSettings, this.projectSettings);\n\n\t\tif (this.projectSettingsLoadError) {\n\t\t\tthis.recordError(\n\t\t\t\t\"project\",\n\t\t\t\tnew Error(\n\t\t\t\t\t`Project settings not saved: settings file failed to parse: ${this.projectSettingsLoadError.message}`,\n\t\t\t\t),\n\t\t\t);\n\t\t\treturn;\n\t\t}\n\n\t\tconst snapshotProjectSettings = structuredClone(this.projectSettings);\n\t\tconst modifiedFields = new Set(this.modifiedProjectFields);\n\t\tconst modifiedNestedFields = this.cloneModifiedNestedFields(this.modifiedProjectNestedFields);\n\t\tthis.enqueueWrite(\"project\", () => {\n\t\t\tthis.persistScopedSettings(\"project\", snapshotProjectSettings, modifiedFields, modifiedNestedFields);\n\t\t});\n\t}\n\n\tasync flush(): Promise<void> {\n\t\tawait this.writeQueue;\n\t}\n\n\tdrainErrors(scope?: SettingsScope): SettingsError[] {\n\t\tif (!scope) {\n\t\t\tconst drained = [...this.errors];\n\t\t\tthis.errors = [];\n\t\t\treturn drained;\n\t\t}\n\t\tconst drained = this.errors.filter((entry) => entry.scope === scope);\n\t\tthis.errors = this.errors.filter((entry) => entry.scope !== scope);\n\t\treturn drained;\n\t}\n\n\tgetOnboardingShown(): boolean {\n\t\treturn this.settings.onboardingShown ?? this.settings.onboardingCompleted ?? false;\n\t}\n\n\tsetOnboardingShown(shown: boolean): void {\n\t\tthis.globalSettings.onboardingShown = shown;\n\t\tthis.markModified(\"onboardingShown\");\n\t\tthis.save();\n\t}\n\n\tgetSessionDir(): string | undefined {\n\t\tconst sessionDir = this.settings.sessionDir;\n\t\tif (!sessionDir) {\n\t\t\treturn sessionDir;\n\t\t}\n\t\tif (sessionDir === \"~\") {\n\t\t\treturn homedir();\n\t\t}\n\t\tif (sessionDir.startsWith(\"~/\")) {\n\t\t\treturn join(homedir(), sessionDir.slice(2));\n\t\t}\n\t\treturn sessionDir;\n\t}\n\n\tgetDefaultProvider(): string | undefined {\n\t\treturn this.settings.defaultProvider;\n\t}\n\n\tgetDefaultModel(): string | undefined {\n\t\treturn this.settings.defaultModel;\n\t}\n\n\tsetDefaultProvider(provider: string): void {\n\t\tthis.globalSettings.defaultProvider = provider;\n\t\tthis.markModified(\"defaultProvider\");\n\t\tthis.save();\n\t}\n\n\tsetDefaultModel(modelId: string): void {\n\t\tthis.globalSettings.defaultModel = modelId;\n\t\tthis.markModified(\"defaultModel\");\n\t\tthis.save();\n\t}\n\n\tsetDefaultModelAndProvider(provider: string, modelId: string): void {\n\t\tthis.globalSettings.defaultProvider = provider;\n\t\tthis.globalSettings.defaultModel = modelId;\n\t\tthis.markModified(\"defaultProvider\");\n\t\tthis.markModified(\"defaultModel\");\n\t\tthis.recordModelUseInternal(provider, modelId);\n\t\tthis.markModified(\"recentModels\");\n\t\tthis.save();\n\t}\n\n\tgetRecentModels(): string[] {\n\t\treturn this.settings.recentModels ?? [];\n\t}\n\n\tprivate recordModelUseInternal(provider: string, modelId: string): void {\n\t\tconst key = `${provider}/${modelId}`;\n\t\tconst next = [key, ...this.getRecentModels().filter((k) => k !== key)];\n\t\tthis.globalSettings.recentModels = next.slice(0, RECENT_MODELS_LIMIT);\n\t}\n\n\tgetSteeringMode(): \"all\" | \"one-at-a-time\" {\n\t\treturn this.settings.steeringMode || \"one-at-a-time\";\n\t}\n\n\tsetSteeringMode(mode: \"all\" | \"one-at-a-time\"): void {\n\t\tthis.globalSettings.steeringMode = mode;\n\t\tthis.markModified(\"steeringMode\");\n\t\tthis.save();\n\t}\n\n\tgetFollowUpMode(): \"all\" | \"one-at-a-time\" {\n\t\treturn this.settings.followUpMode || \"one-at-a-time\";\n\t}\n\n\tsetFollowUpMode(mode: \"all\" | \"one-at-a-time\"): void {\n\t\tthis.globalSettings.followUpMode = mode;\n\t\tthis.markModified(\"followUpMode\");\n\t\tthis.save();\n\t}\n\n\tgetTheme(): string | undefined {\n\t\treturn this.settings.theme;\n\t}\n\n\tsetTheme(theme: string): void {\n\t\tthis.globalSettings.theme = theme;\n\t\tthis.markModified(\"theme\");\n\t\tthis.save();\n\t}\n\n\tgetDefaultThinkingLevel(): \"off\" | \"minimal\" | \"low\" | \"medium\" | \"high\" | \"xhigh\" | \"max\" | undefined {\n\t\treturn this.settings.defaultThinkingLevel;\n\t}\n\n\tsetDefaultThinkingLevel(level: \"off\" | \"minimal\" | \"low\" | \"medium\" | \"high\" | \"xhigh\" | \"max\"): void {\n\t\tthis.globalSettings.defaultThinkingLevel = level;\n\t\tthis.markModified(\"defaultThinkingLevel\");\n\t\tthis.save();\n\t}\n\n\tgetDefaultServiceTier(): ServiceTier {\n\t\treturn this.settings.defaultServiceTier ?? \"default\";\n\t}\n\n\tsetDefaultServiceTier(serviceTier: ServiceTier): void {\n\t\tthis.globalSettings.defaultServiceTier = serviceTier;\n\t\tthis.markModified(\"defaultServiceTier\");\n\t\tthis.save();\n\t}\n\n\tgetRlmMaxSubagents(): number {\n\t\tconst value = this.globalSettings.rlmMaxSubagents ?? DEFAULT_RLM_MAX_SUBAGENTS;\n\t\tassertRlmMaxSubagents(value);\n\t\treturn value;\n\t}\n\n\tsetRlmMaxSubagents(maxSubagents: number): void {\n\t\tassertRlmMaxSubagents(maxSubagents);\n\t\tthis.globalSettings.rlmMaxSubagents = maxSubagents;\n\t\tthis.markModified(\"rlmMaxSubagents\");\n\t\tthis.save();\n\t}\n\n\tgetRlmMaxDepth(): number | undefined {\n\t\treturn this.globalSettings.rlmMaxDepth;\n\t}\n\n\tsetRlmMaxDepth(maxDepth: number): void {\n\t\tthis.globalSettings.rlmMaxDepth = maxDepth;\n\t\tthis.markModified(\"rlmMaxDepth\");\n\t\tthis.save();\n\t}\n\n\tgetIdleEvictionMinutes(): number | \"off\" {\n\t\tconst value: unknown = this.globalSettings.idleEvictionMinutes;\n\t\tif (value === \"off\" || value === \"none\") return \"off\";\n\t\treturn typeof value === \"number\" && Number.isFinite(value) && value > 0 ? value : DEFAULT_IDLE_EVICTION_MINUTES;\n\t}\n\n\tsetIdleEvictionMinutes(value: number | \"off\"): void {\n\t\tif (value !== \"off\" && (!Number.isFinite(value) || value <= 0)) {\n\t\t\tthrow new Error(\"Idle eviction minutes must be a positive number or off\");\n\t\t}\n\t\tthis.globalSettings.idleEvictionMinutes = value;\n\t\tthis.markModified(\"idleEvictionMinutes\");\n\t\tthis.save();\n\t}\n\n\tgetTransport(): TransportSetting {\n\t\treturn this.settings.transport ?? \"sse\";\n\t}\n\n\tsetTransport(transport: TransportSetting): void {\n\t\tthis.globalSettings.transport = transport;\n\t\tthis.markModified(\"transport\");\n\t\tthis.save();\n\t}\n\n\t/** Resolve resource caps without truncating or changing context selection. */\n\tgetCanonicalContextLimits(): { maxMessages: number; maxSourceBytes: number } {\n\t\tconst configured = this.settings.canonicalContext;\n\t\tif (\n\t\t\tconfigured !== undefined &&\n\t\t\t(typeof configured !== \"object\" || configured === null || Array.isArray(configured))\n\t\t)\n\t\t\tthrow new Error(\"canonicalContext must be an object\");\n\t\tconst limits = {\n\t\t\tmaxMessages: configured?.maxMessages === undefined ? 16384 : configured.maxMessages,\n\t\t\tmaxSourceBytes: configured?.maxSourceBytes === undefined ? 64 * 1024 * 1024 : configured.maxSourceBytes,\n\t\t};\n\t\tfor (const [field, value] of Object.entries(limits)) {\n\t\t\tif (!Number.isSafeInteger(value) || value <= 0)\n\t\t\t\tthrow new Error(`canonicalContext.${field} must be a positive safe integer`);\n\t\t}\n\t\treturn limits;\n\t}\n\n\tgetInvocationOutputLimits(): { maxMessages: number; maxSourceBytes: number } {\n\t\tconst configured = this.settings.invocationOutput;\n\t\tif (\n\t\t\tconfigured !== undefined &&\n\t\t\t(typeof configured !== \"object\" || configured === null || Array.isArray(configured))\n\t\t)\n\t\t\tthrow new Error(\"invocationOutput must be an object\");\n\t\tconst limits = {\n\t\t\tmaxMessages: configured?.maxMessages === undefined ? 16384 : configured.maxMessages,\n\t\t\tmaxSourceBytes: configured?.maxSourceBytes === undefined ? 64 * 1024 * 1024 : configured.maxSourceBytes,\n\t\t};\n\t\tfor (const [field, value] of Object.entries(limits)) {\n\t\t\tif (!Number.isSafeInteger(value) || value <= 0)\n\t\t\t\tthrow new Error(`invocationOutput.${field} must be a positive safe integer`);\n\t\t}\n\t\treturn limits;\n\t}\n\n\tgetContextMode(): \"on\" | \"off\" {\n\t\tconst mode = this.settings.context?.mode ?? \"on\";\n\t\tif (mode !== \"on\" && mode !== \"off\") throw new Error(\"context.mode must be on or off\");\n\t\treturn mode;\n\t}\n\n\tgetCompactionEnabled(): boolean {\n\t\treturn this.settings.compaction?.enabled ?? true;\n\t}\n\n\tsetCompactionEnabled(enabled: boolean): void {\n\t\tif (!this.globalSettings.compaction) {\n\t\t\tthis.globalSettings.compaction = {};\n\t\t}\n\t\tthis.globalSettings.compaction.enabled = enabled;\n\t\tthis.markModified(\"compaction\", \"enabled\");\n\t\tthis.save();\n\t}\n\n\tgetCompactionReserveTokens(): number {\n\t\treturn this.settings.compaction?.reserveTokens ?? 16384;\n\t}\n\n\tgetCompactionKeepRecentTokens(): number {\n\t\treturn this.settings.compaction?.keepRecentTokens ?? 20000;\n\t}\n\n\tgetCompactionAgentCallable(): boolean {\n\t\treturn this.settings.compaction?.agentCallable ?? true;\n\t}\n\n\t/** Detached explicit configuration; compaction resolves and validates its model/effort. */\n\tgetCompactionModel(): CompactionModelSettings | undefined {\n\t\tconst model = this.settings.compaction?.model;\n\t\treturn model === undefined ? undefined : structuredClone(model);\n\t}\n\n\tgetCompactionSettings(): { enabled: boolean; reserveTokens: number; keepRecentTokens: number } {\n\t\treturn {\n\t\t\tenabled: this.getCompactionEnabled(),\n\t\t\treserveTokens: this.getCompactionReserveTokens(),\n\t\t\tkeepRecentTokens: this.getCompactionKeepRecentTokens(),\n\t\t};\n\t}\n\n\t/** Detached explicit configuration; the request path resolves and validates its model/effort. */\n\tgetAutoRefineModel(): AutoRefineModelSettings | undefined {\n\t\tconst model = this.settings.autoRefine?.model;\n\t\treturn model === undefined ? undefined : structuredClone(model);\n\t}\n\n\tgetLearningEnabled(): boolean {\n\t\treturn this.settings.learning?.enabled === true;\n\t}\n\n\tgetAutoRefineSettings(): { enabled: boolean; turnInterval: number; compact: boolean; cooldownMs: number } {\n\t\tconst turnInterval = this.settings.autoRefine?.turnInterval;\n\t\tconst cooldownMs = this.settings.autoRefine?.cooldownMs;\n\t\treturn {\n\t\t\tenabled: this.settings.autoRefine?.enabled ?? true,\n\t\t\tturnInterval: Math.max(\n\t\t\t\t1,\n\t\t\t\ttypeof turnInterval === \"number\" && Number.isFinite(turnInterval) ? turnInterval : 25,\n\t\t\t),\n\t\t\tcompact: this.settings.autoRefine?.compact ?? true,\n\t\t\tcooldownMs: Math.max(\n\t\t\t\t0,\n\t\t\t\ttypeof cooldownMs === \"number\" && Number.isFinite(cooldownMs) ? cooldownMs : 20 * 60_000,\n\t\t\t),\n\t\t};\n\t}\n\n\t/** Detached explicit configuration; branch navigation validates the selected model/effort. */\n\tgetBranchSummaryModel(): BranchSummaryModelSettings | undefined {\n\t\tconst model = this.settings.branchSummary?.model;\n\t\treturn model === undefined ? undefined : structuredClone(model);\n\t}\n\n\tgetBranchSummarySettings(): { reserveTokens: number; skipPrompt: boolean } {\n\t\treturn {\n\t\t\treserveTokens: this.settings.branchSummary?.reserveTokens ?? 16384,\n\t\t\tskipPrompt: this.settings.branchSummary?.skipPrompt ?? false,\n\t\t};\n\t}\n\n\tgetBranchSummarySkipPrompt(): boolean {\n\t\treturn this.settings.branchSummary?.skipPrompt ?? false;\n\t}\n\n\tgetRetryEnabled(): boolean {\n\t\treturn this.settings.retry?.enabled ?? true;\n\t}\n\n\tsetRetryEnabled(enabled: boolean): void {\n\t\tif (!this.globalSettings.retry) {\n\t\t\tthis.globalSettings.retry = {};\n\t\t}\n\t\tthis.globalSettings.retry.enabled = enabled;\n\t\tthis.markModified(\"retry\", \"enabled\");\n\t\tthis.save();\n\t}\n\n\tgetRetrySettings(): { enabled: boolean; maxRetries: number; baseDelayMs: number } {\n\t\treturn {\n\t\t\tenabled: this.getRetryEnabled(),\n\t\t\tmaxRetries: this.settings.retry?.maxRetries ?? 3,\n\t\t\tbaseDelayMs: this.settings.retry?.baseDelayMs ?? 2000,\n\t\t};\n\t}\n\n\tgetProviderRetrySettings(): { timeoutMs?: number; maxRetries?: number; maxRetryDelayMs: number } {\n\t\treturn {\n\t\t\ttimeoutMs: this.settings.retry?.provider?.timeoutMs,\n\t\t\tmaxRetries: this.settings.retry?.provider?.maxRetries,\n\t\t\tmaxRetryDelayMs: this.settings.retry?.provider?.maxRetryDelayMs ?? 60000,\n\t\t};\n\t}\n\n\tgetHideThinkingBlock(): boolean {\n\t\treturn this.settings.hideThinkingBlock ?? false;\n\t}\n\n\tsetHideThinkingBlock(hide: boolean): void {\n\t\tthis.globalSettings.hideThinkingBlock = hide;\n\t\tthis.markModified(\"hideThinkingBlock\");\n\t\tthis.save();\n\t}\n\n\tgetShellPath(): string | undefined {\n\t\treturn this.settings.shellPath;\n\t}\n\n\tsetShellPath(path: string | undefined): void {\n\t\tthis.globalSettings.shellPath = path;\n\t\tthis.markModified(\"shellPath\");\n\t\tthis.save();\n\t}\n\n\tgetQuietStartup(): boolean {\n\t\treturn this.settings.quietStartup ?? false;\n\t}\n\n\tsetQuietStartup(quiet: boolean): void {\n\t\tthis.globalSettings.quietStartup = quiet;\n\t\tthis.markModified(\"quietStartup\");\n\t\tthis.save();\n\t}\n\n\tgetShellCommandPrefix(): string | undefined {\n\t\treturn this.settings.shellCommandPrefix;\n\t}\n\n\tsetShellCommandPrefix(prefix: string | undefined): void {\n\t\tthis.globalSettings.shellCommandPrefix = prefix;\n\t\tthis.markModified(\"shellCommandPrefix\");\n\t\tthis.save();\n\t}\n\n\tgetNpmCommand(): string[] | undefined {\n\t\treturn this.settings.npmCommand ? [...this.settings.npmCommand] : undefined;\n\t}\n\n\tsetNpmCommand(command: string[] | undefined): void {\n\t\tthis.globalSettings.npmCommand = command ? [...command] : undefined;\n\t\tthis.markModified(\"npmCommand\");\n\t\tthis.save();\n\t}\n\n\tgetPackages(): PackageSource[] {\n\t\treturn [...(this.settings.packages ?? [])];\n\t}\n\n\tsetPackages(packages: PackageSource[], inactivePackages?: PackageSource[]): void {\n\t\tthis.globalSettings.packages = packages;\n\t\tthis.markModified(\"packages\");\n\t\tif (inactivePackages !== undefined) {\n\t\t\tthis.globalSettings.inactivePackages = inactivePackages;\n\t\t\tthis.markModified(\"inactivePackages\");\n\t\t}\n\t\tthis.save();\n\t}\n\n\tsetProjectPackages(packages: PackageSource[], inactivePackages?: PackageSource[]): void {\n\t\tconst projectSettings = structuredClone(this.projectSettings);\n\t\tprojectSettings.packages = packages;\n\t\tthis.markProjectModified(\"packages\");\n\t\tif (inactivePackages !== undefined) {\n\t\t\tprojectSettings.inactivePackages = inactivePackages;\n\t\t\tthis.markProjectModified(\"inactivePackages\");\n\t\t}\n\t\tthis.saveProjectSettings(projectSettings);\n\t}\n\n\tgetExtensionPaths(): string[] {\n\t\treturn [...(this.settings.extensions ?? [])];\n\t}\n\n\tsetExtensionPaths(paths: string[]): void {\n\t\tthis.globalSettings.extensions = paths;\n\t\tthis.markModified(\"extensions\");\n\t\tthis.save();\n\t}\n\n\tsetProjectExtensionPaths(paths: string[]): void {\n\t\tconst projectSettings = structuredClone(this.projectSettings);\n\t\tprojectSettings.extensions = paths;\n\t\tthis.markProjectModified(\"extensions\");\n\t\tthis.saveProjectSettings(projectSettings);\n\t}\n\n\tgetSkillPaths(): string[] {\n\t\treturn [...(this.settings.skills ?? [])];\n\t}\n\n\tsetSkillPaths(paths: string[]): void {\n\t\tthis.globalSettings.skills = paths;\n\t\tthis.markModified(\"skills\");\n\t\tthis.save();\n\t}\n\n\tsetProjectSkillPaths(paths: string[]): void {\n\t\tconst projectSettings = structuredClone(this.projectSettings);\n\t\tprojectSettings.skills = paths;\n\t\tthis.markProjectModified(\"skills\");\n\t\tthis.saveProjectSettings(projectSettings);\n\t}\n\n\tgetPromptTemplatePaths(): string[] {\n\t\treturn [...(this.settings.prompts ?? [])];\n\t}\n\n\tsetPromptTemplatePaths(paths: string[]): void {\n\t\tthis.globalSettings.prompts = paths;\n\t\tthis.markModified(\"prompts\");\n\t\tthis.save();\n\t}\n\n\tsetProjectPromptTemplatePaths(paths: string[]): void {\n\t\tconst projectSettings = structuredClone(this.projectSettings);\n\t\tprojectSettings.prompts = paths;\n\t\tthis.markProjectModified(\"prompts\");\n\t\tthis.saveProjectSettings(projectSettings);\n\t}\n\n\tgetThemePaths(): string[] {\n\t\treturn [...(this.settings.themes ?? [])];\n\t}\n\n\tsetThemePaths(paths: string[]): void {\n\t\tthis.globalSettings.themes = paths;\n\t\tthis.markModified(\"themes\");\n\t\tthis.save();\n\t}\n\n\tsetProjectThemePaths(paths: string[]): void {\n\t\tconst projectSettings = structuredClone(this.projectSettings);\n\t\tprojectSettings.themes = paths;\n\t\tthis.markProjectModified(\"themes\");\n\t\tthis.saveProjectSettings(projectSettings);\n\t}\n\n\tgetEnableSkillCommands(): boolean {\n\t\treturn this.settings.enableSkillCommands ?? true;\n\t}\n\n\tsetEnableSkillCommands(enabled: boolean): void {\n\t\tthis.globalSettings.enableSkillCommands = enabled;\n\t\tthis.markModified(\"enableSkillCommands\");\n\t\tthis.save();\n\t}\n\n\tgetBundledSkills(): { websearch: boolean } {\n\t\treturn {\n\t\t\twebsearch: this.settings.bundledSkills?.websearch ?? true,\n\t\t};\n\t}\n\n\tgetBundledWebsearchEnabled(): boolean {\n\t\treturn this.getBundledSkills().websearch;\n\t}\n\n\tgetEnableBuiltinSkills(): boolean {\n\t\treturn this.settings.enableBuiltinSkills ?? true;\n\t}\n\n\tsetEnableBuiltinSkills(enabled: boolean): void {\n\t\tthis.globalSettings.enableBuiltinSkills = enabled;\n\t\tthis.markModified(\"enableBuiltinSkills\");\n\t\tthis.save();\n\t}\n\n\tgetThinkingBudgets(): ThinkingBudgetsSettings | undefined {\n\t\treturn this.settings.thinkingBudgets;\n\t}\n\n\tgetShowImages(): boolean {\n\t\treturn this.settings.terminal?.showImages ?? true;\n\t}\n\n\tsetShowImages(show: boolean): void {\n\t\tif (!this.globalSettings.terminal) {\n\t\t\tthis.globalSettings.terminal = {};\n\t\t}\n\t\tthis.globalSettings.terminal.showImages = show;\n\t\tthis.markModified(\"terminal\", \"showImages\");\n\t\tthis.save();\n\t}\n\n\tgetClearOnShrink(): boolean {\n\t\tif (this.settings.terminal?.clearOnShrink !== undefined) {\n\t\t\treturn this.settings.terminal.clearOnShrink;\n\t\t}\n\t\treturn process.env.BASE_CONTEXT_CLEAR_ON_SHRINK === \"1\";\n\t}\n\n\tsetClearOnShrink(enabled: boolean): void {\n\t\tif (!this.globalSettings.terminal) {\n\t\t\tthis.globalSettings.terminal = {};\n\t\t}\n\t\tthis.globalSettings.terminal.clearOnShrink = enabled;\n\t\tthis.markModified(\"terminal\", \"clearOnShrink\");\n\t\tthis.save();\n\t}\n\n\tgetFullscreen(): boolean {\n\t\tif (process.env.BASE_CONTEXT_FULLSCREEN !== undefined) {\n\t\t\treturn process.env.BASE_CONTEXT_FULLSCREEN === \"1\";\n\t\t}\n\t\treturn this.settings.terminal?.fullscreen ?? true;\n\t}\n\n\tsetFullscreen(enabled: boolean): void {\n\t\tif (!this.globalSettings.terminal) {\n\t\t\tthis.globalSettings.terminal = {};\n\t\t}\n\t\tthis.globalSettings.terminal.fullscreen = enabled;\n\t\tthis.markModified(\"terminal\", \"fullscreen\");\n\t\tthis.save();\n\t}\n\n\tgetFullscreenMouse(): boolean {\n\t\treturn this.settings.terminal?.fullscreenMouse ?? true;\n\t}\n\n\tsetFullscreenMouse(enabled: boolean): void {\n\t\tif (!this.globalSettings.terminal) {\n\t\t\tthis.globalSettings.terminal = {};\n\t\t}\n\t\tthis.globalSettings.terminal.fullscreenMouse = enabled;\n\t\tthis.markModified(\"terminal\", \"fullscreenMouse\");\n\t\tthis.save();\n\t}\n\n\tgetShowTerminalProgress(): boolean {\n\t\treturn this.settings.terminal?.showTerminalProgress ?? false;\n\t}\n\n\tsetShowTerminalProgress(enabled: boolean): void {\n\t\tif (!this.globalSettings.terminal) {\n\t\t\tthis.globalSettings.terminal = {};\n\t\t}\n\t\tthis.globalSettings.terminal.showTerminalProgress = enabled;\n\t\tthis.markModified(\"terminal\", \"showTerminalProgress\");\n\t\tthis.save();\n\t}\n\n\tgetImageAutoResize(): boolean {\n\t\treturn this.settings.images?.autoResize ?? true;\n\t}\n\n\tsetImageAutoResize(enabled: boolean): void {\n\t\tif (!this.globalSettings.images) {\n\t\t\tthis.globalSettings.images = {};\n\t\t}\n\t\tthis.globalSettings.images.autoResize = enabled;\n\t\tthis.markModified(\"images\", \"autoResize\");\n\t\tthis.save();\n\t}\n\n\tgetBlockImages(): boolean {\n\t\treturn this.settings.images?.blockImages ?? false;\n\t}\n\n\tsetBlockImages(blocked: boolean): void {\n\t\tif (!this.globalSettings.images) {\n\t\t\tthis.globalSettings.images = {};\n\t\t}\n\t\tthis.globalSettings.images.blockImages = blocked;\n\t\tthis.markModified(\"images\", \"blockImages\");\n\t\tthis.save();\n\t}\n\n\tgetEnabledModels(): string[] | undefined {\n\t\treturn this.settings.enabledModels;\n\t}\n\n\t/** MCP execution is intentionally restricted to user/global settings. */\n\tgetGlobalMcpServers(): Record<string, McpServerConfig> | undefined {\n\t\treturn structuredClone(this.globalSettings.mcpServers);\n\t}\n\n\tsetGlobalMcpServer(name: string, config: McpServerConfig, force = false): void {\n\t\tif (this.globalSettings.mcpServers?.[name] && !force) {\n\t\t\tthrow new Error(`MCP server \"${name}\" already exists. Use --force to replace it.`);\n\t\t}\n\t\tthis.globalSettings.mcpServers = { ...(this.globalSettings.mcpServers ?? {}), [name]: structuredClone(config) };\n\t\tthis.markModified(\"mcpServers\", name);\n\t\tthis.save();\n\t}\n\n\tremoveGlobalMcpServer(name: string): boolean {\n\t\tif (!this.globalSettings.mcpServers?.[name]) return false;\n\t\tconst servers = { ...this.globalSettings.mcpServers };\n\t\tdelete servers[name];\n\t\tthis.globalSettings.mcpServers = servers;\n\t\tthis.markModified(\"mcpServers\", name);\n\t\tthis.save();\n\t\treturn true;\n\t}\n\n\tsetEnabledModels(patterns: string[] | undefined): void {\n\t\tthis.globalSettings.enabledModels = patterns;\n\t\tthis.markModified(\"enabledModels\");\n\t\tthis.save();\n\t}\n\n\tgetTreeFilterMode(): \"default\" | \"no-tools\" | \"user-only\" | \"labeled-only\" | \"all\" {\n\t\tconst mode = this.settings.treeFilterMode;\n\t\tconst valid = [\"default\", \"no-tools\", \"user-only\", \"labeled-only\", \"all\"];\n\t\treturn mode && valid.includes(mode) ? mode : \"user-only\";\n\t}\n\n\tsetTreeFilterMode(mode: \"default\" | \"no-tools\" | \"user-only\" | \"labeled-only\" | \"all\"): void {\n\t\tthis.globalSettings.treeFilterMode = mode;\n\t\tthis.markModified(\"treeFilterMode\");\n\t\tthis.save();\n\t}\n\n\tgetShowHardwareCursor(): boolean {\n\t\treturn this.settings.showHardwareCursor ?? process.env.BASE_CONTEXT_HARDWARE_CURSOR === \"1\";\n\t}\n\n\tsetShowHardwareCursor(enabled: boolean): void {\n\t\tthis.globalSettings.showHardwareCursor = enabled;\n\t\tthis.markModified(\"showHardwareCursor\");\n\t\tthis.save();\n\t}\n\n\tgetEditorPaddingX(): number {\n\t\treturn this.settings.editorPaddingX ?? 0;\n\t}\n\n\tsetEditorPaddingX(padding: number): void {\n\t\tthis.globalSettings.editorPaddingX = Math.max(0, Math.min(3, Math.floor(padding)));\n\t\tthis.markModified(\"editorPaddingX\");\n\t\tthis.save();\n\t}\n\n\tgetAutocompleteMaxVisible(): number {\n\t\treturn this.settings.autocompleteMaxVisible ?? 5;\n\t}\n\n\tsetAutocompleteMaxVisible(maxVisible: number): void {\n\t\tthis.globalSettings.autocompleteMaxVisible = Math.max(3, Math.min(20, Math.floor(maxVisible)));\n\t\tthis.markModified(\"autocompleteMaxVisible\");\n\t\tthis.save();\n\t}\n\n\tgetCodeBlockIndent(): string {\n\t\treturn this.settings.markdown?.codeBlockIndent ?? \"  \";\n\t}\n\n\tgetMermaidRenderingMode(): MermaidRenderingMode {\n\t\tconst mode = this.settings.markdown?.mermaid;\n\t\treturn mode === \"off\" || mode === \"final\" ? mode : \"streaming\";\n\t}\n\n\tsetMermaidRenderingMode(mode: MermaidRenderingMode): void {\n\t\tthis.globalSettings.markdown ??= {};\n\t\tthis.globalSettings.markdown.mermaid = mode;\n\t\tthis.markModified(\"markdown\", \"mermaid\");\n\t\tthis.save();\n\t}\n\n\tgetWarnings(): WarningSettings {\n\t\treturn { ...(this.settings.warnings ?? {}) };\n\t}\n\n\tsetWarnings(warnings: WarningSettings): void {\n\t\tthis.globalSettings.warnings = { ...warnings };\n\t\tthis.markModified(\"warnings\");\n\t\tthis.save();\n\t}\n}\n"]}
+{"version":3,"file":"settings-manager.d.ts","sourceRoot":"","sources":["../../src/core/settings-manager.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ThinkingLevel } from \"@ponythewhite/base-context-agent\";\nimport type { ServiceTier, Transport } from \"@ponythewhite/base-context-ai\";\nimport { existsSync, mkdirSync, readFileSync, renameSync, unlinkSync, writeFileSync } from \"fs\";\nimport { homedir } from \"os\";\nimport { dirname, join } from \"path\";\nimport lockfile from \"proper-lockfile\";\nimport { CONFIG_DIR_NAME, getAgentDir } from \"../config.js\";\nimport { assertRlmMaxSubagents, DEFAULT_RLM_MAX_SUBAGENTS } from \"./rlm-max-subagents.js\";\n\nconst RECENT_MODELS_LIMIT = 20;\nexport const DEFAULT_IDLE_EVICTION_MINUTES = 90;\n\nexport interface CompactionModelSettings {\n\tprovider: string;\n\tmodelId: string;\n\tthinkingLevel: ThinkingLevel;\n}\n\nexport interface CompactionSettings {\n\tenabled?: boolean; // default: true\n\treserveTokens?: number; // default: 16384\n\tkeepRecentTokens?: number; // default: 20000\n\t/** Soft target; absent uses a model-aware working set, \"model-limit\" waits for the full window. */\n\ttargetTokens?: number | \"model-limit\";\n\tagentCallable?: boolean; // default: true - expose the compact skill so the model can request compaction\n\t/** Absent: inherit the main session model and its current thinking level. */\n\tmodel?: CompactionModelSettings;\n}\n\nexport interface BranchSummaryModelSettings {\n\tprovider: string;\n\tmodelId: string;\n\tthinkingLevel: ThinkingLevel;\n}\n\nexport interface BranchSummarySettings {\n\treserveTokens?: number; // default: 16384 (tokens reserved for prompt + LLM response)\n\tskipPrompt?: boolean; // default: false - when true, skips \"Summarize branch?\" prompt and defaults to no summary\n\t/** Absent: inherit the main model and retain omitted request effort. */\n\tmodel?: BranchSummaryModelSettings;\n}\n\n/** One explicit learning-model selection, shared by the real reviewer and planner. */\nexport interface AutoRefineModelSettings {\n\tprovider: string;\n\tmodelId: string;\n\tthinkingLevel: ThinkingLevel;\n}\n\nexport interface AutoRefineSettings {\n\tenabled?: boolean; // default: true\n\tturnInterval?: number; // default: 25 assistant turns\n\tcompact?: boolean; // default: true\n\tcooldownMs?: number; // default: 20 minutes\n\t/** Absent: inherit the main model and retain legacy omitted request effort. */\n\tmodel?: AutoRefineModelSettings;\n}\n\nexport interface ProviderRetrySettings {\n\ttimeoutMs?: number; // SDK/provider request timeout in milliseconds\n\tmaxRetries?: number; // SDK/provider retry attempts\n\tmaxRetryDelayMs?: number; // default: 60000 (max server-requested delay before failing)\n}\n\nexport interface RetrySettings {\n\tenabled?: boolean; // default: true\n\tmaxRetries?: number; // default: 3\n\tbaseDelayMs?: number; // default: 2000 (exponential backoff: 2s, 4s, 8s)\n\tprovider?: ProviderRetrySettings;\n}\n\nexport interface TerminalSettings {\n\tshowImages?: boolean; // default: true (show image type and dimensions)\n\tclearOnShrink?: boolean; // default: false (clear empty rows when content shrinks)\n\tshowTerminalProgress?: boolean; // default: false (OSC 9;4 terminal progress indicators)\n\tfullscreen?: boolean; // default: true (alternate-screen rendering with scrollable transcript)\n\tfullscreenMouse?: boolean; // default: true\n}\n\nexport interface ImageSettings {\n\tautoResize?: boolean; // default: true (resize images to 2000x2000 max for better model compatibility)\n\tblockImages?: boolean; // default: false - when true, prevents all images from being sent to LLM providers\n}\n\nexport interface ThinkingBudgetsSettings {\n\tminimal?: number;\n\tlow?: number;\n\tmedium?: number;\n\thigh?: number;\n}\n\nexport type MermaidRenderingMode = \"off\" | \"final\" | \"streaming\";\n\nexport interface MarkdownSettings {\n\tcodeBlockIndent?: string; // default: \"  \"\n\tmermaid?: MermaidRenderingMode; // default: \"streaming\"\n}\n\nexport interface BundledSkillsSettings {\n\twebsearch?: boolean; // default: true\n}\n\nexport interface WarningSettings {\n\tanthropicExtraUsage?: boolean; // default: true\n}\n\nexport type TransportSetting = Transport;\n\n/**\n * Package source for npm/git packages.\n * - String form: load all resources from the package\n * - Object form: filter which resources to load\n */\nexport type PackageSource =\n\t| string\n\t| {\n\t\t\tsource: string;\n\t\t\textensions?: string[];\n\t\t\tskills?: string[];\n\t\t\tprompts?: string[];\n\t\t\tthemes?: string[];\n\t  };\n\n/**\n * Remote/local MCP server an integration connects to. Built-in integrations\n * (Linear/Notion) are defined in the ai/mcp catalog; this is for user-declared\n * servers. The kernel-side integration package reads creds from auth.json\n * (`mcp:<name>`); login/refresh run host-side.\n */\nexport type McpServerConfig =\n\t| {\n\t\t\ttype: \"http\";\n\t\t\turl: string;\n\t\t\theaders?: Record<string, string>;\n\t\t\t/** Env var holding a static bearer token (skips OAuth). */\n\t\t\tbearerTokenEnvVar?: string;\n\t\t\t/** Use the generic OAuth login flow for this server. */\n\t\t\toauth?: boolean;\n\t\t\t/** Force-disable even when credentials exist. */\n\t\t\tenabled?: boolean;\n\t\t\tenabledTools?: string[];\n\t\t\tdisabledTools?: string[];\n\t\t\tstartupTimeoutMs?: number;\n\t\t\tcallTimeoutMs?: number;\n\t  }\n\t| {\n\t\t\ttype: \"stdio\";\n\t\t\tcommand: string;\n\t\t\targs?: string[];\n\t\t\tcwd?: string;\n\t\t\t/** Environment variables resolved from the kernel environment. */\n\t\t\tenv?: Record<string, { env: string }>;\n\t\t\tenabled?: boolean;\n\t\t\tenabledTools?: string[];\n\t\t\tdisabledTools?: string[];\n\t\t\tstartupTimeoutMs?: number;\n\t\t\tcallTimeoutMs?: number;\n\t  };\n\nexport interface Settings {\n\tonboardingShown?: boolean;\n\tonboardingCompleted?: boolean;\n\tdefaultProvider?: string;\n\tdefaultModel?: string;\n\trecentModels?: string[]; // \"provider/id\" keys, most-recently-used first\n\tdefaultThinkingLevel?: \"off\" | \"minimal\" | \"low\" | \"medium\" | \"high\" | \"xhigh\" | \"max\";\n\tdefaultServiceTier?: ServiceTier;\n\trlmMaxDepth?: number; // default for new sessions; unset falls through to BASE_CONTEXT_RLM_MAX_DEPTH, then 2\n\trlmMaxSubagents?: number; // root-family live admission limit; default: 4\n\tidleEvictionMinutes?: number | \"off\"; // global daemon policy; default: 90\n\ttransport?: TransportSetting; // default: \"sse\"\n\tsteeringMode?: \"all\" | \"one-at-a-time\";\n\tfollowUpMode?: \"all\" | \"one-at-a-time\";\n\ttheme?: string;\n\t/** Resource caps on complete canonical reconstruction, not model/token/heap limits. */\n\tcanonicalContext?: { maxMessages?: number; maxSourceBytes?: number };\n\t/** Complete native invocation output, separate from the working context. */\n\tinvocationOutput?: { maxMessages?: number; maxSourceBytes?: number };\n\tcompaction?: CompactionSettings;\n\t/** Creation default; an existing session changes policy through its canonical owner. */\n\tcontext?: { mode?: \"on\" | \"off\" };\n\tautoRefine?: AutoRefineSettings;\n\t/** Automatic scoped error-fix notes; explicit memory CRUD remains independent. */\n\tlearning?: { enabled?: boolean };\n\tbranchSummary?: BranchSummarySettings;\n\tretry?: RetrySettings;\n\thideThinkingBlock?: boolean;\n\tshellPath?: string; // Custom shell path (e.g., for Cygwin users on Windows)\n\tquietStartup?: boolean;\n\tshellCommandPrefix?: string; // Prefix prepended to every bash command (e.g., \"shopt -s expand_aliases\" for alias support)\n\tnpmCommand?: string[]; // Command used for npm package lookup/install operations, argv-style (e.g., [\"mise\", \"exec\", \"node@20\", \"--\", \"npm\"])\n\tmcpServers?: Record<string, McpServerConfig>; // User-declared MCP servers (name → config); built-ins are in the ai/mcp catalog\n\tpackages?: PackageSource[];\n\t/** Imported declarations only; never resolved or installed until an explicit package install. */\n\tinactivePackages?: PackageSource[]; // Array of npm/git package sources (string or object with filtering)\n\textensions?: string[]; // Array of local extension file paths or directories\n\tskills?: string[]; // Array of local skill file paths or directories\n\tprompts?: string[]; // Array of local prompt template paths or directories\n\tthemes?: string[]; // Array of local theme file paths or directories\n\tenableSkillCommands?: boolean; // default: true - register skills as /skill:name commands\n\tbundledSkills?: BundledSkillsSettings; // Configure built-in skills shipped with Prime Agent\n\tenableBuiltinSkills?: boolean; // default: true - load built-in skills shipped with prime-agent\n\tterminal?: TerminalSettings;\n\timages?: ImageSettings;\n\tenabledModels?: string[]; // Model patterns for cycling (same format as --models CLI flag)\n\ttreeFilterMode?: \"default\" | \"no-tools\" | \"user-only\" | \"labeled-only\" | \"all\"; // Default: \"user-only\"\n\tthinkingBudgets?: ThinkingBudgetsSettings; // Custom token budgets for thinking levels\n\teditorPaddingX?: number; // Horizontal padding for input editor (default: 0)\n\tautocompleteMaxVisible?: number; // Max visible items in autocomplete dropdown (default: 5)\n\tshowHardwareCursor?: boolean; // Show terminal cursor while still positioning it for IME\n\tmarkdown?: MarkdownSettings;\n\twarnings?: WarningSettings;\n\tsessionDir?: string; // Custom session storage directory (same format as --session-dir CLI flag)\n}\n\n/** Deep merge settings: project/overrides take precedence, nested objects merge recursively */\nfunction deepMergeSettings(base: Settings, overrides: Settings): Settings {\n\tconst result: Settings = { ...base };\n\n\tfor (const key of Object.keys(overrides) as (keyof Settings)[]) {\n\t\tconst overrideValue = overrides[key];\n\t\tconst baseValue = base[key];\n\n\t\tif (overrideValue === undefined) {\n\t\t\tcontinue;\n\t\t}\n\t\tif (\n\t\t\ttypeof overrideValue === \"object\" &&\n\t\t\toverrideValue !== null &&\n\t\t\t!Array.isArray(overrideValue) &&\n\t\t\ttypeof baseValue === \"object\" &&\n\t\t\tbaseValue !== null &&\n\t\t\t!Array.isArray(baseValue)\n\t\t) {\n\t\t\t(result as Record<string, unknown>)[key] = { ...baseValue, ...overrideValue };\n\t\t} else {\n\t\t\t(result as Record<string, unknown>)[key] = overrideValue;\n\t\t}\n\t}\n\n\treturn result;\n}\n\nexport type SettingsScope = \"global\" | \"project\";\n\nexport interface SettingsStorage {\n\twithLock(scope: SettingsScope, fn: (current: string | undefined) => string | undefined): void;\n}\n\nexport interface SettingsError {\n\tscope: SettingsScope;\n\terror: Error;\n}\n\nexport class FileSettingsStorage implements SettingsStorage {\n\tprivate globalSettingsPath: string;\n\tprivate projectSettingsPath: string;\n\n\tconstructor(cwd: string, agentDir: string) {\n\t\tthis.globalSettingsPath = join(agentDir, \"settings.json\");\n\t\tthis.projectSettingsPath = join(cwd, CONFIG_DIR_NAME, \"settings.json\");\n\t}\n\n\tprivate acquireLockSyncWithRetry(path: string): () => void {\n\t\tconst maxAttempts = 10;\n\t\tconst delayMs = 20;\n\t\tlet lastError: unknown;\n\t\tlet compromisedError: Error | undefined;\n\n\t\tfor (let attempt = 1; attempt <= maxAttempts; attempt++) {\n\t\t\ttry {\n\t\t\t\tconst release = lockfile.lockSync(path, {\n\t\t\t\t\trealpath: false,\n\t\t\t\t\tonCompromised: (error) => {\n\t\t\t\t\t\tcompromisedError ??= error;\n\t\t\t\t\t},\n\t\t\t\t});\n\t\t\t\tif (compromisedError) {\n\t\t\t\t\trelease();\n\t\t\t\t\tthrow compromisedError;\n\t\t\t\t}\n\t\t\t\treturn release;\n\t\t\t} catch (error) {\n\t\t\t\tif (compromisedError) throw compromisedError;\n\t\t\t\tconst code =\n\t\t\t\t\ttypeof error === \"object\" && error !== null && \"code\" in error\n\t\t\t\t\t\t? String((error as { code?: unknown }).code)\n\t\t\t\t\t\t: undefined;\n\t\t\t\tif (code !== \"ELOCKED\" || attempt === maxAttempts) {\n\t\t\t\t\tthrow error;\n\t\t\t\t}\n\t\t\t\tlastError = error;\n\t\t\t\tconst start = Date.now();\n\t\t\t\twhile (Date.now() - start < delayMs) {\n\t\t\t\t\t// Sleep synchronously to avoid changing callers to async.\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\n\t\tthrow (lastError as Error) ?? new Error(\"Failed to acquire settings lock\");\n\t}\n\n\twithLock(scope: SettingsScope, fn: (current: string | undefined) => string | undefined): void {\n\t\tconst path = scope === \"global\" ? this.globalSettingsPath : this.projectSettingsPath;\n\t\tconst dir = dirname(path);\n\n\t\tlet release: (() => void) | undefined;\n\t\ttry {\n\t\t\tconst fileExists = existsSync(path);\n\t\t\tif (fileExists) {\n\t\t\t\trelease = this.acquireLockSyncWithRetry(path);\n\t\t\t}\n\t\t\tconst current = fileExists ? readFileSync(path, \"utf-8\") : undefined;\n\t\t\tconst next = fn(current);\n\t\t\tif (next !== undefined) {\n\t\t\t\tif (!existsSync(dir)) {\n\t\t\t\t\tmkdirSync(dir, { recursive: true });\n\t\t\t\t}\n\t\t\t\tif (!release) {\n\t\t\t\t\trelease = this.acquireLockSyncWithRetry(path);\n\t\t\t\t}\n\t\t\t\tconst temporaryPath = `${path}.${process.pid}.${Date.now()}.tmp`;\n\t\t\t\ttry {\n\t\t\t\t\twriteFileSync(temporaryPath, next, { encoding: \"utf-8\", mode: 0o600 });\n\t\t\t\t\trenameSync(temporaryPath, path);\n\t\t\t\t} finally {\n\t\t\t\t\tif (existsSync(temporaryPath)) unlinkSync(temporaryPath);\n\t\t\t\t}\n\t\t\t}\n\t\t} finally {\n\t\t\tif (release) {\n\t\t\t\trelease();\n\t\t\t}\n\t\t}\n\t}\n}\n\nexport class InMemorySettingsStorage implements SettingsStorage {\n\tprivate global: string | undefined;\n\tprivate project: string | undefined;\n\n\twithLock(scope: SettingsScope, fn: (current: string | undefined) => string | undefined): void {\n\t\tconst current = scope === \"global\" ? this.global : this.project;\n\t\tconst next = fn(current);\n\t\tif (next !== undefined) {\n\t\t\tif (scope === \"global\") {\n\t\t\t\tthis.global = next;\n\t\t\t} else {\n\t\t\t\tthis.project = next;\n\t\t\t}\n\t\t}\n\t}\n}\n\nexport class SettingsManager {\n\tprivate storage: SettingsStorage;\n\tprivate globalSettings: Settings;\n\tprivate projectSettings: Settings;\n\tprivate settings: Settings;\n\tprivate runtimeOverrides: Settings = {};\n\tprivate modifiedFields = new Set<keyof Settings>(); // Track global fields modified during session\n\tprivate modifiedNestedFields = new Map<keyof Settings, Set<string>>(); // Track global nested field modifications\n\tprivate modifiedProjectFields = new Set<keyof Settings>(); // Track project fields modified during session\n\tprivate modifiedProjectNestedFields = new Map<keyof Settings, Set<string>>(); // Track project nested field modifications\n\tprivate globalSettingsLoadError: Error | null = null; // Track if global settings file had parse errors\n\tprivate projectSettingsLoadError: Error | null = null; // Track if project settings file had parse errors\n\tprivate writeQueue: Promise<void> = Promise.resolve();\n\tprivate errors: SettingsError[];\n\n\tprivate constructor(\n\t\tstorage: SettingsStorage,\n\t\tinitialGlobal: Settings,\n\t\tinitialProject: Settings,\n\t\tglobalLoadError: Error | null = null,\n\t\tprojectLoadError: Error | null = null,\n\t\tinitialErrors: SettingsError[] = [],\n\t) {\n\t\tthis.storage = storage;\n\t\tthis.globalSettings = initialGlobal;\n\t\tthis.projectSettings = initialProject;\n\t\tthis.globalSettingsLoadError = globalLoadError;\n\t\tthis.projectSettingsLoadError = projectLoadError;\n\t\tthis.errors = [...initialErrors];\n\t\tthis.settings = deepMergeSettings(this.globalSettings, this.projectSettings);\n\t}\n\n\t/** Create a SettingsManager that loads from files */\n\tstatic create(cwd: string, agentDir: string = getAgentDir()): SettingsManager {\n\t\tconst storage = new FileSettingsStorage(cwd, agentDir);\n\t\treturn SettingsManager.fromStorage(storage);\n\t}\n\n\t/** Create a SettingsManager from an arbitrary storage backend */\n\tstatic fromStorage(storage: SettingsStorage): SettingsManager {\n\t\tconst globalLoad = SettingsManager.tryLoadFromStorage(storage, \"global\");\n\t\tconst projectLoad = SettingsManager.tryLoadFromStorage(storage, \"project\");\n\t\tconst initialErrors: SettingsError[] = [];\n\t\tif (globalLoad.error) {\n\t\t\tinitialErrors.push({ scope: \"global\", error: globalLoad.error });\n\t\t}\n\t\tif (projectLoad.error) {\n\t\t\tinitialErrors.push({ scope: \"project\", error: projectLoad.error });\n\t\t}\n\n\t\treturn new SettingsManager(\n\t\t\tstorage,\n\t\t\tglobalLoad.settings,\n\t\t\tprojectLoad.settings,\n\t\t\tglobalLoad.error,\n\t\t\tprojectLoad.error,\n\t\t\tinitialErrors,\n\t\t);\n\t}\n\n\t/** Create an in-memory SettingsManager (no file I/O) */\n\tstatic inMemory(settings: Partial<Settings> = {}): SettingsManager {\n\t\tconst storage = new InMemorySettingsStorage();\n\t\tconst initialSettings = SettingsManager.migrateSettings(structuredClone(settings) as Record<string, unknown>);\n\t\tstorage.withLock(\"global\", () => JSON.stringify(initialSettings, null, 2));\n\t\treturn SettingsManager.fromStorage(storage);\n\t}\n\n\tprivate static loadFromStorage(storage: SettingsStorage, scope: SettingsScope): Settings {\n\t\tlet content: string | undefined;\n\t\tstorage.withLock(scope, (current) => {\n\t\t\tcontent = current;\n\t\t\treturn undefined;\n\t\t});\n\n\t\tif (!content) {\n\t\t\treturn {};\n\t\t}\n\t\tconst settings = JSON.parse(content);\n\t\treturn SettingsManager.migrateSettings(settings);\n\t}\n\n\tprivate static tryLoadFromStorage(\n\t\tstorage: SettingsStorage,\n\t\tscope: SettingsScope,\n\t): { settings: Settings; error: Error | null } {\n\t\ttry {\n\t\t\treturn { settings: SettingsManager.loadFromStorage(storage, scope), error: null };\n\t\t} catch (error) {\n\t\t\treturn { settings: {}, error: error as Error };\n\t\t}\n\t}\n\n\t/** Migrate old settings format to new format */\n\tprivate static migrateSettings(settings: Record<string, unknown>): Settings {\n\t\tif (\"queueMode\" in settings && !(\"steeringMode\" in settings)) {\n\t\t\tsettings.steeringMode = settings.queueMode;\n\t\t\tdelete settings.queueMode;\n\t\t}\n\t\tif (!(\"transport\" in settings) && typeof settings.websockets === \"boolean\") {\n\t\t\tsettings.transport = settings.websockets ? \"websocket\" : \"sse\";\n\t\t\tdelete settings.websockets;\n\t\t}\n\t\tif (\n\t\t\t\"skills\" in settings &&\n\t\t\ttypeof settings.skills === \"object\" &&\n\t\t\tsettings.skills !== null &&\n\t\t\t!Array.isArray(settings.skills)\n\t\t) {\n\t\t\tconst skillsSettings = settings.skills as {\n\t\t\t\tenableSkillCommands?: boolean;\n\t\t\t\tcustomDirectories?: unknown;\n\t\t\t};\n\t\t\tif (skillsSettings.enableSkillCommands !== undefined && settings.enableSkillCommands === undefined) {\n\t\t\t\tsettings.enableSkillCommands = skillsSettings.enableSkillCommands;\n\t\t\t}\n\t\t\tif (Array.isArray(skillsSettings.customDirectories) && skillsSettings.customDirectories.length > 0) {\n\t\t\t\tsettings.skills = skillsSettings.customDirectories;\n\t\t\t} else {\n\t\t\t\tdelete settings.skills;\n\t\t\t}\n\t\t}\n\t\tif (\n\t\t\t\"retry\" in settings &&\n\t\t\ttypeof settings.retry === \"object\" &&\n\t\t\tsettings.retry !== null &&\n\t\t\t!Array.isArray(settings.retry)\n\t\t) {\n\t\t\tconst retrySettings = settings.retry as Record<string, unknown>;\n\t\t\tconst providerSettings =\n\t\t\t\ttypeof retrySettings.provider === \"object\" && retrySettings.provider !== null\n\t\t\t\t\t? (retrySettings.provider as Record<string, unknown>)\n\t\t\t\t\t: undefined;\n\t\t\tif (\n\t\t\t\ttypeof retrySettings.maxDelayMs === \"number\" &&\n\t\t\t\t(providerSettings?.maxRetryDelayMs === undefined || providerSettings?.maxRetryDelayMs === null)\n\t\t\t) {\n\t\t\t\tretrySettings.provider = {\n\t\t\t\t\t...(providerSettings ?? {}),\n\t\t\t\t\tmaxRetryDelayMs: retrySettings.maxDelayMs,\n\t\t\t\t};\n\t\t\t}\n\t\t\tdelete retrySettings.maxDelayMs;\n\t\t}\n\n\t\tif (\n\t\t\tsettings.markdown !== undefined &&\n\t\t\t(typeof settings.markdown !== \"object\" || settings.markdown === null || Array.isArray(settings.markdown))\n\t\t) {\n\t\t\tdelete settings.markdown;\n\t\t}\n\n\t\treturn settings as Settings;\n\t}\n\n\tgetGlobalSettings(): Settings {\n\t\treturn structuredClone(this.globalSettings);\n\t}\n\n\tgetProjectSettings(): Settings {\n\t\treturn structuredClone(this.projectSettings);\n\t}\n\n\tasync reload(): Promise<void> {\n\t\tawait this.writeQueue;\n\t\tconst globalLoad = SettingsManager.tryLoadFromStorage(this.storage, \"global\");\n\t\tif (!globalLoad.error) {\n\t\t\tthis.globalSettings = globalLoad.settings;\n\t\t\tthis.globalSettingsLoadError = null;\n\t\t} else {\n\t\t\tthis.globalSettingsLoadError = globalLoad.error;\n\t\t\tthis.recordError(\"global\", globalLoad.error);\n\t\t}\n\n\t\tthis.modifiedFields.clear();\n\t\tthis.modifiedNestedFields.clear();\n\t\tthis.modifiedProjectFields.clear();\n\t\tthis.modifiedProjectNestedFields.clear();\n\n\t\tconst projectLoad = SettingsManager.tryLoadFromStorage(this.storage, \"project\");\n\t\tif (!projectLoad.error) {\n\t\t\tthis.projectSettings = projectLoad.settings;\n\t\t\tthis.projectSettingsLoadError = null;\n\t\t} else {\n\t\t\tthis.projectSettingsLoadError = projectLoad.error;\n\t\t\tthis.recordError(\"project\", projectLoad.error);\n\t\t}\n\n\t\tthis.settings = deepMergeSettings(this.globalSettings, this.projectSettings);\n\t}\n\n\t/** Apply additional overrides on top of current settings */\n\tapplyOverrides(overrides: Partial<Settings>): void {\n\t\tthis.runtimeOverrides = deepMergeSettings(this.runtimeOverrides, overrides);\n\t\tthis.settings = deepMergeSettings(this.settings, overrides);\n\t}\n\n\t/** Mark a global field as modified during this session */\n\tprivate markModified(field: keyof Settings, nestedKey?: string): void {\n\t\tthis.modifiedFields.add(field);\n\t\tif (nestedKey) {\n\t\t\tif (!this.modifiedNestedFields.has(field)) {\n\t\t\t\tthis.modifiedNestedFields.set(field, new Set());\n\t\t\t}\n\t\t\tthis.modifiedNestedFields.get(field)!.add(nestedKey);\n\t\t}\n\t}\n\n\t/** Mark a project field as modified during this session */\n\tprivate markProjectModified(field: keyof Settings, nestedKey?: string): void {\n\t\tthis.modifiedProjectFields.add(field);\n\t\tif (nestedKey) {\n\t\t\tif (!this.modifiedProjectNestedFields.has(field)) {\n\t\t\t\tthis.modifiedProjectNestedFields.set(field, new Set());\n\t\t\t}\n\t\t\tthis.modifiedProjectNestedFields.get(field)!.add(nestedKey);\n\t\t}\n\t}\n\n\tprivate recordError(scope: SettingsScope, error: unknown): void {\n\t\tconst normalizedError = error instanceof Error ? error : new Error(String(error));\n\t\tthis.errors.push({ scope, error: normalizedError });\n\t}\n\n\tprivate clearModifiedScope(scope: SettingsScope): void {\n\t\tif (scope === \"global\") {\n\t\t\tthis.modifiedFields.clear();\n\t\t\tthis.modifiedNestedFields.clear();\n\t\t\treturn;\n\t\t}\n\n\t\tthis.modifiedProjectFields.clear();\n\t\tthis.modifiedProjectNestedFields.clear();\n\t}\n\n\tprivate enqueueWrite(scope: SettingsScope, task: () => void): void {\n\t\tthis.writeQueue = this.writeQueue\n\t\t\t.then(() => {\n\t\t\t\ttask();\n\t\t\t\tthis.clearModifiedScope(scope);\n\t\t\t})\n\t\t\t.catch((error) => {\n\t\t\t\tthis.recordError(scope, error);\n\t\t\t});\n\t}\n\n\tprivate cloneModifiedNestedFields(source: Map<keyof Settings, Set<string>>): Map<keyof Settings, Set<string>> {\n\t\tconst snapshot = new Map<keyof Settings, Set<string>>();\n\t\tfor (const [key, value] of source.entries()) {\n\t\t\tsnapshot.set(key, new Set(value));\n\t\t}\n\t\treturn snapshot;\n\t}\n\n\tprivate persistScopedSettings(\n\t\tscope: SettingsScope,\n\t\tsnapshotSettings: Settings,\n\t\tmodifiedFields: Set<keyof Settings>,\n\t\tmodifiedNestedFields: Map<keyof Settings, Set<string>>,\n\t): void {\n\t\tthis.storage.withLock(scope, (current) => {\n\t\t\tconst currentFileSettings = current\n\t\t\t\t? SettingsManager.migrateSettings(JSON.parse(current) as Record<string, unknown>)\n\t\t\t\t: {};\n\t\t\tconst mergedSettings: Settings = { ...currentFileSettings };\n\t\t\tfor (const field of modifiedFields) {\n\t\t\t\tconst value = snapshotSettings[field];\n\t\t\t\tif (modifiedNestedFields.has(field) && typeof value === \"object\" && value !== null) {\n\t\t\t\t\tconst nestedModified = modifiedNestedFields.get(field)!;\n\t\t\t\t\tconst baseNested = (currentFileSettings[field] as Record<string, unknown>) ?? {};\n\t\t\t\t\tconst inMemoryNested = value as Record<string, unknown>;\n\t\t\t\t\tconst mergedNested = { ...baseNested };\n\t\t\t\t\tfor (const nestedKey of nestedModified) {\n\t\t\t\t\t\tmergedNested[nestedKey] = inMemoryNested[nestedKey];\n\t\t\t\t\t}\n\t\t\t\t\t(mergedSettings as Record<string, unknown>)[field] = mergedNested;\n\t\t\t\t} else {\n\t\t\t\t\t(mergedSettings as Record<string, unknown>)[field] = value;\n\t\t\t\t}\n\t\t\t}\n\n\t\t\treturn JSON.stringify(mergedSettings, null, 2);\n\t\t});\n\t}\n\n\tprivate save(): void {\n\t\tthis.settings = deepMergeSettings(this.globalSettings, this.projectSettings);\n\n\t\tif (this.globalSettingsLoadError) {\n\t\t\tthis.recordError(\n\t\t\t\t\"global\",\n\t\t\t\tnew Error(\n\t\t\t\t\t`Global settings not saved: settings file failed to parse: ${this.globalSettingsLoadError.message}`,\n\t\t\t\t),\n\t\t\t);\n\t\t\treturn;\n\t\t}\n\n\t\tconst snapshotGlobalSettings = structuredClone(this.globalSettings);\n\t\tconst modifiedFields = new Set(this.modifiedFields);\n\t\tconst modifiedNestedFields = this.cloneModifiedNestedFields(this.modifiedNestedFields);\n\n\t\tthis.enqueueWrite(\"global\", () => {\n\t\t\tthis.persistScopedSettings(\"global\", snapshotGlobalSettings, modifiedFields, modifiedNestedFields);\n\t\t});\n\t}\n\n\tprivate saveProjectSettings(settings: Settings): void {\n\t\tthis.projectSettings = structuredClone(settings);\n\t\tthis.settings = deepMergeSettings(this.globalSettings, this.projectSettings);\n\n\t\tif (this.projectSettingsLoadError) {\n\t\t\tthis.recordError(\n\t\t\t\t\"project\",\n\t\t\t\tnew Error(\n\t\t\t\t\t`Project settings not saved: settings file failed to parse: ${this.projectSettingsLoadError.message}`,\n\t\t\t\t),\n\t\t\t);\n\t\t\treturn;\n\t\t}\n\n\t\tconst snapshotProjectSettings = structuredClone(this.projectSettings);\n\t\tconst modifiedFields = new Set(this.modifiedProjectFields);\n\t\tconst modifiedNestedFields = this.cloneModifiedNestedFields(this.modifiedProjectNestedFields);\n\t\tthis.enqueueWrite(\"project\", () => {\n\t\t\tthis.persistScopedSettings(\"project\", snapshotProjectSettings, modifiedFields, modifiedNestedFields);\n\t\t});\n\t}\n\n\tasync flush(): Promise<void> {\n\t\tawait this.writeQueue;\n\t}\n\n\tdrainErrors(scope?: SettingsScope): SettingsError[] {\n\t\tif (!scope) {\n\t\t\tconst drained = [...this.errors];\n\t\t\tthis.errors = [];\n\t\t\treturn drained;\n\t\t}\n\t\tconst drained = this.errors.filter((entry) => entry.scope === scope);\n\t\tthis.errors = this.errors.filter((entry) => entry.scope !== scope);\n\t\treturn drained;\n\t}\n\n\tgetOnboardingShown(): boolean {\n\t\treturn this.settings.onboardingShown ?? this.settings.onboardingCompleted ?? false;\n\t}\n\n\tsetOnboardingShown(shown: boolean): void {\n\t\tthis.globalSettings.onboardingShown = shown;\n\t\tthis.markModified(\"onboardingShown\");\n\t\tthis.save();\n\t}\n\n\tgetSessionDir(): string | undefined {\n\t\tconst sessionDir = this.settings.sessionDir;\n\t\tif (!sessionDir) {\n\t\t\treturn sessionDir;\n\t\t}\n\t\tif (sessionDir === \"~\") {\n\t\t\treturn homedir();\n\t\t}\n\t\tif (sessionDir.startsWith(\"~/\")) {\n\t\t\treturn join(homedir(), sessionDir.slice(2));\n\t\t}\n\t\treturn sessionDir;\n\t}\n\n\tgetDefaultProvider(): string | undefined {\n\t\treturn this.settings.defaultProvider;\n\t}\n\n\tgetDefaultModel(): string | undefined {\n\t\treturn this.settings.defaultModel;\n\t}\n\n\tsetDefaultProvider(provider: string): void {\n\t\tthis.globalSettings.defaultProvider = provider;\n\t\tthis.markModified(\"defaultProvider\");\n\t\tthis.save();\n\t}\n\n\tsetDefaultModel(modelId: string): void {\n\t\tthis.globalSettings.defaultModel = modelId;\n\t\tthis.markModified(\"defaultModel\");\n\t\tthis.save();\n\t}\n\n\tsetDefaultModelAndProvider(provider: string, modelId: string): void {\n\t\tthis.globalSettings.defaultProvider = provider;\n\t\tthis.globalSettings.defaultModel = modelId;\n\t\tthis.markModified(\"defaultProvider\");\n\t\tthis.markModified(\"defaultModel\");\n\t\tthis.recordModelUseInternal(provider, modelId);\n\t\tthis.markModified(\"recentModels\");\n\t\tthis.save();\n\t}\n\n\tgetRecentModels(): string[] {\n\t\treturn this.settings.recentModels ?? [];\n\t}\n\n\tprivate recordModelUseInternal(provider: string, modelId: string): void {\n\t\tconst key = `${provider}/${modelId}`;\n\t\tconst next = [key, ...this.getRecentModels().filter((k) => k !== key)];\n\t\tthis.globalSettings.recentModels = next.slice(0, RECENT_MODELS_LIMIT);\n\t}\n\n\tgetSteeringMode(): \"all\" | \"one-at-a-time\" {\n\t\treturn this.settings.steeringMode || \"one-at-a-time\";\n\t}\n\n\tsetSteeringMode(mode: \"all\" | \"one-at-a-time\"): void {\n\t\tthis.globalSettings.steeringMode = mode;\n\t\tthis.markModified(\"steeringMode\");\n\t\tthis.save();\n\t}\n\n\tgetFollowUpMode(): \"all\" | \"one-at-a-time\" {\n\t\treturn this.settings.followUpMode || \"one-at-a-time\";\n\t}\n\n\tsetFollowUpMode(mode: \"all\" | \"one-at-a-time\"): void {\n\t\tthis.globalSettings.followUpMode = mode;\n\t\tthis.markModified(\"followUpMode\");\n\t\tthis.save();\n\t}\n\n\tgetTheme(): string | undefined {\n\t\treturn this.settings.theme;\n\t}\n\n\tsetTheme(theme: string): void {\n\t\tthis.globalSettings.theme = theme;\n\t\tthis.markModified(\"theme\");\n\t\tthis.save();\n\t}\n\n\tgetDefaultThinkingLevel(): \"off\" | \"minimal\" | \"low\" | \"medium\" | \"high\" | \"xhigh\" | \"max\" | undefined {\n\t\treturn this.settings.defaultThinkingLevel;\n\t}\n\n\tsetDefaultThinkingLevel(level: \"off\" | \"minimal\" | \"low\" | \"medium\" | \"high\" | \"xhigh\" | \"max\"): void {\n\t\tthis.globalSettings.defaultThinkingLevel = level;\n\t\tthis.markModified(\"defaultThinkingLevel\");\n\t\tthis.save();\n\t}\n\n\tgetDefaultServiceTier(): ServiceTier {\n\t\treturn this.settings.defaultServiceTier ?? \"default\";\n\t}\n\n\tsetDefaultServiceTier(serviceTier: ServiceTier): void {\n\t\tthis.globalSettings.defaultServiceTier = serviceTier;\n\t\tthis.markModified(\"defaultServiceTier\");\n\t\tthis.save();\n\t}\n\n\tgetRlmMaxSubagents(): number {\n\t\tconst value = this.globalSettings.rlmMaxSubagents ?? DEFAULT_RLM_MAX_SUBAGENTS;\n\t\tassertRlmMaxSubagents(value);\n\t\treturn value;\n\t}\n\n\tsetRlmMaxSubagents(maxSubagents: number): void {\n\t\tassertRlmMaxSubagents(maxSubagents);\n\t\tthis.globalSettings.rlmMaxSubagents = maxSubagents;\n\t\tthis.markModified(\"rlmMaxSubagents\");\n\t\tthis.save();\n\t}\n\n\tgetRlmMaxDepth(): number | undefined {\n\t\treturn this.globalSettings.rlmMaxDepth;\n\t}\n\n\tsetRlmMaxDepth(maxDepth: number): void {\n\t\tthis.globalSettings.rlmMaxDepth = maxDepth;\n\t\tthis.markModified(\"rlmMaxDepth\");\n\t\tthis.save();\n\t}\n\n\tgetIdleEvictionMinutes(): number | \"off\" {\n\t\tconst value: unknown = this.globalSettings.idleEvictionMinutes;\n\t\tif (value === \"off\" || value === \"none\") return \"off\";\n\t\treturn typeof value === \"number\" && Number.isFinite(value) && value > 0 ? value : DEFAULT_IDLE_EVICTION_MINUTES;\n\t}\n\n\tsetIdleEvictionMinutes(value: number | \"off\"): void {\n\t\tif (value !== \"off\" && (!Number.isFinite(value) || value <= 0)) {\n\t\t\tthrow new Error(\"Idle eviction minutes must be a positive number or off\");\n\t\t}\n\t\tthis.globalSettings.idleEvictionMinutes = value;\n\t\tthis.markModified(\"idleEvictionMinutes\");\n\t\tthis.save();\n\t}\n\n\tgetTransport(): TransportSetting {\n\t\treturn this.settings.transport ?? \"sse\";\n\t}\n\n\tsetTransport(transport: TransportSetting): void {\n\t\tthis.globalSettings.transport = transport;\n\t\tthis.markModified(\"transport\");\n\t\tthis.save();\n\t}\n\n\t/** Resolve resource caps without truncating or changing context selection. */\n\tgetCanonicalContextLimits(): { maxMessages: number; maxSourceBytes: number } {\n\t\tconst configured = this.settings.canonicalContext;\n\t\tif (\n\t\t\tconfigured !== undefined &&\n\t\t\t(typeof configured !== \"object\" || configured === null || Array.isArray(configured))\n\t\t)\n\t\t\tthrow new Error(\"canonicalContext must be an object\");\n\t\tconst limits = {\n\t\t\tmaxMessages: configured?.maxMessages === undefined ? 16384 : configured.maxMessages,\n\t\t\tmaxSourceBytes: configured?.maxSourceBytes === undefined ? 64 * 1024 * 1024 : configured.maxSourceBytes,\n\t\t};\n\t\tfor (const [field, value] of Object.entries(limits)) {\n\t\t\tif (!Number.isSafeInteger(value) || value <= 0)\n\t\t\t\tthrow new Error(`canonicalContext.${field} must be a positive safe integer`);\n\t\t}\n\t\treturn limits;\n\t}\n\n\tgetInvocationOutputLimits(): { maxMessages: number; maxSourceBytes: number } {\n\t\tconst configured = this.settings.invocationOutput;\n\t\tif (\n\t\t\tconfigured !== undefined &&\n\t\t\t(typeof configured !== \"object\" || configured === null || Array.isArray(configured))\n\t\t)\n\t\t\tthrow new Error(\"invocationOutput must be an object\");\n\t\tconst limits = {\n\t\t\tmaxMessages: configured?.maxMessages === undefined ? 16384 : configured.maxMessages,\n\t\t\tmaxSourceBytes: configured?.maxSourceBytes === undefined ? 64 * 1024 * 1024 : configured.maxSourceBytes,\n\t\t};\n\t\tfor (const [field, value] of Object.entries(limits)) {\n\t\t\tif (!Number.isSafeInteger(value) || value <= 0)\n\t\t\t\tthrow new Error(`invocationOutput.${field} must be a positive safe integer`);\n\t\t}\n\t\treturn limits;\n\t}\n\n\tgetContextMode(): \"on\" | \"off\" {\n\t\tconst mode = this.settings.context?.mode ?? \"on\";\n\t\tif (mode !== \"on\" && mode !== \"off\") throw new Error(\"context.mode must be on or off\");\n\t\treturn mode;\n\t}\n\n\tgetCompactionEnabled(): boolean {\n\t\treturn this.settings.compaction?.enabled ?? true;\n\t}\n\n\tsetCompactionEnabled(enabled: boolean): void {\n\t\tif (!this.globalSettings.compaction) {\n\t\t\tthis.globalSettings.compaction = {};\n\t\t}\n\t\tthis.globalSettings.compaction.enabled = enabled;\n\t\tthis.markModified(\"compaction\", \"enabled\");\n\t\tthis.save();\n\t}\n\n\tgetCompactionReserveTokens(): number {\n\t\treturn this.settings.compaction?.reserveTokens ?? 16384;\n\t}\n\n\tgetCompactionKeepRecentTokens(): number {\n\t\treturn this.settings.compaction?.keepRecentTokens ?? 20000;\n\t}\n\n\tgetCompactionAgentCallable(): boolean {\n\t\treturn this.settings.compaction?.agentCallable ?? true;\n\t}\n\n\t/** Detached explicit configuration; compaction resolves and validates its model/effort. */\n\tgetCompactionModel(): CompactionModelSettings | undefined {\n\t\tconst model = this.settings.compaction?.model;\n\t\treturn model === undefined ? undefined : structuredClone(model);\n\t}\n\n\tgetCompactionSettings(): {\n\t\tenabled: boolean;\n\t\treserveTokens: number;\n\t\tkeepRecentTokens: number;\n\t\ttargetTokens?: number | \"model-limit\";\n\t} {\n\t\tconst targetTokens = this.settings.compaction?.targetTokens;\n\t\tif (\n\t\t\ttargetTokens !== undefined &&\n\t\t\ttargetTokens !== \"model-limit\" &&\n\t\t\t(!Number.isSafeInteger(targetTokens) || targetTokens <= 0)\n\t\t) {\n\t\t\tthrow new Error('compaction.targetTokens must be a positive safe integer or \"model-limit\"');\n\t\t}\n\t\treturn {\n\t\t\tenabled: this.getCompactionEnabled(),\n\t\t\treserveTokens: this.getCompactionReserveTokens(),\n\t\t\tkeepRecentTokens: this.getCompactionKeepRecentTokens(),\n\t\t\t...(targetTokens === undefined ? {} : { targetTokens }),\n\t\t};\n\t}\n\n\t/** Detached explicit configuration; the request path resolves and validates its model/effort. */\n\tgetAutoRefineModel(): AutoRefineModelSettings | undefined {\n\t\tconst model = this.settings.autoRefine?.model;\n\t\treturn model === undefined ? undefined : structuredClone(model);\n\t}\n\n\tgetLearningEnabled(): boolean {\n\t\treturn this.settings.learning?.enabled === true;\n\t}\n\n\tgetAutoRefineSettings(): { enabled: boolean; turnInterval: number; compact: boolean; cooldownMs: number } {\n\t\tconst turnInterval = this.settings.autoRefine?.turnInterval;\n\t\tconst cooldownMs = this.settings.autoRefine?.cooldownMs;\n\t\treturn {\n\t\t\tenabled: this.settings.autoRefine?.enabled ?? true,\n\t\t\tturnInterval: Math.max(\n\t\t\t\t1,\n\t\t\t\ttypeof turnInterval === \"number\" && Number.isFinite(turnInterval) ? turnInterval : 25,\n\t\t\t),\n\t\t\tcompact: this.settings.autoRefine?.compact ?? true,\n\t\t\tcooldownMs: Math.max(\n\t\t\t\t0,\n\t\t\t\ttypeof cooldownMs === \"number\" && Number.isFinite(cooldownMs) ? cooldownMs : 20 * 60_000,\n\t\t\t),\n\t\t};\n\t}\n\n\t/** Detached explicit configuration; branch navigation validates the selected model/effort. */\n\tgetBranchSummaryModel(): BranchSummaryModelSettings | undefined {\n\t\tconst model = this.settings.branchSummary?.model;\n\t\treturn model === undefined ? undefined : structuredClone(model);\n\t}\n\n\tgetBranchSummarySettings(): { reserveTokens: number; skipPrompt: boolean } {\n\t\treturn {\n\t\t\treserveTokens: this.settings.branchSummary?.reserveTokens ?? 16384,\n\t\t\tskipPrompt: this.settings.branchSummary?.skipPrompt ?? false,\n\t\t};\n\t}\n\n\tgetBranchSummarySkipPrompt(): boolean {\n\t\treturn this.settings.branchSummary?.skipPrompt ?? false;\n\t}\n\n\tgetRetryEnabled(): boolean {\n\t\treturn this.settings.retry?.enabled ?? true;\n\t}\n\n\tsetRetryEnabled(enabled: boolean): void {\n\t\tif (!this.globalSettings.retry) {\n\t\t\tthis.globalSettings.retry = {};\n\t\t}\n\t\tthis.globalSettings.retry.enabled = enabled;\n\t\tthis.markModified(\"retry\", \"enabled\");\n\t\tthis.save();\n\t}\n\n\tgetRetrySettings(): { enabled: boolean; maxRetries: number; baseDelayMs: number } {\n\t\treturn {\n\t\t\tenabled: this.getRetryEnabled(),\n\t\t\tmaxRetries: this.settings.retry?.maxRetries ?? 3,\n\t\t\tbaseDelayMs: this.settings.retry?.baseDelayMs ?? 2000,\n\t\t};\n\t}\n\n\tgetProviderRetrySettings(): { timeoutMs?: number; maxRetries?: number; maxRetryDelayMs: number } {\n\t\treturn {\n\t\t\ttimeoutMs: this.settings.retry?.provider?.timeoutMs,\n\t\t\tmaxRetries: this.settings.retry?.provider?.maxRetries,\n\t\t\tmaxRetryDelayMs: this.settings.retry?.provider?.maxRetryDelayMs ?? 60000,\n\t\t};\n\t}\n\n\tgetHideThinkingBlock(): boolean {\n\t\treturn this.settings.hideThinkingBlock ?? false;\n\t}\n\n\tsetHideThinkingBlock(hide: boolean): void {\n\t\tthis.globalSettings.hideThinkingBlock = hide;\n\t\tthis.markModified(\"hideThinkingBlock\");\n\t\tthis.save();\n\t}\n\n\tgetShellPath(): string | undefined {\n\t\treturn this.settings.shellPath;\n\t}\n\n\tsetShellPath(path: string | undefined): void {\n\t\tthis.globalSettings.shellPath = path;\n\t\tthis.markModified(\"shellPath\");\n\t\tthis.save();\n\t}\n\n\tgetQuietStartup(): boolean {\n\t\treturn this.settings.quietStartup ?? false;\n\t}\n\n\tsetQuietStartup(quiet: boolean): void {\n\t\tthis.globalSettings.quietStartup = quiet;\n\t\tthis.markModified(\"quietStartup\");\n\t\tthis.save();\n\t}\n\n\tgetShellCommandPrefix(): string | undefined {\n\t\treturn this.settings.shellCommandPrefix;\n\t}\n\n\tsetShellCommandPrefix(prefix: string | undefined): void {\n\t\tthis.globalSettings.shellCommandPrefix = prefix;\n\t\tthis.markModified(\"shellCommandPrefix\");\n\t\tthis.save();\n\t}\n\n\tgetNpmCommand(): string[] | undefined {\n\t\treturn this.settings.npmCommand ? [...this.settings.npmCommand] : undefined;\n\t}\n\n\tsetNpmCommand(command: string[] | undefined): void {\n\t\tthis.globalSettings.npmCommand = command ? [...command] : undefined;\n\t\tthis.markModified(\"npmCommand\");\n\t\tthis.save();\n\t}\n\n\tgetPackages(): PackageSource[] {\n\t\treturn [...(this.settings.packages ?? [])];\n\t}\n\n\tsetPackages(packages: PackageSource[], inactivePackages?: PackageSource[]): void {\n\t\tthis.globalSettings.packages = packages;\n\t\tthis.markModified(\"packages\");\n\t\tif (inactivePackages !== undefined) {\n\t\t\tthis.globalSettings.inactivePackages = inactivePackages;\n\t\t\tthis.markModified(\"inactivePackages\");\n\t\t}\n\t\tthis.save();\n\t}\n\n\tsetProjectPackages(packages: PackageSource[], inactivePackages?: PackageSource[]): void {\n\t\tconst projectSettings = structuredClone(this.projectSettings);\n\t\tprojectSettings.packages = packages;\n\t\tthis.markProjectModified(\"packages\");\n\t\tif (inactivePackages !== undefined) {\n\t\t\tprojectSettings.inactivePackages = inactivePackages;\n\t\t\tthis.markProjectModified(\"inactivePackages\");\n\t\t}\n\t\tthis.saveProjectSettings(projectSettings);\n\t}\n\n\tgetExtensionPaths(): string[] {\n\t\treturn [...(this.settings.extensions ?? [])];\n\t}\n\n\tsetExtensionPaths(paths: string[]): void {\n\t\tthis.globalSettings.extensions = paths;\n\t\tthis.markModified(\"extensions\");\n\t\tthis.save();\n\t}\n\n\tsetProjectExtensionPaths(paths: string[]): void {\n\t\tconst projectSettings = structuredClone(this.projectSettings);\n\t\tprojectSettings.extensions = paths;\n\t\tthis.markProjectModified(\"extensions\");\n\t\tthis.saveProjectSettings(projectSettings);\n\t}\n\n\tgetSkillPaths(): string[] {\n\t\treturn [...(this.settings.skills ?? [])];\n\t}\n\n\tsetSkillPaths(paths: string[]): void {\n\t\tthis.globalSettings.skills = paths;\n\t\tthis.markModified(\"skills\");\n\t\tthis.save();\n\t}\n\n\tsetProjectSkillPaths(paths: string[]): void {\n\t\tconst projectSettings = structuredClone(this.projectSettings);\n\t\tprojectSettings.skills = paths;\n\t\tthis.markProjectModified(\"skills\");\n\t\tthis.saveProjectSettings(projectSettings);\n\t}\n\n\tgetPromptTemplatePaths(): string[] {\n\t\treturn [...(this.settings.prompts ?? [])];\n\t}\n\n\tsetPromptTemplatePaths(paths: string[]): void {\n\t\tthis.globalSettings.prompts = paths;\n\t\tthis.markModified(\"prompts\");\n\t\tthis.save();\n\t}\n\n\tsetProjectPromptTemplatePaths(paths: string[]): void {\n\t\tconst projectSettings = structuredClone(this.projectSettings);\n\t\tprojectSettings.prompts = paths;\n\t\tthis.markProjectModified(\"prompts\");\n\t\tthis.saveProjectSettings(projectSettings);\n\t}\n\n\tgetThemePaths(): string[] {\n\t\treturn [...(this.settings.themes ?? [])];\n\t}\n\n\tsetThemePaths(paths: string[]): void {\n\t\tthis.globalSettings.themes = paths;\n\t\tthis.markModified(\"themes\");\n\t\tthis.save();\n\t}\n\n\tsetProjectThemePaths(paths: string[]): void {\n\t\tconst projectSettings = structuredClone(this.projectSettings);\n\t\tprojectSettings.themes = paths;\n\t\tthis.markProjectModified(\"themes\");\n\t\tthis.saveProjectSettings(projectSettings);\n\t}\n\n\tgetEnableSkillCommands(): boolean {\n\t\treturn this.settings.enableSkillCommands ?? true;\n\t}\n\n\tsetEnableSkillCommands(enabled: boolean): void {\n\t\tthis.globalSettings.enableSkillCommands = enabled;\n\t\tthis.markModified(\"enableSkillCommands\");\n\t\tthis.save();\n\t}\n\n\tgetBundledSkills(): { websearch: boolean } {\n\t\treturn {\n\t\t\twebsearch: this.settings.bundledSkills?.websearch ?? true,\n\t\t};\n\t}\n\n\tgetBundledWebsearchEnabled(): boolean {\n\t\treturn this.getBundledSkills().websearch;\n\t}\n\n\tgetEnableBuiltinSkills(): boolean {\n\t\treturn this.settings.enableBuiltinSkills ?? true;\n\t}\n\n\tsetEnableBuiltinSkills(enabled: boolean): void {\n\t\tthis.globalSettings.enableBuiltinSkills = enabled;\n\t\tthis.markModified(\"enableBuiltinSkills\");\n\t\tthis.save();\n\t}\n\n\tgetThinkingBudgets(): ThinkingBudgetsSettings | undefined {\n\t\treturn this.settings.thinkingBudgets;\n\t}\n\n\tgetShowImages(): boolean {\n\t\treturn this.settings.terminal?.showImages ?? true;\n\t}\n\n\tsetShowImages(show: boolean): void {\n\t\tif (!this.globalSettings.terminal) {\n\t\t\tthis.globalSettings.terminal = {};\n\t\t}\n\t\tthis.globalSettings.terminal.showImages = show;\n\t\tthis.markModified(\"terminal\", \"showImages\");\n\t\tthis.save();\n\t}\n\n\tgetClearOnShrink(): boolean {\n\t\tif (this.settings.terminal?.clearOnShrink !== undefined) {\n\t\t\treturn this.settings.terminal.clearOnShrink;\n\t\t}\n\t\treturn process.env.BASE_CONTEXT_CLEAR_ON_SHRINK === \"1\";\n\t}\n\n\tsetClearOnShrink(enabled: boolean): void {\n\t\tif (!this.globalSettings.terminal) {\n\t\t\tthis.globalSettings.terminal = {};\n\t\t}\n\t\tthis.globalSettings.terminal.clearOnShrink = enabled;\n\t\tthis.markModified(\"terminal\", \"clearOnShrink\");\n\t\tthis.save();\n\t}\n\n\tgetFullscreen(): boolean {\n\t\tif (process.env.BASE_CONTEXT_FULLSCREEN !== undefined) {\n\t\t\treturn process.env.BASE_CONTEXT_FULLSCREEN === \"1\";\n\t\t}\n\t\treturn this.settings.terminal?.fullscreen ?? true;\n\t}\n\n\tsetFullscreen(enabled: boolean): void {\n\t\tif (!this.globalSettings.terminal) {\n\t\t\tthis.globalSettings.terminal = {};\n\t\t}\n\t\tthis.globalSettings.terminal.fullscreen = enabled;\n\t\tthis.markModified(\"terminal\", \"fullscreen\");\n\t\tthis.save();\n\t}\n\n\tgetFullscreenMouse(): boolean {\n\t\treturn this.settings.terminal?.fullscreenMouse ?? true;\n\t}\n\n\tsetFullscreenMouse(enabled: boolean): void {\n\t\tif (!this.globalSettings.terminal) {\n\t\t\tthis.globalSettings.terminal = {};\n\t\t}\n\t\tthis.globalSettings.terminal.fullscreenMouse = enabled;\n\t\tthis.markModified(\"terminal\", \"fullscreenMouse\");\n\t\tthis.save();\n\t}\n\n\tgetShowTerminalProgress(): boolean {\n\t\treturn this.settings.terminal?.showTerminalProgress ?? false;\n\t}\n\n\tsetShowTerminalProgress(enabled: boolean): void {\n\t\tif (!this.globalSettings.terminal) {\n\t\t\tthis.globalSettings.terminal = {};\n\t\t}\n\t\tthis.globalSettings.terminal.showTerminalProgress = enabled;\n\t\tthis.markModified(\"terminal\", \"showTerminalProgress\");\n\t\tthis.save();\n\t}\n\n\tgetImageAutoResize(): boolean {\n\t\treturn this.settings.images?.autoResize ?? true;\n\t}\n\n\tsetImageAutoResize(enabled: boolean): void {\n\t\tif (!this.globalSettings.images) {\n\t\t\tthis.globalSettings.images = {};\n\t\t}\n\t\tthis.globalSettings.images.autoResize = enabled;\n\t\tthis.markModified(\"images\", \"autoResize\");\n\t\tthis.save();\n\t}\n\n\tgetBlockImages(): boolean {\n\t\treturn this.settings.images?.blockImages ?? false;\n\t}\n\n\tsetBlockImages(blocked: boolean): void {\n\t\tif (!this.globalSettings.images) {\n\t\t\tthis.globalSettings.images = {};\n\t\t}\n\t\tthis.globalSettings.images.blockImages = blocked;\n\t\tthis.markModified(\"images\", \"blockImages\");\n\t\tthis.save();\n\t}\n\n\tgetEnabledModels(): string[] | undefined {\n\t\treturn this.settings.enabledModels;\n\t}\n\n\t/** MCP execution is intentionally restricted to user/global settings. */\n\tgetGlobalMcpServers(): Record<string, McpServerConfig> | undefined {\n\t\treturn structuredClone(this.globalSettings.mcpServers);\n\t}\n\n\tsetGlobalMcpServer(name: string, config: McpServerConfig, force = false): void {\n\t\tif (this.globalSettings.mcpServers?.[name] && !force) {\n\t\t\tthrow new Error(`MCP server \"${name}\" already exists. Use --force to replace it.`);\n\t\t}\n\t\tthis.globalSettings.mcpServers = { ...(this.globalSettings.mcpServers ?? {}), [name]: structuredClone(config) };\n\t\tthis.markModified(\"mcpServers\", name);\n\t\tthis.save();\n\t}\n\n\tremoveGlobalMcpServer(name: string): boolean {\n\t\tif (!this.globalSettings.mcpServers?.[name]) return false;\n\t\tconst servers = { ...this.globalSettings.mcpServers };\n\t\tdelete servers[name];\n\t\tthis.globalSettings.mcpServers = servers;\n\t\tthis.markModified(\"mcpServers\", name);\n\t\tthis.save();\n\t\treturn true;\n\t}\n\n\tsetEnabledModels(patterns: string[] | undefined): void {\n\t\tthis.globalSettings.enabledModels = patterns;\n\t\tthis.markModified(\"enabledModels\");\n\t\tthis.save();\n\t}\n\n\tgetTreeFilterMode(): \"default\" | \"no-tools\" | \"user-only\" | \"labeled-only\" | \"all\" {\n\t\tconst mode = this.settings.treeFilterMode;\n\t\tconst valid = [\"default\", \"no-tools\", \"user-only\", \"labeled-only\", \"all\"];\n\t\treturn mode && valid.includes(mode) ? mode : \"user-only\";\n\t}\n\n\tsetTreeFilterMode(mode: \"default\" | \"no-tools\" | \"user-only\" | \"labeled-only\" | \"all\"): void {\n\t\tthis.globalSettings.treeFilterMode = mode;\n\t\tthis.markModified(\"treeFilterMode\");\n\t\tthis.save();\n\t}\n\n\tgetShowHardwareCursor(): boolean {\n\t\treturn this.settings.showHardwareCursor ?? process.env.BASE_CONTEXT_HARDWARE_CURSOR === \"1\";\n\t}\n\n\tsetShowHardwareCursor(enabled: boolean): void {\n\t\tthis.globalSettings.showHardwareCursor = enabled;\n\t\tthis.markModified(\"showHardwareCursor\");\n\t\tthis.save();\n\t}\n\n\tgetEditorPaddingX(): number {\n\t\treturn this.settings.editorPaddingX ?? 0;\n\t}\n\n\tsetEditorPaddingX(padding: number): void {\n\t\tthis.globalSettings.editorPaddingX = Math.max(0, Math.min(3, Math.floor(padding)));\n\t\tthis.markModified(\"editorPaddingX\");\n\t\tthis.save();\n\t}\n\n\tgetAutocompleteMaxVisible(): number {\n\t\treturn this.settings.autocompleteMaxVisible ?? 5;\n\t}\n\n\tsetAutocompleteMaxVisible(maxVisible: number): void {\n\t\tthis.globalSettings.autocompleteMaxVisible = Math.max(3, Math.min(20, Math.floor(maxVisible)));\n\t\tthis.markModified(\"autocompleteMaxVisible\");\n\t\tthis.save();\n\t}\n\n\tgetCodeBlockIndent(): string {\n\t\treturn this.settings.markdown?.codeBlockIndent ?? \"  \";\n\t}\n\n\tgetMermaidRenderingMode(): MermaidRenderingMode {\n\t\tconst mode = this.settings.markdown?.mermaid;\n\t\treturn mode === \"off\" || mode === \"final\" ? mode : \"streaming\";\n\t}\n\n\tsetMermaidRenderingMode(mode: MermaidRenderingMode): void {\n\t\tthis.globalSettings.markdown ??= {};\n\t\tthis.globalSettings.markdown.mermaid = mode;\n\t\tthis.markModified(\"markdown\", \"mermaid\");\n\t\tthis.save();\n\t}\n\n\tgetWarnings(): WarningSettings {\n\t\treturn { ...(this.settings.warnings ?? {}) };\n\t}\n\n\tsetWarnings(warnings: WarningSettings): void {\n\t\tthis.globalSettings.warnings = { ...warnings };\n\t\tthis.markModified(\"warnings\");\n\t\tthis.save();\n\t}\n}\n"]}

package/dist/core/settings-manager.js

@@ -591,10 +591,17 @@ export class SettingsManager {
         return model === undefined ? undefined : structuredClone(model);
     }
     getCompactionSettings() {
+        const targetTokens = this.settings.compaction?.targetTokens;
+        if (targetTokens !== undefined &&
+            targetTokens !== "model-limit" &&
+            (!Number.isSafeInteger(targetTokens) || targetTokens <= 0)) {
+            throw new Error('compaction.targetTokens must be a positive safe integer or "model-limit"');
+        }
         return {
             enabled: this.getCompactionEnabled(),
             reserveTokens: this.getCompactionReserveTokens(),
             keepRecentTokens: this.getCompactionKeepRecentTokens(),
+            ...(targetTokens === undefined ? {} : { targetTokens }),
         };
     }
     /** Detached explicit configuration; the request path resolves and validates its model/effort. */