alchemy 2.0.0-beta.76 → 2.0.0-beta.77

package/lib/Util/Terminal.d.ts

@@ -0,0 +1,23 @@
+/** Terminal-emulator features shared by CliKit components. */
+import { detectUnicodeSupport } from "@alchemy.run/sigil/capabilities";
+import { type TerminalProgressState } from "@alchemy.run/sigil/ansi";
+export declare const ANSI_RESET = "\u001B[0m";
+export declare const ANSI_BOLD = "\u001B[1m";
+export declare const ANSI_DIM = "\u001B[2m";
+/** Truecolor foreground escape for raw, non-layout output. */
+export declare const ansiFg: (hex: string) => string;
+/**
+ * The canonical color-support decision, shared by raw terminal strings and
+ * CliKit capability detection so the two can never disagree.
+ */
+export declare const colorsEnabled: (stream?: Pick<NodeJS.WriteStream, "isTTY">) => boolean;
+/** The canonical Unicode-support decision for raw terminal strings. */
+export declare const unicodeEnabled: typeof detectUnicodeSupport;
+/** Environment override for child processes whose piped output returns here. */
+export declare const pipedColorEnv: () => Record<string, string>;
+export declare const paint: (code: string, value: string) => string;
+export declare const copyToClipboard: (text: string, stdout?: Pick<NodeJS.WriteStream, "write">) => void;
+export declare const setNativeProgress: (state: TerminalProgressState, value?: number, stdout?: Pick<NodeJS.WriteStream, "write" | "isTTY">) => void;
+/** Display-width-aware truncation (wide CJK/emoji count by rendered cells). */
+export declare const truncate: (value: string, width: number) => string;
+//# sourceMappingURL=Terminal.d.ts.map

package/lib/Util/Terminal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Terminal.d.ts","sourceRoot":"","sources":["../../src/Util/Terminal.ts"],"names":[],"mappings":"AAAA,8DAA8D;AAC9D,OAAO,EAEL,oBAAoB,EACrB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAIL,KAAK,qBAAqB,EAC3B,MAAM,yBAAyB,CAAC;AAGjC,eAAO,MAAM,UAAU,cAAc,CAAC;AACtC,eAAO,MAAM,SAAS,cAAc,CAAC;AACrC,eAAO,MAAM,QAAQ,cAAc,CAAC;AAEpC,8DAA8D;AAC9D,eAAO,MAAM,MAAM,QAAS,MAAM,WAKjC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,aAAa,YAChB,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,OAAO,CAAC,KACxC,OAAuC,CAAC;AAE3C,uEAAuE;AACvE,eAAO,MAAM,cAAc,6BAAuB,CAAC;AAEnD,gFAAgF;AAChF,eAAO,MAAM,aAAa,QAAO,MAAM,CAAC,MAAM,EAAE,MAAM,CACkB,CAAC;AAEzE,eAAO,MAAM,KAAK,SAAU,MAAM,SAAS,MAAM,KAAG,MACM,CAAC;AAE3D,eAAO,MAAM,eAAe,SACpB,MAAM,WACJ,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,OAAO,CAAC,KACxC,IAMF,CAAC;AAEF,eAAO,MAAM,iBAAiB,UACrB,qBAAqB,UACpB,MAAM,WACN,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,OAAO,GAAG,OAAO,CAAC,KAClD,IAKF,CAAC;AAIF,+EAA+E;AAC/E,eAAO,MAAM,QAAQ,UAAW,MAAM,SAAS,MAAM,KAAG,MAYvD,CAAC"}

package/lib/Util/Terminal.js

@@ -0,0 +1,57 @@
+/** Terminal-emulator features shared by CliKit components. */
+import { detectColorLevel, detectUnicodeSupport, } from "@alchemy.run/sigil/capabilities";
+import { setClipboard, setTerminalProgress, tmuxPassthrough, } from "@alchemy.run/sigil/ansi";
+import stringWidth from "string-width";
+export const ANSI_RESET = "\u001B[0m";
+export const ANSI_BOLD = "\u001B[1m";
+export const ANSI_DIM = "\u001B[2m";
+/** Truecolor foreground escape for raw, non-layout output. */
+export const ansiFg = (hex) => {
+    const red = Number.parseInt(hex.slice(1, 3), 16);
+    const green = Number.parseInt(hex.slice(3, 5), 16);
+    const blue = Number.parseInt(hex.slice(5, 7), 16);
+    return `\u001B[38;2;${red};${green};${blue}m`;
+};
+/**
+ * The canonical color-support decision, shared by raw terminal strings and
+ * CliKit capability detection so the two can never disagree.
+ */
+export const colorsEnabled = (stream = process.stdout) => detectColorLevel(stream) > 0;
+/** The canonical Unicode-support decision for raw terminal strings. */
+export const unicodeEnabled = detectUnicodeSupport;
+/** Environment override for child processes whose piped output returns here. */
+export const pipedColorEnv = () => colorsEnabled() ? { FORCE_COLOR: process.env.FORCE_COLOR ?? "1" } : {};
+export const paint = (code, value) => colorsEnabled() ? `${code}${value}${ANSI_RESET}` : value;
+export const copyToClipboard = (text, stdout = process.stdout) => {
+    let sequence = setClipboard(text);
+    if (process.env.TMUX !== undefined) {
+        sequence = tmuxPassthrough(sequence);
+    }
+    stdout.write(sequence);
+};
+export const setNativeProgress = (state, value, stdout = process.stdout) => {
+    if (stdout.isTTY !== true)
+        return;
+    let sequence = setTerminalProgress(state, value);
+    if (process.env.TMUX !== undefined)
+        sequence = tmuxPassthrough(sequence);
+    stdout.write(sequence);
+};
+const truncateSegmenter = new Intl.Segmenter();
+/** Display-width-aware truncation (wide CJK/emoji count by rendered cells). */
+export const truncate = (value, width) => {
+    const max = Math.max(4, width);
+    if (stringWidth(value) <= max)
+        return value;
+    let total = 0;
+    let kept = "";
+    for (const { segment } of truncateSegmenter.segment(value)) {
+        const segmentWidth = stringWidth(segment);
+        if (total + segmentWidth > max - 1)
+            break;
+        total += segmentWidth;
+        kept += segment;
+    }
+    return `${kept}…`;
+};
+//# sourceMappingURL=Terminal.js.map

package/lib/Util/Terminal.js.map

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

package/lib/Util/Theme.d.ts

@@ -0,0 +1,123 @@
+import type { Paint } from "@alchemy.run/sigil/color";
+export declare const theme: {
+    readonly color: {
+        readonly brand: "#e28a5b";
+        readonly accent: "#9acb69";
+        readonly accentBright: "#c5df8c";
+        readonly accentMuted: "#60764b";
+        readonly success: "#9acb69";
+        readonly warning: "#efb85a";
+        readonly danger: "#d96f52";
+        readonly magenta: "#c084d6";
+        readonly info: "#b6c77a";
+        readonly sage: "#b8cf83";
+        readonly olive: "#9ea85e";
+        readonly coral: "#ef9a6a";
+        readonly muted: "#8f887c";
+        readonly diffAddBackground: "#263b2a";
+        readonly diffRemoveBackground: "#422a26";
+        readonly onAccent: "#14110d";
+        readonly emphasis: "#f5f0e6";
+    };
+    readonly space: {
+        readonly inline: 1;
+        readonly indent: 2;
+        readonly section: 1;
+    };
+    readonly paint: {
+        readonly focus: "#e28a5b";
+        readonly interactive: "#e28a5b";
+        readonly info: "#b6c77a";
+        readonly success: "#9acb69";
+        readonly warning: "#efb85a";
+        readonly error: "#d96f52";
+    };
+    readonly glyph: {
+        readonly section: "●";
+        /**
+         * Marks the step currently being answered — the same "active one" glyph
+         * the profile tabs use. Deliberately not a chevron so the list cursor
+         * (`pointer`) is the only chevron on screen.
+         */
+        readonly active: "◆";
+        /** List cursor: the one focus glyph shared by every prompt and dashboard row. */
+        readonly pointer: "❯";
+        readonly success: "✓";
+        readonly warning: "!";
+        readonly error: "×";
+        readonly info: "•";
+        readonly selected: "◆";
+        readonly unselected: "·";
+        readonly checked: "✓";
+        readonly unchecked: "·";
+        readonly add: "+";
+        readonly adopt: "(+)";
+        readonly edit: "~";
+        readonly refresh: "↻";
+        readonly delete: "-";
+        readonly orphan: "(-)";
+        readonly replace: "↔";
+        readonly run: "▶";
+        readonly bar: "┊";
+        readonly mask: "•";
+        readonly bullet: "·";
+        readonly overflowUp: "↑";
+        readonly overflowDown: "↓";
+        readonly overflowLeft: "‹";
+        readonly overflowRight: "›";
+    };
+    /**
+     * Key-hint labels for KeyBar footers. Resolve through `useKeyGlyphs()`
+     * (components/Environment.tsx) so ASCII terminals get readable fallbacks
+     * instead of mojibake.
+     */
+    readonly keyHint: {
+        readonly enter: "↩";
+        readonly upDown: "↑/↓";
+        readonly leftRight: "←/→";
+        readonly escape: "esc";
+        readonly space: "space";
+        readonly tab: "tab";
+        readonly yesNo: "y/n";
+    };
+};
+export type KeyHint = {
+    readonly [Key in keyof typeof theme.keyHint]: string;
+};
+export type GlyphName = keyof typeof theme.glyph;
+export declare const asciiGlyphs: {
+    readonly [Key in GlyphName]: string;
+};
+export declare const glyphsFor: (unicode: boolean) => {
+    readonly active: string;
+    readonly add: string;
+    readonly adopt: string;
+    readonly bar: string;
+    readonly bullet: string;
+    readonly checked: string;
+    readonly delete: string;
+    readonly edit: string;
+    readonly error: string;
+    readonly info: string;
+    readonly mask: string;
+    readonly orphan: string;
+    readonly overflowDown: string;
+    readonly overflowLeft: string;
+    readonly overflowRight: string;
+    readonly overflowUp: string;
+    readonly pointer: string;
+    readonly refresh: string;
+    readonly replace: string;
+    readonly run: string;
+    readonly section: string;
+    readonly selected: string;
+    readonly success: string;
+    readonly unchecked: string;
+    readonly unselected: string;
+    readonly warning: string;
+};
+export declare const spinnerFramesFor: (unicode: boolean) => readonly string[];
+export type StatusVariant = "info" | "success" | "warning" | "error";
+export declare const statusColor: (variant: StatusVariant) => string;
+export declare const statusPaint: (variant: StatusVariant) => Paint;
+//# sourceMappingURL=Theme.d.ts.map

package/lib/Util/Theme.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Theme.d.ts","sourceRoot":"","sources":["../../src/Util/Theme.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,0BAA0B,CAAC;AA0BtD,eAAO,MAAM,KAAK;;wBAnBT,SAAS;yBACR,SAAS;+BACH,SAAS;8BACV,SAAS;0BACb,SAAS;0BACT,SAAS;yBACV,SAAS;0BACR,SAAS;uBACZ,SAAS;uBACT,SAAS;wBACR,SAAS;wBACT,SAAS;wBACT,SAAS;oCACG,SAAS;uCACN,SAAS;2BACrB,SAAS;2BACT,SAAS;;;iBAMjB,MAAM,EAAE,CAAC;iBACT,MAAM,EAAE,CAAC;iBACT,OAAO,EAAE,CAAC;;;iBAGV,KAAK;iBACL,WAAW;iBACX,IAAI;iBACJ,OAAO;iBACP,OAAO;iBACP,KAAK;;;iBAGL,OAAO,EAAE,GAAG;QACZ;;;;WAIG;iBACH,MAAM,EAAE,GAAG;QACX,iFAAiF;iBACjF,OAAO,EAAE,GAAG;iBACZ,OAAO,EAAE,GAAG;iBACZ,OAAO,EAAE,GAAG;iBACZ,KAAK,EAAE,GAAG;iBACV,IAAI,EAAE,GAAG;iBACT,QAAQ,EAAE,GAAG;iBACb,UAAU,EAAE,GAAG;iBACf,OAAO,EAAE,GAAG;iBACZ,SAAS,EAAE,GAAG;iBACd,GAAG,EAAE,GAAG;iBACR,KAAK,EAAE,KAAK;iBACZ,IAAI,EAAE,GAAG;iBACT,OAAO,EAAE,GAAG;iBACZ,MAAM,EAAE,GAAG;iBACX,MAAM,EAAE,KAAK;iBACb,OAAO,EAAE,GAAG;iBACZ,GAAG,EAAE,GAAG;iBACR,GAAG,EAAE,GAAG;iBACR,IAAI,EAAE,GAAG;iBACT,MAAM,EAAE,GAAG;iBACX,UAAU,EAAE,GAAG;iBACf,YAAY,EAAE,GAAG;iBACjB,YAAY,EAAE,GAAG;iBACjB,aAAa,EAAE,GAAG;;IAEpB;;;;OAIG;;iBAED,KAAK,EAAE,GAAG;iBACV,MAAM,EAAE,KAAK;iBACb,SAAS,EAAE,KAAK;iBAChB,MAAM,EAAE,KAAK;iBACb,KAAK,EAAE,OAAO;iBACd,GAAG,EAAE,KAAK;iBACV,KAAK,EAAE,KAAK;;CAEN,CAAC;AAEX,MAAM,MAAM,OAAO,GAAG;IAAE,QAAQ,EAAE,GAAG,IAAI,MAAM,OAAO,KAAK,CAAC,OAAO,GAAG,MAAM;CAAE,CAAC;AAC/E,MAAM,MAAM,SAAS,GAAG,MAAM,OAAO,KAAK,CAAC,KAAK,CAAC;AAEjD,eAAO,MAAM,WAAW,EAAE;IAAE,QAAQ,EAAE,GAAG,IAAI,SAAS,GAAG,MAAM;CA2B9D,CAAC;AAEF,eAAO,MAAM,SAAS,YAAa,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;CACL,CAAC;AAgBtC,eAAO,MAAM,gBAAgB,YAAa,OAAO,KAAG,SAAS,MAAM,EACrB,CAAC;AAE/C,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,CAAC;AAErE,eAAO,MAAM,WAAW,YAAa,aAAa,KAAG,MACY,CAAC;AAElE,eAAO,MAAM,WAAW,YAAa,aAAa,KAAG,KAC/B,CAAC"}

package/lib/Util/Theme.js

@@ -0,0 +1,133 @@
+/**
+ * Alchemy's palette is anchored in terracotta and green. The supporting
+ * amber, olive, sage, and coral tones stay within that warm botanical range.
+ */
+const color = {
+    brand: "#e28a5b",
+    accent: "#9acb69",
+    accentBright: "#c5df8c",
+    accentMuted: "#60764b",
+    success: "#9acb69",
+    warning: "#efb85a",
+    danger: "#d96f52",
+    magenta: "#c084d6",
+    info: "#b6c77a",
+    sage: "#b8cf83",
+    olive: "#9ea85e",
+    coral: "#ef9a6a",
+    muted: "#8f887c",
+    diffAddBackground: "#263b2a",
+    diffRemoveBackground: "#422a26",
+    onAccent: "#14110d",
+    emphasis: "#f5f0e6",
+};
+export const theme = {
+    color,
+    space: {
+        inline: 1,
+        indent: 2,
+        section: 1,
+    },
+    paint: {
+        focus: color.brand,
+        interactive: color.brand,
+        info: color.info,
+        success: color.success,
+        warning: color.warning,
+        error: color.danger,
+    },
+    glyph: {
+        section: "●",
+        /**
+         * Marks the step currently being answered — the same "active one" glyph
+         * the profile tabs use. Deliberately not a chevron so the list cursor
+         * (`pointer`) is the only chevron on screen.
+         */
+        active: "◆",
+        /** List cursor: the one focus glyph shared by every prompt and dashboard row. */
+        pointer: "❯",
+        success: "✓",
+        warning: "!",
+        error: "×",
+        info: "•",
+        selected: "◆",
+        unselected: "·",
+        checked: "✓",
+        unchecked: "·",
+        add: "+",
+        adopt: "(+)",
+        edit: "~",
+        refresh: "↻",
+        delete: "-",
+        orphan: "(-)",
+        replace: "↔",
+        run: "▶",
+        bar: "┊",
+        mask: "•",
+        bullet: "·",
+        overflowUp: "↑",
+        overflowDown: "↓",
+        overflowLeft: "‹",
+        overflowRight: "›",
+    },
+    /**
+     * Key-hint labels for KeyBar footers. Resolve through `useKeyGlyphs()`
+     * (components/Environment.tsx) so ASCII terminals get readable fallbacks
+     * instead of mojibake.
+     */
+    keyHint: {
+        enter: "↩",
+        upDown: "↑/↓",
+        leftRight: "←/→",
+        escape: "esc",
+        space: "space",
+        tab: "tab",
+        yesNo: "y/n",
+    },
+};
+export const asciiGlyphs = {
+    section: "@",
+    active: "*",
+    pointer: ">",
+    success: "+",
+    warning: "!",
+    error: "x",
+    info: "i",
+    selected: "*",
+    unselected: ".",
+    checked: "x",
+    unchecked: ".",
+    add: "+",
+    adopt: "(+)",
+    edit: "~",
+    refresh: "r",
+    delete: "-",
+    orphan: "(-)",
+    replace: "~",
+    run: ">",
+    bar: ":",
+    mask: "*",
+    bullet: ".",
+    overflowUp: "^",
+    overflowDown: "v",
+    overflowLeft: "<",
+    overflowRight: ">",
+};
+export const glyphsFor = (unicode) => unicode ? theme.glyph : asciiGlyphs;
+const spinnerFrames = [
+    "⠋",
+    "⠙",
+    "⠹",
+    "⠸",
+    "⠼",
+    "⠴",
+    "⠦",
+    "⠧",
+    "⠇",
+    "⠏",
+];
+const asciiSpinnerFrames = ["-", "\\", "|", "/"];
+export const spinnerFramesFor = (unicode) => unicode ? spinnerFrames : asciiSpinnerFrames;
+export const statusColor = (variant) => variant === "error" ? theme.color.danger : theme.color[variant];
+export const statusPaint = (variant) => theme.paint[variant];
+//# sourceMappingURL=Theme.js.map

package/lib/Util/Theme.js.map

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

package/lib/Util/interactive.d.ts

@@ -1,16 +1,21 @@
+import * as Effect from "effect/Effect";
+export declare const isNonInteractive: () => boolean;
 /**
- * Returns true when the current process looks like it's being driven by a
- * coding agent, CI runner, test runner, or anything else that won't render an
- * interactive TUI / prompt well.
- *
- * Two callers rely on this:
- *  - `Cli/selectCli.ts` uses it to pick `LoggingCli` over the Ink TUI.
- *  - `Auth/Profile.ts` uses it to refuse to launch an interactive credential
- *    configure flow (and thus avoid acquiring an auth lockfile) when there's
- *    no TTY to drive the prompts.
+ * Whether a plain line-based prompt can still read an answer from stdin.
  *
- * Kept in `Util` (rather than `Cli`) so `Auth` can depend on it without
- * pulling in the CLI layer.
+ * Distinct from {@link isNonInteractive}: `ALCHEMY_PLAIN` / `ALCHEMY_NO_TUI`
+ * turn off the TUI *rendering*, not input — a human running plain mode in a
+ * terminal can still answer a `[y/n]` question. Agents and CI pipe stdin
+ * (or set their env markers) and land `false`.
  */
-export declare const isNonInteractive: () => boolean;
+export declare const canPromptOnStdin: () => boolean;
+export interface InteractionCapabilities {
+    readonly input: boolean;
+}
+/** Process capabilities as an Effect so callers can replace them in tests. */
+export declare const processInteractionCapabilities: Effect.Effect<InteractionCapabilities>;
+/** Select user-facing copy from an injected capability Effect. */
+export declare const messageForCapabilities: <E, R>(capabilities: Effect.Effect<InteractionCapabilities, E, R>, interactive: string, nonInteractive: string) => Effect.Effect<string, E, R>;
+/** Prefer the profile dashboard when this process can own a TUI screen. */
+export declare const profileCommandHint: (nonInteractiveCommand: string) => Effect.Effect<string, never, never>;
 //# sourceMappingURL=interactive.d.ts.map

package/lib/Util/interactive.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"interactive.d.ts","sourceRoot":"","sources":["../../src/Util/interactive.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,gBAAgB,QAAO,OAiBnC,CAAC"}
+{"version":3,"file":"interactive.d.ts","sourceRoot":"","sources":["../../src/Util/interactive.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAkExC,eAAO,MAAM,gBAAgB,QAAO,OASnC,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,gBAAgB,QAAO,OAOnC,CAAC;AAEF,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;CACzB;AAED,8EAA8E;AAC9E,eAAO,MAAM,8BAA8B,EAAE,MAAM,CAAC,MAAM,CAAC,uBAAuB,CAC7B,CAAC;AAEtD,kEAAkE;AAClE,eAAO,MAAM,sBAAsB,GAAI,CAAC,EAAE,CAAC,gBAC3B,MAAM,CAAC,MAAM,CAAC,uBAAuB,EAAE,CAAC,EAAE,CAAC,CAAC,eAC7C,MAAM,kBACH,MAAM,KACrB,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC,CAG1B,CAAC;AAEJ,2EAA2E;AAC3E,eAAO,MAAM,kBAAkB,0BAA2B,MAAM,wCAK7D,CAAC"}

package/lib/Util/interactive.js

@@ -1,35 +1,103 @@
+import * as Effect from "effect/Effect";
 /**
  * Returns true when the current process looks like it's being driven by a
  * coding agent, CI runner, test runner, or anything else that won't render an
  * interactive TUI / prompt well.
  *
- * Two callers rely on this:
- *  - `Cli/selectCli.ts` uses it to pick `LoggingCli` over the Ink TUI.
- *  - `Auth/Profile.ts` uses it to refuse to launch an interactive credential
- *    configure flow (and thus avoid acquiring an auth lockfile) when there's
- *    no TTY to drive the prompts.
+ * This is the process-level source of truth used by CliKit capability
+ * detection, auth configuration guards, and spawned-command stdin policy.
  *
  * Kept in `Util` (rather than `Cli`) so `Auth` can depend on it without
  * pulling in the CLI layer.
  */
+// An explicit CLI flag beats every env-based heuristic. Checked via argv
+// because capability detection runs while the CLI's service layers are
+// built, before the command parser has produced flag values. Only scan up
+// to a `--` separator so a positional argument that happens to be the
+// literal text "--no-input" is not mistaken for the flag.
+const hasNoInputFlag = () => {
+    const separator = process.argv.indexOf("--");
+    const flagArgs = separator === -1 ? process.argv : process.argv.slice(0, separator);
+    return flagArgs.includes("--no-input");
+};
+// Known coding-agent env vars, ported from unjs/std-env (src/agents.ts).
+// Best-effort — the isTTY checks at the call sites already catch most cases
+// since agents typically pipe stdin/stdout. std-env's kiro check
+// (TERM_PROGRAM=kiro gated on no-TTY) is deliberately omitted: both call
+// sites only reach this function when stdin/stdout ARE a TTY, where that
+// check would never match.
+const isAgentEnv = (env) => !!(
+// explicit override supported by std-env
+env.AI_AGENT ||
+    // claude
+    env.CLAUDECODE ||
+    env.CLAUDE_CODE ||
+    env.CLAUDE_CODE_ENTRYPOINT ||
+    // replit
+    env.REPL_ID ||
+    // gemini
+    env.GEMINI_CLI ||
+    // codex
+    env.CODEX_SANDBOX ||
+    env.CODEX_THREAD_ID ||
+    env.CODEX_CLI ||
+    // opencode
+    env.OPENCODE ||
+    // auggie
+    env.AUGMENT_AGENT ||
+    // goose
+    env.GOOSE_PROVIDER ||
+    // junie
+    env.JUNIE_DATA ||
+    env.JUNIE_SHIM_PATH ||
+    // aider
+    env.AIDER_MODEL ||
+    // pi
+    /\.pi[\\/]agent/.test(env.PATH ?? "") ||
+    // devin
+    /devin/.test(env.EDITOR ?? "") ||
+    // cursor
+    env.CURSOR_AGENT);
 export const isNonInteractive = () => {
     const env = process.env;
+    if (hasNoInputFlag())
+        return true;
     if (env.ALCHEMY_PLAIN === "1" || env.ALCHEMY_NO_TUI === "1")
         return true;
     if (env.ALCHEMY_TUI === "1")
         return false;
-    if (!process.stdout.isTTY)
+    if (!process.stdin.isTTY || !process.stdout.isTTY)
         return true;
     if (env.CI)
         return true;
-    // Known coding-agent env vars. These are best-effort — the isTTY check
-    // above already catches most cases since agents typically pipe stdout.
-    if (env.CLAUDECODE ||
-        env.CLAUDE_CODE_ENTRYPOINT ||
-        env.CURSOR_AGENT ||
-        env.AIDER_MODEL ||
-        env.CODEX_CLI)
+    if (isAgentEnv(env))
         return true;
     return false;
 };
+/**
+ * Whether a plain line-based prompt can still read an answer from stdin.
+ *
+ * Distinct from {@link isNonInteractive}: `ALCHEMY_PLAIN` / `ALCHEMY_NO_TUI`
+ * turn off the TUI *rendering*, not input — a human running plain mode in a
+ * terminal can still answer a `[y/n]` question. Agents and CI pipe stdin
+ * (or set their env markers) and land `false`.
+ */
+export const canPromptOnStdin = () => {
+    const env = process.env;
+    if (hasNoInputFlag())
+        return false;
+    if (!process.stdin.isTTY || !process.stdout.isTTY)
+        return false;
+    if (env.CI)
+        return false;
+    if (isAgentEnv(env))
+        return false;
+    return true;
+};
+/** Process capabilities as an Effect so callers can replace them in tests. */
+export const processInteractionCapabilities = Effect.sync(() => ({ input: !isNonInteractive() }));
+/** Select user-facing copy from an injected capability Effect. */
+export const messageForCapabilities = (capabilities, interactive, nonInteractive) => Effect.map(capabilities, ({ input }) => input ? interactive : nonInteractive);
+/** Prefer the profile dashboard when this process can own a TUI screen. */
+export const profileCommandHint = (nonInteractiveCommand) => messageForCapabilities(processInteractionCapabilities, "alchemy profile", nonInteractiveCommand);
 //# sourceMappingURL=interactive.js.map

package/lib/Util/interactive.js.map

@@ -1 +1 @@
-{"version":3,"file":"interactive.js","sourceRoot":"","sources":["../../src/Util/interactive.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,GAAY,EAAE;IAC5C,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;IACxB,IAAI,GAAG,CAAC,aAAa,KAAK,GAAG,IAAI,GAAG,CAAC,cAAc,KAAK,GAAG;QAAE,OAAO,IAAI,CAAC;IACzE,IAAI,GAAG,CAAC,WAAW,KAAK,GAAG;QAAE,OAAO,KAAK,CAAC;IAC1C,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IACvC,IAAI,GAAG,CAAC,EAAE;QAAE,OAAO,IAAI,CAAC;IACxB,uEAAuE;IACvE,uEAAuE;IACvE,IACE,GAAG,CAAC,UAAU;QACd,GAAG,CAAC,sBAAsB;QAC1B,GAAG,CAAC,YAAY;QAChB,GAAG,CAAC,WAAW;QACf,GAAG,CAAC,SAAS;QAEb,OAAO,IAAI,CAAC;IACd,OAAO,KAAK,CAAC;AACf,CAAC,CAAC"}
+{"version":3,"file":"interactive.js","sourceRoot":"","sources":["../../src/Util/interactive.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC;;;;;;;;;;GAUG;AACH,yEAAyE;AACzE,uEAAuE;AACvE,0EAA0E;AAC1E,sEAAsE;AACtE,0DAA0D;AAC1D,MAAM,cAAc,GAAG,GAAY,EAAE;IACnC,MAAM,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7C,MAAM,QAAQ,GACZ,SAAS,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;IACrE,OAAO,QAAQ,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;AACzC,CAAC,CAAC;AAEF,yEAAyE;AACzE,4EAA4E;AAC5E,iEAAiE;AACjE,yEAAyE;AACzE,yEAAyE;AACzE,2BAA2B;AAC3B,MAAM,UAAU,GAAG,CAAC,GAAsB,EAAW,EAAE,CACrD,CAAC,CAAC;AACA,yCAAyC;AACzC,GAAG,CAAC,QAAQ;IACZ,SAAS;IACT,GAAG,CAAC,UAAU;IACd,GAAG,CAAC,WAAW;IACf,GAAG,CAAC,sBAAsB;IAC1B,SAAS;IACT,GAAG,CAAC,OAAO;IACX,SAAS;IACT,GAAG,CAAC,UAAU;IACd,QAAQ;IACR,GAAG,CAAC,aAAa;IACjB,GAAG,CAAC,eAAe;IACnB,GAAG,CAAC,SAAS;IACb,WAAW;IACX,GAAG,CAAC,QAAQ;IACZ,SAAS;IACT,GAAG,CAAC,aAAa;IACjB,QAAQ;IACR,GAAG,CAAC,cAAc;IAClB,QAAQ;IACR,GAAG,CAAC,UAAU;IACd,GAAG,CAAC,eAAe;IACnB,QAAQ;IACR,GAAG,CAAC,WAAW;IACf,KAAK;IACL,gBAAgB,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC;IACrC,QAAQ;IACR,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,IAAI,EAAE,CAAC;IAC9B,SAAS;IACT,GAAG,CAAC,YAAY,CACjB,CAAC;AAEJ,MAAM,CAAC,MAAM,gBAAgB,GAAG,GAAY,EAAE;IAC5C,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;IACxB,IAAI,cAAc,EAAE;QAAE,OAAO,IAAI,CAAC;IAClC,IAAI,GAAG,CAAC,aAAa,KAAK,GAAG,IAAI,GAAG,CAAC,cAAc,KAAK,GAAG;QAAE,OAAO,IAAI,CAAC;IACzE,IAAI,GAAG,CAAC,WAAW,KAAK,GAAG;QAAE,OAAO,KAAK,CAAC;IAC1C,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IAC/D,IAAI,GAAG,CAAC,EAAE;QAAE,OAAO,IAAI,CAAC;IACxB,IAAI,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IACjC,OAAO,KAAK,CAAC;AACf,CAAC,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,GAAY,EAAE;IAC5C,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;IACxB,IAAI,cAAc,EAAE;QAAE,OAAO,KAAK,CAAC;IACnC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK;QAAE,OAAO,KAAK,CAAC;IAChE,IAAI,GAAG,CAAC,EAAE;QAAE,OAAO,KAAK,CAAC;IACzB,IAAI,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,KAAK,CAAC;IAClC,OAAO,IAAI,CAAC;AACd,CAAC,CAAC;AAMF,8EAA8E;AAC9E,MAAM,CAAC,MAAM,8BAA8B,GACzC,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,gBAAgB,EAAE,EAAE,CAAC,CAAC,CAAC;AAEtD,kEAAkE;AAClE,MAAM,CAAC,MAAM,sBAAsB,GAAG,CACpC,YAA0D,EAC1D,WAAmB,EACnB,cAAsB,EACO,EAAE,CAC/B,MAAM,CAAC,GAAG,CAAC,YAAY,EAAE,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CACrC,KAAK,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,cAAc,CACrC,CAAC;AAEJ,2EAA2E;AAC3E,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,qBAA6B,EAAE,EAAE,CAClE,sBAAsB,CACpB,8BAA8B,EAC9B,iBAAiB,EACjB,qBAAqB,CACtB,CAAC"}

package/lib/Util/scc.d.ts

@@ -1,12 +1,20 @@
+/**
+ * Compute the strongly-connected components of a directed graph.
+ *
+ * Components are emitted in Tarjan completion order — the reverse
+ * topological order of the condensation, so a component appears before
+ * every component that has an edge into it.
+ *
+ * Implementation is iterative Tarjan's algorithm to avoid blowing the JS
+ * call stack on very wide graphs.
+ */
+export declare const stronglyConnectedComponents: (nodes: Iterable<string>, successors: (node: string) => Iterable<string>) => string[][];
 /**
  * Compute the set of graph nodes that participate in a dependency cycle.
  *
  * A node is considered "in a cycle" iff it sits in a strongly-connected
  * component (SCC) of size > 1, or has a self-edge (size-1 SCC that loops
  * back to itself).
- *
- * Implementation is iterative Tarjan's algorithm to avoid blowing the JS
- * call stack on very wide graphs.
  */
 export declare const findCycleMembers: (edges: Record<string, readonly string[]>) => Set<string>;
 //# sourceMappingURL=scc.d.ts.map

package/lib/Util/scc.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scc.d.ts","sourceRoot":"","sources":["../../src/Util/scc.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,eAAO,MAAM,gBAAgB,UACpB,MAAM,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,KACvC,GAAG,CAAC,MAAM,CA4EZ,CAAC"}
+{"version":3,"file":"scc.d.ts","sourceRoot":"","sources":["../../src/Util/scc.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,eAAO,MAAM,2BAA2B,UAC/B,QAAQ,CAAC,MAAM,CAAC,cACX,CAAC,IAAI,EAAE,MAAM,KAAK,QAAQ,CAAC,MAAM,CAAC,KAC7C,MAAM,EAAE,EAmEV,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,UACpB,MAAM,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,KACvC,GAAG,CAAC,MAAM,CAiBZ,CAAC"}

package/lib/Util/scc.js

@@ -1,15 +1,15 @@
 /**
- * Compute the set of graph nodes that participate in a dependency cycle.
+ * Compute the strongly-connected components of a directed graph.
  *
- * A node is considered "in a cycle" iff it sits in a strongly-connected
- * component (SCC) of size > 1, or has a self-edge (size-1 SCC that loops
- * back to itself).
+ * Components are emitted in Tarjan completion order — the reverse
+ * topological order of the condensation, so a component appears before
+ * every component that has an edge into it.
  *
  * Implementation is iterative Tarjan's algorithm to avoid blowing the JS
  * call stack on very wide graphs.
  */
-export const findCycleMembers = (edges) => {
-    const cycleMembers = new Set();
+export const stronglyConnectedComponents = (nodes, successors) => {
+    const output = [];
     let index = 0;
     const indexOf = new Map();
     const lowlink = new Map();
@@ -22,17 +22,16 @@ export const findCycleMembers = (edges) => {
         index += 1;
         stack.push(node);
         onStack.add(node);
-        callStack.push({ node, childIdx: 0 });
+        callStack.push({ node, children: [...successors(node)], childIdx: 0 });
     };
-    for (const root of Object.keys(edges)) {
+    for (const root of nodes) {
         if (indexOf.has(root))
             continue;
         startNode(root);
         while (callStack.length > 0) {
             const frame = callStack[callStack.length - 1];
-            const children = edges[frame.node] ?? [];
-            if (frame.childIdx < children.length) {
-                const child = children[frame.childIdx];
+            if (frame.childIdx < frame.children.length) {
+                const child = frame.children[frame.childIdx];
                 frame.childIdx += 1;
                 if (!indexOf.has(child)) {
                     startNode(child);
@@ -53,17 +52,7 @@ export const findCycleMembers = (edges) => {
                     if (w === frame.node)
                         break;
                 }
-                if (scc.length > 1) {
-                    for (const fqn of scc)
-                        cycleMembers.add(fqn);
-                }
-                else {
-                    // Size-1 SCC: only counts as a cycle if it has a self-edge.
-                    const only = scc[0];
-                    if ((edges[only] ?? []).includes(only)) {
-                        cycleMembers.add(only);
-                    }
-                }
+                output.push(scc);
             }
             // Pop frame and propagate lowlink up to the parent.
             callStack.pop();
@@ -76,6 +65,30 @@ export const findCycleMembers = (edges) => {
             }
         }
     }
+    return output;
+};
+/**
+ * Compute the set of graph nodes that participate in a dependency cycle.
+ *
+ * A node is considered "in a cycle" iff it sits in a strongly-connected
+ * component (SCC) of size > 1, or has a self-edge (size-1 SCC that loops
+ * back to itself).
+ */
+export const findCycleMembers = (edges) => {
+    const cycleMembers = new Set();
+    for (const scc of stronglyConnectedComponents(Object.keys(edges), (node) => edges[node] ?? [])) {
+        if (scc.length > 1) {
+            for (const fqn of scc)
+                cycleMembers.add(fqn);
+        }
+        else {
+            // Size-1 SCC: only counts as a cycle if it has a self-edge.
+            const only = scc[0];
+            if ((edges[only] ?? []).includes(only)) {
+                cycleMembers.add(only);
+            }
+        }
+    }
     return cycleMembers;
 };
 //# sourceMappingURL=scc.js.map