@qduc/term2 0.30.0 → 0.31.1

package/dist/skins/zen/tools.js

@@ -0,0 +1,81 @@
+import React from 'react';
+import { Box, Text } from 'ink';
+import { TOOL_STATUS_GLYPH, useTheme } from '../../components/theme.js';
+import { BRAILLE_SPINNER, useSpinnerFrame } from '../shared/spinner.js';
+import { MARKER_COLUMNS, useZenStyles } from './style.js';
+/**
+ * Tool calls sit under the answer's text column, indented by the width of the
+ * `◆` marker, so a turn reads as one column of prose with the machinery tucked
+ * into it. The frame wraps header and body together (the container composes
+ * them), so the indent is all it can do; the header decides everything else.
+ */
+export const ZenToolFrame = ({ children }) => (React.createElement(Box, { flexDirection: "column", paddingLeft: MARKER_COLUMNS }, children));
+const isTrouble = (status) => status === 'failed' || status === 'rejected';
+/** The glyph of a call in flight. A component of its own so only this cell re-renders on each tick. */
+const RunningGlyph = () => {
+    const theme = useTheme();
+    const frame = useSpinnerFrame(BRAILLE_SPINNER, true, 120);
+    return React.createElement(Text, { color: theme.warning }, frame);
+};
+const StatusGlyph = ({ status }) => {
+    const theme = useTheme();
+    const { faint } = useZenStyles();
+    if (status === 'running')
+        return React.createElement(RunningGlyph, null);
+    if (isTrouble(status)) {
+        return (React.createElement(Text, { color: theme.toolStatus[status], bold: true }, TOOL_STATUS_GLYPH[status]));
+    }
+    // Settled and waiting calls are furniture: the glyph is there to be scanned, not to be coloured.
+    return React.createElement(Text, { ...faint }, TOOL_STATUS_GLYPH[status]);
+};
+/**
+ * One quiet line. Colour is spent only on trouble: a failed call is red from its
+ * glyph to its last word, everything that went right recedes. A running call is
+ * the one other thing allowed to stand out, with a small spinner in the warning
+ * tone, because it is the one thing still happening.
+ */
+export const ZenToolHeader = ({ status, display, nested, action, meta, trailing, textColor }) => {
+    const theme = useTheme();
+    const { quiet, faint, colourless } = useZenStyles();
+    const inFlight = status === 'running' || status === 'pending';
+    if (nested) {
+        return (React.createElement(Box, null,
+            React.createElement(Text, { wrap: "truncate", ...faint },
+                React.createElement(StatusGlyph, { status: status }),
+                " ",
+                action,
+                meta)));
+    }
+    // Standard display prints the output underneath, so the header is the brighter
+    // of the two; concise display is the whole record, so it recedes.
+    const actionStyle = status === 'failed'
+        ? { color: theme.danger, dimColor: false, bold: colourless }
+        : display === 'standard' || inFlight
+            ? { color: undefined, dimColor: false }
+            : { ...quiet, color: textColor || quiet.color };
+    return (React.createElement(Box, null,
+        React.createElement(Box, { width: MARKER_COLUMNS, flexShrink: 0 },
+            React.createElement(StatusGlyph, { status: status })),
+        React.createElement(Text, { ...actionStyle },
+            action,
+            meta,
+            trailing)));
+};
+/**
+ * One quiet line for a run of calls, and, only when something failed, the failing
+ * calls beneath it, in the danger tone. A partly failed run keeps a calm summary:
+ * most of it worked, and the line below says exactly what did not.
+ */
+export const ZenToolGroupSummary = ({ status, summary, failures }) => {
+    const theme = useTheme();
+    const { quiet, faint, colourless } = useZenStyles();
+    return (React.createElement(Box, { flexDirection: "column", paddingLeft: MARKER_COLUMNS, width: "100%" },
+        React.createElement(Box, null,
+            React.createElement(Box, { width: MARKER_COLUMNS, flexShrink: 0 }, status === 'failed' ? (React.createElement(Text, { color: theme.toolStatus.failed, bold: true }, TOOL_STATUS_GLYPH.failed)) : (React.createElement(Text, { ...faint }, TOOL_STATUS_GLYPH.completed))),
+            React.createElement(Text, { ...quiet }, summary)),
+        failures !== '' && (React.createElement(Box, null,
+            React.createElement(Box, { width: MARKER_COLUMNS, flexShrink: 0 },
+                React.createElement(Text, { color: theme.toolStatus.failed, bold: true }, TOOL_STATUS_GLYPH.failed)),
+            React.createElement(Text, { color: theme.danger, bold: colourless }, failures)))));
+};
+//# sourceMappingURL=tools.js.map

package/dist/skins/zen/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../../source/skins/zen/tools.tsx"],"names":[],"mappings":"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"}

package/dist/skins/zen/width.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Terminal columns a string occupies, for the few places zen has to decide a
+ * layout before Ink does (does the approval fit on one line, how much of the
+ * status line can stay).
+ *
+ * `terminalTextWidth` deliberately counts every non-ASCII code point as two cells,
+ * which would make zen's own glyphs (`›`, `◆`, `·`, `—`, `▲`) cost double and push
+ * it into its narrow layouts far too early. Those are single cells in every
+ * terminal this app targets; only genuinely wide scripts and emoji are doubled.
+ */
+export declare function cells(value: string): number;
+//# sourceMappingURL=width.d.ts.map

package/dist/skins/zen/width.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"width.d.ts","sourceRoot":"","sources":["../../../source/skins/zen/width.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,wBAAgB,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAgB3C"}

package/dist/skins/zen/width.js

@@ -0,0 +1,27 @@
+/**
+ * Terminal columns a string occupies, for the few places zen has to decide a
+ * layout before Ink does (does the approval fit on one line, how much of the
+ * status line can stay).
+ *
+ * `terminalTextWidth` deliberately counts every non-ASCII code point as two cells,
+ * which would make zen's own glyphs (`›`, `◆`, `·`, `—`, `▲`) cost double and push
+ * it into its narrow layouts far too early. Those are single cells in every
+ * terminal this app targets; only genuinely wide scripts and emoji are doubled.
+ */
+export function cells(value) {
+    let width = 0;
+    for (const char of value) {
+        const code = char.codePointAt(0) ?? 0;
+        const wide = (code >= 0x1100 && code <= 0x115f) ||
+            (code >= 0x2e80 && code <= 0xa4cf) ||
+            (code >= 0xac00 && code <= 0xd7a3) ||
+            (code >= 0xf900 && code <= 0xfaff) ||
+            (code >= 0xfe30 && code <= 0xfe6f) ||
+            (code >= 0xff00 && code <= 0xff60) ||
+            (code >= 0xffe0 && code <= 0xffe6) ||
+            (code >= 0x1f300 && code <= 0x1faff);
+        width += wide ? 2 : 1;
+    }
+    return width;
+}
+//# sourceMappingURL=width.js.map

package/dist/skins/zen/width.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"width.js","sourceRoot":"","sources":["../../../source/skins/zen/width.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,MAAM,UAAU,KAAK,CAAC,KAAa;IACjC,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QACtC,MAAM,IAAI,GACR,CAAC,IAAI,IAAI,MAAM,IAAI,IAAI,IAAI,MAAM,CAAC;YAClC,CAAC,IAAI,IAAI,MAAM,IAAI,IAAI,IAAI,MAAM,CAAC;YAClC,CAAC,IAAI,IAAI,MAAM,IAAI,IAAI,IAAI,MAAM,CAAC;YAClC,CAAC,IAAI,IAAI,MAAM,IAAI,IAAI,IAAI,MAAM,CAAC;YAClC,CAAC,IAAI,IAAI,MAAM,IAAI,IAAI,IAAI,MAAM,CAAC;YAClC,CAAC,IAAI,IAAI,MAAM,IAAI,IAAI,IAAI,MAAM,CAAC;YAClC,CAAC,IAAI,IAAI,MAAM,IAAI,IAAI,IAAI,MAAM,CAAC;YAClC,CAAC,IAAI,IAAI,OAAO,IAAI,IAAI,IAAI,OAAO,CAAC,CAAC;QACvC,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACxB,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/theme/ThemeContext.d.ts

@@ -0,0 +1,26 @@
+import { type FC, type ReactNode } from 'react';
+import type { ISettingsService } from '../services/service-interfaces.js';
+import { type ThemeTokens } from './palettes.js';
+import { type BackgroundMode } from './resolve-theme.js';
+export declare const useTheme: () => ThemeTokens;
+export declare const ThemeProvider: FC<{
+    theme: ThemeTokens;
+    children?: ReactNode;
+}>;
+interface SettingsThemeProviderProps {
+    settingsService: ISettingsService;
+    /** Environment used to resolve `auto`; injectable so tests do not depend on the host terminal. */
+    env?: Readonly<Record<string, string | undefined>>;
+    /** What the terminal reported at startup (see `detectTerminalBackground`). */
+    detectedBackground?: BackgroundMode;
+    children?: ReactNode;
+}
+/**
+ * Resolves `ui.theme` against the environment and provides the result. It
+ * subscribes to the setting, so changing it in `/settings` recolours the UI
+ * immediately. Lines already committed to the terminal's scrollback keep the
+ * colours they were printed with — that output is no longer ours to repaint.
+ */
+export declare const SettingsThemeProvider: FC<SettingsThemeProviderProps>;
+export {};
+//# sourceMappingURL=ThemeContext.d.ts.map

package/dist/theme/ThemeContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ThemeContext.d.ts","sourceRoot":"","sources":["../../source/theme/ThemeContext.tsx"],"names":[],"mappings":"AAAA,OAAc,EAA6B,KAAK,EAAE,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAClF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AAE1E,OAAO,EAAyB,KAAK,WAAW,EAAE,MAAM,eAAe,CAAC;AACxE,OAAO,EAAoB,KAAK,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAS3E,eAAO,MAAM,QAAQ,QAAO,WAAuC,CAAC;AAEpE,eAAO,MAAM,aAAa,EAAE,EAAE,CAAC;IAAE,KAAK,EAAE,WAAW,CAAC;IAAC,QAAQ,CAAC,EAAE,SAAS,CAAA;CAAE,CAE1E,CAAC;AAEF,UAAU,0BAA0B;IAClC,eAAe,EAAE,gBAAgB,CAAC;IAClC,kGAAkG;IAClG,GAAG,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC;IACnD,8EAA8E;IAC9E,kBAAkB,CAAC,EAAE,cAAc,CAAC;IACpC,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB;AAED;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,EAAE,EAAE,CAAC,0BAA0B,CAShE,CAAC"}

package/dist/theme/ThemeContext.js

@@ -0,0 +1,24 @@
+import React, { createContext, useContext } from 'react';
+import { useSetting } from '../hooks/use-setting.js';
+import { DEFAULT_THEME, THEMES } from './palettes.js';
+import { resolveThemeName } from './resolve-theme.js';
+/**
+ * The default is the dark palette, not `undefined`: components rendered with no
+ * provider (unit tests, one-off Ink roots) look exactly as they always have, and
+ * `useTheme()` can never return nothing.
+ */
+const ThemeContext = createContext(DEFAULT_THEME);
+export const useTheme = () => useContext(ThemeContext);
+export const ThemeProvider = ({ theme, children }) => (React.createElement(ThemeContext.Provider, { value: theme }, children));
+/**
+ * Resolves `ui.theme` against the environment and provides the result. It
+ * subscribes to the setting, so changing it in `/settings` recolours the UI
+ * immediately. Lines already committed to the terminal's scrollback keep the
+ * colours they were printed with — that output is no longer ours to repaint.
+ */
+export const SettingsThemeProvider = ({ settingsService, env = process.env, detectedBackground, children, }) => {
+    const setting = useSetting(settingsService, 'ui.theme') ?? 'auto';
+    const theme = THEMES[resolveThemeName(setting, { env, detectedBackground })];
+    return React.createElement(ThemeProvider, { theme: theme }, children);
+};
+//# sourceMappingURL=ThemeContext.js.map

package/dist/theme/ThemeContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ThemeContext.js","sourceRoot":"","sources":["../../source/theme/ThemeContext.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,aAAa,EAAE,UAAU,EAA2B,MAAM,OAAO,CAAC;AAElF,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,EAAoB,MAAM,eAAe,CAAC;AACxE,OAAO,EAAE,gBAAgB,EAAuB,MAAM,oBAAoB,CAAC;AAE3E;;;;GAIG;AACH,MAAM,YAAY,GAAG,aAAa,CAAc,aAAa,CAAC,CAAC;AAE/D,MAAM,CAAC,MAAM,QAAQ,GAAG,GAAgB,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC;AAEpE,MAAM,CAAC,MAAM,aAAa,GAAqD,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,CACtG,oBAAC,YAAY,CAAC,QAAQ,IAAC,KAAK,EAAE,KAAK,IAAG,QAAQ,CAAyB,CACxE,CAAC;AAWF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAmC,CAAC,EACpE,eAAe,EACf,GAAG,GAAG,OAAO,CAAC,GAAG,EACjB,kBAAkB,EAClB,QAAQ,GACT,EAAE,EAAE;IACH,MAAM,OAAO,GAAG,UAAU,CAAC,eAAe,EAAE,UAAU,CAAC,IAAI,MAAM,CAAC;IAClE,MAAM,KAAK,GAAG,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,EAAE,GAAG,EAAE,kBAAkB,EAAE,CAAC,CAAC,CAAC;IAC7E,OAAO,oBAAC,aAAa,IAAC,KAAK,EAAE,KAAK,IAAG,QAAQ,CAAiB,CAAC;AACjE,CAAC,CAAC"}

package/dist/theme/detect-terminal-background.d.ts

@@ -0,0 +1,29 @@
+import { type BackgroundMode } from './resolve-theme.js';
+export declare const DEFAULT_DETECTION_TIMEOUT_MS = 150;
+type DetectionStdin = Pick<NodeJS.ReadStream, 'isTTY' | 'isRaw' | 'resume' | 'pause' | 'on' | 'off' | 'readableFlowing'> & {
+    setRawMode?: (mode: boolean) => unknown;
+    setEncoding?: (encoding: BufferEncoding) => unknown;
+};
+type DetectionStdout = Pick<NodeJS.WriteStream, 'isTTY' | 'write'>;
+export interface DetectTerminalBackgroundOptions {
+    stdin: DetectionStdin;
+    stdout: DetectionStdout;
+    timeoutMs?: number;
+}
+/**
+ * Asks the terminal whether its background is light or dark (OSC 11), without
+ * ever hanging or leaking bytes.
+ *
+ * The colour query is followed by a Device Attributes query. Terminals answer
+ * requests in order and every terminal answers DA1, so receiving the DA1 reply
+ * means any colour reply has already arrived. A terminal that ignores OSC 11
+ * therefore costs one round trip rather than the full timeout, and its DA1
+ * reply is consumed here instead of landing in the prompt later. The timeout
+ * is only the backstop for a terminal that is silent or a link that drops it.
+ *
+ * Must run before the Ink app takes over stdin: the replies arrive as input.
+ * Resolves `undefined` whenever the answer is unknown, never throws.
+ */
+export declare function detectTerminalBackground(options: DetectTerminalBackgroundOptions): Promise<BackgroundMode | undefined>;
+export {};
+//# sourceMappingURL=detect-terminal-background.d.ts.map

package/dist/theme/detect-terminal-background.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect-terminal-background.d.ts","sourceRoot":"","sources":["../../source/theme/detect-terminal-background.ts"],"names":[],"mappings":"AAAA,OAAO,EAA6C,KAAK,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAOpG,eAAO,MAAM,4BAA4B,MAAM,CAAC;AAEhD,KAAK,cAAc,GAAG,IAAI,CACxB,MAAM,CAAC,UAAU,EACjB,OAAO,GAAG,OAAO,GAAG,QAAQ,GAAG,OAAO,GAAG,IAAI,GAAG,KAAK,GAAG,iBAAiB,CAC1E,GAAG;IACF,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,OAAO,CAAC;IACxC,WAAW,CAAC,EAAE,CAAC,QAAQ,EAAE,cAAc,KAAK,OAAO,CAAC;CACrD,CAAC;AACF,KAAK,eAAe,GAAG,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC;AAEnE,MAAM,WAAW,+BAA+B;IAC9C,KAAK,EAAE,cAAc,CAAC;IACtB,MAAM,EAAE,eAAe,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,+BAA+B,GACvC,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC,CAoDrC"}

package/dist/theme/detect-terminal-background.js

@@ -0,0 +1,72 @@
+import { backgroundModeFromRgb, parseOsc11Response } from './resolve-theme.js';
+const OSC11_QUERY = '\u001B]11;?\u001B\\';
+/** Primary Device Attributes: every terminal answers it, so it marks "the replies are done". */
+const DA1_QUERY = '\u001B[c';
+const DA1_REPLY = /\u001B\[\?[\d;]*c/;
+export const DEFAULT_DETECTION_TIMEOUT_MS = 150;
+/**
+ * Asks the terminal whether its background is light or dark (OSC 11), without
+ * ever hanging or leaking bytes.
+ *
+ * The colour query is followed by a Device Attributes query. Terminals answer
+ * requests in order and every terminal answers DA1, so receiving the DA1 reply
+ * means any colour reply has already arrived. A terminal that ignores OSC 11
+ * therefore costs one round trip rather than the full timeout, and its DA1
+ * reply is consumed here instead of landing in the prompt later. The timeout
+ * is only the backstop for a terminal that is silent or a link that drops it.
+ *
+ * Must run before the Ink app takes over stdin: the replies arrive as input.
+ * Resolves `undefined` whenever the answer is unknown, never throws.
+ */
+export function detectTerminalBackground(options) {
+    const { stdin, stdout, timeoutMs = DEFAULT_DETECTION_TIMEOUT_MS } = options;
+    if (!stdin.isTTY || !stdout.isTTY || typeof stdin.setRawMode !== 'function') {
+        return Promise.resolve(undefined);
+    }
+    const setRawMode = stdin.setRawMode.bind(stdin);
+    return new Promise((resolve) => {
+        const wasRaw = Boolean(stdin.isRaw);
+        const wasFlowing = stdin.readableFlowing === true;
+        let buffer = '';
+        let mode;
+        let settled = false;
+        const finish = () => {
+            if (settled)
+                return;
+            settled = true;
+            clearTimeout(timer);
+            stdin.off('data', onData);
+            try {
+                setRawMode(wasRaw);
+            }
+            catch {
+                // Terminal went away; nothing to restore.
+            }
+            if (!wasFlowing)
+                stdin.pause();
+            resolve(mode);
+        };
+        const onData = (chunk) => {
+            buffer += typeof chunk === 'string' ? chunk : chunk.toString('utf8');
+            const rgb = parseOsc11Response(buffer);
+            if (rgb) {
+                mode = backgroundModeFromRgb(rgb);
+            }
+            if (DA1_REPLY.test(buffer)) {
+                finish();
+            }
+        };
+        // Armed before the query goes out, so `finish` can always cancel it.
+        const timer = setTimeout(finish, timeoutMs);
+        try {
+            setRawMode(true);
+            stdin.on('data', onData);
+            stdin.resume();
+            stdout.write(OSC11_QUERY + DA1_QUERY);
+        }
+        catch {
+            finish();
+        }
+    });
+}
+//# sourceMappingURL=detect-terminal-background.js.map

package/dist/theme/detect-terminal-background.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect-terminal-background.js","sourceRoot":"","sources":["../../source/theme/detect-terminal-background.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,kBAAkB,EAAuB,MAAM,oBAAoB,CAAC;AAEpG,MAAM,WAAW,GAAG,qBAAqB,CAAC;AAC1C,gGAAgG;AAChG,MAAM,SAAS,GAAG,UAAU,CAAC;AAC7B,MAAM,SAAS,GAAG,mBAAmB,CAAC;AAEtC,MAAM,CAAC,MAAM,4BAA4B,GAAG,GAAG,CAAC;AAiBhD;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,wBAAwB,CACtC,OAAwC;IAExC,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,GAAG,4BAA4B,EAAE,GAAG,OAAO,CAAC;IAE5E,IAAI,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC,MAAM,CAAC,KAAK,IAAI,OAAO,KAAK,CAAC,UAAU,KAAK,UAAU,EAAE,CAAC;QAC5E,OAAO,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IACpC,CAAC;IACD,MAAM,UAAU,GAAG,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAEhD,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACpC,MAAM,UAAU,GAAG,KAAK,CAAC,eAAe,KAAK,IAAI,CAAC;QAClD,IAAI,MAAM,GAAG,EAAE,CAAC;QAChB,IAAI,IAAgC,CAAC;QACrC,IAAI,OAAO,GAAG,KAAK,CAAC;QAEpB,MAAM,MAAM,GAAG,GAAG,EAAE;YAClB,IAAI,OAAO;gBAAE,OAAO;YACpB,OAAO,GAAG,IAAI,CAAC;YACf,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,KAAK,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;YAC1B,IAAI,CAAC;gBACH,UAAU,CAAC,MAAM,CAAC,CAAC;YACrB,CAAC;YAAC,MAAM,CAAC;gBACP,0CAA0C;YAC5C,CAAC;YACD,IAAI,CAAC,UAAU;gBAAE,KAAK,CAAC,KAAK,EAAE,CAAC;YAC/B,OAAO,CAAC,IAAI,CAAC,CAAC;QAChB,CAAC,CAAC;QAEF,MAAM,MAAM,GAAG,CAAC,KAAsB,EAAE,EAAE;YACxC,MAAM,IAAI,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;YACrE,MAAM,GAAG,GAAG,kBAAkB,CAAC,MAAM,CAAC,CAAC;YACvC,IAAI,GAAG,EAAE,CAAC;gBACR,IAAI,GAAG,qBAAqB,CAAC,GAAG,CAAC,CAAC;YACpC,CAAC;YACD,IAAI,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC3B,MAAM,EAAE,CAAC;YACX,CAAC;QACH,CAAC,CAAC;QAEF,qEAAqE;QACrE,MAAM,KAAK,GAAG,UAAU,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;QAE5C,IAAI,CAAC;YACH,UAAU,CAAC,IAAI,CAAC,CAAC;YACjB,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;YACzB,KAAK,CAAC,MAAM,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,WAAW,GAAG,SAAS,CAAC,CAAC;QACxC,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,EAAE,CAAC;QACX,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/theme/palettes.d.ts

@@ -0,0 +1,84 @@
+/**
+ * Built-in colour palettes.
+ *
+ * A palette is a complete set of *semantic* tokens, named for what they mean
+ * rather than what they look like, so the same idea renders the same way
+ * everywhere. Two rules keep that true:
+ *
+ *  1. No hex literals outside this directory (enforced by
+ *     `no-raw-colors.guard.test.ts`). A one-off `#a78bfa` in a component is how
+ *     the palette drifted to 29 colours before.
+ *  2. No named terminal colours (`'green'`, `'gray'`). Those resolve against the
+ *     *user's* terminal palette, so the app looks different on every machine and
+ *     can land unreadable. Palettes use explicit `#rrggbb` instead.
+ *
+ * Contrast is a tested property, not a hope: see `palettes.test.ts`. A palette
+ * declares which terminal backgrounds it is designed for in
+ * `supportedBackgrounds`, and the test holds its body colours to WCAG 4.5:1 on
+ * each of them.
+ */
+/** `undefined` lets the terminal's own default win, which is how `mono` works. */
+export type Color = string | undefined;
+export declare const THEME_NAMES: readonly ['dark', 'light', 'high-contrast', 'mono'];
+export type ThemeName = (typeof THEME_NAMES)[number];
+/**
+ * A colour a table or helper can name without holding a value: store the role,
+ * then resolve it with `theme[role]` where the theme is in scope. This is what
+ * lets module-level data (hint lists, label maps) stay theme-aware.
+ */
+export type ColorRole = 'accent' | 'accentAlt' | 'success' | 'warning' | 'danger' | 'dangerSoft' | 'text' | 'textMuted' | 'textSubtle' | 'border' | 'borderActive' | 'codeBackground' | 'userBackground' | 'userText' | 'reasoning' | 'toolOutput';
+export type ModeBadge = 'STANDARD' | 'LITE' | 'SHELL' | 'PLAN' | 'ORCHESTRATOR' | 'MENTOR';
+export type ToolStatusKind = 'pending' | 'running' | 'completed' | 'failed' | 'rejected';
+export interface ThemeTokens {
+    name: ThemeName;
+    /**
+     * Terminal backgrounds this palette is designed to sit on. Used by the
+     * contrast test and as documentation; empty for a palette that defines no
+     * colours.
+     */
+    supportedBackgrounds: readonly string[];
+    /** The single interactive accent: prompts, selection, user identity, focus. */
+    accent: Color;
+    /**
+     * Secondary accent: work that runs outside the foreground turn — the mentor
+     * lane, background tasks, queued follow-ups. Not a general-purpose highlight.
+     */
+    accentAlt: Color;
+    success: Color;
+    warning: Color;
+    danger: Color;
+    /** Softer danger, for body text under a danger heading. */
+    dangerSoft: Color;
+    /** Primary body text. Left undefined at most call sites so the terminal default wins. */
+    text: Color;
+    /** Secondary text: values, metadata, tool output. */
+    textMuted: Color;
+    /** Tertiary text: labels, hints, footers, separators. */
+    textSubtle: Color;
+    /** Dividers and inactive container borders. */
+    border: Color;
+    /** Borders of the surface that currently owns input. */
+    borderActive: Color;
+    /** Background behind inline code spans. */
+    codeBackground: Color;
+    /** Full-width band behind user messages. */
+    userBackground: Color;
+    /**
+     * Text on `userBackground`. Explicit on purpose: leaving it to the terminal
+     * default put dark-on-dark text on light terminals (1.5:1).
+     */
+    userText: Color;
+    /** Model reasoning / thinking transcript. */
+    reasoning: Color;
+    /** Tool stdout and rendered tool results. */
+    toolOutput: Color;
+    /** One badge colour per operating mode: identity, not rank. */
+    modeBadge: Record<ModeBadge, Color>;
+    /** Foreground for text sitting on a `modeBadge` background. */
+    modeBadgeForeground: Color;
+    /** Colour for each tool-line status glyph. */
+    toolStatus: Record<ToolStatusKind, Color>;
+}
+export declare const THEMES: Readonly<Record<ThemeName, ThemeTokens>>;
+export declare const DEFAULT_THEME: ThemeTokens;
+//# sourceMappingURL=palettes.d.ts.map

package/dist/theme/palettes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"palettes.d.ts","sourceRoot":"","sources":["../../source/theme/palettes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,kFAAkF;AAClF,MAAM,MAAM,KAAK,GAAG,MAAM,GAAG,SAAS,CAAC;AAEvC,eAAO,MAAM,WAAW,YAAI,MAAM,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,CAAU,CAAC;AAC/E,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC;AAErD;;;;GAIG;AACH,MAAM,MAAM,SAAS,GACjB,QAAQ,GACR,WAAW,GACX,SAAS,GACT,SAAS,GACT,QAAQ,GACR,YAAY,GACZ,MAAM,GACN,WAAW,GACX,YAAY,GACZ,QAAQ,GACR,cAAc,GACd,gBAAgB,GAChB,gBAAgB,GAChB,UAAU,GACV,WAAW,GACX,YAAY,CAAC;AAEjB,MAAM,MAAM,SAAS,GAAG,UAAU,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,cAAc,GAAG,QAAQ,CAAC;AAC3F,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,GAAG,UAAU,CAAC;AAEzF,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,SAAS,CAAC;IAChB;;;;OAIG;IACH,oBAAoB,EAAE,SAAS,MAAM,EAAE,CAAC;IAGxC,+EAA+E;IAC/E,MAAM,EAAE,KAAK,CAAC;IACd;;;OAGG;IACH,SAAS,EAAE,KAAK,CAAC;IAGjB,OAAO,EAAE,KAAK,CAAC;IACf,OAAO,EAAE,KAAK,CAAC;IACf,MAAM,EAAE,KAAK,CAAC;IACd,2DAA2D;IAC3D,UAAU,EAAE,KAAK,CAAC;IAGlB,yFAAyF;IACzF,IAAI,EAAE,KAAK,CAAC;IACZ,qDAAqD;IACrD,SAAS,EAAE,KAAK,CAAC;IACjB,yDAAyD;IACzD,UAAU,EAAE,KAAK,CAAC;IAGlB,+CAA+C;IAC/C,MAAM,EAAE,KAAK,CAAC;IACd,wDAAwD;IACxD,YAAY,EAAE,KAAK,CAAC;IACpB,2CAA2C;IAC3C,cAAc,EAAE,KAAK,CAAC;IAItB,4CAA4C;IAC5C,cAAc,EAAE,KAAK,CAAC;IACtB;;;OAGG;IACH,QAAQ,EAAE,KAAK,CAAC;IAChB,6CAA6C;IAC7C,SAAS,EAAE,KAAK,CAAC;IACjB,6CAA6C;IAC7C,UAAU,EAAE,KAAK,CAAC;IAGlB,+DAA+D;IAC/D,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;IACpC,+DAA+D;IAC/D,mBAAmB,EAAE,KAAK,CAAC;IAC3B,8CAA8C;IAC9C,UAAU,EAAE,MAAM,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC;CAC3C;AA2JD,eAAO,MAAM,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,SAAS,EAAE,WAAW,CAAC,CAK3D,CAAC;AAEF,eAAO,MAAM,aAAa,EAAE,WAAkB,CAAC"}

package/dist/theme/palettes.js

@@ -0,0 +1,175 @@
+/**
+ * Built-in colour palettes.
+ *
+ * A palette is a complete set of *semantic* tokens, named for what they mean
+ * rather than what they look like, so the same idea renders the same way
+ * everywhere. Two rules keep that true:
+ *
+ *  1. No hex literals outside this directory (enforced by
+ *     `no-raw-colors.guard.test.ts`). A one-off `#a78bfa` in a component is how
+ *     the palette drifted to 29 colours before.
+ *  2. No named terminal colours (`'green'`, `'gray'`). Those resolve against the
+ *     *user's* terminal palette, so the app looks different on every machine and
+ *     can land unreadable. Palettes use explicit `#rrggbb` instead.
+ *
+ * Contrast is a tested property, not a hope: see `palettes.test.ts`. A palette
+ * declares which terminal backgrounds it is designed for in
+ * `supportedBackgrounds`, and the test holds its body colours to WCAG 4.5:1 on
+ * each of them.
+ */
+export const THEME_NAMES = ['dark', 'light', 'high-contrast', 'mono'];
+const MODE_BADGES_ON_LIGHT_TEXT = {
+    STANDARD: '#0f766e',
+    LITE: '#047857',
+    SHELL: '#b45309',
+    PLAN: '#0369a1',
+    ORCHESTRATOR: '#9f1239',
+    MENTOR: '#6d28d9',
+};
+const DARK = {
+    name: 'dark',
+    supportedBackgrounds: ['#0f172a', '#0d1117', '#000000'],
+    accent: '#22d3ee',
+    accentAlt: '#a78bfa',
+    success: '#10b981',
+    warning: '#f59e0b',
+    // Not #ef4444: on the pill/inline-code surface (#1e293b) that measured 3.9:1.
+    danger: '#f46060',
+    dangerSoft: '#f87171',
+    text: '#e2e8f0',
+    textMuted: '#94a3b8',
+    textSubtle: '#64748b',
+    border: '#334155',
+    borderActive: '#22d3ee',
+    codeBackground: '#1e293b',
+    userBackground: '#334155',
+    userText: '#e2e8f0',
+    reasoning: '#64748b',
+    toolOutput: '#94a3b8',
+    modeBadge: MODE_BADGES_ON_LIGHT_TEXT,
+    modeBadgeForeground: '#f8fafc',
+    toolStatus: {
+        pending: '#64748b',
+        running: '#f59e0b',
+        completed: '#10b981',
+        failed: '#f46060',
+        rejected: '#f46060',
+    },
+};
+const LIGHT = {
+    name: 'light',
+    supportedBackgrounds: ['#ffffff', '#f6f8fa'],
+    // Accent, success and warning are a step darker than the Tailwind 700s: on the pill/inline-code
+    // surface (#e2e8f0) those measured 4.1-4.3:1.
+    accent: '#0d6c85',
+    accentAlt: '#6d28d9',
+    success: '#147539',
+    warning: '#a64c08',
+    danger: '#b91c1c',
+    dangerSoft: '#c81e1e',
+    text: '#1e293b',
+    textMuted: '#475569',
+    textSubtle: '#64748b',
+    border: '#cbd5e1',
+    borderActive: '#0d6c85',
+    codeBackground: '#e2e8f0',
+    userBackground: '#e2e8f0',
+    userText: '#1e293b',
+    reasoning: '#64748b',
+    toolOutput: '#475569',
+    modeBadge: MODE_BADGES_ON_LIGHT_TEXT,
+    modeBadgeForeground: '#f8fafc',
+    toolStatus: {
+        pending: '#64748b',
+        running: '#a64c08',
+        completed: '#147539',
+        failed: '#b91c1c',
+        rejected: '#b91c1c',
+    },
+};
+/** Maximum separation on a dark terminal, for low vision and bright rooms. */
+const HIGH_CONTRAST = {
+    name: 'high-contrast',
+    supportedBackgrounds: ['#000000', '#0d1117'],
+    accent: '#00e5ff',
+    accentAlt: '#d8b4fe',
+    success: '#4ade80',
+    warning: '#ffd33d',
+    danger: '#ff6b6b',
+    dangerSoft: '#ff9a9a',
+    text: '#ffffff',
+    textMuted: '#e6e6e6',
+    textSubtle: '#bfbfbf',
+    border: '#8b949e',
+    borderActive: '#00e5ff',
+    codeBackground: '#262626',
+    userBackground: '#ffffff',
+    userText: '#000000',
+    reasoning: '#bfbfbf',
+    toolOutput: '#e6e6e6',
+    modeBadge: {
+        STANDARD: '#0f766e',
+        LITE: '#047857',
+        SHELL: '#92400e',
+        PLAN: '#075985',
+        ORCHESTRATOR: '#9f1239',
+        MENTOR: '#6d28d9',
+    },
+    modeBadgeForeground: '#ffffff',
+    toolStatus: {
+        pending: '#bfbfbf',
+        running: '#ffd33d',
+        completed: '#4ade80',
+        failed: '#ff6b6b',
+        rejected: '#ff6b6b',
+    },
+};
+const NO_COLOR_BADGES = {
+    STANDARD: undefined,
+    LITE: undefined,
+    SHELL: undefined,
+    PLAN: undefined,
+    ORCHESTRATOR: undefined,
+    MENTOR: undefined,
+};
+/**
+ * No colour at all (`NO_COLOR`, `TERM=dumb`, or by choice). Everything falls
+ * back to the terminal defaults; meaning has to survive on glyphs and weight.
+ */
+const MONO = {
+    name: 'mono',
+    supportedBackgrounds: [],
+    accent: undefined,
+    accentAlt: undefined,
+    success: undefined,
+    warning: undefined,
+    danger: undefined,
+    dangerSoft: undefined,
+    text: undefined,
+    textMuted: undefined,
+    textSubtle: undefined,
+    border: undefined,
+    borderActive: undefined,
+    codeBackground: undefined,
+    userBackground: undefined,
+    userText: undefined,
+    reasoning: undefined,
+    toolOutput: undefined,
+    modeBadge: NO_COLOR_BADGES,
+    modeBadgeForeground: undefined,
+    toolStatus: {
+        pending: undefined,
+        running: undefined,
+        completed: undefined,
+        failed: undefined,
+        rejected: undefined,
+    },
+};
+export const THEMES = {
+    dark: DARK,
+    light: LIGHT,
+    'high-contrast': HIGH_CONTRAST,
+    mono: MONO,
+};
+export const DEFAULT_THEME = DARK;
+//# sourceMappingURL=palettes.js.map

package/dist/theme/palettes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"palettes.js","sourceRoot":"","sources":["../../source/theme/palettes.ts"],"names":[],"mappings":"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"}

package/dist/theme/resolve-theme.d.ts

@@ -0,0 +1,44 @@
+import { type ThemeName } from './palettes.js';
+/** What `ui.theme` may hold: a concrete theme, or `auto` to pick one for the terminal. */
+export type ThemeSetting = 'auto' | ThemeName;
+export declare const THEME_SETTING_VALUES: readonly ["auto", "dark", "light", "high-contrast", "mono"];
+export type BackgroundMode = 'dark' | 'light';
+export type Rgb = {
+    r: number;
+    g: number;
+    b: number;
+};
+export interface ResolveThemeContext {
+    env: Readonly<Record<string, string | undefined>>;
+    /** What the terminal itself reported (OSC 11), when it answered. */
+    detectedBackground?: BackgroundMode;
+}
+/**
+ * Picks the concrete theme for a `ui.theme` setting.
+ *
+ * An explicit theme always wins, including over `NO_COLOR`: that variable is a
+ * default for software that has no user configuration, and the no-color.org
+ * convention lets explicit user config override it.
+ *
+ * For `auto`, evidence is ordered by how much it can be trusted: no-colour
+ * signals, then what the terminal actually reported, then the static
+ * `COLORFGBG` hint some terminals export, then dark (the common case).
+ */
+export declare function resolveThemeName(setting: ThemeSetting, context: ResolveThemeContext): ThemeName;
+/**
+ * Whether startup should spend a round trip asking the terminal for its
+ * background. Only `auto` can use the answer, and only while colour is on:
+ * otherwise `resolveThemeName` ignores it, so asking would be pure cost.
+ */
+export declare function shouldDetectBackground(setting: ThemeSetting, env: ResolveThemeContext['env']): boolean;
+/**
+ * `COLORFGBG` is `fg;bg` or `fg;default;bg` using ANSI palette indices. Indices
+ * 0-6 and 8 are dark; 7 and 9-15 are light. Anything else is unknown rather
+ * than guessed.
+ */
+export declare function parseColorFgBg(value: string | undefined): BackgroundMode | undefined;
+/** Parses a terminal's reply to an OSC 11 (background colour) query. */
+export declare function parseOsc11Response(data: string): Rgb | undefined;
+/** Classifies by perceived luminance (Rec. 601), so saturated-but-dark colours stay dark. */
+export declare function backgroundModeFromRgb({ r, g, b }: Rgb): BackgroundMode;
+//# sourceMappingURL=resolve-theme.d.ts.map

package/dist/theme/resolve-theme.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-theme.d.ts","sourceRoot":"","sources":["../../source/theme/resolve-theme.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,KAAK,SAAS,EAAE,MAAM,eAAe,CAAC;AAE5D,0FAA0F;AAC1F,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,SAAS,CAAC;AAC9C,eAAO,MAAM,oBAAoB,6DAAoC,CAAC;AAEtE,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,OAAO,CAAC;AAC9C,MAAM,MAAM,GAAG,GAAG;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAEtD,MAAM,WAAW,mBAAmB;IAClC,GAAG,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC;IAClD,oEAAoE;IACpE,kBAAkB,CAAC,EAAE,cAAc,CAAC;CACrC;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,mBAAmB,GAAG,SAAS,CAU/F;AAID;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,EAAE,mBAAmB,CAAC,KAAK,CAAC,GAAG,OAAO,CAEtG;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,cAAc,GAAG,SAAS,CAiBpF;AAQD,wEAAwE;AACxE,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,GAAG,GAAG,SAAS,CAMhE;AAED,6FAA6F;AAC7F,wBAAgB,qBAAqB,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,GAAG,GAAG,cAAc,CAEtE"}