koneck 2.122.0 → 2.124.0

package/dist/frame-sync.js

@@ -0,0 +1,80 @@
+/**
+ * Atomic frames, so a fast animation does not flash.
+ *
+ * Ink repaints its live region by erasing the lines it last wrote and printing the new ones:
+ *
+ *     stream.write(ansiEscapes.eraseLines(previousLineCount) + output)   // ink/build/log-update.js
+ *
+ * That is one `write`, but a terminal does not treat it as one picture. It erases the region,
+ * displays the gap, then draws the replacement — and the gap is a visible flash. The taller the
+ * live region, the more obvious it is, which is why it showed up here as flicker rather than as
+ * tearing. It was previously worked around by repainting less often: the spinner advanced once a
+ * second, the shimmer once every two, and the tick that reveals streamed text ran at 500-1000ms.
+ * That hid the flash by making the interface look broken — reported as "even 10x slower than a
+ * tortoise" — and it did not remove the cause, so any faster animation brought the flash back.
+ *
+ * DEC private mode 2026 removes the cause. Between "begin synchronized update" and "end", a
+ * terminal that implements it buffers what it receives and presents the result in one frame, so
+ * the erase and the redraw are never on screen separately. There is nothing to flash. Every
+ * frame Ink writes is wrapped inside a single `write` call, so the begin and the end cannot be
+ * separated by a crash, and terminals bound the block with their own timeout regardless.
+ *
+ * Terminals that do not implement it ignore it: setting and resetting an unrecognised DEC private
+ * mode is defined as a no-op, which is why this needs no capability query and prints nothing on an
+ * older terminal. It is still limited to a TTY — a pipe or a file should receive the frame bytes
+ * and nothing else — and can be turned off with KONECK_NO_SYNC_OUTPUT=1 if some terminal is found
+ * that handles it badly.
+ */
+/** Begin a synchronized update: hold everything that follows back from the screen. */
+const BEGIN = '\x1b[?2026h';
+/** End it: present everything since BEGIN as one frame. */
+const END = '\x1b[?2026l';
+/** Whether frames written to this stream should be presented atomically. */
+export function wantsSynchronizedFrames(stream = process.stdout, env = process.env) {
+    if (!stream.isTTY)
+        return false;
+    if (env.KONECK_NO_SYNC_OUTPUT === '1')
+        return false;
+    // A terminal that declares itself dumb is telling us it has no private modes to set.
+    if (!env.TERM || env.TERM === 'dumb')
+        return false;
+    return true;
+}
+/** One frame, bracketed so the terminal shows all of it at once or none of it. */
+export function synchronizedFrame(chunk) {
+    // An empty write has no frame to present, and bracketing it would be two escape sequences
+    // saying nothing.
+    if (chunk === '')
+        return chunk;
+    return BEGIN + chunk + END;
+}
+/**
+ * The same stream, with each write presented as one frame.
+ *
+ * A Proxy rather than a subclass or a prototype clone because Ink both writes to this object and
+ * listens on it, and an EventEmitter keeps its listeners on the instance. Every member other than
+ * `write` is read from — and every method bound to — the real stream, so `on('resize')` registers
+ * on the stream the terminal actually resizes rather than on a copy that never hears about it.
+ */
+export function withSynchronizedFrames(stream) {
+    if (!wantsSynchronizedFrames(stream))
+        return stream;
+    return new Proxy(stream, {
+        get(target, prop) {
+            if (prop === 'write') {
+                // Called on `target`, not lifted off it: a stream's write reaches into `this._writableState`,
+                // so a detached reference throws "Cannot read properties of undefined". Found by running
+                // the real binary on a pty, which a fake stream in a unit test had not needed to expose.
+                return (chunk, ...rest) => {
+                    const write = target.write;
+                    return typeof chunk === 'string'
+                        ? write.call(target, synchronizedFrame(chunk), ...rest)
+                        : write.call(target, chunk, ...rest);
+                };
+            }
+            const value = Reflect.get(target, prop, target);
+            return typeof value === 'function' ? value.bind(target) : value;
+        },
+    });
+}
+//# sourceMappingURL=frame-sync.js.map

package/dist/frame-sync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"frame-sync.js","sourceRoot":"","sources":["../src/frame-sync.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,sFAAsF;AACtF,MAAM,KAAK,GAAG,aAAa,CAAC;AAC5B,2DAA2D;AAC3D,MAAM,GAAG,GAAG,aAAa,CAAC;AAE1B,4EAA4E;AAC5E,MAAM,UAAU,uBAAuB,CACrC,SAA8B,OAAO,CAAC,MAAM,EAC5C,MAA0C,OAAO,CAAC,GAAG;IAErD,IAAI,CAAC,MAAM,CAAC,KAAK;QAAE,OAAO,KAAK,CAAC;IAChC,IAAI,GAAG,CAAC,qBAAqB,KAAK,GAAG;QAAE,OAAO,KAAK,CAAC;IACpD,qFAAqF;IACrF,IAAI,CAAC,GAAG,CAAC,IAAI,IAAI,GAAG,CAAC,IAAI,KAAK,MAAM;QAAE,OAAO,KAAK,CAAC;IACnD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,kFAAkF;AAClF,MAAM,UAAU,iBAAiB,CAAC,KAAa;IAC7C,0FAA0F;IAC1F,kBAAkB;IAClB,IAAI,KAAK,KAAK,EAAE;QAAE,OAAO,KAAK,CAAC;IAC/B,OAAO,KAAK,GAAG,KAAK,GAAG,GAAG,CAAC;AAC7B,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,sBAAsB,CAA+B,MAAS;IAC5E,IAAI,CAAC,uBAAuB,CAAC,MAAM,CAAC;QAAE,OAAO,MAAM,CAAC;IACpD,OAAO,IAAI,KAAK,CAAC,MAAM,EAAE;QACvB,GAAG,CAAC,MAAM,EAAE,IAAI;YACd,IAAI,IAAI,KAAK,OAAO,EAAE,CAAC;gBACrB,8FAA8F;gBAC9F,yFAAyF;gBACzF,yFAAyF;gBACzF,OAAO,CAAC,KAAc,EAAE,GAAG,IAAe,EAAW,EAAE;oBACrD,MAAM,KAAK,GAAG,MAAM,CAAC,KAA0D,CAAC;oBAChF,OAAO,OAAO,KAAK,KAAK,QAAQ;wBAC9B,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,iBAAiB,CAAC,KAAK,CAAC,EAAE,GAAG,IAAI,CAAC;wBACvD,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC,CAAC;gBACzC,CAAC,CAAC;YACJ,CAAC;YACD,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;YAChD,OAAO,OAAO,KAAK,KAAK,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;QAClE,CAAC;KACF,CAAM,CAAC;AACV,CAAC"}

package/dist/ink-chat.d.ts

@@ -68,8 +68,46 @@ export declare function pasteForDisplay(text: string, maxRows?: number): string;
  * reader is watching appear, rather than the whole reply waiting for the turn to end.
  */
 export declare function liveReplyLines(termRows: number | undefined): number;
-/** Sampling cadence for live stream refs: quick enough to read, slow enough not to flash. */
-export declare function liveRefreshDelay(idleForMs: number): number;
+/**
+ * How long one animation frame lasts.
+ *
+ * Every tick both advances the animation and reveals whatever the stream has added since the
+ * last one, so this is the interface's frame rate. It was 500ms while a stream was active and
+ * 1,000ms once it went quiet, which is where "the loader is moving slowly ... even 10x slower
+ * than a tortoise" came from: the spinner took ten seconds to turn once and the shimmer
+ * forty-eight to cross a word.
+ *
+ * The reason it was that slow was flicker, and the flicker was real — but the rate was never its
+ * cause. Ink writes a frame by erasing the previous one and drawing the next, and the terminal
+ * showed the gap between the two. Repainting less often only made the flash rarer. It is now
+ * fixed where it happens, in frame-sync.ts, by presenting each frame atomically, which leaves the
+ * frame rate free to be a frame rate.
+ *
+ * 80ms is what cli-spinners and ora use for braille spinners, and it is comfortably above Ink's
+ * own 32ms write throttle (`throttle(this.onRender, 32)` in ink/build/ink.js), so each tick
+ * becomes exactly one write rather than being coalesced with its neighbours. Measured cost of a
+ * tick on a Raspberry Pi 5: 0.7ms of React render and about 700 bytes written, or roughly 1% of
+ * one core at this rate.
+ */
+export declare const FRAME_MS = 80;
+/**
+ * How long one work word is held before the next is shown.
+ *
+ * The word is there to be read and enjoyed, not to reassure by moving, so it outlasts the
+ * animation by a long way.
+ */
+export declare const WORD_HOLD_MS = 60000;
+/**
+ * Which spinner cell and shimmer column a turn is showing after this much work.
+ *
+ * One function so the two cannot drift apart, and pure so the rates can be asserted rather than
+ * eyeballed: both advance one step per frame, the spinner wrapping around its glyphs and the
+ * shimmer running on for `Shimmer` to wrap over the word plus its trailing gap.
+ */
+export declare function animFrames(elapsedMs: number, spinnerLength: number): {
+    spin: number;
+    shimmer: number;
+};
 export { WORK_WORDS, shouldName, tierFor, workWord, type WorkTier, type TurnEffort, } from './work-words.js';
 /** Logical families for the searchable command palette; headers reuse an existing row. */
 export declare function commandGroup(command: string): string;

package/dist/ink-chat.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ink-chat.d.ts","sourceRoot":"","sources":["../src/ink-chat.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"ink-chat.d.ts","sourceRoot":"","sources":["../src/ink-chat.tsx"],"names":[],"mappings":"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"}

package/dist/ink-chat.js

@@ -2,8 +2,9 @@ import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-run
 import React, { useState, useEffect, useRef } from 'react';
 import { Box, Static, Text, render, useApp, useInput, useStdin } from 'ink';
 import { execa } from 'execa';
-import { createAgentSession, buildClient, resolveAgentConcurrency, toolsUnsupportedNotice } from './engine.js';
-import { estimateCost, formatCost } from './pricing.js';
+import { resolveAgentConcurrency, toolsUnsupportedNotice } from './engine-facts.js';
+import { withSynchronizedFrames } from './frame-sync.js';
+import { estimateCost, formatCost, rateText } from './pricing.js';
 import { generateSessionId, saveSession, listSessions, loadSession, relativeAge, renameSession, forkSession, archiveSession, findSession, } from './session.js';
 import { loadMemory } from './memory.js';
 import { loadKoneckConfig, saveKoneckConfig, setConfigKey, configKeyDescriptions, CONFIG_FILE, CONFIG_SCHEMA, stepValue, displayValue } from './config-store.js';
@@ -49,16 +50,18 @@ import { logoFor } from './logo.js';
 import { describeActivity } from './activity.js';
 import { redactSecrets, containsSecret } from './redact.js';
 import { renderTrajectory } from './trajectory.js';
-import { describeSandbox, resolveSandbox } from './sandbox.js';
-import { doctorChecks, doctorReport } from './doctor.js';
-import { runQualityGate } from './quality-gate.js';
-import { runPreflight, preflightReport, isPreflightReady } from './preflight.js';
+// sandbox.js and doctor.js are loaded by /status and /doctor. sandbox.js imports execaSync to run
+// bubblewrap and doctor.js shells out to check the environment, and both are reached only from
+// handleCommand, which is async. Measured: 122ms and 150ms.
+// quality-gate.js, mcp.js and refactor.js are loaded at the one command that uses each. Each
+// reaches something large — quality-gate takes shellFor from tools.js, refactor takes runAgent
+// from engine.js and ts-morph with it — and an eager import here undid the engine being lazy,
+// because the graph simply arrived by another road. Measured: 339ms, 141ms and 75ms.
+// preflight.js is loaded by the command that runs it: it imports quality-gate.js, and so
+// tools.js, for 505ms that a session which never types /preflight should not pay.
 import { listAuditEvents } from './audit.js';
 import { initializePolicy, loadPolicy, POLICY_FILE } from './policy.js';
 import { isWorkspaceTrusted, trustWorkspace, untrustWorkspace } from './workspace-trust.js';
-import { loadMCPConfig } from './mcp.js';
-import { renameSymbol, extractInterface, moveSymbol } from './refactor.js';
-import { rateText } from './model-catalog.js';
 const CYAN = '#54D7E7';
 const GREEN = '#9BCB8F';
 const CRIMSON = '#E8878D';
@@ -382,9 +385,62 @@ export function liveReplyLines(termRows) {
     const rows = termRows && termRows > 0 ? termRows : 24;
     return rows < 12 ? 1 : 2;
 }
-/** Sampling cadence for live stream refs: quick enough to read, slow enough not to flash. */
-export function liveRefreshDelay(idleForMs) {
-    return idleForMs < 2_000 ? 500 : 1_000;
+/**
+ * The engine, loaded the first time a turn needs it.
+ *
+ * Importing it at the top of this module cost 645ms of the 1,163ms it took to load the terminal
+ * app on a Raspberry Pi 5 — it reaches the OpenAI SDK, execa and ts-morph through fifty-seven
+ * modules — and not one line of it is needed to draw the banner, the prompt or the status bar.
+ * Nothing here is on a render path: every caller already runs inside an async handler, and the
+ * two things the interface prints synchronously are in engine-facts.js for that reason.
+ *
+ * The promise is cached, so concurrent callers share one import and later turns pay nothing. It is
+ * also warmed in the background as soon as the interface is up, which is why the first turn does
+ * not feel the move either.
+ */
+let enginePromise;
+function engine() {
+    return (enginePromise ??= import('./engine.js'));
+}
+/**
+ * How long one animation frame lasts.
+ *
+ * Every tick both advances the animation and reveals whatever the stream has added since the
+ * last one, so this is the interface's frame rate. It was 500ms while a stream was active and
+ * 1,000ms once it went quiet, which is where "the loader is moving slowly ... even 10x slower
+ * than a tortoise" came from: the spinner took ten seconds to turn once and the shimmer
+ * forty-eight to cross a word.
+ *
+ * The reason it was that slow was flicker, and the flicker was real — but the rate was never its
+ * cause. Ink writes a frame by erasing the previous one and drawing the next, and the terminal
+ * showed the gap between the two. Repainting less often only made the flash rarer. It is now
+ * fixed where it happens, in frame-sync.ts, by presenting each frame atomically, which leaves the
+ * frame rate free to be a frame rate.
+ *
+ * 80ms is what cli-spinners and ora use for braille spinners, and it is comfortably above Ink's
+ * own 32ms write throttle (`throttle(this.onRender, 32)` in ink/build/ink.js), so each tick
+ * becomes exactly one write rather than being coalesced with its neighbours. Measured cost of a
+ * tick on a Raspberry Pi 5: 0.7ms of React render and about 700 bytes written, or roughly 1% of
+ * one core at this rate.
+ */
+export const FRAME_MS = 80;
+/**
+ * How long one work word is held before the next is shown.
+ *
+ * The word is there to be read and enjoyed, not to reassure by moving, so it outlasts the
+ * animation by a long way.
+ */
+export const WORD_HOLD_MS = 60_000;
+/**
+ * Which spinner cell and shimmer column a turn is showing after this much work.
+ *
+ * One function so the two cannot drift apart, and pure so the rates can be asserted rather than
+ * eyeballed: both advance one step per frame, the spinner wrapping around its glyphs and the
+ * shimmer running on for `Shimmer` to wrap over the word plus its trailing gap.
+ */
+export function animFrames(elapsedMs, spinnerLength) {
+    const frame = Math.floor(Math.max(0, elapsedMs) / FRAME_MS);
+    return { spin: frame % spinnerLength, shimmer: frame };
 }
 const SPINNER = G.spinner;
 /**
@@ -1215,7 +1271,7 @@ export function App({ config: initialConfig, clearFrame }) {
     // Tool approval callbacks belong to a session created on an earlier render. Keep the control
     // posture live so turning approval on during a turn governs its next consequential tool call.
     const cfgRef = useRef(initialConfig);
-    // Live activity accumulates in a ref and is painted by the 100 ms ticker. Mutating a ref
+    // Live activity accumulates in a ref and is painted by the FRAME_MS ticker. Mutating a ref
     // instead of calling setState per token keeps a Raspberry Pi from re-rendering on every chunk.
     const sayRef = useRef(''); // narration not yet committed
     const liveToolRef = useRef(null); // the one tool still running
@@ -1223,8 +1279,6 @@ export function App({ config: initialConfig, clearFrame }) {
     const replyStartedRef = useRef(false);
     /** Everything streamed this turn. Empty means the provider did not stream at all. */
     const streamedRef = useRef('');
-    /** When the live region last had something new to show, used to pick the repaint rate. */
-    const lastActivityRef = useRef(Date.now());
     /**
      * Frames received before any content — proof the provider has the request and is working.
      *
@@ -1336,7 +1390,6 @@ export function App({ config: initialConfig, clearFrame }) {
      * whatever is left in the buffer.
      */
     function pushSay(text) {
-        lastActivityRef.current = Date.now();
         sayRef.current += text;
         streamedRef.current += text;
         charsRef.current += text.length;
@@ -1391,7 +1444,6 @@ export function App({ config: initialConfig, clearFrame }) {
     function pushTool(name, args) {
         commitSay();
         // Photograph every file this tool has announced it will touch, before it touches it.
-        lastActivityRef.current = Date.now();
         turnToolsRef.current += 1;
         pendingDiffRef.current = filesTouchedBy(name, args).slice(0, MAX_DIFF_FILES)
             .map(rel => ({ rel, before: readForDiff(rel) }));
@@ -1545,10 +1597,9 @@ export function App({ config: initialConfig, clearFrame }) {
         },
         onToolResult: (name, ok, ms, detail) => finishTool(name, ok, ms, detail),
         onToolOutput: (_name, line) => {
-            // Deliberately does not count as activity for the frame rate. A dev server logs a request
-            // every second or two, and treating each one as "something is happening" held the UI in its
-            // fastest repaint band for as long as the server ran — which is the flicker. The line still
-            // updates; the whole region just stops being redrawn eight times a second to show it.
+            // Written to the ref rather than to state: a dev server logs a request every second or two,
+            // and a setState per line re-rendered the interface on each one. The ticker paints whatever
+            // the ref holds when the next frame comes round, so a chatty tool costs nothing extra.
             if (liveToolRef.current)
                 liveToolRef.current.output = line;
         },
@@ -1597,7 +1648,6 @@ export function App({ config: initialConfig, clearFrame }) {
             // produce tens of thousands of characters per turn, and what anyone watching wants is what
             // it is thinking now.
             thinkingTextRef.current = (thinkingTextRef.current + text).slice(-THINKING_TAIL_CHARS);
-            lastActivityRef.current = Date.now();
         },
         onAgentProgress: (list) => { agentsRef.current = list; setAgents(list); },
         onWindowDetected: (limit, source) => setDetectedContext({ limit, source }),
@@ -1923,11 +1973,14 @@ export function App({ config: initialConfig, clearFrame }) {
      */
     const sessionNow = () => {
         if (!activeSession.p) {
-            activeSession.p = hold(createAgentSession({
+            // The options are built here, not inside the then, so the hooks and refs are read at the
+            // moment the session was asked for rather than a microtask later.
+            const opts = {
                 ...initialConfig,
                 pace: paceFrom(initialConfig.pace ?? savedEffort(undefined), 'medium'),
                 ...failoverHooks(), silent: true, ...sessionOpts,
-            }));
+            };
+            activeSession.p = hold(engine().then(m => m.createAgentSession(opts)));
         }
         return activeSession.p;
     };
@@ -2207,36 +2260,25 @@ export function App({ config: initialConfig, clearFrame }) {
         }
         busyStart.current = Date.now();
         wordTimer.current = 0;
-        // The frame rate is the flicker rate. Every tick makes Ink update the live region, so network
-        // activity must be sampled for a human reader rather than mirrored frame-for-frame. Half a
-        // second keeps streamed prose feeling live; an idle tool only needs a once-a-second
-        // heartbeat. This is particularly important in terminals that repaint an ANSI line update as
-        // a flash.
+        // One rate, whether or not the stream is saying anything. The spinner earns its place
+        // precisely when nothing is arriving — the 2m 44s wait on a provider that had gone quiet is
+        // what this was reported from — so backing the animation off when a turn goes idle stopped
+        // it in the one situation it exists for. Flicker is handled where it is caused, by writing
+        // each frame atomically; see frame-sync.ts.
         let timer;
+        const wordEvery = Math.max(1, Math.round(WORD_HOLD_MS / FRAME_MS));
         const tick = () => {
+            // Elapsed is read from the clock rather than counted in ticks, so a frame the event loop
+            // delivers late moves the animation on by what actually passed instead of falling behind.
             const elapsed = Date.now() - busyStart.current;
-            const delay = currentDelay();
-            // Do not animate several cells for every content refresh. The spinner moves once a second
-            // and the shimmer once every two seconds; the intervening refreshes are solely to reveal
-            // new streamed text.
-            setAnim({
-                spin: Math.floor(elapsed / 1_000) % SPINNER.length,
-                shimmer: Math.floor(elapsed / 2_000),
-                elapsed,
-            });
+            const { spin, shimmer } = animFrames(elapsed, SPINNER.length);
+            setAnim({ spin, shimmer, elapsed });
             wordTimer.current += 1;
-            // Roughly every 60 seconds, whatever the current rate. Twenty-five felt churned on a long
-            // run — the word is there to be read and enjoyed, not to reassure by moving.
-            if (wordTimer.current % Math.max(20, Math.round(60_000 / delay)) === 0) {
+            if (wordTimer.current % wordEvery === 0)
                 setSpinWord(w => w + 1);
-            }
-            timer = setTimeout(tick, delay);
-        };
-        const currentDelay = () => {
-            const idleFor = Date.now() - lastActivityRef.current;
-            return liveRefreshDelay(idleFor);
+            timer = setTimeout(tick, FRAME_MS);
         };
-        timer = setTimeout(tick, liveRefreshDelay(0));
+        timer = setTimeout(tick, FRAME_MS);
         return () => clearTimeout(timer);
     }, [busy]);
     // A queued prompt runs the moment the agent is free again. Keyed on `busy` rather than done
@@ -2325,7 +2367,8 @@ export function App({ config: initialConfig, clearFrame }) {
         const c = newCfg ?? cfg;
         cfgRef.current = c;
         setDetectedContext(null);
-        activeSession.p = hold(createAgentSession({ ...c, pace: paceFrom(effortRef.current, 'medium'), ...failoverHooks(), silent: true, ...sessionOpts }));
+        const opts = { ...c, pace: paceFrom(effortRef.current, 'medium'), ...failoverHooks(), silent: true, ...sessionOpts };
+        activeSession.p = hold(engine().then(m => m.createAgentSession(opts)));
         if (newCfg)
             setCfg(newCfg);
     }
@@ -2419,7 +2462,7 @@ export function App({ config: initialConfig, clearFrame }) {
             : 'The sending session has not done any work yet; this is a fresh instruction.';
         if (transcript.trim() !== '') {
             try {
-                const client = buildClient(cfg);
+                const client = (await engine()).buildClient(cfg);
                 const res = await client.chat.completions.create({
                     model: cfg.model,
                     max_tokens: 220,
@@ -2481,7 +2524,8 @@ export function App({ config: initialConfig, clearFrame }) {
                         ...(st.note ? { note: st.note } : {}),
                     })), updatedAt: Date.now() }
                 : undefined;
-            activeSession.p = hold(createAgentSession({ ...restoredCfg, silent: true, ...sessionOpts }, messages, { turns: meta.turns, totalTokens: meta.totalTokens }, restoredPlan));
+            const resumeOpts = { ...restoredCfg, silent: true, ...sessionOpts };
+            activeSession.p = hold(engine().then(m => m.createAgentSession(resumeOpts, messages, { turns: meta.turns, totalTokens: meta.totalTokens }, restoredPlan)));
             if (restoredPlan)
                 setPlan(restoredPlan);
             setSessionGoal(meta.goal ?? null);
@@ -3104,6 +3148,7 @@ export function App({ config: initialConfig, clearFrame }) {
                 // question that actually matters when a provider misbehaves unanswered: where did the
                 // request go? Working that out took a proxy and half an hour.
                 const endpoint = resolveProvider(cfg.provider, cfg.baseURL).baseURL;
+                const { describeSandbox, resolveSandbox } = await import('./sandbox.js');
                 addSystem(`Provider   : ${cfg.provider}\n` +
                     `Endpoint   : ${endpoint}\n` +
                     `Model      : ${cfg.model}\n` +
@@ -3199,6 +3244,7 @@ export function App({ config: initialConfig, clearFrame }) {
                 // rather than a stale global default.
                 addSystem(`**KONECK Doctor** — checking ${cfg.provider} and this workspace…`);
                 try {
+                    const { doctorChecks, doctorReport } = await import('./doctor.js');
                     const checks = await doctorChecks(cfg.cwd, cfg.provider, cfg.baseURL, cfg.apiKey);
                     setRows(prev => prev.slice(0, -1));
                     addSystem(`**KONECK Doctor**\n\n${doctorReport(checks)}`);
@@ -3210,6 +3256,7 @@ export function App({ config: initialConfig, clearFrame }) {
                 return;
             }
             case '/mcp': {
+                const { loadMCPConfig } = await import('./mcp.js');
                 const configured = await loadMCPConfig(cfg.cwd);
                 const session = await sessionNow().catch(() => null);
                 addSystem(mcpStatusText(Object.keys(configured?.servers ?? {}), session?.mcpServers ?? []));
@@ -3306,6 +3353,7 @@ export function App({ config: initialConfig, clearFrame }) {
                 addSystem(`Running native TypeScript refactor: ${cmd}…`);
                 try {
                     if (cmd === '/rename') {
+                        const { renameSymbol } = await import('./refactor.js');
                         const result = await renameSymbol(parts[0], parts[1], cfg.cwd, { announce: false });
                         addSystem(`Renamed \`${parts[0]}\` → \`${parts[1]}\` in ${result.filesChanged.length} file(s) (${result.occurrences} occurrence(s)).` +
                             (checkpoint
@@ -3313,11 +3361,13 @@ export function App({ config: initialConfig, clearFrame }) {
                                 : '\n\nNo Git restore point was available. Run `/preflight` before committing.'));
                     }
                     else if (cmd === '/extract') {
+                        const { extractInterface } = await import('./refactor.js');
                         await extractInterface(parts[0], parts[1], cfg.cwd, { announce: false });
                         addSystem(`Extracted interface for \`${parts[1]}\` from \`${parts[0]}\`.` +
                             (checkpoint ? `\n\nRestore point: \`${checkpoint.id}\` — run \`/preflight\`, or \`/revert ${checkpoint.id} --confirm\` to undo.` : '\n\nRun `/preflight` before committing.'));
                     }
                     else {
+                        const { moveSymbol } = await import('./refactor.js');
                         await moveSymbol(parts[0], parts[1], parts[2], cfg.cwd, { announce: false });
                         addSystem(`Moved \`${parts[0]}\` from \`${parts[1]}\` to \`${parts[2]}\` and updated imports.` +
                             (checkpoint ? `\n\nRestore point: \`${checkpoint.id}\` — run \`/preflight\`, or \`/revert ${checkpoint.id} --confirm\` to undo.` : '\n\nRun `/preflight` before committing.'));
@@ -3835,6 +3885,7 @@ export function App({ config: initialConfig, clearFrame }) {
                 // the same independent proof on demand, without the legacy TUI writing over Ink's frame.
                 addSystem('**Quality gate** — running detected lint and test checks…');
                 try {
+                    const { runQualityGate } = await import('./quality-gate.js');
                     const result = await runQualityGate(cfg.cwd, { report: false });
                     setRows(prev => prev.slice(0, -1));
                     if (result.checks.length === 0) {
@@ -3861,6 +3912,7 @@ export function App({ config: initialConfig, clearFrame }) {
             case '/preflight': {
                 addSystem('**Preflight** — checking patch integrity and detected quality gates…');
                 try {
+                    const { runPreflight, preflightReport } = await import('./preflight.js');
                     const result = await runPreflight(cfg.cwd);
                     setRows(prev => prev.slice(0, -1));
                     addSystem(preflightReport(result));
@@ -3878,6 +3930,7 @@ export function App({ config: initialConfig, clearFrame }) {
                 }
                 addSystem('**Ship check** — running deterministic readiness checks…');
                 try {
+                    const { runPreflight, preflightReport, isPreflightReady } = await import('./preflight.js');
                     const result = await runPreflight(cfg.cwd);
                     setRows(prev => prev.slice(0, -1));
                     addSystem(preflightReport(result));
@@ -5130,7 +5183,6 @@ export function App({ config: initialConfig, clearFrame }) {
             thinkingRef.current = { chars: 0, at: 0 };
             thinkingTextRef.current = '';
             incompleteRef.current = null;
-            lastActivityRef.current = Date.now();
             providerFramesRef.current = 0;
             liveToolRef.current = null;
             charsRef.current = 0;
@@ -5789,8 +5841,19 @@ export async function runInkChatMode(config) {
     // appearing at the top with a dead copy of the interface below it — caused by the first version
     // of this repaint, which did exactly that.
     let inkClear;
-    const app = render(_jsx(App, { config: config, clearFrame: () => inkClear?.() }), { exitOnCtrlC: false, patchConsole: false });
+    // Frames go out bracketed as synchronized updates, so the erase-then-redraw Ink performs on
+    // every repaint is composited by the terminal instead of being shown as a blank flash. That is
+    // what allows the animation to run at FRAME_MS; see frame-sync.ts.
+    const app = render(_jsx(App, { config: config, clearFrame: () => inkClear?.() }), { stdout: withSynchronizedFrames(process.stdout),
+        exitOnCtrlC: false, patchConsole: false });
     inkClear = app.clear;
+    // The engine is imported on demand so the banner and the prompt are not waiting on the OpenAI
+    // SDK, execa and ts-morph — 645ms of the 1,163ms it took to load this module on a Raspberry Pi
+    // 5. Warmed here, one tick after the interface is up, so the first turn does not pay for it
+    // either: by the time anything has been typed it is already in memory. Failures are ignored
+    // because this is only a head start — the real import happens at the call site and reports
+    // there.
+    setTimeout(() => { void engine().catch(() => { }); }, 0);
     await app.waitUntilExit();
 }
 //# sourceMappingURL=ink-chat.js.map