@crouton-kit/crouter 0.3.70 → 0.3.79

package/dist/core/profiles/select.js

@@ -15,6 +15,37 @@ import { emitKeypressEvents } from 'node:readline';
 import { listProfiles, loadProfileManifest, updateProfileLastUsed, createProfile, addProfileProject, ensureRootProfile, ROOT_PROFILE_ID, } from './manifest.js';
 import { getDefaultProfileId, setDefaultProfileId, clearDefaultProfile, } from './default-binding.js';
 import { stdoutColor } from '../output.js';
+import { formatBinding, matchesTerminalInput, resolveUserKeybindings, } from '../keybindings/index.js';
+const PROFILE_MENU_ACTIONS = [
+    'crtr.profile.menu.abort', 'crtr.profile.menu.up', 'crtr.profile.menu.down',
+    'crtr.profile.menu.select', 'crtr.profile.menu.accept-default',
+    'crtr.profile.menu.slot.1', 'crtr.profile.menu.slot.2', 'crtr.profile.menu.slot.3',
+    'crtr.profile.menu.slot.4', 'crtr.profile.menu.slot.5', 'crtr.profile.menu.slot.6',
+    'crtr.profile.menu.slot.7', 'crtr.profile.menu.slot.8', 'crtr.profile.menu.slot.9',
+    'crtr.profile.menu.create', 'crtr.profile.menu.search-existing', 'crtr.profile.menu.use-root',
+    'crtr.profile.menu.set-default', 'crtr.profile.menu.add-directory', 'crtr.profile.menu.unpin',
+];
+const PROFILE_SEARCH_ACTIONS = [
+    'crtr.profile.search.abort', 'crtr.profile.search.back', 'crtr.profile.search.pick',
+    'crtr.profile.search.up', 'crtr.profile.search.down', 'crtr.profile.search.delete',
+];
+function profileRawInput(str, k) {
+    return {
+        input: k.ctrl === true || k.meta === true ? (k.name ?? str) : str,
+        upArrow: k.name === 'up', downArrow: k.name === 'down',
+        return: k.name === 'return' || k.name === 'enter', escape: k.name === 'escape',
+        backspace: k.name === 'backspace', ctrl: k.ctrl, meta: k.meta, shift: k.shift,
+    };
+}
+function firstProfileMatch(bindings, ids, raw) {
+    return ids.find((id) => matchesTerminalInput(bindings, id, raw)) ?? null;
+}
+export function resolveProfileMenuAction(bindings, raw) {
+    return firstProfileMatch(bindings, PROFILE_MENU_ACTIONS, raw);
+}
+export function resolveProfileSearchAction(bindings, raw) {
+    return firstProfileMatch(bindings, PROFILE_SEARCH_ACTIONS, raw);
+}
 /** Resolve cwd to an absolute, realpath'd form so it compares against the
  *  realpath'd project dirs `createProfile`/`addProfileProject` already store
  *  (manifest.ts resolves every project dir through `realpathSync`). Falls back
@@ -154,14 +185,17 @@ function blockRows(block) {
     }
     return newlines + extra;
 }
-function renderMenu(title, subtitle, rows, sel, hint) {
+function renderMenu(bindings, title, subtitle, rows, sel, hint) {
     let out = `\n  ${bold(title)}\n`;
     if (subtitle !== undefined)
         out += `  ${dim(subtitle)}\n`;
     out += '\n';
     let num = 0;
     for (const [i, r] of rows.entries()) {
-        const tag = r.hotkey ?? String(++num);
+        const slot = r.bindingId === undefined ? ++num : 0;
+        const tag = r.bindingId !== undefined
+            ? formatBinding(bindings, r.bindingId)
+            : slot <= 9 ? formatBinding(bindings, `crtr.profile.menu.slot.${slot}`) : '';
         const mark = i === sel ? HILITE : ' ';
         const det = r.detail !== '' ? '  ' + dim(r.detail) : '';
         const def = r.isDefault ? '  ' + accent('\u00b7 ' + (r.defaultText ?? 'default')) : '';
@@ -169,23 +203,22 @@ function renderMenu(title, subtitle, rows, sel, hint) {
     }
     if (hint !== undefined)
         out += `\n    ${dim(hint)}\n`;
-    out += `\n  ${dim('\u2191\u2193/jk move  \u21b5 select  esc default  ^C quit')}\n`;
+    out += `\n  ${dim(`${formatBinding(bindings, 'crtr.profile.menu.up')}/${formatBinding(bindings, 'crtr.profile.menu.down')} move  ${formatBinding(bindings, 'crtr.profile.menu.select')} select  ${formatBinding(bindings, 'crtr.profile.menu.accept-default')} default  ${formatBinding(bindings, 'crtr.profile.menu.abort')} quit`)}\n`;
     return out;
 }
 /** Drive a highlighted keypress menu to a resolution. Returns the selected row
- *  index, plus the action letter when one of `actionKeys` was pressed on the
- *  highlighted row. */
-function runMenu(title, subtitle, rows, opts = {}) {
+ *  index, plus the semantic action when a row-scoped action was invoked. */
+function runMenu(bindings, title, subtitle, rows, opts = {}) {
     const numbered = [];
     rows.forEach((r, i) => {
-        if (r.hotkey === undefined)
+        if (r.bindingId === undefined)
             numbered.push(i);
     });
     let sel = opts.initialIndex ?? 0;
     return new Promise((resolve) => {
         let prevLines = 0;
         const draw = () => {
-            const block = renderMenu(title, subtitle, rows, sel, opts.hint);
+            const block = renderMenu(bindings, title, subtitle, rows, sel, opts.hint);
             process.stdout.write((prevLines > 0 ? cursorUp(prevLines) + CLEAR_DOWN : '') + block);
             prevLines = blockRows(block);
         };
@@ -196,22 +229,23 @@ function runMenu(title, subtitle, rows, opts = {}) {
             process.stdin.pause();
         };
         const onKey = (str, k) => {
-            if (k.ctrl === true && k.name === 'c') {
+            const action = resolveProfileMenuAction(bindings, profileRawInput(str, k));
+            if (action === 'crtr.profile.menu.abort') {
                 cleanup();
                 process.stdout.write('\n');
                 process.exit(130);
             }
-            if (k.name === 'up' || k.name === 'k' || str === 'k') {
+            if (action === 'crtr.profile.menu.up') {
                 sel = (sel - 1 + rows.length) % rows.length;
                 draw();
                 return;
             }
-            if (k.name === 'down' || k.name === 'j' || str === 'j') {
+            if (action === 'crtr.profile.menu.down') {
                 sel = (sel + 1) % rows.length;
                 draw();
                 return;
             }
-            if (k.name === 'return' || k.name === 'enter') {
+            if (action === 'crtr.profile.menu.select') {
                 cleanup();
                 resolve({ index: sel });
                 return;
@@ -219,28 +253,28 @@ function runMenu(title, subtitle, rows, opts = {}) {
             // Esc cancels navigation and accepts the default row (the MRU/pinned
             // profile, or the root row on the no-coverage menu) — a safe exit, never
             // a dead key. Ctrl-C still aborts crtr entirely.
-            if (k.name === 'escape') {
+            if (action === 'crtr.profile.menu.accept-default') {
                 cleanup();
                 resolve({ index: opts.initialIndex ?? 0 });
                 return;
             }
-            if (str !== undefined && /^[0-9]$/.test(str)) {
-                const d = Number.parseInt(str, 10);
+            if (action?.startsWith('crtr.profile.menu.slot.')) {
+                const d = Number.parseInt(action.slice(-1), 10);
                 if (d >= 1 && d <= numbered.length) {
                     sel = numbered[d - 1];
                     draw();
                 }
                 return;
             }
-            const hk = rows.findIndex((r) => r.hotkey !== undefined && r.hotkey === str);
+            const hk = rows.findIndex((r) => r.bindingId !== undefined && r.bindingId === action);
             if (hk >= 0) {
                 cleanup();
                 resolve({ index: hk });
                 return;
             }
-            if (str !== undefined && opts.actionKeys?.includes(str) === true) {
+            if (action !== null && opts.actionBindingIds?.includes(action) === true) {
                 cleanup();
-                resolve({ index: sel, action: str });
+                resolve({ index: sel, action });
             }
         };
         emitKeypressEvents(process.stdin);
@@ -308,7 +342,7 @@ async function offerAddDirToProfile(rl, entry, cwd) {
  *  out (returns null → caller falls back to root). Because typing filters,
  *  navigation here is arrows-only — j/k are literal filter characters (fzf
  *  convention), unlike the non-search menus where j/k move. */
-async function promptSelectExistingProfile() {
+async function promptSelectExistingProfile(bindings) {
     const all = [...listProfiles()]
         .filter((e) => e.profileId !== ROOT_PROFILE_ID)
         .sort((a, b) => (isMoreRecent(a.manifest.last_used_at, b.manifest.last_used_at) ? -1 : 1));
@@ -341,7 +375,7 @@ async function promptSelectExistingProfile() {
                 });
             }
             block += `\n  ${accent('\u203a')} ${filter}${dim('\u2588')}\n`;
-            block += `  ${dim('type to filter  \u2191\u2193 move  \u21b5 pick  esc back')}\n`;
+            block += `  ${dim(`type to filter  ${formatBinding(bindings, 'crtr.profile.search.up')}/${formatBinding(bindings, 'crtr.profile.search.down')} move  ${formatBinding(bindings, 'crtr.profile.search.pick')} pick  ${formatBinding(bindings, 'crtr.profile.search.back')} back`)}\n`;
             process.stdout.write((prevLines > 0 ? cursorUp(prevLines) + CLEAR_DOWN : '') + block);
             prevLines = blockRows(block);
         };
@@ -352,39 +386,40 @@ async function promptSelectExistingProfile() {
             process.stdin.pause();
         };
         const onKey = (str, k) => {
-            if (k.ctrl === true && k.name === 'c') {
+            const action = resolveProfileSearchAction(bindings, profileRawInput(str, k));
+            if (action === 'crtr.profile.search.abort') {
                 cleanup();
                 process.stdout.write('\n');
                 process.exit(130);
             }
-            if (k.name === 'escape') {
+            if (action === 'crtr.profile.search.back') {
                 cleanup();
                 resolve(null);
                 return;
             }
             const matches = matchesOf();
-            if (k.name === 'return' || k.name === 'enter') {
+            if (action === 'crtr.profile.search.pick') {
                 if (matches.length > 0) {
                     cleanup();
                     resolve(matches[sel].profileId);
                 }
                 return;
             }
-            if (k.name === 'up' || (k.ctrl === true && k.name === 'p')) {
+            if (action === 'crtr.profile.search.up') {
                 if (matches.length > 0) {
                     sel = (sel - 1 + matches.length) % matches.length;
                     draw();
                 }
                 return;
             }
-            if (k.name === 'down' || (k.ctrl === true && k.name === 'n')) {
+            if (action === 'crtr.profile.search.down') {
                 if (matches.length > 0) {
                     sel = (sel + 1) % matches.length;
                     draw();
                 }
                 return;
             }
-            if (k.name === 'backspace') {
+            if (action === 'crtr.profile.search.delete') {
                 filter = filter.slice(0, -1);
                 sel = 0;
                 draw();
@@ -416,18 +451,18 @@ async function createProfileHere(rl, cwd) {
     process.stdout.write(`  ${accent('\u2713')} ${dim(`created profile "${name}"`)}\n`);
     return profileId;
 }
-async function promptCreateOrRoot(cwd) {
+async function promptCreateOrRoot(cwd, bindings) {
     // Root is the highlighted default so a bare Enter (or Esc) still lands on the
     // safe no-op, exactly as the old `[c/s/r]` prompt defaulted. Looped so Esc
     // out of the search sub-list returns HERE rather than silently dropping to
     // root — the create/select/root choice is always the fallback, never skipped.
     const rows = [
-        { label: 'create a profile here', detail: '', hotkey: 'c' },
-        { label: 'select an existing profile', detail: '', hotkey: 's' },
-        { label: dim('use the root profile'), detail: '', hotkey: 'r', isDefault: true },
+        { label: 'create a profile here', detail: '', bindingId: 'crtr.profile.menu.create' },
+        { label: 'select an existing profile', detail: '', bindingId: 'crtr.profile.menu.search-existing' },
+        { label: dim('use the root profile'), detail: '', bindingId: 'crtr.profile.menu.use-root', isDefault: true },
     ];
     for (;;) {
-        const res = await runMenu('No profile covers this directory', undefined, rows, {
+        const res = await runMenu(bindings, 'No profile covers this directory', undefined, rows, {
             initialIndex: 2,
         });
         if (res.index === 0) {
@@ -440,7 +475,7 @@ async function promptCreateOrRoot(cwd) {
             }
         }
         if (res.index === 1) {
-            const selected = await promptSelectExistingProfile();
+            const selected = await promptSelectExistingProfile(bindings);
             // Esc/back out of the search list (or no profiles to pick) → re-show this
             // create/select/root menu, not a silent fall-through to root.
             if (selected === null)
@@ -469,7 +504,7 @@ async function promptCreateOrRoot(cwd) {
  *  here: a claimed/covered directory always has at least a covering profile as a
  *  sane identity, so `[r]oot` belongs only to the no-coverage prompt
  *  (`promptCreateOrRoot`). Same raw-readline / boot-gating rationale. */
-async function promptPickProfileOrCreate(candidates, cwd, exact, pinnedId) {
+async function promptPickProfileOrCreate(candidates, cwd, exact, pinnedId, bindings) {
     // MRU-first so the most-recently-used candidate is the bare-Enter default —
     // the same profile the non-interactive path auto-picks. A per-cwd pin (set
     // here with `d`) overrides that: it sorts to the top and becomes the
@@ -501,24 +536,22 @@ async function promptPickProfileOrCreate(candidates, cwd, exact, pinnedId) {
             defaultText,
         };
     });
-    rows.push({ label: dim('create a new profile here'), detail: '', hotkey: 'c' });
-    // Action letters resolve on the highlighted row: `d` pins it as this
-    // directory's default; `a` widens its purview to include cwd (meaningless
-    // when the candidates already claim cwd exactly, so hidden there); `u` clears
-    // an existing pin.
-    const actionKeys = ['d'];
+    rows.push({ label: dim('create a new profile here'), detail: '', bindingId: 'crtr.profile.menu.create' });
+    // Row-scoped actions pin the highlighted profile, widen its purview (hidden
+    // when candidates already claim cwd exactly), or clear an existing pin.
+    const actionBindingIds = ['crtr.profile.menu.set-default'];
     if (!exact)
-        actionKeys.push('a');
+        actionBindingIds.push('crtr.profile.menu.add-directory');
     if (pinned !== null)
-        actionKeys.push('u');
-    const hintParts = ['d=set default'];
+        actionBindingIds.push('crtr.profile.menu.unpin');
+    const hintParts = [`${formatBinding(bindings, 'crtr.profile.menu.set-default')}=set default`];
     if (!exact)
-        hintParts.push('a=add dir here');
+        hintParts.push(`${formatBinding(bindings, 'crtr.profile.menu.add-directory')}=add dir here`);
     if (pinned !== null)
-        hintParts.push('u=unpin');
-    const res = await runMenu(exact ? 'Choose a profile' : 'Select a profile', exact
+        hintParts.push(`${formatBinding(bindings, 'crtr.profile.menu.unpin')}=unpin`);
+    const res = await runMenu(bindings, exact ? 'Choose a profile' : 'Select a profile', exact
         ? 'Several profiles claim this directory as their project'
-        : 'This directory falls under existing profile(s)', rows, { actionKeys, hint: hintParts.join('  ') });
+        : 'This directory falls under existing profile(s)', rows, { actionBindingIds, hint: hintParts.join('  ') });
     // The create row is last; selecting it (Enter on it, or `c`) creates here.
     if (res.index >= ordered.length) {
         const rl = createInterface({ input: process.stdin, output: process.stdout });
@@ -530,16 +563,16 @@ async function promptPickProfileOrCreate(candidates, cwd, exact, pinnedId) {
         }
     }
     const picked = ordered[res.index];
-    if (res.action === 'u') {
+    if (res.action === 'crtr.profile.menu.unpin') {
         clearDefaultProfile(cwd);
         process.stdout.write(`  ${accent('\u2713')} ${dim('cleared the default for this directory')}\n`);
         return picked.profileId;
     }
-    if (res.action === 'd') {
+    if (res.action === 'crtr.profile.menu.set-default') {
         setDefaultProfileId(cwd, picked.profileId);
         process.stdout.write(`  ${accent('\u2713')} ${dim(`"${picked.manifest.name}" is now the default here`)}\n`);
     }
-    else if (res.action === 'a') {
+    else if (res.action === 'crtr.profile.menu.add-directory') {
         addProfileProject(picked.profileId, cwd);
         process.stdout.write(`  ${accent('\u2713')} ${dim(`added this directory to "${picked.manifest.name}"`)}\n`);
     }
@@ -576,6 +609,7 @@ async function promptPickProfileOrCreate(candidates, cwd, exact, pinnedId) {
  *     never stdout, which the caller may be piping. */
 export async function selectProfileForCwd(cwd, explicitProfile, forcePicker = false) {
     const resolvedCwd = resolveCwd(cwd);
+    const bindings = resolveUserKeybindings();
     if (explicitProfile !== undefined && explicitProfile !== null && explicitProfile !== '') {
         const entry = loadProfileManifest(explicitProfile);
         // Selecting a profile from a directory it does not yet cover: offer to
@@ -633,10 +667,10 @@ export async function selectProfileForCwd(cwd, explicitProfile, forcePicker = fa
     // the create-or-root prompt (root is only ever offered there).
     const validPinnedId = pinned !== null ? pinned.profileId : null;
     const chosen = exact.length > 1
-        ? await promptPickProfileOrCreate(exact, resolvedCwd, true, validPinnedId)
+        ? await promptPickProfileOrCreate(exact, resolvedCwd, true, validPinnedId, bindings)
         : covering.length > 0
-            ? await promptPickProfileOrCreate(covering, resolvedCwd, false, validPinnedId)
-            : await promptCreateOrRoot(resolvedCwd);
+            ? await promptPickProfileOrCreate(covering, resolvedCwd, false, validPinnedId, bindings)
+            : await promptCreateOrRoot(resolvedCwd, bindings);
     updateProfileLastUsed(chosen);
     return chosen;
 }

package/dist/core/provider-management.d.ts

@@ -0,0 +1,12 @@
+/** The minimal shape of a Providers-panel row the removal router needs. */
+export interface RemovableProviderRow {
+    providerId: string;
+    name: string;
+    managed: boolean;
+    configured?: boolean;
+    label?: string;
+}
+/** Route a row's removal to the coordinated service (managed) or AuthStorage (non-managed) and
+ *  return the truthful panel notice. May throw (e.g. an unknown-subscription error) — callers
+ *  surface that as the notice. */
+export declare function removeProviderRow(agentDir: string, row: RemovableProviderRow): string;

package/dist/core/provider-management.js

@@ -0,0 +1,24 @@
+// Removal routing for a Providers-panel row, kept in core (out of the TUI module) so both the
+// `crtr sys setup` panel and the regression suite exercise the exact same guard.
+//
+// Final-review finding #1: a MANAGED provider — whether an account row (has a label) or the
+// provider HEADER row (no label, the default cursor position) — MUST go through the coordinated
+// removeManagedProvider so auth.json AND the rotation pool are torn down together (a header removes
+// every account). Only a NON-managed configured provider uses the raw AuthStorage.logout(). Routing
+// a managed header to logout() (the original bug) strips only auth.json, leaves the pool configured,
+// and makes the panel claim "Removed" while a reload still shows the provider — the split-ownership
+// bug this feature exists to eliminate.
+import { join } from 'node:path';
+import { AuthStorage } from '@earendil-works/pi-coding-agent';
+import { removeManagedProvider } from './subscription-state.js';
+/** Route a row's removal to the coordinated service (managed) or AuthStorage (non-managed) and
+ *  return the truthful panel notice. May throw (e.g. an unknown-subscription error) — callers
+ *  surface that as the notice. */
+export function removeProviderRow(agentDir, row) {
+    if (row.managed) {
+        removeManagedProvider(row.providerId, row.label === undefined ? undefined : row.label === 'Default account' ? row.providerId : row.label);
+        return row.label === undefined ? `Removed ${row.name}` : `Removed ${row.name} account`;
+    }
+    AuthStorage.create(join(agentDir, 'auth.json')).logout(row.providerId);
+    return `Removed ${row.name}`;
+}

package/dist/core/runtime/broker-protocol.d.ts

@@ -169,6 +169,15 @@ export interface CycleModelFrame {
     type: 'cycle_model';
     direction?: 'forward' | 'backward';
 }
+/** `cycleLadder(direction)` — alt+m forward / alt+shift+m backward. Walks the INTERLEAVED model ladder
+ *  (anthropic/ultra → openai/ultra → anthropic/strong → openai/strong → …),
+ *  starting from the current model, applying each rung's own thinking level.
+ *  Distinct from `cycle_model`, which steps the flat registry list. `direction`
+ *  defaults to `'forward'` when absent. */
+export interface CycleLadderFrame {
+    type: 'cycle_ladder';
+    direction?: 'forward' | 'backward';
+}
 /** `cycleThinkingLevel()` — shift+tab. Cycles to the next thinking level; the new
  *  level reaches viewers via the relayed `thinking_level_changed` event, so the
  *  broker replies a plain `ack` (no payload). Distinct from `set_thinking_level`,
@@ -303,7 +312,7 @@ export interface ShareFrame {
 export interface ReloadAuthFrame {
     type: 'reload_auth';
 }
-export type ClientToBroker = HelloFrame | PromptFrame | SteerFrame | FollowUpFrame | AbortFrame | BashFrame | RequestControlFrame | ReleaseControlFrame | ByeFrame | ShutdownFrame | SetModelFrame | CycleModelFrame | CycleThinkingFrame | SetThinkingLevelFrame | DequeueFrame | SetAutoRetryFrame | SetAutoCompactionFrame | CompactFrame | NewSessionFrame | SwitchSessionFrame | ForkFrame | SetSessionNameFrame | GetCommandsFrame | NavigateTreeFrame | ReloadFrame | ExportFrame | ListModelsFrame | ListSessionsFrame | GetTreeFrame | GetSettingsFrame | ListScopedModelsFrame | ExtensionUIResponseFrame | CloneFrame | ShareFrame | ReloadAuthFrame;
+export type ClientToBroker = HelloFrame | PromptFrame | SteerFrame | FollowUpFrame | AbortFrame | BashFrame | RequestControlFrame | ReleaseControlFrame | ByeFrame | ShutdownFrame | SetModelFrame | CycleModelFrame | CycleLadderFrame | CycleThinkingFrame | SetThinkingLevelFrame | DequeueFrame | SetAutoRetryFrame | SetAutoCompactionFrame | CompactFrame | NewSessionFrame | SwitchSessionFrame | ForkFrame | SetSessionNameFrame | GetCommandsFrame | NavigateTreeFrame | ReloadFrame | ExportFrame | ListModelsFrame | ListSessionsFrame | GetTreeFrame | GetSettingsFrame | ListScopedModelsFrame | ExtensionUIResponseFrame | CloneFrame | ShareFrame | ReloadAuthFrame;
 export interface WelcomeFrame {
     type: 'welcome';
     snapshot: BrokerSnapshot;
@@ -330,6 +339,13 @@ export interface ControlChangedFrame {
 export interface ModelChangedFrame {
     type: 'model_changed';
     model: string | undefined;
+    /** The full resolved `provider/id[:thinking]` spec (`formatModelSpec`) — what
+     *  the broker persists into the node's own launch recipe. Viewers use it to
+     *  persist a non-portable explicit pick as a kind DEFAULT
+     *  (`persistDefaultKindModel`) without guessing the provider from the bare
+     *  id. Null when the engine has no model. Optional so older brokers'
+     *  frames still parse. */
+    spec?: string | null;
 }
 export interface ErrorFrame {
     type: 'error';
@@ -380,9 +396,10 @@ export interface WireScopedModel {
     model: Model<Api>;
     thinkingLevel?: AgentSession['thinkingLevel'];
 }
-/** Wire form of pi's `SessionInfo`: identical EXCEPT `created`/`modified` are ISO
- *  strings (pi's are `Date`, which JSON cannot round-trip) — the viewer revives
- *  them with `new Date(...)` before handing them to `SessionSelectorComponent`. */
+/** Wire form of pi's `SessionInfo`: `created`/`modified` are ISO strings (pi's
+ *  are `Date`, which JSON cannot round-trip), and `allMessagesText` is a bounded
+ *  opening/latest search excerpt rather than the unbounded transcript text. The
+ *  viewer revives the dates before handing them to `SessionSelectorComponent`. */
 export interface WireSessionInfo extends Omit<SessionInfo, 'created' | 'modified'> {
     created: string;
     modified: string;
@@ -494,10 +511,21 @@ export interface DisplayTitleFrame {
 }
 /** A blocking dialog routed to the controller — pi's public RPC request type. */
 export type ExtensionUIRequestFrame = RpcExtensionUIRequest;
+/** Broker → client: dismiss a previously-forwarded blocking dialog by request id,
+ *  WITHOUT a client answer. The broker sends this exactly when it resolves a pending
+ *  dialog ITSELF rather than the client answering it — the extension aborted the
+ *  request out-of-band (e.g. a local OAuth loopback callback won the race against a
+ *  still-open manual-paste dialog) or the broker-side timeout fired. The client tears
+ *  down ONLY the overlay whose `id` matches; every other dialog stays exactly as it
+ *  was, so an unrelated request can never dismiss an unrelated blocking dialog. */
+export interface ExtensionUIDismissFrame {
+    type: 'extension_ui_dismiss';
+    id: string;
+}
 /** Everything the broker can send. Live `AgentSessionEvent`s are relayed
  *  verbatim (the broker adds nothing); the broker's own control frames carry
  *  non-colliding `type` discriminants. */
-export type BrokerToClient = WelcomeFrame | ControlChangedFrame | ModelChangedFrame | ErrorFrame | AckFrame | BrokerDataFrame | DisplayStatusFrame | DisplayWidgetFrame | DisplayTitleFrame | BashStartFrame | BashOutputFrame | BashEndFrame | ExtensionUIRequestFrame | AgentSessionEvent;
+export type BrokerToClient = WelcomeFrame | ControlChangedFrame | ModelChangedFrame | ErrorFrame | AckFrame | BrokerDataFrame | DisplayStatusFrame | DisplayWidgetFrame | DisplayTitleFrame | BashStartFrame | BashOutputFrame | BashEndFrame | ExtensionUIRequestFrame | ExtensionUIDismissFrame | AgentSessionEvent;
 /** Encode one frame as a single newline-terminated JSON line. */
 export declare function encodeFrame(frame: ClientToBroker | BrokerToClient): string;
 /** Byte bounds for a {@link FrameDecoder} (C5). */