@code-yeongyu/senpi 2026.7.20 → 2026.7.22

package/dist/modes/interactive/tool-progress.d.ts

@@ -0,0 +1,8 @@
+export interface ToolProgressDetails {
+    readonly activity?: string;
+    readonly startedAt: number;
+    readonly maxWaitMs?: number;
+}
+export declare function readToolProgress(details: unknown): ToolProgressDetails | undefined;
+export declare function formatToolProgressLine(progress: ToolProgressDetails, now: number, spinnerFrame?: number): string;
+//# sourceMappingURL=tool-progress.d.ts.map

package/dist/modes/interactive/tool-progress.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-progress.d.ts","sourceRoot":"","sources":["../../../src/modes/interactive/tool-progress.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,mBAAmB;IACnC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,mBAAmB,GAAG,SAAS,CAYlF;AAED,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,mBAAmB,EAAE,GAAG,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,CAOhH"}

package/dist/modes/interactive/tool-progress.js

@@ -0,0 +1,26 @@
+import { formatWorkingElapsedSeconds } from "./working-status.js";
+export function readToolProgress(details) {
+    if (typeof details !== "object" || details === null || !("progress" in details))
+        return undefined;
+    const progress = details.progress;
+    if (typeof progress !== "object" || progress === null || !("startedAt" in progress))
+        return undefined;
+    if (typeof progress.startedAt !== "number" || !Number.isFinite(progress.startedAt))
+        return undefined;
+    if ("activity" in progress && typeof progress.activity !== "string")
+        return undefined;
+    if ("maxWaitMs" in progress && (typeof progress.maxWaitMs !== "number" || !Number.isFinite(progress.maxWaitMs))) {
+        return undefined;
+    }
+    const activity = "activity" in progress && typeof progress.activity === "string" ? progress.activity : undefined;
+    const maxWaitMs = "maxWaitMs" in progress && typeof progress.maxWaitMs === "number" ? progress.maxWaitMs : undefined;
+    return { activity, startedAt: progress.startedAt, maxWaitMs };
+}
+export function formatToolProgressLine(progress, now, spinnerFrame) {
+    const activity = progress.activity || "working";
+    const elapsed = formatWorkingElapsedSeconds((now - progress.startedAt) / 1_000);
+    const maxWait = progress.maxWaitMs === undefined ? "" : ` / max ${Math.max(0, Math.floor(progress.maxWaitMs / 1_000))}s`;
+    const spinner = spinnerFrame === undefined ? "⏵" : ["⏵", "⏷", "⏴", "⏶"][spinnerFrame % 4];
+    return `${spinner} ${activity} · ${elapsed}${maxWait}`;
+}
+//# sourceMappingURL=tool-progress.js.map

package/dist/modes/interactive/tool-progress.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-progress.js","sourceRoot":"","sources":["../../../src/modes/interactive/tool-progress.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,2BAA2B,EAAE,MAAM,qBAAqB,CAAC;AAQlE,MAAM,UAAU,gBAAgB,CAAC,OAAgB;IAChD,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,IAAI,IAAI,CAAC,CAAC,UAAU,IAAI,OAAO,CAAC;QAAE,OAAO,SAAS,CAAC;IAClG,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;IAClC,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,QAAQ,KAAK,IAAI,IAAI,CAAC,CAAC,WAAW,IAAI,QAAQ,CAAC;QAAE,OAAO,SAAS,CAAC;IACtG,IAAI,OAAO,QAAQ,CAAC,SAAS,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,SAAS,CAAC;QAAE,OAAO,SAAS,CAAC;IACrG,IAAI,UAAU,IAAI,QAAQ,IAAI,OAAO,QAAQ,CAAC,QAAQ,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC;IACtF,IAAI,WAAW,IAAI,QAAQ,IAAI,CAAC,OAAO,QAAQ,CAAC,SAAS,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC;QACjH,OAAO,SAAS,CAAC;IAClB,CAAC;IACD,MAAM,QAAQ,GAAG,UAAU,IAAI,QAAQ,IAAI,OAAO,QAAQ,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC;IACjH,MAAM,SAAS,GAAG,WAAW,IAAI,QAAQ,IAAI,OAAO,QAAQ,CAAC,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC;IACrH,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,CAAC,SAAS,EAAE,SAAS,EAAE,CAAC;AAC/D,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,QAA6B,EAAE,GAAW,EAAE,YAAqB;IACvG,MAAM,QAAQ,GAAG,QAAQ,CAAC,QAAQ,IAAI,SAAS,CAAC;IAChD,MAAM,OAAO,GAAG,2BAA2B,CAAC,CAAC,GAAG,GAAG,QAAQ,CAAC,SAAS,CAAC,GAAG,KAAK,CAAC,CAAC;IAChF,MAAM,OAAO,GACZ,QAAQ,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,SAAS,GAAG,KAAK,CAAC,CAAC,GAAG,CAAC;IAC1G,MAAM,OAAO,GAAG,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,YAAY,GAAG,CAAC,CAAC,CAAC;IAC1F,OAAO,GAAG,OAAO,IAAI,QAAQ,MAAM,OAAO,GAAG,OAAO,EAAE,CAAC;AACxD,CAAC","sourcesContent":["import { formatWorkingElapsedSeconds } from \"./working-status.ts\";\n\nexport interface ToolProgressDetails {\n\treadonly activity?: string;\n\treadonly startedAt: number;\n\treadonly maxWaitMs?: number;\n}\n\nexport function readToolProgress(details: unknown): ToolProgressDetails | undefined {\n\tif (typeof details !== \"object\" || details === null || !(\"progress\" in details)) return undefined;\n\tconst progress = details.progress;\n\tif (typeof progress !== \"object\" || progress === null || !(\"startedAt\" in progress)) return undefined;\n\tif (typeof progress.startedAt !== \"number\" || !Number.isFinite(progress.startedAt)) return undefined;\n\tif (\"activity\" in progress && typeof progress.activity !== \"string\") return undefined;\n\tif (\"maxWaitMs\" in progress && (typeof progress.maxWaitMs !== \"number\" || !Number.isFinite(progress.maxWaitMs))) {\n\t\treturn undefined;\n\t}\n\tconst activity = \"activity\" in progress && typeof progress.activity === \"string\" ? progress.activity : undefined;\n\tconst maxWaitMs = \"maxWaitMs\" in progress && typeof progress.maxWaitMs === \"number\" ? progress.maxWaitMs : undefined;\n\treturn { activity, startedAt: progress.startedAt, maxWaitMs };\n}\n\nexport function formatToolProgressLine(progress: ToolProgressDetails, now: number, spinnerFrame?: number): string {\n\tconst activity = progress.activity || \"working\";\n\tconst elapsed = formatWorkingElapsedSeconds((now - progress.startedAt) / 1_000);\n\tconst maxWait =\n\t\tprogress.maxWaitMs === undefined ? \"\" : ` / max ${Math.max(0, Math.floor(progress.maxWaitMs / 1_000))}s`;\n\tconst spinner = spinnerFrame === undefined ? \"⏵\" : [\"⏵\", \"⏷\", \"⏴\", \"⏶\"][spinnerFrame % 4];\n\treturn `${spinner} ${activity} · ${elapsed}${maxWait}`;\n}\n"]}

package/dist/modes/interactive/tool-result-reveal.d.ts

@@ -0,0 +1,18 @@
+import type { ToolExecutionComponent } from "./components/tool-execution.ts";
+import type { ToolExecutionResult } from "./components/tool-execution-types.ts";
+type ToolResultRevealComponent = Pick<ToolExecutionComponent, "updateResult">;
+export type ToolResultRevealControllerOptions = {
+    readonly getSmoothStreaming: () => boolean;
+    readonly getSmoothStreamingFps: () => number;
+    readonly requestRender: () => void;
+};
+export declare class ToolResultRevealController {
+    #private;
+    constructor(options: ToolResultRevealControllerOptions);
+    update(id: string, component: ToolResultRevealComponent, partialResult: ToolExecutionResult): boolean;
+    finish(id: string): void;
+    refresh(): void;
+    stop(): void;
+}
+export {};
+//# sourceMappingURL=tool-result-reveal.d.ts.map

package/dist/modes/interactive/tool-result-reveal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-result-reveal.d.ts","sourceRoot":"","sources":["../../../src/modes/interactive/tool-result-reveal.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AAC7E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sCAAsC,CAAC;AAGhF,KAAK,yBAAyB,GAAG,IAAI,CAAC,sBAAsB,EAAE,cAAc,CAAC,CAAC;AAW9E,MAAM,MAAM,iCAAiC,GAAG;IAC/C,QAAQ,CAAC,kBAAkB,EAAE,MAAM,OAAO,CAAC;IAC3C,QAAQ,CAAC,qBAAqB,EAAE,MAAM,MAAM,CAAC;IAC7C,QAAQ,CAAC,aAAa,EAAE,MAAM,IAAI,CAAC;CACnC,CAAC;AAiBF,qBAAa,0BAA0B;;IAQtC,YAAY,OAAO,EAAE,iCAAiC,EAIrD;IAED,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,yBAAyB,EAAE,aAAa,EAAE,mBAAmB,GAAG,OAAO,CA+BpG;IAED,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAMvB;IAED,OAAO,IAAI,IAAI,CAUd;IAED,IAAI,IAAI,IAAI,CAGX;CA0ED"}

package/dist/modes/interactive/tool-result-reveal.js

@@ -0,0 +1,155 @@
+import { BlockUnitCounter, DEFAULT_SMOOTH_FPS, MAX_SMOOTH_FPS, MIN_SMOOTH_FPS, nextStep } from "./streaming-reveal.js";
+function firstText(result) {
+    const block = result.content[0];
+    return block?.type === "text" ? block.text : undefined;
+}
+function displayResult(state, revealed = state.revealed) {
+    const first = state.target.content[0];
+    if (first?.type !== "text")
+        throw new Error("Expected a text tool result");
+    return {
+        content: [{ ...first, text: state.unitCounter.slice(0, state.text, revealed) }, ...state.target.content.slice(1)],
+        details: state.target.details,
+        isError: false,
+    };
+}
+export class ToolResultRevealController {
+    #getSmoothStreaming;
+    #getSmoothStreamingFps;
+    #requestRender;
+    #states = new Map();
+    #timer;
+    #timerFps;
+    constructor(options) {
+        this.#getSmoothStreaming = options.getSmoothStreaming;
+        this.#getSmoothStreamingFps = options.getSmoothStreamingFps;
+        this.#requestRender = options.requestRender;
+    }
+    update(id, component, partialResult) {
+        const text = firstText(partialResult);
+        if (!this.#getSmoothStreaming() || text === undefined) {
+            this.#discard(id);
+            return false;
+        }
+        const existing = this.#states.get(id);
+        if (existing === undefined || existing.component !== component || !text.startsWith(existing.text)) {
+            const state = {
+                component,
+                target: partialResult,
+                text,
+                revealed: 0,
+                lastTickAt: performance.now(),
+                unitCounter: new BlockUnitCounter(),
+            };
+            state.revealed = state.unitCounter.count(0, text);
+            component.updateResult(displayResult(state), true);
+            this.#states.set(id, state);
+            this.#syncTimer();
+            return true;
+        }
+        const wasCaughtUp = existing.revealed >= existing.unitCounter.count(0, existing.text);
+        existing.target = partialResult;
+        existing.text = text;
+        const total = existing.unitCounter.count(0, text);
+        if (wasCaughtUp && existing.revealed < total)
+            existing.lastTickAt = performance.now();
+        this.#syncTimer();
+        return true;
+    }
+    finish(id) {
+        const state = this.#states.get(id);
+        if (state === undefined)
+            return;
+        state.component.updateResult(displayResult(state, state.unitCounter.count(0, state.text)), true);
+        this.#states.delete(id);
+        this.#syncTimer();
+    }
+    refresh() {
+        if (!this.#getSmoothStreaming()) {
+            this.#flushAll();
+            return;
+        }
+        if (!this.#hasBacklog()) {
+            this.#stopTimer();
+            return;
+        }
+        this.#startTimer(true);
+    }
+    stop() {
+        this.#stopTimer();
+        this.#states.clear();
+    }
+    #discard(id) {
+        if (!this.#states.delete(id))
+            return;
+        this.#syncTimer();
+    }
+    #flushAll() {
+        for (const state of this.#states.values()) {
+            state.component.updateResult(displayResult(state, state.unitCounter.count(0, state.text)), true);
+        }
+        this.#states.clear();
+        this.#stopTimer();
+    }
+    #hasBacklog() {
+        for (const state of this.#states.values()) {
+            if (state.revealed < state.unitCounter.count(0, state.text))
+                return true;
+        }
+        return false;
+    }
+    #syncTimer() {
+        if (!this.#hasBacklog()) {
+            this.#stopTimer();
+            return;
+        }
+        this.#startTimer(false);
+    }
+    #startTimer(restart) {
+        const configuredFps = this.#getSmoothStreamingFps();
+        const fps = Number.isFinite(configuredFps)
+            ? Math.min(MAX_SMOOTH_FPS, Math.max(MIN_SMOOTH_FPS, configuredFps))
+            : DEFAULT_SMOOTH_FPS;
+        if (!restart && this.#timer !== undefined && this.#timerFps === fps)
+            return;
+        this.#stopTimer();
+        const now = performance.now();
+        for (const state of this.#states.values()) {
+            if (state.revealed < state.unitCounter.count(0, state.text))
+                state.lastTickAt = now;
+        }
+        const timer = setInterval(() => this.#tick(), 1000 / fps);
+        timer.unref();
+        this.#timer = timer;
+        this.#timerFps = fps;
+    }
+    #stopTimer() {
+        if (this.#timer !== undefined)
+            clearInterval(this.#timer);
+        this.#timer = undefined;
+        this.#timerFps = undefined;
+    }
+    #tick() {
+        if (!this.#getSmoothStreaming()) {
+            this.#flushAll();
+            this.#requestRender();
+            return;
+        }
+        const now = performance.now();
+        let rendered = false;
+        for (const state of this.#states.values()) {
+            const total = state.unitCounter.count(0, state.text);
+            const backlog = total - state.revealed;
+            if (backlog <= 0)
+                continue;
+            state.revealed = Math.min(total, state.revealed + nextStep(backlog, now - state.lastTickAt));
+            state.lastTickAt = now;
+            state.component.updateResult(displayResult(state), true);
+            rendered = true;
+        }
+        if (rendered)
+            this.#requestRender();
+        this.#syncTimer();
+    }
+}
+//# sourceMappingURL=tool-result-reveal.js.map

package/dist/modes/interactive/tool-result-reveal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-result-reveal.js","sourceRoot":"","sources":["../../../src/modes/interactive/tool-result-reveal.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ToolExecutionComponent } from \"./components/tool-execution.ts\";\nimport type { ToolExecutionResult } from \"./components/tool-execution-types.ts\";\nimport { BlockUnitCounter, DEFAULT_SMOOTH_FPS, MAX_SMOOTH_FPS, MIN_SMOOTH_FPS, nextStep } from \"./streaming-reveal.ts\";\n\ntype ToolResultRevealComponent = Pick<ToolExecutionComponent, \"updateResult\">;\n\ntype ToolResultRevealState = {\n\tcomponent: ToolResultRevealComponent;\n\ttarget: ToolExecutionResult;\n\ttext: string;\n\trevealed: number;\n\tlastTickAt: number;\n\tunitCounter: BlockUnitCounter;\n};\n\nexport type ToolResultRevealControllerOptions = {\n\treadonly getSmoothStreaming: () => boolean;\n\treadonly getSmoothStreamingFps: () => number;\n\treadonly requestRender: () => void;\n};\n\nfunction firstText(result: ToolExecutionResult): string | undefined {\n\tconst block = result.content[0];\n\treturn block?.type === \"text\" ? block.text : undefined;\n}\n\nfunction displayResult(state: ToolResultRevealState, revealed = state.revealed): ToolExecutionResult {\n\tconst first = state.target.content[0];\n\tif (first?.type !== \"text\") throw new Error(\"Expected a text tool result\");\n\treturn {\n\t\tcontent: [{ ...first, text: state.unitCounter.slice(0, state.text, revealed) }, ...state.target.content.slice(1)],\n\t\tdetails: state.target.details,\n\t\tisError: false,\n\t};\n}\n\nexport class ToolResultRevealController {\n\treadonly #getSmoothStreaming: () => boolean;\n\treadonly #getSmoothStreamingFps: () => number;\n\treadonly #requestRender: () => void;\n\treadonly #states = new Map<string, ToolResultRevealState>();\n\t#timer: NodeJS.Timeout | undefined;\n\t#timerFps: number | undefined;\n\n\tconstructor(options: ToolResultRevealControllerOptions) {\n\t\tthis.#getSmoothStreaming = options.getSmoothStreaming;\n\t\tthis.#getSmoothStreamingFps = options.getSmoothStreamingFps;\n\t\tthis.#requestRender = options.requestRender;\n\t}\n\n\tupdate(id: string, component: ToolResultRevealComponent, partialResult: ToolExecutionResult): boolean {\n\t\tconst text = firstText(partialResult);\n\t\tif (!this.#getSmoothStreaming() || text === undefined) {\n\t\t\tthis.#discard(id);\n\t\t\treturn false;\n\t\t}\n\n\t\tconst existing = this.#states.get(id);\n\t\tif (existing === undefined || existing.component !== component || !text.startsWith(existing.text)) {\n\t\t\tconst state: ToolResultRevealState = {\n\t\t\t\tcomponent,\n\t\t\t\ttarget: partialResult,\n\t\t\t\ttext,\n\t\t\t\trevealed: 0,\n\t\t\t\tlastTickAt: performance.now(),\n\t\t\t\tunitCounter: new BlockUnitCounter(),\n\t\t\t};\n\t\t\tstate.revealed = state.unitCounter.count(0, text);\n\t\t\tcomponent.updateResult(displayResult(state), true);\n\t\t\tthis.#states.set(id, state);\n\t\t\tthis.#syncTimer();\n\t\t\treturn true;\n\t\t}\n\n\t\tconst wasCaughtUp = existing.revealed >= existing.unitCounter.count(0, existing.text);\n\t\texisting.target = partialResult;\n\t\texisting.text = text;\n\t\tconst total = existing.unitCounter.count(0, text);\n\t\tif (wasCaughtUp && existing.revealed < total) existing.lastTickAt = performance.now();\n\t\tthis.#syncTimer();\n\t\treturn true;\n\t}\n\n\tfinish(id: string): void {\n\t\tconst state = this.#states.get(id);\n\t\tif (state === undefined) return;\n\t\tstate.component.updateResult(displayResult(state, state.unitCounter.count(0, state.text)), true);\n\t\tthis.#states.delete(id);\n\t\tthis.#syncTimer();\n\t}\n\n\trefresh(): void {\n\t\tif (!this.#getSmoothStreaming()) {\n\t\t\tthis.#flushAll();\n\t\t\treturn;\n\t\t}\n\t\tif (!this.#hasBacklog()) {\n\t\t\tthis.#stopTimer();\n\t\t\treturn;\n\t\t}\n\t\tthis.#startTimer(true);\n\t}\n\n\tstop(): void {\n\t\tthis.#stopTimer();\n\t\tthis.#states.clear();\n\t}\n\n\t#discard(id: string): void {\n\t\tif (!this.#states.delete(id)) return;\n\t\tthis.#syncTimer();\n\t}\n\n\t#flushAll(): void {\n\t\tfor (const state of this.#states.values()) {\n\t\t\tstate.component.updateResult(displayResult(state, state.unitCounter.count(0, state.text)), true);\n\t\t}\n\t\tthis.#states.clear();\n\t\tthis.#stopTimer();\n\t}\n\n\t#hasBacklog(): boolean {\n\t\tfor (const state of this.#states.values()) {\n\t\t\tif (state.revealed < state.unitCounter.count(0, state.text)) return true;\n\t\t}\n\t\treturn false;\n\t}\n\n\t#syncTimer(): void {\n\t\tif (!this.#hasBacklog()) {\n\t\t\tthis.#stopTimer();\n\t\t\treturn;\n\t\t}\n\t\tthis.#startTimer(false);\n\t}\n\n\t#startTimer(restart: boolean): void {\n\t\tconst configuredFps = this.#getSmoothStreamingFps();\n\t\tconst fps = Number.isFinite(configuredFps)\n\t\t\t? Math.min(MAX_SMOOTH_FPS, Math.max(MIN_SMOOTH_FPS, configuredFps))\n\t\t\t: DEFAULT_SMOOTH_FPS;\n\t\tif (!restart && this.#timer !== undefined && this.#timerFps === fps) return;\n\t\tthis.#stopTimer();\n\t\tconst now = performance.now();\n\t\tfor (const state of this.#states.values()) {\n\t\t\tif (state.revealed < state.unitCounter.count(0, state.text)) state.lastTickAt = now;\n\t\t}\n\t\tconst timer = setInterval(() => this.#tick(), 1000 / fps);\n\t\ttimer.unref();\n\t\tthis.#timer = timer;\n\t\tthis.#timerFps = fps;\n\t}\n\n\t#stopTimer(): void {\n\t\tif (this.#timer !== undefined) clearInterval(this.#timer);\n\t\tthis.#timer = undefined;\n\t\tthis.#timerFps = undefined;\n\t}\n\n\t#tick(): void {\n\t\tif (!this.#getSmoothStreaming()) {\n\t\t\tthis.#flushAll();\n\t\t\tthis.#requestRender();\n\t\t\treturn;\n\t\t}\n\n\t\tconst now = performance.now();\n\t\tlet rendered = false;\n\t\tfor (const state of this.#states.values()) {\n\t\t\tconst total = state.unitCounter.count(0, state.text);\n\t\t\tconst backlog = total - state.revealed;\n\t\t\tif (backlog <= 0) continue;\n\t\t\tstate.revealed = Math.min(total, state.revealed + nextStep(backlog, now - state.lastTickAt));\n\t\t\tstate.lastTickAt = now;\n\t\t\tstate.component.updateResult(displayResult(state), true);\n\t\t\trendered = true;\n\t\t}\n\t\tif (rendered) this.#requestRender();\n\t\tthis.#syncTimer();\n\t}\n}\n"]}

package/dist/utils/fs-watch.d.ts

@@ -1,5 +1,5 @@
-import { type FSWatcher, type WatchListener } from "node:fs";
+import { type FSWatcher, type WatchListener, type WatchOptions } from "node:fs";
 export declare const FS_WATCH_RETRY_DELAY_MS = 5000;
 export declare function closeWatcher(watcher: FSWatcher | null | undefined): void;
-export declare function watchWithErrorHandler(path: string, listener: WatchListener<string>, onError: () => void): FSWatcher | null;
+export declare function watchWithErrorHandler(path: string, listener: WatchListener<string>, onError: () => void, options?: WatchOptions): FSWatcher | null;
 //# sourceMappingURL=fs-watch.d.ts.map

package/dist/utils/fs-watch.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fs-watch.d.ts","sourceRoot":"","sources":["../../src/utils/fs-watch.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,SAAS,EAAE,KAAK,aAAa,EAAS,MAAM,SAAS,CAAC;AAEpE,eAAO,MAAM,uBAAuB,OAAO,CAAC;AAE5C,wBAAgB,YAAY,CAAC,OAAO,EAAE,SAAS,GAAG,IAAI,GAAG,SAAS,GAAG,IAAI,CAUxE;AAED,wBAAgB,qBAAqB,CACpC,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,aAAa,CAAC,MAAM,CAAC,EAC/B,OAAO,EAAE,MAAM,IAAI,GACjB,SAAS,GAAG,IAAI,CASlB"}
+{"version":3,"file":"fs-watch.d.ts","sourceRoot":"","sources":["../../src/utils/fs-watch.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,SAAS,EAAE,KAAK,aAAa,EAAE,KAAK,YAAY,EAAS,MAAM,SAAS,CAAC;AAEvF,eAAO,MAAM,uBAAuB,OAAO,CAAC;AAE5C,wBAAgB,YAAY,CAAC,OAAO,EAAE,SAAS,GAAG,IAAI,GAAG,SAAS,GAAG,IAAI,CAUxE;AAED,wBAAgB,qBAAqB,CACpC,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,aAAa,CAAC,MAAM,CAAC,EAC/B,OAAO,EAAE,MAAM,IAAI,EACnB,OAAO,CAAC,EAAE,YAAY,GACpB,SAAS,GAAG,IAAI,CASlB"}

package/dist/utils/fs-watch.js

@@ -11,9 +11,9 @@ export function closeWatcher(watcher) {
         // Ignore watcher close errors
     }
 }
-export function watchWithErrorHandler(path, listener, onError) {
+export function watchWithErrorHandler(path, listener, onError, options) {
     try {
-        const watcher = watch(path, listener);
+        const watcher = watch(path, { ...options, encoding: "utf8" }, listener);
         watcher.on("error", onError);
         return watcher;
     }

package/dist/utils/fs-watch.js.map

@@ -1 +1 @@
-{"version":3,"file":"fs-watch.js","sourceRoot":"","sources":["../../src/utils/fs-watch.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsC,KAAK,EAAE,MAAM,SAAS,CAAC;AAEpE,MAAM,CAAC,MAAM,uBAAuB,GAAG,IAAI,CAAC;AAE5C,MAAM,UAAU,YAAY,CAAC,OAAqC;IACjE,IAAI,CAAC,OAAO,EAAE,CAAC;QACd,OAAO;IACR,CAAC;IAED,IAAI,CAAC;QACJ,OAAO,CAAC,KAAK,EAAE,CAAC;IACjB,CAAC;IAAC,MAAM,CAAC;QACR,8BAA8B;IAC/B,CAAC;AACF,CAAC;AAED,MAAM,UAAU,qBAAqB,CACpC,IAAY,EACZ,QAA+B,EAC/B,OAAmB;IAEnB,IAAI,CAAC;QACJ,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QACtC,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAC7B,OAAO,OAAO,CAAC;IAChB,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,EAAE,CAAC;QACV,OAAO,IAAI,CAAC;IACb,CAAC;AACF,CAAC","sourcesContent":["import { type FSWatcher, type WatchListener, watch } from \"node:fs\";\n\nexport const FS_WATCH_RETRY_DELAY_MS = 5000;\n\nexport function closeWatcher(watcher: FSWatcher | null | undefined): void {\n\tif (!watcher) {\n\t\treturn;\n\t}\n\n\ttry {\n\t\twatcher.close();\n\t} catch {\n\t\t// Ignore watcher close errors\n\t}\n}\n\nexport function watchWithErrorHandler(\n\tpath: string,\n\tlistener: WatchListener<string>,\n\tonError: () => void,\n): FSWatcher | null {\n\ttry {\n\t\tconst watcher = watch(path, listener);\n\t\twatcher.on(\"error\", onError);\n\t\treturn watcher;\n\t} catch {\n\t\tonError();\n\t\treturn null;\n\t}\n}\n"]}
+{"version":3,"file":"fs-watch.js","sourceRoot":"","sources":["../../src/utils/fs-watch.ts"],"names":[],"mappings":"AAAA,OAAO,EAAyD,KAAK,EAAE,MAAM,SAAS,CAAC;AAEvF,MAAM,CAAC,MAAM,uBAAuB,GAAG,IAAI,CAAC;AAE5C,MAAM,UAAU,YAAY,CAAC,OAAqC;IACjE,IAAI,CAAC,OAAO,EAAE,CAAC;QACd,OAAO;IACR,CAAC;IAED,IAAI,CAAC;QACJ,OAAO,CAAC,KAAK,EAAE,CAAC;IACjB,CAAC;IAAC,MAAM,CAAC;QACR,8BAA8B;IAC/B,CAAC;AACF,CAAC;AAED,MAAM,UAAU,qBAAqB,CACpC,IAAY,EACZ,QAA+B,EAC/B,OAAmB,EACnB,OAAsB;IAEtB,IAAI,CAAC;QACJ,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,EAAE,GAAG,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,QAAQ,CAAC,CAAC;QACxE,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAC7B,OAAO,OAAO,CAAC;IAChB,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,EAAE,CAAC;QACV,OAAO,IAAI,CAAC;IACb,CAAC;AACF,CAAC","sourcesContent":["import { type FSWatcher, type WatchListener, type WatchOptions, watch } from \"node:fs\";\n\nexport const FS_WATCH_RETRY_DELAY_MS = 5000;\n\nexport function closeWatcher(watcher: FSWatcher | null | undefined): void {\n\tif (!watcher) {\n\t\treturn;\n\t}\n\n\ttry {\n\t\twatcher.close();\n\t} catch {\n\t\t// Ignore watcher close errors\n\t}\n}\n\nexport function watchWithErrorHandler(\n\tpath: string,\n\tlistener: WatchListener<string>,\n\tonError: () => void,\n\toptions?: WatchOptions,\n): FSWatcher | null {\n\ttry {\n\t\tconst watcher = watch(path, { ...options, encoding: \"utf8\" }, listener);\n\t\twatcher.on(\"error\", onError);\n\t\treturn watcher;\n\t} catch {\n\t\tonError();\n\t\treturn null;\n\t}\n}\n"]}

package/docs/extensions.md

@@ -12,6 +12,7 @@ Extensions are TypeScript modules that extend pi's behavior. They can subscribe
 - **User interaction** - Prompt users via `ctx.ui` (select, confirm, input, notify)
 - **Custom UI components** - Full TUI components with keyboard input via `ctx.ui.custom()` for complex interactions
 - **Custom commands** - Register commands like `/mycommand` via `pi.registerCommand()`
+- **Model fallback** - The bundled [`/fallback`](#bundled-fallback-command) command manages global per-model retry chains. Use `/fallback <target> <fallback1> [fallback2 ...]` for scripts, or `/fallback` in the TUI to view and edit chains. `--no-model-fallback` and `SENPI_NO_FALLBACK=1` disable it for one run.
 - **Session persistence** - Store state that survives restarts via `pi.appendEntry()`
 - **Custom rendering** - Control how tool calls/results and messages appear in TUI
 
@@ -31,6 +32,7 @@ See [examples/extensions/](../examples/extensions/) for working implementations.
 ## Table of Contents
 
 - [Quick Start](#quick-start)
+- [Bundled /fallback Command](#bundled-fallback-command)
 - [Extension Locations](#extension-locations)
 - [Available Imports](#available-imports)
 - [Writing an Extension](#writing-an-extension)
@@ -45,6 +47,7 @@ See [examples/extensions/](../examples/extensions/) for working implementations.
 - [ExtensionContext](#extensioncontext)
 - [ExtensionCommandContext](#extensioncommandcontext)
 - [ExtensionAPI Methods](#extensionapi-methods)
+- [Config reload](#config-reload)
 - [State Management](#state-management)
 - [Custom Tools](#custom-tools)
   - [Dynamic Tool Loading](#dynamic-tool-loading)
@@ -106,6 +109,32 @@ Test with `--extension` (or `-e`) flag:
 pi -e ./my-extension.ts
 ```
 
+## Bundled /fallback Command
+
+The bundled `model-fallback` extension registers `/fallback` to manage global per-model retry fallback chains. The command writes through the active session settings manager, so a saved chain is available to the current session's next retry without restarting Senpi. See [Settings](settings.md#model-fallback-chains) for selector syntax and runtime behavior.
+
+Use the quick-set form in scripts or any non-TUI mode:
+
+```text
+/fallback anthropic/claude-fable-5 ccapi/kimi-k3:max
+```
+
+The first argument is the exact primary model selector; each later argument is an ordered fallback selector. Quick-set validates selectors before saving. At least one fallback is required:
+
+```text
+/fallback <target> <fallback1> [fallback2 ...]
+```
+
+Run `/fallback` without arguments in the TUI for a menu that can:
+
+- show configured chains and live fallback state;
+- add or edit a chain by choosing the target, each fallback, and either an explicit or inherited thinking level;
+- remove a chain;
+- toggle `retry.modelFallback`; and
+- choose `retry.fallbackRevertPolicy` (`cooldown-expiry` or `never`).
+
+Use quick-set in non-TUI modes; the no-argument menu requires interactive UI. Pass `--no-model-fallback` or set `SENPI_NO_FALLBACK=1` to disable fallback for that process without modifying saved settings.
+
 ## Extension Locations
 
 > **Security:** Extensions run with your full system permissions and can execute arbitrary code. Only install from sources you trust.
@@ -1717,6 +1746,55 @@ pi.events.on("my:event", (data) => { ... });
 pi.events.emit("my:event", { ... });
 ```
 
+## Config reload
+
+Senpi's default-on `config-reload` builtin watches configured global surfaces and trusted project-local `.senpi` surfaces. A real content change requests the normal full session reload when the agent is idle; busy or compacting sessions defer it until a safe idle edge. Parseable built-in files (`settings.json`, `models.json`, and `keybindings.json`) are validated before reload, so a rejected edit keeps the running configuration active.
+
+Configure it in `settings.json` with optional fields; omitted fields use the defaults shown here. Invalid `configReload` fields are ignored individually, so a malformed block falls back to these defaults rather than disabling watching:
+
+```json
+{
+  "configReload": {
+    "enabled": true,
+    "debounceMs": 200,
+    "watch": {
+      "settings": true,
+      "models": true,
+      "keybindings": true,
+      "prompts": true,
+      "skills": true,
+      "extensions": true
+    }
+  }
+}
+```
+
+`skills` covers skill paths declared in settings as well as trusted project skills. Themes, credentials, sessions, and reload logs are not watched. Project config surfaces require project trust.
+
+### `config-watch:*` event protocol
+
+Extensions can register additional reloadable surfaces on the shared in-process `pi.events` bus. The channels are `config-watch:register`, `config-watch:unregister`, `config-watch:ready`, `config-watch:changed`, `config-watch:reloaded`, and `config-watch:rejected`. Registrations with the same `id` are last-wins. The registration wire shape is:
+
+```typescript
+{
+  id: string;
+  displayName: string;
+  targets: Array<{
+    path: string;
+    kind: "file" | "dir";
+    filterGlobs?: string[]; // simple name/suffix patterns, for example ["omo.json", "omo.jsonc"]
+  }>;
+  validate?: (changedPaths: readonly string[]) =>
+    | { ok: true }
+    | { ok: false; errors: string[] }
+    | Promise<{ ok: true } | { ok: false; errors: string[] }>;
+}
+```
+
+`config-watch:changed` emits `{ registrationId, paths, deferred }`; `config-watch:reloaded` emits `{ registrationId, paths }`; and `config-watch:rejected` emits `{ registrationId, paths, errors }`. `config-watch:ready` emits `{ enabled }`. Treat all event payloads as untrusted at the receiver boundary.
+
+In TUI mode the builtin requests the host reload action and shows notifications. RPC hosts without a reload action intentionally run in degraded mode: watchers remain active and `config-watch:changed` still emits, but no reload is requested. Print mode starts no watchers so a short-lived process can exit normally.
+
 ### pi.registerProvider(name, config)
 
 Register or override a model provider dynamically. Useful for proxies, custom endpoints, or team-wide model configurations.
@@ -2898,7 +2976,7 @@ const highlighted = highlightCode(code, lang, theme);
 | Interactive | `"tui"` | `true` | Full TUI with terminal rendering |
 | RPC (`--mode rpc`) | `"rpc"` | `true` | Dialogs and notifications via JSON protocol; `custom()` returns `undefined`. See [rpc.md](rpc.md) |
 | JSON (`--mode json`) | `"json"` | `false` | Event stream to stdout; UI methods are no-ops |
-| Print (`-p`) | `"print"` | `false` | Extensions run but can't prompt |
+| Print (`-p`) | `"print"` | `false` | Extensions run but can't prompt; `config-reload` deliberately starts no filesystem watchers |
 
 Use `ctx.mode === "tui"` before TUI-specific features (`custom()`, component factories, terminal input). Use `ctx.hasUI` before dialog and notification methods that work in both TUI and RPC modes.
 

package/docs/mcp.md

@@ -87,6 +87,15 @@ Per-request timeout. Default `30000`.
 ### `connectTimeoutMs`
 Connect + initialize handshake timeout. Default `15000`.
 
+### `startupTimeoutMs`
+Bounded startup window (ms) that a server's first connect + catalog fetch is
+raced against during session attach. A server that does not settle inside the
+window keeps connecting in the background and surfaces its tools when ready, so
+a slow or wedged server never blocks the first turn. Default `250`. Set higher
+to wait for tools before the first turn, `0` to never wait. The
+`SENPI_MCP_STARTUP_TIMEOUT_MS` environment variable overrides this for every
+server.
+
 ### `includeTools`
 Glob allowlist (`*` wildcards) over server-side tool names. Default: all.
 
@@ -199,7 +208,7 @@ Extension-declared servers use bare names (no prefix).
 | `degraded` | transient failure; auto-reconnect with backoff is running | wait, or `/mcp reconnect <name>` |
 | tools missing | server filtered/disabled, or hidden behind search | check `includeTools`/`excludeTools`, ask the model to `tool_search` |
 | child exits at spawn (EOF) | bad `command`/`args`/`env` | `/mcp logs <name>` shows the captured stderr |
-| slow first call | lazy server cold boot | use `lifecycle:"eager"` or `"keep-alive"` |
+| slow first call | lazy server cold boot (tools attach in the background) | raise `startupTimeoutMs`, or use `lifecycle:"eager"` / `"keep-alive"` |
 
 ## Security notes
 

package/docs/models.md

@@ -209,6 +209,7 @@ If your command is slow, expensive, rate-limited, or should keep using a previou
 | `contextWindow` | No | `128000` | Context window size in tokens |
 | `maxTokens` | No | `16384` | Maximum output tokens |
 | `cost` | No | all zeros | Per-million-token rates with optional request-wide input pricing tiers |
+| `recoverTextToolCalls` | No | Claude ID default | Enables or disables recovery of leaked Claude XML tool calls from streamed assistant text. This is a top-level model field, not a `compat` field. |
 | `compat` | No | provider `compat` | Provider compatibility overrides. Merged with provider-level `compat` when both are set. |
 
 A cost tier supplies a complete alternate rate set and applies to the full request when total input usage (`input + cacheRead + cacheWrite`) exceeds `inputTokensAbove`. When multiple tiers match, the highest threshold wins.
@@ -237,6 +238,106 @@ Current behavior:
 - `/model`, `--list-models`, and the interactive footer display entries by model `id`.
 - The configured `name` is used for model matching and secondary model detail text. It does not replace the footer/status-bar model id.
 
+## Claude text tool-call recovery
+
+Some Claude-family models or compatible gateways may accidentally emit a
+supported tool call as XML assistant text instead of a native provider tool
+call. Senpi can recover these calls while the response is streaming, execute a
+complete validated call through the normal agent loop, and persist it as native
+tool-call history for the next request.
+
+The setting is the top-level boolean `recoverTextToolCalls`. Non-boolean values
+in `models.json` are rejected.
+
+### Recovery activation precedence
+
+| Priority | Condition | Result |
+|----------|-----------|--------|
+| 1 | The model has a configured text tool-call protocol | Disabled |
+| 2 | `recoverTextToolCalls` is explicitly `true` or `false` | Configured boolean |
+| 3 | The original selected model id matches the Claude boundary rule | Claude ID default |
+
+The default boundary rule is
+`/(^|[^a-z0-9])claude([^a-z0-9]|$)/i`. It is evaluated against the
+original selected model id, before a provider alias or request hook rewrites
+the wire model id. Recovery is provider/API independent and is skipped when
+the request has no tools.
+
+Explicitly disable recovery for a Claude model:
+
+```json
+{
+  "providers": {
+    "anthropic": {
+      "modelOverrides": {
+        "anthropic/claude-sonnet-4": {
+          "recoverTextToolCalls": false
+        }
+      }
+    }
+  }
+}
+```
+
+Explicitly enable recovery for a non-Claude custom alias:
+
+```json
+{
+  "providers": {
+    "custom-proxy": {
+      "baseUrl": "https://proxy.example.com/v1",
+      "apiKey": "$CUSTOM_PROXY_KEY",
+      "api": "openai-completions",
+      "models": [
+        {
+          "id": "model-without-claude-name",
+          "recoverTextToolCalls": true
+        }
+      ]
+    }
+  }
+}
+```
+
+Text tool-call protocols retain exclusive ownership of text parsing. If
+`toolCallFormat` resolves for a model, recovery stays disabled even when
+`recoverTextToolCalls` is explicitly `true`.
+
+### Recovery scan boundaries
+
+| Content | Scanned | Behavior |
+|---------|---------|----------|
+| Ordinary assistant text | Yes | Supported leaked invokes may become native tool calls |
+| Inline and fenced code | No | Preserved byte-for-byte as text |
+| Thinking and redacted thinking | No | Preserved with signatures and metadata |
+| Provider-native and native tool-call blocks | No | Passed through without XML inspection |
+| Historical persisted messages | No | Replayed as stored; legacy XML text is not rewritten |
+
+The recognized syntax is limited to bare `invoke`/`parameter`/`function_calls`
+tags and their exact lowercase `antml:` variants. Unknown tools, ambiguous tool
+names, unrelated tags, and arbitrary namespace prefixes remain text.
+
+### Recovery outcomes
+
+| Condition | Outcome |
+|-----------|---------|
+| Complete valid call | Execute once |
+| Incomplete or invalid call | Do not execute |
+| Caller abort | Interrupted; do not execute |
+| Late native ID collision | Fail closed; do not execute |
+
+An incomplete call is persisted as an incomplete native tool call and produces
+a safe error result asking the model to re-issue complete arguments. A caller
+abort always remains interrupted, even if a complete leaked call was already
+recognized. Native/recovered ID collisions discovered after an event was
+emitted terminate with an error instead of renaming provider IDs.
+
+Recovered calls are persisted and replayed in each provider's native format.
+Senpi does not migrate or rewrite older stored assistant text. The next
+prompt-cache suffix may change after recovery because new messages contain
+native tool-call history instead of leaked XML; that cache-key change is
+expected.
+
 ### Thinking Level Map
 
 Use `thinkingLevelMap` on a model to describe model-specific thinking controls. Keys are senpi thinking levels: `off`, `minimal`, `low`, `medium`, `high`, `xhigh`, `max`. Maps may contain holes; for example, a model can expose `high` and `max` without exposing `xhigh`.
@@ -340,7 +441,7 @@ Use `modelOverrides` to customize built-in models and matching extension-registe
 }
 ```
 
-`modelOverrides` supports these fields per model: `name`, `reasoning`, `thinkingLevelMap`, `input`, `cost` (partial), `contextWindow`, `maxTokens`, `headers`, `compat`.
+`modelOverrides` supports these fields per model: `name`, `reasoning`, `thinkingLevelMap`, `input`, `cost` (partial), `contextWindow`, `maxTokens`, `headers`, `recoverTextToolCalls`, `compat`.
 
 Direct OpenAI GPT-5.6 Sol, Terra, and Luna default to a `272000` context window so requests remain within OpenAI's short-context pricing tier. To opt into OpenAI's 1.05M context window, increase it for each model you use:
 

package/docs/providers.md

@@ -91,6 +91,7 @@ pi
 | Xiaomi MiMo Token Plan (China) | `XIAOMI_TOKEN_PLAN_CN_API_KEY` | `xiaomi-token-plan-cn` |
 | Xiaomi MiMo Token Plan (Amsterdam) | `XIAOMI_TOKEN_PLAN_AMS_API_KEY` | `xiaomi-token-plan-ams` |
 | Xiaomi MiMo Token Plan (Singapore) | `XIAOMI_TOKEN_PLAN_SGP_API_KEY` | `xiaomi-token-plan-sgp` |
+| Alibaba Token Plan (ap-southeast-1) | `ALIBABA_TOKEN_PLAN_API_KEY` | `alibaba-token-plan` |
 
 Reference for environment variables and `auth.json` keys: [`const envMap`](https://github.com/earendil-works/pi-mono/blob/main/packages/ai/src/env-api-keys.ts) in [`packages/ai/src/env-api-keys.ts`](https://github.com/earendil-works/pi-mono/blob/main/packages/ai/src/env-api-keys.ts).
 
@@ -112,7 +113,8 @@ Store credentials in `~/.pi/agent/auth.json`:
   "xiaomi": { "type": "api_key", "key": "..." },
   "xiaomi-token-plan-cn":  { "type": "api_key", "key": "..." },
   "xiaomi-token-plan-ams": { "type": "api_key", "key": "..." },
-  "xiaomi-token-plan-sgp": { "type": "api_key", "key": "..." }
+  "xiaomi-token-plan-sgp": { "type": "api_key", "key": "..." },
+  "alibaba-token-plan": { "type": "api_key", "key": "..." }
 }
 ```
 

package/docs/settings.md

@@ -206,6 +206,9 @@ Set `PI_SKIP_VERSION_CHECK=1` to disable the senpi version update check. Use `--
 | `retry.enabled` | boolean | `true` | Enable automatic agent-level retry on transient errors |
 | `retry.maxRetries` | number | `3` | Maximum agent-level retry attempts |
 | `retry.baseDelayMs` | number | `2000` | Base delay for agent-level exponential backoff (2s, 4s, 8s) |
+| `retry.modelFallback` | boolean | `true` | Let eligible retry failures advance through configured per-model fallback chains |
+| `retry.fallbackChains` | `Record<string, string[]>` | `{}` | Ordered exact model-selector to fallback-selector chains |
+| `retry.fallbackRevertPolicy` | `"cooldown-expiry"` \| `"never"` | `"cooldown-expiry"` | Automatic primary-model restoration policy |
 | `retry.provider.timeoutMs` | number | `300000` | Provider/SDK request timeout and stream idle timeout in milliseconds |
 | `retry.provider.maxRetries` | number | `0` | Provider/SDK retry attempts |
 | `retry.provider.maxRetryDelayMs` | number | `60000` | Max server-requested delay before failing (60s) |
@@ -229,6 +232,38 @@ Keep `retry.provider.maxRetries` at `0` unless provider-level retries are explic
 }
 ```
 
+#### Model fallback chains
+
+`retry.fallbackChains` maps one exact primary-model selector to an ordered list of fallback selectors. A selector is `provider/model` with an optional `:thinking-level` suffix. For example, this switches Fable 5 to Kimi K3 at `max` thinking when an eligible failure occurs:
+
+```json
+{
+  "retry": {
+    "modelFallback": true,
+    "fallbackChains": {
+      "anthropic/claude-fable-5": ["ccapi/kimi-k3:max"]
+    },
+    "fallbackRevertPolicy": "cooldown-expiry"
+  }
+}
+```
+
+A chain is only for the exact primary model it names: selector lookup first considers an exact thinking-level selector, then the same `provider/model` without its thinking suffix. Wildcard selectors, role keys such as `default`, and other catch-all chains are not supported.
+
+A fallback entry with `:thinking-level` requests that level on the target model; a bare entry inherits the current thinking level. Either value is clamped to the target model's supported levels. When an unpinned fallback later returns to the primary, it restores the original thinking level unless you changed it while using the fallback.
+
+`/fallback` writes these settings to the global settings file. Project settings are still merged when read; because `fallbackChains` is a nested map, a project `retry.fallbackChains` replaces the global map rather than merging individual chain keys.
+
+#### Fallback behavior and diagnostics
+
+With `retry.enabled` and `retry.modelFallback` enabled, Senpi can switch from a transient or eligible hard provider failure to the next configured candidate. The switch continues the current turn without changing the existing conversation prefix, preserving prompt-cache inputs; fallback lifecycle events are never added to model context. Returning to a primary model happens only at a turn boundary, never while a response is streaming.
+
+Anthropic streaming refusals are identified from typed `stopDetails`. A configured candidate receives an immediate **pinned** fallback switch with a user-visible fallback notice: Senpi does not retry the refusing model and a pinned fallback never auto-reverts. Set `retry.fallbackRevertPolicy` to `"cooldown-expiry"` (the default) to return an unpinned fallback to its primary after the primary's cooldown expires, or `"never"` to keep the fallback until you change models.
+
+Fallback decisions are process-local. A `senpi-task` or subagent child process reads its own settings and maintains its own in-memory suppression state; it does not affect its parent process. Disable fallback for one run without changing settings with `--no-model-fallback` or `SENPI_NO_FALLBACK=1`.
+
+For diagnostics, Senpi writes sanitized NDJSON records for candidate skips, cooldowns, switches, reverts, manual clears, and validation warnings to `<agentDir>/logs/fallback.log`. The file is mode `0600` and rotates at 5 MB (`fallback.log.1`).
+
 ### Message Delivery
 
 | Setting | Type | Default | Description |