maka-agent 0.2.0-dev.45.20260921 → 0.2.0-dev.47.20260922

package/dist/pi-tui-layout.js

@@ -150,6 +150,13 @@ export class MakaPiLayoutComponent extends Container {
     previousLines;
     previousRows;
     previousWidth;
+    /**
+     * An in-turn question is live chrome, not a modal picker: reserving its rows
+     * keeps the transcript tail above it instead of compositing the prompt over
+     * model output. The runner owns the interaction lifecycle; this component
+     * owns the resulting terminal geometry.
+     */
+    blockingInteraction;
     constructor(state, transcript, activityStrip, pendingQueue, editor, statusLine, terminal, todoIndicator) {
         super();
         this.state = state;
@@ -168,45 +175,66 @@ export class MakaPiLayoutComponent extends Container {
         this.addChild(editor);
         this.addChild(statusLine);
     }
+    setBlockingInteraction(interaction) {
+        if (this.blockingInteraction === interaction)
+            return;
+        if (this.blockingInteraction)
+            this.removeChild(this.blockingInteraction);
+        this.blockingInteraction = interaction;
+        if (interaction)
+            this.addChild(interaction);
+    }
     render(width) {
         const transcriptLines = this.transcript.render(width);
         const activityLines = this.activityStrip.render(width);
         const allPendingLines = this.pendingQueue.render(width);
         const statusLines = this.statusLine.render(width);
-        // Supplementary information must not steal the composer's minimum space.
+        const blockingInteraction = this.blockingInteraction;
+        // #1064: separate an active strip from the last transcript line. Reserve
+        // both that gap and a content row before budgeting a blocking question.
+        const activityActive = activityLines.length > 0 && activityLines.some((line) => line.length > 0);
+        const lastTranscriptLine = transcriptLines[transcriptLines.length - 1];
+        const needGap = activityActive && lastTranscriptLine !== undefined && lastTranscriptLine.length > 0;
+        const paddedTranscript = needGap ? [...transcriptLines, ''] : transcriptLines;
+        const transcriptRows = blockingInteraction
+            ? Math.min(paddedTranscript.length, needGap ? 2 : 1)
+            : 0;
+        const interactionMargin = blockingInteraction ? 1 : 0;
+        const input = blockingInteraction ?? this.editor;
+        const minimumInputRows = input.minimumViewportRows();
+        // Supplementary information yields to the active input and transcript.
         const todoLines = this.terminal.rows >
             activityLines.length +
                 allPendingLines.length +
                 statusLines.length +
-                this.editor.minimumViewportRows()
+                transcriptRows +
+                interactionMargin +
+                minimumInputRows
             ? (this.todoIndicator?.render(width) ?? []).slice(0, 1)
             : [];
-        const pendingRowsAvailable = this.editor.isShowingAutocomplete()
+        const pendingRowsAvailable = blockingInteraction || this.editor.isShowingAutocomplete()
             ? Math.max(0, this.terminal.rows -
                 activityLines.length -
                 statusLines.length -
                 todoLines.length -
-                this.editor.minimumViewportRows())
+                transcriptRows -
+                interactionMargin -
+                minimumInputRows)
             : allPendingLines.length;
         const pendingLines = fitPendingQueueLines(allPendingLines, pendingRowsAvailable);
-        this.editor.setViewportRows(this.terminal.rows -
+        input.setViewportRows(this.terminal.rows -
             activityLines.length -
             pendingLines.length -
             statusLines.length -
-            todoLines.length);
-        const editorLines = this.editor.render(width);
-        // #1064: when the activity strip is showing (a turn is running), separate
-        // it from the last transcript line with a blank row. Without this, a
-        // thinking or tool row (the agent-work stack, which has no internal blank
-        // gaps) sits directly against `Working… 12s`.
-        const activityActive = activityLines.length > 0 && activityLines.some((line) => line.length > 0);
-        const lastTranscriptLine = transcriptLines[transcriptLines.length - 1];
-        const needGap = activityActive && lastTranscriptLine !== undefined && lastTranscriptLine.length > 0;
-        const paddedTranscript = needGap ? [...transcriptLines, ''] : transcriptLines;
+            todoLines.length -
+            transcriptRows -
+            interactionMargin);
+        const inputLines = input.render(width);
         const chromeRows = activityLines.length +
             pendingLines.length +
             todoLines.length +
-            editorLines.length +
+            inputLines.length +
+            interactionMargin +
             statusLines.length;
         const viewportRows = Math.max(0, this.terminal.rows - chromeRows);
         const paddingRows = Math.max(0, viewportRows - paddedTranscript.length);
@@ -216,7 +244,8 @@ export class MakaPiLayoutComponent extends Container {
             ...activityLines,
             ...pendingLines,
             ...todoLines,
-            ...editorLines,
+            ...inputLines,
+            ...(blockingInteraction ? [''] : []),
             ...statusLines,
         ];
         // #1097: record where pi-tui's live viewport starts for this render, in

package/dist/pi-tui-pickers.js

@@ -16,7 +16,7 @@
  * specific language governing permissions and limitations
  * under the License.
  */
-import { CombinedAutocompleteProvider, Editor, Key, SelectList, decodeKittyPrintable, isKeyRelease, isKeyRepeat, matchesKey, truncateToWidth, visibleWidth, wrapTextWithAnsi, } from '@earendil-works/pi-tui';
+import { CombinedAutocompleteProvider, CURSOR_MARKER, Editor, Key, SelectList, decodeKittyPrintable, isKeyRelease, isKeyRepeat, matchesKey, truncateToWidth, visibleWidth, wrapTextWithAnsi, } from '@earendil-works/pi-tui';
 import { defineUiMessageCatalog, formatUiMessage, resolveUiMessageCatalog, } from '@maka/core/ui-locale';
 import { providerDefaultsOf, validateSlug, } from '@maka/core/llm-connections';
 import { CONNECTION_NAME_MAX_LENGTH } from '@maka/core/runtime-policy';
@@ -333,6 +333,7 @@ const USER_QUESTION_ROW_PREFIX_WIDTH = 2;
 export class UserQuestionOverlay {
     input;
     editor;
+    viewportRows = Number.POSITIVE_INFINITY;
     // Highlight index over [0, options.length]. `options.length` is the input row.
     activeIndex = 0;
     constructor(tui, input) {
@@ -352,6 +353,13 @@ export class UserQuestionOverlay {
     get inputRowIndex() {
         return this.input.options.length;
     }
+    minimumViewportRows() {
+        // One title, every option, the answer field, and the closing divider.
+        return this.input.options.length + 3;
+    }
+    setViewportRows(rows) {
+        this.viewportRows = Math.max(this.minimumViewportRows(), Math.floor(rows));
+    }
     get onInputRow() {
         return this.activeIndex === this.inputRowIndex;
     }
@@ -411,30 +419,33 @@ export class UserQuestionOverlay {
         const hint = padLine(ansi.dim(this.input.hint), safeWidth);
         const blank = padLine('', safeWidth);
         const divider = padLine(ansi.accent('-'.repeat(safeWidth)), safeWidth);
-        const inputRows = this.renderInputRow(safeWidth);
+        const allInputRows = this.renderInputRow(safeWidth);
+        const inputBudget = Math.max(1, this.viewportRows - this.input.options.length - 2);
+        const cursorRow = Math.max(0, allInputRows.findIndex((line) => line.includes(CURSOR_MARKER)));
+        const inputStart = Math.max(0, Math.min(cursorRow, allInputRows.length - inputBudget));
+        const inputRows = allInputRows.slice(inputStart, inputStart + inputBudget);
         const optionRows = this.input.options.map((option, index) => formatUserQuestionOptionRow(option, index === this.activeIndex, safeWidth));
-        const assemble = (title, options) => [
+        const assemble = (title, options, help = [hint, blank]) => [
             ...title,
-            hint,
-            blank,
+            ...help,
             ...options.flat(),
             ...inputRows,
             divider,
         ];
         const full = assemble(titleLines, optionRows);
-        const budget = this.input.maxRows?.() ?? Number.POSITIVE_INFINITY;
+        const budget = this.viewportRows;
         if (full.length <= budget)
             return full;
-        // Over budget pi-tui would slice(0, maxHeight) — silently dropping the
-        // input row and divider. Degrade instead: cap the title at two lines and
-        // give every option an equal share of the remaining rows, each ending in
-        // a visible ellipsis when clamped. Only a terminal too short for one row
-        // per option still overflows, falling back to the pre-existing clip.
-        const cappedTitle = clampRowsWithEllipsis(titleLines, 2, safeWidth);
-        const fixedRows = cappedTitle.length + 2 + inputRows.length + 1;
+        // The layout owns the available height. Short screens first lose spacing
+        // and the hint, retaining the question, every choice, and the answer field.
+        const titleBudget = Math.min(2, Math.max(1, budget - this.input.options.length - inputRows.length - 3));
+        const cappedTitle = clampRowsWithEllipsis(titleLines, titleBudget, safeWidth);
+        const helpBudget = Math.max(0, budget - cappedTitle.length - this.input.options.length - inputRows.length - 1);
+        const help = [hint, blank].slice(0, helpBudget);
+        const fixedRows = cappedTitle.length + help.length + inputRows.length + 1;
         const optionBudget = Math.max(this.input.options.length, budget - fixedRows);
         const perOption = Math.max(1, Math.floor(optionBudget / Math.max(1, this.input.options.length)));
-        return assemble(cappedTitle, optionRows.map((rows) => clampRowsWithEllipsis(rows, perOption, safeWidth)));
+        return assemble(cappedTitle, optionRows.map((rows) => clampRowsWithEllipsis(rows, perOption, safeWidth)), help);
     }
     renderInputRow(width) {
         const marker = this.onInputRow ? '→' : ' ';

package/dist/pi-tui-runner.js

@@ -240,7 +240,7 @@ export async function runMakaPiTui(input) {
         };
     };
     let userQuestionInFlight = false;
-    let userQuestionOverlay;
+    let userQuestionPrompt;
     let userQuestionProgress;
     let formResponseInFlightRequestId;
     let formOverlay;
@@ -1783,9 +1783,14 @@ export async function runMakaPiTui(input) {
         maxHeight: '100%',
         margin: { bottom: BOTTOM_PICKER_MARGIN_ROWS },
     });
-    const closeUserQuestionOverlay = () => {
-        userQuestionOverlay?.hide();
-        userQuestionOverlay = undefined;
+    const closeUserQuestionPrompt = () => {
+        const prompt = userQuestionPrompt;
+        if (!prompt)
+            return;
+        layout.setBlockingInteraction(undefined);
+        userQuestionPrompt = undefined;
+        if (tui.getFocusedComponent() === prompt)
+            tui.setFocus(editorSurface);
     };
     const finishUserQuestion = (requestId, answers) => {
         if (userQuestionInFlight)
@@ -1796,7 +1801,7 @@ export async function runMakaPiTui(input) {
             return;
         }
         userQuestionInFlight = true;
-        closeUserQuestionOverlay();
+        closeUserQuestionPrompt();
         void respond
             .call(input.driver, { requestId, answers })
             .then(() => {
@@ -1824,36 +1829,35 @@ export async function runMakaPiTui(input) {
             finishUserQuestion(request.requestId, progress.answers);
             return;
         }
-        closeUserQuestionOverlay();
+        closeUserQuestionPrompt();
         const advance = (answer) => {
             progress.answers[progress.index] = answer;
             progress.index += 1;
             showUserQuestion();
         };
-        userQuestionOverlay = showBottomPicker(new UserQuestionOverlay(tui, {
+        userQuestionPrompt = new UserQuestionOverlay(tui, {
             title: question.question,
             rightLabel: `${progress.index + 1} / ${request.questions.length}`,
             hint: '↑↓ move · type to answer · Enter select · Esc unanswered · Ctrl+C stop',
             placeholder: 'Other: type your answer…',
             options: question.options,
-            // Live budget: terminal.rows changes on resize, so read it per render
-            // rather than at overlay construction.
-            maxRows: () => Math.max(1, terminal.rows - BOTTOM_PICKER_MARGIN_ROWS),
             onSelectOption: (index) => advance(question.options[index]?.label ?? null),
             onSubmitText: (value) => advance(value),
             onSkip: () => advance(null),
-        }));
+        });
+        layout.setBlockingInteraction(userQuestionPrompt);
+        tui.setFocus(userQuestionPrompt);
     };
-    const syncUserQuestionOverlay = () => {
+    const syncUserQuestionPrompt = () => {
         const request = activeUserQuestionRequest(state);
         if (!request) {
-            closeUserQuestionOverlay();
+            closeUserQuestionPrompt();
             userQuestionProgress = undefined;
             return;
         }
         if (userQuestionInFlight)
             return;
-        if (userQuestionProgress?.requestId !== request.requestId) {
+        if (userQuestionProgress?.requestId !== request.requestId || !userQuestionPrompt) {
             userQuestionProgress = {
                 requestId: request.requestId,
                 index: 0,
@@ -1978,7 +1982,7 @@ export async function runMakaPiTui(input) {
             transcriptOverlay?.hide();
             transcriptOverlay = undefined;
         }
-        syncUserQuestionOverlay();
+        syncUserQuestionPrompt();
         syncFormOverlay();
     };
     const showSelectPicker = (title, rightLabel, items, onSelect, options) => {
@@ -4090,6 +4094,11 @@ export async function runMakaPiTui(input) {
                 requestTurnInterrupt();
             return { consume: true };
         }
+        // AskUserQuestion is rendered inside the live layout so the transcript is
+        // not covered by a modal overlay. Keep the same input-capture boundary as
+        // the old overlay while the prompt owns focus.
+        if (userQuestionPrompt)
+            return undefined;
         if (tui.hasOverlay())
             return undefined;
         if (sideConversation && matchesSideConversationToggle(data)) {

package/dist/runtime-host-service-manager.js

@@ -24,9 +24,10 @@ import { mkdir, open, readFile, realpath, rename, rm, stat, unlink, } from 'node
 import { homedir } from 'node:os';
 import { dirname, isAbsolute, join, resolve } from 'node:path';
 import { truncateUtf8 } from '@maka/core/diagnostic-log';
+import { redactSecrets } from '@maka/core/redaction';
 import { canonicalProjectDirectoryRootSpec, isCanonicalRuntimeHostWebSocketPath, PROJECT_DIRECTORY_MAX_ROOTS, projectDirectoryRootSpecValid, RUNTIME_HOST_PROTOCOL_VERSION, } from '@maka/runtime-host/protocol';
 import { connectExistingRuntimeHost, prepareConnectedRuntimeHostRetirement, } from '@maka/runtime-host/client';
-import { resolveRuntimeHostManagedServiceId, RUNTIME_HOST_SERVICE_LOG_MAX_BYTES, } from '@maka/runtime-host/operator';
+import { resolveRuntimeHostManagedServiceId, RUNTIME_HOST_SERVICE_LOG_MAX_BYTES, RUNTIME_HOST_SERVICE_ERROR_MESSAGE_MAX_BYTES, } from '@maka/runtime-host/operator';
 import { withProcessLifetimeFileUpdateLock } from '@maka/storage/process-lifetime-file-update-lock';
 import { discoverMarkedStorageRoot, resolveExistingStorageRoot, tryAcquireInteractiveRootOwner, } from '@maka/storage/root-authority';
 import { isRuntimeHostManagedDeploymentCli, removeRuntimeHostManagedDeployment, resolveExistingRuntimeHostManagedDeploymentRoot, resolveRuntimeHostManagedDeploymentForCli, resolveRuntimeHostManagedDeploymentRoot, } from './runtime-host-managed-deployment.js';
@@ -39,6 +40,7 @@ const DEFAULT_WEBSOCKET_PATH = '/runtime-host';
 const SERVICE_OPERATION_LOCK_TIMEOUT_MS = 60_000;
 const SERVICE_READY_TIMEOUT_MS = 45_000;
 const SERVICE_READY_POLL_MS = 50;
+const SERVICE_READINESS_LOG_MAX_BYTES = 1_024;
 export class RuntimeHostServiceManagerError extends Error {
     code;
     constructor(code, message, options) {
@@ -451,6 +453,17 @@ export function formatRuntimeHostServiceLogs(sources) {
     })
         .join('\n');
 }
+export function formatRuntimeHostServiceReadinessDiagnostic(input) {
+    const lines = [`Runtime Host service did not become ready: ${redactSecrets(input.lastFailure)}`];
+    if (input.status) {
+        lines.push(`service state: ${input.status.state}; active: ${String(input.status.active)}; pid: ${input.status.pid ?? 'none'}; last exit code: ${input.status.lastExitCode ?? 'unknown'}`);
+    }
+    if (input.logs?.trim()) {
+        const safeLogs = takeUtf8Tail(redactSecrets(input.logs.trim()), SERVICE_READINESS_LOG_MAX_BYTES);
+        lines.push(`service logs (tail):\n${safeLogs}`);
+    }
+    return truncateUtf8(lines.join('\n'), RUNTIME_HOST_SERVICE_ERROR_MESSAGE_MAX_BYTES, '\n<diagnostic truncated>');
+}
 function takeUtf8Tail(value, maximumBytes) {
     const encoded = Buffer.from(value);
     if (encoded.byteLength <= maximumBytes)
@@ -738,7 +751,18 @@ export async function verifyRuntimeHostManagedServiceReady(config, backend) {
         }
         await new Promise((resolveWait) => setTimeout(resolveWait, SERVICE_READY_POLL_MS));
     }
-    throw new RuntimeHostServiceManagerError('service_manager_operation_failed', `Runtime Host service did not become ready: ${lastFailure}`);
+    throw new RuntimeHostServiceManagerError('service_manager_operation_failed', await formatRuntimeHostServiceReadinessFailure(lastFailure, backend));
+}
+async function formatRuntimeHostServiceReadinessFailure(lastFailure, backend) {
+    const [status, logs] = await Promise.all([
+        backend.status().catch(() => undefined),
+        backend.logs().catch(() => undefined),
+    ]);
+    return formatRuntimeHostServiceReadinessDiagnostic({
+        lastFailure,
+        status,
+        logs,
+    });
 }
 async function prepareRuntimeHostRetirement(config, expectedPid, allowInterruptActiveTasks) {
     const connected = await connectExistingRuntimeHost({

package/dist/tui-context-refresh.js

@@ -16,6 +16,7 @@
  * specific language governing permissions and limitations
  * under the License.
  */
+import { createRefreshReadCoordinator } from '@maka/core/refresh-read-coordinator';
 /**
  * How full the context is right now, re-asked mid-turn (#4545).
  *
@@ -55,44 +56,32 @@ export function isCtxRefreshRelevantEvent(event) {
 export const CTX_REFRESH_DEBOUNCE_MS = 400;
 /**
  * Coalesces a burst of refresh-worthy events into one query, and lets only
- * the latest issued query apply. A query that resolves after a newer one was
- * issued — or after `cancel` retired it — is dropped: the answer a slow read
- * brings back describes an older snapshot than the one already shown, and a
- * torn-down session is not owed an update at all. A failed query leaves the
- * last value standing: it is still the newest answer anyone has.
+ * the latest valid query apply. A query that resolves after a newer one was
+ * issued, after a relevant event invalidated it, or after `cancel` retired it
+ * is dropped: the answer a slow read brings back describes an older snapshot
+ * than the one already shown, and a torn-down session is not owed an update
+ * at all. A failed query leaves the last value standing: it is still the
+ * newest answer anyone has.
  *
  * The scheduler is injected so the policy is testable without a wall clock,
  * and follows the CLI's ticker convention: schedule returns the cancel.
  */
 export function createCtxRefresher(input) {
-    let cancelScheduled;
-    let revision = 0;
-    const dropScheduled = () => {
-        cancelScheduled?.();
-        cancelScheduled = undefined;
-    };
-    const run = () => {
-        cancelScheduled = undefined;
-        const requestRevision = ++revision;
-        void input.query().then((result) => {
-            if (requestRevision !== revision)
-                return;
-            input.apply(result);
-        }, () => { });
-    };
+    const coordinator = createRefreshReadCoordinator({
+        read: input.query,
+        apply: input.apply,
+        delayMs: input.delayMs,
+        schedule: input.schedule,
+    });
     return {
         observe(event) {
             if (!isCtxRefreshRelevantEvent(event))
                 return;
             // Restart rather than stack: the last event of a burst is the one whose
             // snapshot the reader wants, and an earlier timer would read before it.
-            dropScheduled();
-            cancelScheduled = input.schedule(run, input.delayMs);
-        },
-        cancel() {
-            dropScheduled();
-            revision += 1;
+            coordinator.observe();
         },
+        cancel: coordinator.cancel,
     };
 }
 /** Default one-shot timer; unref'd so a pending refresh never holds the CLI open. */

package/dist/tui-mcp-control.js

@@ -22,6 +22,7 @@ import { createCredentialMcpOAuthStorage, McpClientManager } from '@maka/mcp';
 import { createFileCredentialStore } from '@maka/storage/credential-store';
 import { AtomicFileWriteCommitUnknownError, createMcpConfigStore, assertMcpEndpointPolicyOnChanges, McpConfigSourceError, normalizeMcpConfig, normalizeMcpImport, } from '@maka/storage/mcp-config-store';
 import { createMcpCapabilityProvider } from './mcp-capability-provider.js';
+import { McpCapabilityPublication } from './mcp-capability-publication.js';
 const RUNTIME_HOST_CREDENTIAL_ENV = 'MAKA_RUNTIME_HOST_ACCESS_CREDENTIAL';
 export function createTuiMcpController(input, overrides = {}) {
     const manager = overrides.manager ??
@@ -49,9 +50,7 @@ class TuiMcpControllerImpl {
     #preparedImport;
     #actionLane = Promise.resolve();
     #publicationSuppressed = false;
-    #publicationRequested = false;
-    #publicationTask;
-    #published;
+    #publication;
     #snapshot = freezeSnapshot({
         initialization: 'loading',
         configuration: 'synchronizing',
@@ -67,6 +66,24 @@ class TuiMcpControllerImpl {
             ...this.#snapshot,
             canManagePublicationCredential: Boolean(connection.setCredential && connection.removeCredential),
         });
+        this.#publication = new McpCapabilityPublication({
+            connectionIdentity: () => this.#availability.kind === 'connected'
+                ? connectionIdentity(this.#availability)
+                : undefined,
+            revision: () => this.#deps.manager.toolSnapshot().revision,
+            createProvider: () => this.#deps.createProvider(this.#deps.manager),
+            replace: (provider) => this.#connection.replaceClientCapabilities(provider),
+            unregister: () => this.#connection.unregisterClientCapabilities(),
+            onState: (state) => {
+                this.#updateSnapshot({
+                    publication: state === 'unavailable'
+                        ? this.#availability.kind === 'unavailable'
+                            ? (this.#availability.reason ?? 'host_unavailable')
+                            : 'waiting'
+                        : state,
+                });
+            },
+        });
         this.#disposeManagerChange = deps.manager.onChange(() => {
             try {
                 this.#refreshManagerSnapshot();
@@ -81,7 +98,7 @@ class TuiMcpControllerImpl {
         this.#disposeConnectionAvailability = connection.subscribeConnectionAvailability((availability) => {
             this.#availability = availability;
             if (availability.kind === 'unavailable') {
-                this.#published = undefined;
+                this.#publication.invalidate();
                 this.#updateSnapshot({
                     publication: availability.reason ?? 'host_unavailable',
                     ...(availability.reason === 'provider_conflict'
@@ -161,15 +178,11 @@ class TuiMcpControllerImpl {
         this.#disposeConnectionAvailability();
         this.#listeners.clear();
         this.#preparedImport = undefined;
-        this.#publicationRequested = false;
+        const publicationClosing = this.#publication.close().catch(() => undefined);
         const managerClosing = this.#deps.manager.close();
         await this.#actionLane.catch(() => undefined);
         this.#config = undefined;
-        await this.#publicationTask?.catch(() => undefined);
-        if (this.#availability.kind === 'connected') {
-            await this.#connection.unregisterClientCapabilities().catch(() => undefined);
-        }
-        this.#published = undefined;
+        await publicationClosing;
         await this.#connection.closePublication?.().catch(() => undefined);
         await managerClosing;
         await this.#initialization.catch(() => undefined);
@@ -400,9 +413,10 @@ class TuiMcpControllerImpl {
         }
     }
     async #settlePublication() {
-        this.#requestPublication();
-        while (!this.#closed && (this.#publicationTask || this.#publicationRequested)) {
-            await this.#publicationTask?.catch(() => undefined);
+        if (!this.#closed &&
+            this.#snapshot.initialization === 'ready' &&
+            !this.#publicationSuppressed) {
+            await this.#publication.settle();
         }
         if (this.#snapshot.publication === 'error' ||
             this.#snapshot.publication === 'credential_rejected' ||
@@ -436,74 +450,9 @@ class TuiMcpControllerImpl {
         this.#notify();
     }
     #requestPublication() {
-        if (this.#closed) {
-            this.#publicationRequested = false;
+        if (this.#closed || this.#snapshot.initialization !== 'ready' || this.#publicationSuppressed)
             return;
-        }
-        if (this.#snapshot.initialization !== 'ready' || this.#publicationSuppressed)
-            return;
-        this.#publicationRequested = true;
-        if (this.#publicationTask)
-            return;
-        this.#publicationTask = this.#runPublicationQueue().finally(() => {
-            this.#publicationTask = undefined;
-            if (this.#publicationRequested)
-                this.#requestPublication();
-        });
-    }
-    async #runPublicationQueue() {
-        while (this.#publicationRequested && !this.#closed) {
-            this.#publicationRequested = false;
-            await this.#publishCurrentSnapshot();
-        }
-    }
-    async #publishCurrentSnapshot() {
-        const availability = this.#availability;
-        if (availability.kind !== 'connected') {
-            this.#updateSnapshot({ publication: availability.reason ?? 'host_unavailable' });
-            return;
-        }
-        const identity = connectionIdentity(availability);
-        const revision = this.#deps.manager.toolSnapshot().revision;
-        if (this.#published?.identity === identity && this.#published.revision === revision) {
-            this.#updateSnapshot({
-                publication: this.#snapshot.toolCount === 0 ? 'not_published' : 'published',
-            });
-            return;
-        }
-        let provider;
-        this.#updateSnapshot({ publication: 'publishing' });
-        try {
-            provider = this.#deps.createProvider(this.#deps.manager);
-            if (provider) {
-                await this.#connection.replaceClientCapabilities(provider);
-            }
-            else if (this.#published?.identity === identity && this.#published.registered) {
-                await this.#connection.unregisterClientCapabilities();
-            }
-        }
-        catch {
-            await closeProvider(provider);
-            if (this.#isCurrent(identity, revision)) {
-                this.#updateSnapshot({ publication: 'error' });
-            }
-            else {
-                this.#requestPublication();
-            }
-            return;
-        }
-        if (!this.#isCurrent(identity, revision)) {
-            this.#requestPublication();
-            return;
-        }
-        this.#published = { identity, revision, registered: provider !== undefined };
-        this.#updateSnapshot({ publication: provider ? 'published' : 'not_published' });
-    }
-    #isCurrent(identity, revision) {
-        return (!this.#closed &&
-            this.#availability.kind === 'connected' &&
-            connectionIdentity(this.#availability) === identity &&
-            this.#deps.manager.toolSnapshot().revision === revision);
+        this.#publication.request();
     }
     #updateSnapshot(update) {
         this.#snapshot = freezeSnapshot({ ...this.#snapshot, ...update });
@@ -548,14 +497,6 @@ function freezeSnapshot(snapshot) {
 function connectionIdentity(availability) {
     return `${availability.hostEpoch}\0${availability.connectionId}`;
 }
-async function closeProvider(provider) {
-    try {
-        await provider?.close?.();
-    }
-    catch {
-        // A rejected provider never crossed into Host ownership.
-    }
-}
 function cloneConfig(config) {
     return structuredClone(config);
 }

package/node_modules/@maka/core/dist/client-capability-grant.js

@@ -41,11 +41,11 @@ export function decodeClientCapabilitySessionGrantKey(value) {
 }
 export function decodeClientCapabilityGrantTarget(value) {
     const record = plainRecord(value, 'Client Capability Grant target');
-    const capability = oneOf(record.capability, ['browser', 'computer_use', 'desktop_mcp'], 'capability');
+    const capability = oneOf(record.capability, ['browser', 'computer_use', 'desktop_mcp', 'mcp'], 'capability');
     const scope = decodeClientCapabilityGrantScope(record.scope);
     if ((capability === 'browser' && scope.kind !== 'browser_origin') ||
         (capability === 'computer_use' && scope.kind !== 'capability') ||
-        (capability === 'desktop_mcp' && scope.kind !== 'mcp_tool')) {
+        ((capability === 'desktop_mcp' || capability === 'mcp') && scope.kind !== 'mcp_tool')) {
         throw new Error('Client Capability Session Grant scope does not match capability');
     }
     return deepFreeze({

package/node_modules/@maka/core/dist/model-thinking.js

@@ -65,6 +65,39 @@ function deriveThinkingChoices(options) {
     }
     return THINKING_LEVELS.filter((level) => choices.has(level));
 }
+/** Known patch-capable models. Unknown models stay off until explicitly enabled. */
+const APPLY_PATCH_MODELS = new Set([
+    'gpt-5-codex',
+    'gpt-5.1',
+    'gpt-5.1-codex',
+    'gpt-5.1-codex-mini',
+    'gpt-5.1-codex-max',
+    'gpt-5.2',
+    'gpt-5.2-codex',
+    'gpt-5.3-codex',
+    'gpt-5.3-codex-spark',
+    'gpt-5.4',
+    'gpt-5.4-mini',
+    'gpt-5.4-nano',
+    'gpt-5.4-pro',
+    'gpt-5.5',
+    'gpt-5.6',
+    'gpt-5.6-sol',
+    'gpt-5.6-terra',
+    'gpt-5.6-luna',
+    'gpt-6-astra',
+    'deepseek-v4-flash',
+    'deepseek-v4-flash-vision-exp',
+    'deepseek-v4-pro',
+]);
+/** Shared by model settings and tool routing so the displayed switch matches execution. */
+export function modelApplyPatchEnabled(modelId, override) {
+    return (override?.applyPatch ??
+        APPLY_PATCH_MODELS.has(modelId
+            .trim()
+            .toLowerCase()
+            .replace(/-\d{4}-\d{2}-\d{2}$/, '')));
+}
 function isRecord(value) {
     return typeof value === 'object' && value !== null && !Array.isArray(value);
 }
@@ -90,6 +123,8 @@ function normalizeModelOverride(entry) {
     }
     if (typeof entry.vision === 'boolean')
         declared.vision = entry.vision;
+    if (typeof entry.applyPatch === 'boolean')
+        declared.applyPatch = entry.applyPatch;
     for (const field of [
         'contextWindow',
         'compactionThreshold',
@@ -240,7 +275,7 @@ export function thinkingVariantsForModel(providerType, modelId) {
 export function applyModelOverride(model, override) {
     if (!override)
         return model;
-    const { thinkingLevels: _thinking, defaultThinkingLevel: _defaultThinking, serviceTier: _tier, compactionThreshold: _threshold, maxOutputTokens: _outputBudget, vision, capabilities, ...facts } = override;
+    const { thinkingLevels: _thinking, defaultThinkingLevel: _defaultThinking, serviceTier: _tier, compactionThreshold: _threshold, maxOutputTokens: _outputBudget, applyPatch: _applyPatch, vision, capabilities, ...facts } = override;
     return {
         ...model,
         ...facts,