@xelauvas/xela-cli 0.1.0

package/src/utils/exportRenderer.tsx

@@ -0,0 +1,98 @@
+import React, { useRef } from 'react';
+import stripAnsi from 'strip-ansi';
+import { Messages } from '../components/Messages.js';
+import { KeybindingProvider } from '../keybindings/KeybindingContext.js';
+import { loadKeybindingsSyncWithWarnings } from '../keybindings/loadUserBindings.js';
+import type { KeybindingContextName } from '../keybindings/types.js';
+import { AppStateProvider } from '../state/AppState.js';
+import type { Tools } from '../Tool.js';
+import type { Message } from '../types/message.js';
+import { renderToAnsiString } from './staticRender.js';
+
+/**
+ * Minimal keybinding provider for static/headless renders.
+ * Provides keybinding context without the ChordInterceptor (which uses useInput
+ * and would hang in headless renders with no stdin).
+ */
+function StaticKeybindingProvider({
+  children
+}: {
+  children: React.ReactNode;
+}): React.ReactNode {
+  const {
+    bindings
+  } = loadKeybindingsSyncWithWarnings();
+  const pendingChordRef = useRef(null);
+  const handlerRegistryRef = useRef(new Map());
+  const activeContexts = useRef(new Set<KeybindingContextName>()).current;
+  return <KeybindingProvider bindings={bindings} pendingChordRef={pendingChordRef} pendingChord={null} setPendingChord={() => {}} activeContexts={activeContexts} registerActiveContext={() => {}} unregisterActiveContext={() => {}} handlerRegistryRef={handlerRegistryRef}>
+      {children}
+    </KeybindingProvider>;
+}
+
+// Upper-bound how many NormalizedMessages a Message can produce.
+// normalizeMessages splits one Message with N content blocks into N
+// NormalizedMessages — 1:1 with block count. String content = 1 block.
+// AttachmentMessage etc. have no .message and normalize to ≤1.
+function normalizedUpperBound(m: Message): number {
+  if (!('message' in m)) return 1;
+  const c = m.message.content;
+  return Array.isArray(c) ? c.length : 1;
+}
+
+/**
+ * Streams rendered messages in chunks, ANSI codes preserved. Each chunk is a
+ * fresh renderToAnsiString — yoga layout tree + Ink's screen buffer are sized
+ * to the tallest CHUNK instead of the full session. Measured (Mar 2026,
+ * 538-msg session): −55% plateau RSS vs a single full render. The sink owns
+ * the output — write to stdout for `[` dump-to-scrollback, appendFile for `v`.
+ *
+ * Messages.renderRange slices AFTER normalize→group→collapse, so tool-call
+ * grouping stays correct across chunk seams; buildMessageLookups runs on
+ * the full normalized array so tool_use↔tool_result resolves regardless of
+ * which chunk each landed in.
+ */
+export async function streamRenderedMessages(messages: Message[], tools: Tools, sink: (ansiChunk: string) => void | Promise<void>, {
+  columns,
+  verbose = false,
+  chunkSize = 40,
+  onProgress
+}: {
+  columns?: number;
+  verbose?: boolean;
+  chunkSize?: number;
+  onProgress?: (rendered: number) => void;
+} = {}): Promise<void> {
+  const renderChunk = (range: readonly [number, number]) => renderToAnsiString(<AppStateProvider>
+        <StaticKeybindingProvider>
+          <Messages messages={messages} tools={tools} commands={[]} verbose={verbose} toolJSX={null} toolUseConfirmQueue={[]} inProgressToolUseIDs={new Set()} isMessageSelectorVisible={false} conversationId="export" screen="prompt" streamingToolUses={[]} showAllInTranscript={true} isLoading={false} renderRange={range} />
+        </StaticKeybindingProvider>
+      </AppStateProvider>, columns);
+
+  // renderRange indexes into the post-collapse array whose length we can't
+  // see from here — normalize splits each Message into one NormalizedMessage
+  // per content block (unbounded per message), collapse merges some back.
+  // Ceiling is the exact normalize output count + chunkSize so the loop
+  // always reaches the empty slice where break fires (collapse only shrinks).
+  let ceiling = chunkSize;
+  for (const m of messages) ceiling += normalizedUpperBound(m);
+  for (let offset = 0; offset < ceiling; offset += chunkSize) {
+    const ansi = await renderChunk([offset, offset + chunkSize]);
+    if (stripAnsi(ansi).trim() === '') break;
+    await sink(ansi);
+    onProgress?.(offset + chunkSize);
+  }
+}
+
+/**
+ * Renders messages to a plain text string suitable for export.
+ * Uses the same React rendering logic as the interactive UI.
+ */
+export async function renderMessagesToPlainText(messages: Message[], tools: Tools = [], columns?: number): Promise<string> {
+  const parts: string[] = [];
+  await streamRenderedMessages(messages, tools, chunk => void parts.push(stripAnsi(chunk)), {
+    columns
+  });
+  return parts.join('');
+}
+//# sourceMappingURL=data:application/json;charset=utf-8;base64,eyJ2ZXJzaW9uIjozLCJuYW1lcyI6WyJSZWFjdCIsInVzZVJlZiIsInN0cmlwQW5zaSIsIk1lc3NhZ2VzIiwiS2V5YmluZGluZ1Byb3ZpZGVyIiwibG9hZEtleWJpbmRpbmdzU3luY1dpdGhXYXJuaW5ncyIsIktleWJpbmRpbmdDb250ZXh0TmFtZSIsIkFwcFN0YXRlUHJvdmlkZXIiLCJUb29scyIsIk1lc3NhZ2UiLCJyZW5kZXJUb0Fuc2lTdHJpbmciLCJTdGF0aWNLZXliaW5kaW5nUHJvdmlkZXIiLCJjaGlsZHJlbiIsIlJlYWN0Tm9kZSIsImJpbmRpbmdzIiwicGVuZGluZ0Nob3JkUmVmIiwiaGFuZGxlclJlZ2lzdHJ5UmVmIiwiTWFwIiwiYWN0aXZlQ29udGV4dHMiLCJTZXQiLCJjdXJyZW50Iiwibm9ybWFsaXplZFVwcGVyQm91bmQiLCJtIiwiYyIsIm1lc3NhZ2UiLCJjb250ZW50IiwiQXJyYXkiLCJpc0FycmF5IiwibGVuZ3RoIiwic3RyZWFtUmVuZGVyZWRNZXNzYWdlcyIsIm1lc3NhZ2VzIiwidG9vbHMiLCJzaW5rIiwiYW5zaUNodW5rIiwiUHJvbWlzZSIsImNvbHVtbnMiLCJ2ZXJib3NlIiwiY2h1bmtTaXplIiwib25Qcm9ncmVzcyIsInJlbmRlcmVkIiwicmVuZGVyQ2h1bmsiLCJyYW5nZSIsImNlaWxpbmciLCJvZmZzZXQiLCJhbnNpIiwidHJpbSIsInJlbmRlck1lc3NhZ2VzVG9QbGFpblRleHQiLCJwYXJ0cyIsImNodW5rIiwicHVzaCIsImpvaW4iXSwic291cmNlcyI6WyJleHBvcnRSZW5kZXJlci50c3giXSwic291cmNlc0NvbnRlbnQiOlsiaW1wb3J0IFJlYWN0LCB7IHVzZVJlZiB9IGZyb20gJ3JlYWN0J1xuaW1wb3J0IHN0cmlwQW5zaSBmcm9tICdzdHJpcC1hbnNpJ1xuaW1wb3J0IHsgTWVzc2FnZXMgfSBmcm9tICcuLi9jb21wb25lbnRzL01lc3NhZ2VzLmpzJ1xuaW1wb3J0IHsgS2V5YmluZGluZ1Byb3ZpZGVyIH0gZnJvbSAnLi4va2V5YmluZGluZ3MvS2V5YmluZGluZ0NvbnRleHQuanMnXG5pbXBvcnQgeyBsb2FkS2V5YmluZGluZ3NTeW5jV2l0aFdhcm5pbmdzIH0gZnJvbSAnLi4va2V5YmluZGluZ3MvbG9hZFVzZXJCaW5kaW5ncy5qcydcbmltcG9ydCB0eXBlIHsgS2V5YmluZGluZ0NvbnRleHROYW1lIH0gZnJvbSAnLi4va2V5YmluZGluZ3MvdHlwZXMuanMnXG5pbXBvcnQgeyBBcHBTdGF0ZVByb3ZpZGVyIH0gZnJvbSAnLi4vc3RhdGUvQXBwU3RhdGUuanMnXG5pbXBvcnQgdHlwZSB7IFRvb2xzIH0gZnJvbSAnLi4vVG9vbC5qcydcbmltcG9ydCB0eXBlIHsgTWVzc2FnZSB9IGZyb20gJy4uL3R5cGVzL21lc3NhZ2UuanMnXG5pbXBvcnQgeyByZW5kZXJUb0Fuc2lTdHJpbmcgfSBmcm9tICcuL3N0YXRpY1JlbmRlci5qcydcblxuLyoqXG4gKiBNaW5pbWFsIGtleWJpbmRpbmcgcHJvdmlkZXIgZm9yIHN0YXRpYy9oZWFkbGVzcyByZW5kZXJzLlxuICogUHJvdmlkZXMga2V5YmluZGluZyBjb250ZXh0IHdpdGhvdXQgdGhlIENob3JkSW50ZXJjZXB0b3IgKHdoaWNoIHVzZXMgdXNlSW5wdXRcbiAqIGFuZCB3b3VsZCBoYW5nIGluIGhlYWRsZXNzIHJlbmRlcnMgd2l0aCBubyBzdGRpbikuXG4gKi9cbmZ1bmN0aW9uIFN0YXRpY0tleWJpbmRpbmdQcm92aWRlcih7XG4gIGNoaWxkcmVuLFxufToge1xuICBjaGlsZHJlbjogUmVhY3QuUmVhY3ROb2RlXG59KTogUmVhY3QuUmVhY3ROb2RlIHtcbiAgY29uc3QgeyBiaW5kaW5ncyB9ID0gbG9hZEtleWJpbmRpbmdzU3luY1dpdGhXYXJuaW5ncygpXG4gIGNvbnN0IHBlbmRpbmdDaG9yZFJlZiA9IHVzZVJlZihudWxsKVxuICBjb25zdCBoYW5kbGVyUmVnaXN0cnlSZWYgPSB1c2VSZWYobmV3IE1hcCgpKVxuICBjb25zdCBhY3RpdmVDb250ZXh0cyA9IHVzZVJlZihuZXcgU2V0PEtleWJpbmRpbmdDb250ZXh0TmFtZT4oKSkuY3VycmVudFxuXG4gIHJldHVybiAoXG4gICAgPEtleWJpbmRpbmdQcm92aWRlclxuICAgICAgYmluZGluZ3M9e2JpbmRpbmdzfVxuICAgICAgcGVuZGluZ0Nob3JkUmVmPXtwZW5kaW5nQ2hvcmRSZWZ9XG4gICAgICBwZW5kaW5nQ2hvcmQ9e251bGx9XG4gICAgICBzZXRQZW5kaW5nQ2hvcmQ9eygpID0+IHt9fVxuICAgICAgYWN0aXZlQ29udGV4dHM9e2FjdGl2ZUNvbnRleHRzfVxuICAgICAgcmVnaXN0ZXJBY3RpdmVDb250ZXh0PXsoKSA9PiB7fX1cbiAgICAgIHVucmVnaXN0ZXJBY3RpdmVDb250ZXh0PXsoKSA9PiB7fX1cbiAgICAgIGhhbmRsZXJSZWdpc3RyeVJlZj17aGFuZGxlclJlZ2lzdHJ5UmVmfVxuICAgID5cbiAgICAgIHtjaGlsZHJlbn1cbiAgICA8L0tleWJpbmRpbmdQcm92aWRlcj5cbiAgKVxufVxuXG4vLyBVcHBlci1ib3VuZCBob3cgbWFueSBOb3JtYWxpemVkTWVzc2FnZXMgYSBNZXNzYWdlIGNhbiBwcm9kdWNlLlxuLy8gbm9ybWFsaXplTWVzc2FnZXMgc3BsaXRzIG9uZSBNZXNzYWdlIHdpdGggTiBjb250ZW50IGJsb2NrcyBpbnRvIE5cbi8vIE5vcm1hbGl6ZWRNZXNzYWdlcyDigJQgMToxIHdpdGggYmxvY2sgY291bnQuIFN0cmluZyBjb250ZW50ID0gMSBibG9jay5cbi8vIEF0dGFjaG1lbnRNZXNzYWdlIGV0Yy4gaGF2ZSBubyAubWVzc2FnZSBhbmQgbm9ybWFsaXplIHRvIOKJpDEuXG5mdW5jdGlvbiBub3JtYWxpemVkVXBwZXJCb3VuZChtOiBNZXNzYWdlKTogbnVtYmVyIHtcbiAgaWYgKCEoJ21lc3NhZ2UnIGluIG0pKSByZXR1cm4gMVxuICBjb25zdCBjID0gbS5tZXNzYWdlLmNvbnRlbnRcbiAgcmV0dXJuIEFycmF5LmlzQXJyYXkoYykgPyBjLmxlbmd0aCA6IDFcbn1cblxuLyoqXG4gKiBTdHJlYW1zIHJlbmRlcmVkIG1lc3NhZ2VzIGluIGNodW5rcywgQU5TSSBjb2RlcyBwcmVzZXJ2ZWQuIEVhY2ggY2h1bmsgaXMgYVxuICogZnJlc2ggcmVuZGVyVG9BbnNpU3RyaW5nIOKAlCB5b2dhIGxheW91dCB0cmVlICsgSW5rJ3Mgc2NyZWVuIGJ1ZmZlciBhcmUgc2l6ZWRcbiAqIHRvIHRoZSB0YWxsZXN0IENIVU5LIGluc3RlYWQgb2YgdGhlIGZ1bGwgc2Vzc2lvbi4gTWVhc3VyZWQgKE1hciAyMDI2LFxuICogNTM4LW1zZyBzZXNzaW9uKTog4oiSNTUlIHBsYXRlYXUgUlNTIHZzIGEgc2luZ2xlIGZ1bGwgcmVuZGVyLiBUaGUgc2luayBvd25zXG4gKiB0aGUgb3V0cHV0IOKAlCB3cml0ZSB0byBzdGRvdXQgZm9yIGBbYCBkdW1wLXRvLXNjcm9sbGJhY2ssIGFwcGVuZEZpbGUgZm9yIGB2YC5cbiAqXG4gKiBNZXNzYWdlcy5yZW5kZXJSYW5nZSBzbGljZXMgQUZURVIgbm9ybWFsaXpl4oaSZ3JvdXDihpJjb2xsYXBzZSwgc28gdG9vbC1jYWxsXG4gKiBncm91cGluZyBzdGF5cyBjb3JyZWN0IGFjcm9zcyBjaHVuayBzZWFtczsgYnVpbGRNZXNzYWdlTG9va3VwcyBydW5zIG9uXG4gKiB0aGUgZnVsbCBub3JtYWxpemVkIGFycmF5IHNvIHRvb2xfdXNl4oaUdG9vbF9yZXN1bHQgcmVzb2x2ZXMgcmVnYXJkbGVzcyBvZlxuICogd2hpY2ggY2h1bmsgZWFjaCBsYW5kZWQgaW4uXG4gKi9cbmV4cG9ydCBhc3luYyBmdW5jdGlvbiBzdHJlYW1SZW5kZXJlZE1lc3NhZ2VzKFxuICBtZXNzYWdlczogTWVzc2FnZVtdLFxuICB0b29sczogVG9vbHMsXG4gIHNpbms6IChhbnNpQ2h1bms6IHN0cmluZykgPT4gdm9pZCB8IFByb21pc2U8dm9pZD4sXG4gIHtcbiAgICBjb2x1bW5zLFxuICAgIHZlcmJvc2UgPSBmYWxzZSxcbiAgICBjaHVua1NpemUgPSA0MCxcbiAgICBvblByb2dyZXNzLFxuICB9OiB7XG4gICAgY29sdW1ucz86IG51bWJlclxuICAgIHZlcmJvc2U/OiBib29sZWFuXG4gICAgY2h1bmtTaXplPzogbnVtYmVyXG4gICAgb25Qcm9ncmVzcz86IChyZW5kZXJlZDogbnVtYmVyKSA9PiB2b2lkXG4gIH0gPSB7fSxcbik6IFByb21pc2U8dm9pZD4ge1xuICBjb25zdCByZW5kZXJDaHVuayA9IChyYW5nZTogcmVhZG9ubHkgW251bWJlciwgbnVtYmVyXSkgPT5cbiAgICByZW5kZXJUb0Fuc2lTdHJpbmcoXG4gICAgICA8QXBwU3RhdGVQcm92aWRlcj5cbiAgICAgICAgPFN0YXRpY0tleWJpbmRpbmdQcm92aWRlcj5cbiAgICAgICAgICA8TWVzc2FnZXNcbiAgICAgICAgICAgIG1lc3NhZ2VzPXttZXNzYWdlc31cbiAgICAgICAgICAgIHRvb2xzPXt0b29sc31cbiAgICAgICAgICAgIGNvbW1hbmRzPXtbXX1cbiAgICAgICAgICAgIHZlcmJvc2U9e3ZlcmJvc2V9XG4gICAgICAgICAgICB0b29sSlNYPXtudWxsfVxuICAgICAgICAgICAgdG9vbFVzZUNvbmZpcm1RdWV1ZT17W119XG4gICAgICAgICAgICBpblByb2dyZXNzVG9vbFVzZUlEcz17bmV3IFNldCgpfVxuICAgICAgICAgICAgaXNNZXNzYWdlU2VsZWN0b3JWaXNpYmxlPXtmYWxzZX1cbiAgICAgICAgICAgIGNvbnZlcnNhdGlvbklkPVwiZXhwb3J0XCJcbiAgICAgICAgICAgIHNjcmVlbj1cInByb21wdFwiXG4gICAgICAgICAgICBzdHJlYW1pbmdUb29sVXNlcz17W119XG4gICAgICAgICAgICBzaG93QWxsSW5UcmFuc2NyaXB0PXt0cnVlfVxuICAgICAgICAgICAgaXNMb2FkaW5nPXtmYWxzZX1cbiAgICAgICAgICAgIHJlbmRlclJhbmdlPXtyYW5nZX1cbiAgICAgICAgICAvPlxuICAgICAgICA8L1N0YXRpY0tleWJpbmRpbmdQcm92aWRlcj5cbiAgICAgIDwvQXBwU3RhdGVQcm92aWRlcj4sXG4gICAgICBjb2x1bW5zLFxuICAgIClcblxuICAvLyByZW5kZXJSYW5nZSBpbmRleGVzIGludG8gdGhlIHBvc3QtY29sbGFwc2UgYXJyYXkgd2hvc2UgbGVuZ3RoIHdlIGNhbid0XG4gIC8vIHNlZSBmcm9tIGhlcmUg4oCUIG5vcm1hbGl6ZSBzcGxpdHMgZWFjaCBNZXNzYWdlIGludG8gb25lIE5vcm1hbGl6ZWRNZXNzYWdlXG4gIC8vIHBlciBjb250ZW50IGJsb2NrICh1bmJvdW5kZWQgcGVyIG1lc3NhZ2UpLCBjb2xsYXBzZSBtZXJnZXMgc29tZSBiYWNrLlxuICAvLyBDZWlsaW5nIGlzIHRoZSBleGFjdCBub3JtYWxpemUgb3V0cHV0IGNvdW50ICsgY2h1bmtTaXplIHNvIHRoZSBsb29wXG4gIC8vIGFsd2F5cyByZWFjaGVzIHRoZSBlbXB0eSBzbGljZSB3aGVyZSBicmVhayBmaXJlcyAoY29sbGFwc2Ugb25seSBzaHJpbmtzKS5cbiAgbGV0IGNlaWxpbmcgPSBjaHVua1NpemVcbiAgZm9yIChjb25zdCBtIG9mIG1lc3NhZ2VzKSBjZWlsaW5nICs9IG5vcm1hbGl6ZWRVcHBlckJvdW5kKG0pXG4gIGZvciAobGV0IG9mZnNldCA9IDA7IG9mZnNldCA8IGNlaWxpbmc7IG9mZnNldCArPSBjaHVua1NpemUpIHtcbiAgICBjb25zdCBhbnNpID0gYXdhaXQgcmVuZGVyQ2h1bmsoW29mZnNldCwgb2Zmc2V0ICsgY2h1bmtTaXplXSlcbiAgICBpZiAoc3RyaXBBbnNpKGFuc2kpLnRyaW0oKSA9PT0gJycpIGJyZWFrXG4gICAgYXdhaXQgc2luayhhbnNpKVxuICAgIG9uUHJvZ3Jlc3M/LihvZmZzZXQgKyBjaHVua1NpemUpXG4gIH1cbn1cblxuLyoqXG4gKiBSZW5kZXJzIG1lc3NhZ2VzIHRvIGEgcGxhaW4gdGV4dCBzdHJpbmcgc3VpdGFibGUgZm9yIGV4cG9ydC5cbiAqIFVzZXMgdGhlIHNhbWUgUmVhY3QgcmVuZGVyaW5nIGxvZ2ljIGFzIHRoZSBpbnRlcmFjdGl2ZSBVSS5cbiAqL1xuZXhwb3J0IGFzeW5jIGZ1bmN0aW9uIHJlbmRlck1lc3NhZ2VzVG9QbGFpblRleHQoXG4gIG1lc3NhZ2VzOiBNZXNzYWdlW10sXG4gIHRvb2xzOiBUb29scyA9IFtdLFxuICBjb2x1bW5zPzogbnVtYmVyLFxuKTogUHJvbWlzZTxzdHJpbmc+IHtcbiAgY29uc3QgcGFydHM6IHN0cmluZ1tdID0gW11cbiAgYXdhaXQgc3RyZWFtUmVuZGVyZWRNZXNzYWdlcyhcbiAgICBtZXNzYWdlcyxcbiAgICB0b29scyxcbiAgICBjaHVuayA9PiB2b2lkIHBhcnRzLnB1c2goc3RyaXBBbnNpKGNodW5rKSksXG4gICAgeyBjb2x1bW5zIH0sXG4gIClcbiAgcmV0dXJuIHBhcnRzLmpvaW4oJycpXG59XG4iXSwibWFwcGluZ3MiOiJBQUFBLE9BQU9BLEtBQUssSUFBSUMsTUFBTSxRQUFRLE9BQU87QUFDckMsT0FBT0MsU0FBUyxNQUFNLFlBQVk7QUFDbEMsU0FBU0MsUUFBUSxRQUFRLDJCQUEyQjtBQUNwRCxTQUFTQyxrQkFBa0IsUUFBUSxxQ0FBcUM7QUFDeEUsU0FBU0MsK0JBQStCLFFBQVEsb0NBQW9DO0FBQ3BGLGNBQWNDLHFCQUFxQixRQUFRLHlCQUF5QjtBQUNwRSxTQUFTQyxnQkFBZ0IsUUFBUSxzQkFBc0I7QUFDdkQsY0FBY0MsS0FBSyxRQUFRLFlBQVk7QUFDdkMsY0FBY0MsT0FBTyxRQUFRLHFCQUFxQjtBQUNsRCxTQUFTQyxrQkFBa0IsUUFBUSxtQkFBbUI7O0FBRXREO0FBQ0E7QUFDQTtBQUNBO0FBQ0E7QUFDQSxTQUFTQyx3QkFBd0JBLENBQUM7RUFDaENDO0FBR0YsQ0FGQyxFQUFFO0VBQ0RBLFFBQVEsRUFBRVosS0FBSyxDQUFDYSxTQUFTO0FBQzNCLENBQUMsQ0FBQyxFQUFFYixLQUFLLENBQUNhLFNBQVMsQ0FBQztFQUNsQixNQUFNO0lBQUVDO0VBQVMsQ0FBQyxHQUFHVCwrQkFBK0IsQ0FBQyxDQUFDO0VBQ3RELE1BQU1VLGVBQWUsR0FBR2QsTUFBTSxDQUFDLElBQUksQ0FBQztFQUNwQyxNQUFNZSxrQkFBa0IsR0FBR2YsTUFBTSxDQUFDLElBQUlnQixHQUFHLENBQUMsQ0FBQyxDQUFDO0VBQzVDLE1BQU1DLGNB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

package/src/utils/extraUsage.ts

@@ -0,0 +1,23 @@
+import { isClaudeAISubscriber } from './auth.js'
+import { has1mContext } from './context.js'
+
+export function isBilledAsExtraUsage(
+  model: string | null,
+  isFastMode: boolean,
+  isOpus1mMerged: boolean,
+): boolean {
+  if (!isClaudeAISubscriber()) return false
+  if (isFastMode) return true
+  if (model === null || !has1mContext(model)) return false
+
+  const m = model
+    .toLowerCase()
+    .replace(/\[1m\]$/, '')
+    .trim()
+  const isOpus46 = m === 'opus' || m.includes('opus-4-6')
+  const isSonnet46 = m === 'sonnet' || m.includes('sonnet-4-6')
+
+  if (isOpus46 && isOpus1mMerged) return false
+
+  return isOpus46 || isSonnet46
+}

package/src/utils/fastMode.ts

@@ -0,0 +1,532 @@
+import axios from 'axios'
+import { getOauthConfig, OAUTH_BETA_HEADER } from 'src/constants/oauth.js'
+import { getFeatureValue_CACHED_MAY_BE_STALE } from 'src/services/analytics/growthbook.js'
+import {
+  getIsNonInteractiveSession,
+  getKairosActive,
+  preferThirdPartyAuthentication,
+} from '../bootstrap/state.js'
+import {
+  type AnalyticsMetadata_I_VERIFIED_THIS_IS_NOT_CODE_OR_FILEPATHS,
+  logEvent,
+} from '../services/analytics/index.js'
+import {
+  getAnthropicApiKey,
+  getClaudeAIOAuthTokens,
+  handleOAuth401Error,
+  hasProfileScope,
+} from './auth.js'
+import { isInBundledMode } from './bundledMode.js'
+import { getGlobalConfig, saveGlobalConfig } from './config.js'
+import { logForDebugging } from './debug.js'
+import { isEnvTruthy } from './envUtils.js'
+import {
+  getDefaultMainLoopModelSetting,
+  isOpus1mMergeEnabled,
+  type ModelSetting,
+  parseUserSpecifiedModel,
+} from './model/model.js'
+import { getAPIProvider } from './model/providers.js'
+import { isEssentialTrafficOnly } from './privacyLevel.js'
+import {
+  getInitialSettings,
+  getSettingsForSource,
+  updateSettingsForSource,
+} from './settings/settings.js'
+import { createSignal } from './signal.js'
+
+export function isFastModeEnabled(): boolean {
+  return !isEnvTruthy(process.env.CLAUDE_CODE_DISABLE_FAST_MODE)
+}
+
+export function isFastModeAvailable(): boolean {
+  if (!isFastModeEnabled()) {
+    return false
+  }
+  return getFastModeUnavailableReason() === null
+}
+
+type AuthType = 'oauth' | 'api-key'
+
+function getDisabledReasonMessage(
+  disabledReason: FastModeDisabledReason,
+  authType: AuthType,
+): string {
+  switch (disabledReason) {
+    case 'free':
+      return authType === 'oauth'
+        ? 'Fast mode requires a paid subscription'
+        : 'Fast mode unavailable during evaluation. Please purchase credits.'
+    case 'preference':
+      return 'Fast mode has been disabled by your organization'
+    case 'extra_usage_disabled':
+      // Only OAuth users can have extra_usage_disabled; console users don't have this concept
+      return 'Fast mode requires extra usage billing · /extra-usage to enable'
+    case 'network_error':
+      return 'Fast mode unavailable due to network connectivity issues'
+    case 'unknown':
+      return 'Fast mode is currently unavailable'
+  }
+}
+
+export function getFastModeUnavailableReason(): string | null {
+  if (!isFastModeEnabled()) {
+    return 'Fast mode is not available'
+  }
+
+  const statigReason = getFeatureValue_CACHED_MAY_BE_STALE(
+    'tengu_penguins_off',
+    null,
+  )
+  // Statsig reason has priority over other reasons.
+  if (statigReason !== null) {
+    logForDebugging(`Fast mode unavailable: ${statigReason}`)
+    return statigReason
+  }
+
+  // Previously, fast mode required the native binary (bun build). This is no
+  // longer necessary, but we keep this option behind a flag just in case.
+  if (
+    !isInBundledMode() &&
+    getFeatureValue_CACHED_MAY_BE_STALE('tengu_marble_sandcastle', false)
+  ) {
+    return 'Fast mode requires the native binary · Install from: https://claude.com/product/claude-code'
+  }
+
+  // Not available in the SDK unless explicitly opted in via --settings.
+  // Assistant daemon mode is exempt — it's first-party orchestration, and
+  // kairosActive is set before this check runs (main.tsx:~1626 vs ~3249).
+  if (
+    getIsNonInteractiveSession() &&
+    preferThirdPartyAuthentication() &&
+    !getKairosActive()
+  ) {
+    const flagFastMode = getSettingsForSource('flagSettings')?.fastMode
+    if (!flagFastMode) {
+      const reason = 'Fast mode is not available in the Agent SDK'
+      logForDebugging(`Fast mode unavailable: ${reason}`)
+      return reason
+    }
+  }
+
+  // Only available for 1P (not Bedrock/Vertex/Foundry)
+  if (getAPIProvider() !== 'firstParty') {
+    const reason = 'Fast mode is not available on Bedrock, Vertex, or Foundry'
+    logForDebugging(`Fast mode unavailable: ${reason}`)
+    return reason
+  }
+
+  if (orgStatus.status === 'disabled') {
+    if (
+      orgStatus.reason === 'network_error' ||
+      orgStatus.reason === 'unknown'
+    ) {
+      // The org check can fail behind corporate proxies that block the
+      // endpoint. We add CLAUDE_CODE_SKIP_FAST_MODE_NETWORK_ERRORS=1 to
+      // bypass this check in the CC binary. This is OK since we have
+      // another check in the API to error out when disabled by org.
+      if (isEnvTruthy(process.env.CLAUDE_CODE_SKIP_FAST_MODE_NETWORK_ERRORS)) {
+        return null
+      }
+    }
+    const authType: AuthType =
+      getClaudeAIOAuthTokens() !== null ? 'oauth' : 'api-key'
+    const reason = getDisabledReasonMessage(orgStatus.reason, authType)
+    logForDebugging(`Fast mode unavailable: ${reason}`)
+    return reason
+  }
+
+  return null
+}
+
+// @[MODEL LAUNCH]: Update supported Fast Mode models.
+export const FAST_MODE_MODEL_DISPLAY = 'Opus 4.6'
+
+export function getFastModeModel(): string {
+  return 'opus' + (isOpus1mMergeEnabled() ? '[1m]' : '')
+}
+
+export function getInitialFastModeSetting(model: ModelSetting): boolean {
+  if (!isFastModeEnabled()) {
+    return false
+  }
+  if (!isFastModeAvailable()) {
+    return false
+  }
+  if (!isFastModeSupportedByModel(model)) {
+    return false
+  }
+  const settings = getInitialSettings()
+  // If per-session opt-in is required, fast mode starts off each session
+  if (settings.fastModePerSessionOptIn) {
+    return false
+  }
+  return settings.fastMode === true
+}
+
+export function isFastModeSupportedByModel(
+  modelSetting: ModelSetting,
+): boolean {
+  if (!isFastModeEnabled()) {
+    return false
+  }
+  const model = modelSetting ?? getDefaultMainLoopModelSetting()
+  const parsedModel = parseUserSpecifiedModel(model)
+  return parsedModel.toLowerCase().includes('opus-4-6')
+}
+
+// --- Fast mode runtime state ---
+// Separate from user preference (settings.fastMode). This tracks the actual
+// operational state: whether we're actively sending fast speed or in cooldown
+// after a rate limit.
+
+export type FastModeRuntimeState =
+  | { status: 'active' }
+  | { status: 'cooldown'; resetAt: number; reason: CooldownReason }
+
+let runtimeState: FastModeRuntimeState = { status: 'active' }
+let hasLoggedCooldownExpiry = false
+
+// --- Cooldown event listeners ---
+export type CooldownReason = 'rate_limit' | 'overloaded'
+
+const cooldownTriggered =
+  createSignal<[resetAt: number, reason: CooldownReason]>()
+const cooldownExpired = createSignal()
+export const onCooldownTriggered = cooldownTriggered.subscribe
+export const onCooldownExpired = cooldownExpired.subscribe
+
+export function getFastModeRuntimeState(): FastModeRuntimeState {
+  if (
+    runtimeState.status === 'cooldown' &&
+    Date.now() >= runtimeState.resetAt
+  ) {
+    if (isFastModeEnabled() && !hasLoggedCooldownExpiry) {
+      logForDebugging('Fast mode cooldown expired, re-enabling fast mode')
+      hasLoggedCooldownExpiry = true
+      cooldownExpired.emit()
+    }
+    runtimeState = { status: 'active' }
+  }
+  return runtimeState
+}
+
+export function triggerFastModeCooldown(
+  resetTimestamp: number,
+  reason: CooldownReason,
+): void {
+  if (!isFastModeEnabled()) {
+    return
+  }
+  runtimeState = { status: 'cooldown', resetAt: resetTimestamp, reason }
+  hasLoggedCooldownExpiry = false
+  const cooldownDurationMs = resetTimestamp - Date.now()
+  logForDebugging(
+    `Fast mode cooldown triggered (${reason}), duration ${Math.round(cooldownDurationMs / 1000)}s`,
+  )
+  logEvent('tengu_fast_mode_fallback_triggered', {
+    cooldown_duration_ms: cooldownDurationMs,
+    cooldown_reason:
+      reason as AnalyticsMetadata_I_VERIFIED_THIS_IS_NOT_CODE_OR_FILEPATHS,
+  })
+  cooldownTriggered.emit(resetTimestamp, reason)
+}
+
+export function clearFastModeCooldown(): void {
+  runtimeState = { status: 'active' }
+}
+
+/**
+ * Called when the API rejects a fast mode request (e.g., 400 "Fast mode is
+ * not enabled for your organization"). Permanently disables fast mode using
+ * the same flow as when the prefetch discovers the org has it disabled.
+ */
+export function handleFastModeRejectedByAPI(): void {
+  if (orgStatus.status === 'disabled') {
+    return
+  }
+  orgStatus = { status: 'disabled', reason: 'preference' }
+  updateSettingsForSource('userSettings', { fastMode: undefined })
+  saveGlobalConfig(current => ({
+    ...current,
+    penguinModeOrgEnabled: false,
+  }))
+  orgFastModeChange.emit(false)
+}
+
+// --- Overage rejection listeners ---
+// Fired when a 429 indicates fast mode was rejected because extra usage
+// (overage billing) is not available. Distinct from org-level disabling.
+const overageRejection = createSignal<[message: string]>()
+export const onFastModeOverageRejection = overageRejection.subscribe
+
+function getOverageDisabledMessage(reason: string | null): string {
+  switch (reason) {
+    case 'out_of_credits':
+      return 'Fast mode disabled · extra usage credits exhausted'
+    case 'org_level_disabled':
+    case 'org_service_level_disabled':
+      return 'Fast mode disabled · extra usage disabled by your organization'
+    case 'org_level_disabled_until':
+      return 'Fast mode disabled · extra usage spending cap reached'
+    case 'member_level_disabled':
+      return 'Fast mode disabled · extra usage disabled for your account'
+    case 'seat_tier_level_disabled':
+    case 'seat_tier_zero_credit_limit':
+    case 'member_zero_credit_limit':
+      return 'Fast mode disabled · extra usage not available for your plan'
+    case 'overage_not_provisioned':
+    case 'no_limits_configured':
+      return 'Fast mode requires extra usage billing · /extra-usage to enable'
+    default:
+      return 'Fast mode disabled · extra usage not available'
+  }
+}
+
+function isOutOfCreditsReason(reason: string | null): boolean {
+  return reason === 'org_level_disabled_until' || reason === 'out_of_credits'
+}
+
+/**
+ * Called when a 429 indicates fast mode was rejected because extra usage
+ * is not available. Permanently disables fast mode (unless the user has
+ * ran out of credits) and notifies with a reason-specific message.
+ */
+export function handleFastModeOverageRejection(reason: string | null): void {
+  const message = getOverageDisabledMessage(reason)
+  logForDebugging(
+    `Fast mode overage rejection: ${reason ?? 'unknown'} — ${message}`,
+  )
+  logEvent('tengu_fast_mode_overage_rejected', {
+    overage_disabled_reason: (reason ??
+      'unknown') as AnalyticsMetadata_I_VERIFIED_THIS_IS_NOT_CODE_OR_FILEPATHS,
+  })
+  // Disable fast mode permanently unless the user has ran out of credits
+  if (!isOutOfCreditsReason(reason)) {
+    updateSettingsForSource('userSettings', { fastMode: undefined })
+    saveGlobalConfig(current => ({
+      ...current,
+      penguinModeOrgEnabled: false,
+    }))
+  }
+  overageRejection.emit(message)
+}
+
+export function isFastModeCooldown(): boolean {
+  return getFastModeRuntimeState().status === 'cooldown'
+}
+
+export function getFastModeState(
+  model: ModelSetting,
+  fastModeUserEnabled: boolean | undefined,
+): 'off' | 'cooldown' | 'on' {
+  const enabled =
+    isFastModeEnabled() &&
+    isFastModeAvailable() &&
+    !!fastModeUserEnabled &&
+    isFastModeSupportedByModel(model)
+  if (enabled && isFastModeCooldown()) {
+    return 'cooldown'
+  }
+  if (enabled) {
+    return 'on'
+  }
+  return 'off'
+}
+
+// Disabled reason returned by the API. The API is the canonical source for why
+// fast mode is disabled (free account, admin preference, extra usage not enabled).
+export type FastModeDisabledReason =
+  | 'free'
+  | 'preference'
+  | 'extra_usage_disabled'
+  | 'network_error'
+  | 'unknown'
+
+// In-memory cache of the fast mode status from the API.
+// Distinct from the user's fastMode app state — this represents
+// whether the org *allows* fast mode and why it may be disabled.
+// Modeled as a discriminated union so the invalid state
+// (disabled without a reason) is unrepresentable.
+type FastModeOrgStatus =
+  | { status: 'pending' }
+  | { status: 'enabled' }
+  | { status: 'disabled'; reason: FastModeDisabledReason }
+
+let orgStatus: FastModeOrgStatus = { status: 'pending' }
+
+// Listeners notified when org-level fast mode status changes
+const orgFastModeChange = createSignal<[orgEnabled: boolean]>()
+export const onOrgFastModeChanged = orgFastModeChange.subscribe
+
+type FastModeResponse = {
+  enabled: boolean
+  disabled_reason: FastModeDisabledReason | null
+}
+
+async function fetchFastModeStatus(
+  auth: { accessToken: string } | { apiKey: string },
+): Promise<FastModeResponse> {
+  const endpoint = `${getOauthConfig().BASE_API_URL}/api/claude_code_penguin_mode`
+  const headers: Record<string, string> =
+    'accessToken' in auth
+      ? {
+          Authorization: `Bearer ${auth.accessToken}`,
+          'anthropic-beta': OAUTH_BETA_HEADER,
+        }
+      : { 'x-api-key': auth.apiKey }
+
+  const response = await axios.get<FastModeResponse>(endpoint, { headers })
+  return response.data
+}
+
+const PREFETCH_MIN_INTERVAL_MS = 30_000
+let lastPrefetchAt = 0
+let inflightPrefetch: Promise<void> | null = null
+
+/**
+ * Resolve orgStatus from the persisted cache without making any API calls.
+ * Used when startup prefetches are throttled to avoid hitting the network
+ * while still making fast mode availability checks work.
+ */
+export function resolveFastModeStatusFromCache(): void {
+  if (!isFastModeEnabled()) {
+    return
+  }
+  if (orgStatus.status !== 'pending') {
+    return
+  }
+  const isAnt = process.env.USER_TYPE === 'ant'
+  const cachedEnabled = getGlobalConfig().penguinModeOrgEnabled === true
+  orgStatus =
+    isAnt || cachedEnabled
+      ? { status: 'enabled' }
+      : { status: 'disabled', reason: 'unknown' }
+}
+
+export async function prefetchFastModeStatus(): Promise<void> {
+  // Skip network requests if nonessential traffic is disabled
+  if (isEssentialTrafficOnly()) {
+    return
+  }
+
+  if (!isFastModeEnabled()) {
+    return
+  }
+
+  if (inflightPrefetch) {
+    logForDebugging(
+      'Fast mode prefetch in progress, returning in-flight promise',
+    )
+    return inflightPrefetch
+  }
+
+  // Service key OAuth sessions lack user:profile scope → endpoint 403s.
+  // Resolve orgStatus from cache and bail before burning the throttle window.
+  // API key auth is unaffected.
+  const apiKey = getAnthropicApiKey()
+  const hasUsableOAuth =
+    getClaudeAIOAuthTokens()?.accessToken && hasProfileScope()
+  if (!hasUsableOAuth && !apiKey) {
+    const isAnt = process.env.USER_TYPE === 'ant'
+    const cachedEnabled = getGlobalConfig().penguinModeOrgEnabled === true
+    orgStatus =
+      isAnt || cachedEnabled
+        ? { status: 'enabled' }
+        : { status: 'disabled', reason: 'preference' }
+    return
+  }
+
+  const now = Date.now()
+  if (now - lastPrefetchAt < PREFETCH_MIN_INTERVAL_MS) {
+    logForDebugging('Skipping fast mode prefetch, fetched recently')
+    return
+  }
+  lastPrefetchAt = now
+
+  const fetchWithCurrentAuth = async (): Promise<FastModeResponse> => {
+    const currentTokens = getClaudeAIOAuthTokens()
+    const auth =
+      currentTokens?.accessToken && hasProfileScope()
+        ? { accessToken: currentTokens.accessToken }
+        : apiKey
+          ? { apiKey }
+          : null
+    if (!auth) {
+      throw new Error('No auth available')
+    }
+    return fetchFastModeStatus(auth)
+  }
+
+  async function doFetch(): Promise<void> {
+    try {
+      let status: FastModeResponse
+      try {
+        status = await fetchWithCurrentAuth()
+      } catch (err) {
+        const isAuthError =
+          axios.isAxiosError(err) &&
+          (err.response?.status === 401 ||
+            (err.response?.status === 403 &&
+              typeof err.response?.data === 'string' &&
+              err.response.data.includes('OAuth token has been revoked')))
+        if (isAuthError) {
+          const failedAccessToken = getClaudeAIOAuthTokens()?.accessToken
+          if (failedAccessToken) {
+            await handleOAuth401Error(failedAccessToken)
+            status = await fetchWithCurrentAuth()
+          } else {
+            throw err
+          }
+        } else {
+          throw err
+        }
+      }
+
+      const previousEnabled =
+        orgStatus.status !== 'pending'
+          ? orgStatus.status === 'enabled'
+          : getGlobalConfig().penguinModeOrgEnabled
+      orgStatus = status.enabled
+        ? { status: 'enabled' }
+        : {
+            status: 'disabled',
+            reason: status.disabled_reason ?? 'preference',
+          }
+      if (previousEnabled !== status.enabled) {
+        // When org disables fast mode, permanently turn off the user's fast mode setting
+        if (!status.enabled) {
+          updateSettingsForSource('userSettings', { fastMode: undefined })
+        }
+        saveGlobalConfig(current => ({
+          ...current,
+          penguinModeOrgEnabled: status.enabled,
+        }))
+        orgFastModeChange.emit(status.enabled)
+      }
+      logForDebugging(
+        `Org fast mode: ${status.enabled ? 'enabled' : `disabled (${status.disabled_reason ?? 'preference'})`}`,
+      )
+    } catch (err) {
+      // On failure: ants default to enabled (don't block internal users).
+      // External users: fall back to the cached penguinModeOrgEnabled value;
+      // if no positive cache, disable with network_error reason.
+      const isAnt = process.env.USER_TYPE === 'ant'
+      const cachedEnabled = getGlobalConfig().penguinModeOrgEnabled === true
+      orgStatus =
+        isAnt || cachedEnabled
+          ? { status: 'enabled' }
+          : { status: 'disabled', reason: 'network_error' }
+      logForDebugging(
+        `Failed to fetch org fast mode status, defaulting to ${orgStatus.status === 'enabled' ? 'enabled (cached)' : 'disabled (network_error)'}: ${err}`,
+        { level: 'error' },
+      )
+      logEvent('tengu_org_penguin_mode_fetch_failed', {})
+    } finally {
+      inflightPrefetch = null
+    }
+  }
+
+  inflightPrefetch = doFetch()
+  return inflightPrefetch
+}