@elizaos/agent 2.0.0-beta.2 → 2.0.11-beta.5

package/tui/agent-terminal-tui.js

@@ -0,0 +1,416 @@
+import { resolveApiBindHost, resolveDesktopApiPort, resolveServerOnlyPort, } from "@elizaos/shared";
+import { ansi, CombinedAutocompleteProvider, darkTheme, Editor, getTerminalView, hasTerminalView, ProcessTerminal, SelectList, TUI, truncateToWidth, } from "@elizaos/tui";
+import { matchSlashInput, resolveSlashDispatch, toSlashCommands, } from "./slash-commands.js";
+import { isTerminalTuiEnabled } from "./tui-enabled.js";
+const selectTheme = {
+    selectedPrefix: ansi.cyan,
+    selectedText: ansi.cyan,
+    description: ansi.dim,
+    scrollInfo: ansi.dim,
+    noMatch: ansi.dim,
+};
+const editorTheme = {
+    borderColor: darkTheme.colors.border,
+    selectList: selectTheme,
+};
+function resolveDefaultApiBaseUrl() {
+    const host = resolveApiBindHost(process.env);
+    const port = process.env.ELIZA_API_PORT
+        ? resolveDesktopApiPort(process.env)
+        : resolveServerOnlyPort(process.env);
+    const displayHost = host === "0.0.0.0" || host === "::" ? "127.0.0.1" : host;
+    return `http://${displayHost}:${port}`;
+}
+async function readJson(fetchImpl, apiBaseUrl, path, init) {
+    const response = await fetchImpl(new URL(path, apiBaseUrl), {
+        ...init,
+        headers: {
+            "Content-Type": "application/json",
+            ...init?.headers,
+        },
+    });
+    if (!response.ok) {
+        throw new Error(`${path} returned HTTP ${response.status}`);
+    }
+    return (await response.json());
+}
+class AgentTerminalView {
+    tui;
+    apiBaseUrl;
+    fetchImpl;
+    onExit;
+    views = [];
+    selectedView = null;
+    status = "starting terminal tui";
+    mode = "views";
+    /** The registered terminal view rendered inline in `detail` mode. */
+    detailView = null;
+    searchQuery = "";
+    viewList = new SelectList([], 12, selectTheme);
+    chatInput;
+    commands = [];
+    conversationId = null;
+    lastChatLine = "No terminal chat sent yet.";
+    constructor(tui, apiBaseUrl, fetchImpl, onExit) {
+        this.tui = tui;
+        this.apiBaseUrl = apiBaseUrl;
+        this.fetchImpl = fetchImpl;
+        this.onExit = onExit;
+        this.chatInput = new Editor(tui, editorTheme, { paddingX: 0 });
+        this.viewList.onSelect = (item) => {
+            const view = this.views.find((candidate) => candidate.id === item.value);
+            if (view)
+                void this.openView(view);
+        };
+        this.viewList.onSelectionChange = (item) => {
+            this.selectedView =
+                this.views.find((candidate) => candidate.id === item.value) ?? null;
+            this.tui.requestRender();
+        };
+        this.chatInput.onSubmit = (value) => {
+            void this.sendChat(value);
+        };
+    }
+    async start() {
+        await Promise.all([this.refreshViews(), this.refreshCommands()]);
+    }
+    async refreshCommands() {
+        try {
+            const data = await readJson(this.fetchImpl, this.apiBaseUrl, "/api/commands?surface=tui");
+            this.commands = data.commands ?? [];
+            this.chatInput.setAutocompleteProvider(new CombinedAutocompleteProvider(toSlashCommands(this.commands)));
+        }
+        catch {
+            // A missing catalog (older backend, command plugin disabled) leaves the
+            // composer working as a plain message input — slash text is still sent
+            // to the agent verbatim by sendChat.
+            this.commands = [];
+        }
+    }
+    async refreshViews() {
+        this.status = "refreshing tui views";
+        this.tui.requestRender();
+        try {
+            const data = await readJson(this.fetchImpl, this.apiBaseUrl, "/api/views?viewType=tui");
+            this.views = (data.views ?? []).filter((view) => view.viewType === "tui");
+            const items = this.views.map((view, index) => {
+                // A registered terminal view renders its real content inline here;
+                // others can only navigate the GUI shell.
+                const renderable = hasTerminalView(view.id);
+                return {
+                    value: view.id,
+                    label: `${index + 1}. ${view.label}${renderable ? " ▣" : ""}`,
+                    description: renderable
+                        ? "renders inline · enter to open"
+                        : (view.path ?? `/${view.id}/tui`),
+                };
+            });
+            this.viewList.setItems(items);
+            this.selectedView = this.views[0] ?? null;
+            this.status =
+                this.views.length > 0
+                    ? `${this.views.length} tui views ready`
+                    : "no tui views registered";
+        }
+        catch (error) {
+            this.status =
+                error instanceof Error ? error.message : "failed to refresh tui views";
+        }
+        finally {
+            this.tui.requestRender();
+        }
+    }
+    render(width) {
+        if (this.mode === "detail" && this.detailView) {
+            const header = [
+                ansi.bold(`elizaOS terminal tui · ${this.selectedView?.label ?? "view"}`),
+                ansi.dim("esc/q returns to views · this is the live view render"),
+                "",
+            ];
+            const body = this.detailView.render(width);
+            return [...header, ...body].map((line) => truncateToWidth(line, width));
+        }
+        const selected = this.selectedView
+            ? `${this.selectedView.label} (${this.selectedView.path ?? this.selectedView.id})`
+            : "none";
+        const lines = [
+            ansi.bold("elizaOS terminal tui"),
+            ansi.dim(`api ${this.apiBaseUrl}`),
+            `status: ${this.status}`,
+            `selected: ${selected}`,
+            "",
+            "shortcuts: ↑/↓ select  enter open  1-9 quick-open  r refresh  / search  c chat  q quit",
+            "chat: type after pressing c, enter sends, esc returns to views",
+            "",
+        ];
+        if (this.mode === "chat") {
+            const hint = this.commands.length > 0
+                ? ansi.dim("type / for commands · enter sends · esc returns to views")
+                : ansi.dim("enter sends · esc returns to views");
+            lines.push(ansi.cyan("chat composer"), this.lastChatLine, hint, "");
+            lines.push(...this.chatInput.render(width));
+            // Guard every line to the terminal width — the TUI render loop throws on
+            // any overflow (e.g. the shortcuts line on an 80-col terminal).
+            return lines.map((line) => truncateToWidth(line, width));
+        }
+        if (this.mode === "search") {
+            lines.push(ansi.cyan("search views"), `filter: ${this.searchQuery || ansi.dim("(type to filter)")}`, ansi.dim("enter opens highlighted view; esc clears search"), "");
+        }
+        lines.push(ansi.cyan("registered tui views"));
+        lines.push(...this.viewList.render(width));
+        return lines.map((line) => truncateToWidth(line, width));
+    }
+    handleInput(data) {
+        if (this.mode === "detail") {
+            // Esc / q / Ctrl+C return to the view list; everything else drives the
+            // inline view so it stays interactive.
+            if (data === "" || data === "q" || data === "") {
+                this.mode = "views";
+                this.detailView = null;
+                this.status = `${this.views.length} tui views ready`;
+                this.tui.requestRender();
+                return;
+            }
+            this.detailView?.handleInput?.(data);
+            this.tui.requestRender();
+            return;
+        }
+        if (this.mode === "chat") {
+            this.handleChatInput(data);
+            return;
+        }
+        if (this.mode === "search") {
+            this.handleSearchInput(data);
+            return;
+        }
+        if (data === "\u0003" || data === "q") {
+            this.onExit?.();
+            return;
+        }
+        if (data === "r") {
+            void this.refreshViews();
+            return;
+        }
+        if (data === "c") {
+            this.enterChatMode();
+            return;
+        }
+        // Bare `/` enters view-search mode (a top-level keybinding). The Editor's
+        // own `/`-at-line-start slash menu lives inside the composer and only
+        // fires once chat mode owns the input, so the two never collide.
+        if (data === "/") {
+            this.mode = "search";
+            this.status = "filtering tui views";
+            this.tui.requestRender();
+            return;
+        }
+        if (/^[1-9]$/u.test(data)) {
+            const index = Number.parseInt(data, 10) - 1;
+            const view = this.views[index];
+            if (view)
+                void this.openView(view);
+            return;
+        }
+        this.viewList.handleInput(data);
+    }
+    enterChatMode() {
+        this.mode = "chat";
+        // Keep focus on the view so Escape/Ctrl+C can return to views; the Editor
+        // renders its cursor off its own `focused` flag, which we drive manually.
+        this.chatInput.focused = true;
+        this.tui.requestRender();
+    }
+    exitChatMode() {
+        this.mode = "views";
+        this.chatInput.focused = false;
+        this.tui.requestRender();
+    }
+    handleChatInput(data) {
+        // Escape with an open dropdown closes the dropdown (handled by the Editor)
+        // rather than exiting chat mode, so one Escape doesn't do two things.
+        if (data === "\u001b" && this.chatInput.isShowingAutocomplete()) {
+            this.chatInput.handleInput(data);
+            this.tui.requestRender();
+            return;
+        }
+        // Escape (no dropdown) and Ctrl+C return to the view list instead of
+        // tearing down the whole TUI.
+        if (data === "\u001b" || data === "\u0003") {
+            this.exitChatMode();
+            return;
+        }
+        this.chatInput.handleInput(data);
+        this.tui.requestRender();
+    }
+    invalidate() {
+        this.viewList.invalidate();
+    }
+    async openView(view) {
+        this.selectedView = view;
+        // A plugin-registered terminal view renders its real content inline — the
+        // first time a `viewType: "tui"` view actually renders in the terminal,
+        // rather than only navigating the GUI shell.
+        const registered = getTerminalView(view.id);
+        if (registered) {
+            this.detailView = registered;
+            this.mode = "detail";
+            this.status = `viewing ${view.label}`;
+            this.tui.requestRender();
+            return;
+        }
+        this.status = `opening ${view.label}`;
+        this.tui.requestRender();
+        try {
+            await readJson(this.fetchImpl, this.apiBaseUrl, `/api/views/${encodeURIComponent(view.id)}/navigate?viewType=tui`, { method: "POST", body: JSON.stringify({ viewType: "tui" }) });
+            this.status = `opened ${view.label}`;
+        }
+        catch (error) {
+            this.status =
+                error instanceof Error ? error.message : `failed to open ${view.label}`;
+        }
+        finally {
+            this.tui.requestRender();
+        }
+    }
+    handleSearchInput(data) {
+        if (data === "\u001b") {
+            this.mode = "views";
+            this.searchQuery = "";
+            this.viewList.setFilter("");
+            this.status = `${this.views.length} tui views ready`;
+            this.tui.requestRender();
+            return;
+        }
+        if (data === "\r" || data === "\n") {
+            const selected = this.viewList.getSelectedItem();
+            const view = selected
+                ? this.views.find((candidate) => candidate.id === selected.value)
+                : null;
+            this.mode = "views";
+            if (view)
+                void this.openView(view);
+            return;
+        }
+        if (data === "\u007f" || data === "\b") {
+            this.searchQuery = this.searchQuery.slice(0, -1);
+            this.viewList.setFilter(this.searchQuery);
+            this.tui.requestRender();
+            return;
+        }
+        if (data === "\u0003") {
+            this.onExit?.();
+            return;
+        }
+        if (/^[ -~]+$/u.test(data)) {
+            this.searchQuery += data;
+            this.viewList.setFilter(this.searchQuery);
+            this.tui.requestRender();
+            return;
+        }
+        this.viewList.handleInput(data);
+    }
+    async ensureConversation() {
+        if (this.conversationId)
+            return this.conversationId;
+        const data = await readJson(this.fetchImpl, this.apiBaseUrl, "/api/conversations", {
+            method: "POST",
+            body: JSON.stringify({
+                title: "SSH terminal",
+                metadata: { source: "terminal-tui" },
+            }),
+        });
+        const id = data.conversation?.id;
+        if (!id)
+            throw new Error("conversation create returned no id");
+        this.conversationId = id;
+        return id;
+    }
+    async sendChat(value) {
+        const text = value.trim();
+        // The Editor self-clears on submit; this guards the rare empty submit.
+        if (!text)
+            return;
+        const match = matchSlashInput(this.commands, text);
+        if (match) {
+            const dispatch = resolveSlashDispatch(match, text);
+            switch (dispatch.kind) {
+                case "clear":
+                    this.lastChatLine = "No terminal chat sent yet.";
+                    this.conversationId = null;
+                    this.tui.requestRender();
+                    return;
+                case "new":
+                    this.conversationId = null;
+                    this.lastChatLine = "started a new conversation";
+                    this.tui.requestRender();
+                    return;
+                case "navigate-view": {
+                    const view = this.views.find((v) => v.id === dispatch.viewId);
+                    if (view) {
+                        this.lastChatLine = `you: ${text}`;
+                        await this.openView(view);
+                    }
+                    else {
+                        this.lastChatLine = `unknown view: ${dispatch.viewId}`;
+                        this.tui.requestRender();
+                    }
+                    return;
+                }
+                case "send":
+                    await this.sendMessage(dispatch.text);
+                    return;
+            }
+        }
+        await this.sendMessage(text);
+    }
+    async sendMessage(text) {
+        this.lastChatLine = `you: ${text}`;
+        this.tui.requestRender();
+        try {
+            const conversationId = await this.ensureConversation();
+            await readJson(this.fetchImpl, this.apiBaseUrl, `/api/conversations/${conversationId}/messages`, {
+                method: "POST",
+                body: JSON.stringify({
+                    text,
+                    channelType: "DM",
+                    source: "terminal-tui",
+                    metadata: {
+                        viewId: this.selectedView?.id,
+                        viewType: "tui",
+                    },
+                }),
+            });
+            this.lastChatLine = `sent: ${text}`;
+        }
+        catch (error) {
+            this.lastChatLine =
+                error instanceof Error
+                    ? `chat failed: ${error.message}`
+                    : "chat failed";
+        }
+        finally {
+            this.tui.requestRender();
+        }
+    }
+}
+export function startAgentTerminalTui(options = {}) {
+    if (!options.terminal && !isTerminalTuiEnabled())
+        return null;
+    const terminal = options.terminal ?? new ProcessTerminal();
+    const tui = new TUI(terminal);
+    const view = new AgentTerminalView(tui, options.apiBaseUrl ?? resolveDefaultApiBaseUrl(), options.fetchImpl ?? fetch, () => handle.stop());
+    const handle = {
+        stop: () => {
+            tui.stop();
+            options.onExit?.();
+        },
+        ready: view.start(),
+    };
+    tui.addChild(view);
+    tui.setFocus(view);
+    tui.start();
+    handle.ready.catch(() => {
+        tui.requestRender();
+    });
+    return handle;
+}

package/tui/slash-commands.d.ts

@@ -0,0 +1,107 @@
+/**
+ * Pure helpers that bridge the universal slash-command catalog (served by
+ * `GET /api/commands?surface=tui`) into the terminal composer.
+ *
+ * The catalog item shape mirrors the server's `SerializedCommand`
+ * (@elizaos/plugin-commands). We keep a local copy of the transport type so
+ * the TUI does not take a runtime dependency on the commands plugin, matching
+ * how the web client (`@elizaos/ui` `client-types-commands`) keeps its own.
+ *
+ * Everything here is pure (no terminal, no I/O) so it is unit-testable. The
+ * side effects (HTTP, transcript mutation) live in `agent-terminal-tui.ts`.
+ */
+import type { SlashCommand } from "@elizaos/tui";
+export type CommandSurface = "gui" | "tui" | "discord" | "telegram";
+export type CommandArgSource = "models" | "views" | "settings-sections" | "skills" | "providers";
+export type ClientCommandAction = "clear-chat" | "new-conversation" | "toggle-fullscreen" | "open-command-palette" | "show-commands";
+export interface SerializedCommandArg {
+    name: string;
+    description: string;
+    required?: boolean;
+    choices?: string[];
+    dynamicChoices?: CommandArgSource;
+    captureRemaining?: boolean;
+}
+export type SerializedCommandTarget = {
+    kind: "agent";
+    action?: string;
+} | {
+    kind: "navigate";
+    tab?: string;
+    viewId?: string;
+    path?: string;
+    section?: string;
+} | {
+    kind: "client";
+    clientAction: ClientCommandAction;
+};
+export interface SerializedCommand {
+    key: string;
+    nativeName: string;
+    description: string;
+    textAliases: string[];
+    scope: "text" | "native" | "both";
+    category?: string;
+    acceptsArgs: boolean;
+    args: SerializedCommandArg[];
+    requiresAuth: boolean;
+    requiresElevated: boolean;
+    surfaces?: CommandSurface[];
+    target: SerializedCommandTarget;
+    icon?: string;
+}
+export interface CommandsCatalogResponse {
+    commands: SerializedCommand[];
+    surface: string | null;
+    agentId: string | null;
+    generatedAt: string;
+}
+/**
+ * The display name for a command (no leading slash). Prefers the first text
+ * alias the user actually types (e.g. `/help` → `help`) and falls back to the
+ * native name. This is what the autocomplete dropdown shows and what the
+ * Editor inserts as `/<name> `.
+ */
+export declare function commandName(command: SerializedCommand): string;
+/**
+ * Map a serialized catalog command to the tui `SlashCommand` the
+ * `CombinedAutocompleteProvider` expects. Argument completions are wired only
+ * when the command exposes a single first argument with static `choices`
+ * (the autocomplete provider has no live-source resolution, so dynamic-only
+ * args contribute no suggestions).
+ */
+export declare function toSlashCommand(command: SerializedCommand): SlashCommand;
+/** Map the whole catalog to tui slash commands, preserving catalog order. */
+export declare function toSlashCommands(commands: SerializedCommand[]): SlashCommand[];
+/**
+ * Match a submitted draft against the catalog by its command token. Returns
+ * the matching command and the remaining argument string, or `null` when the
+ * draft is not a recognized slash command.
+ */
+export interface ParsedSlashInput {
+    command: SerializedCommand;
+    args: string;
+}
+export declare function matchSlashInput(commands: SerializedCommand[], text: string): ParsedSlashInput | null;
+/**
+ * What dispatching a matched command should do in the terminal. Pure decision
+ * that the TUI executes — keeps the side-effect-free routing testable.
+ *
+ * - `send` — forward the literal slash text to the agent over the message API.
+ * - `navigate-view` — open a view via the existing `/api/views/:id/navigate`
+ *   path (only when we can resolve a concrete view id).
+ * - `clear` / `new` — local transcript / conversation behavior.
+ */
+export type SlashDispatch = {
+    kind: "send";
+    text: string;
+} | {
+    kind: "navigate-view";
+    viewId: string;
+} | {
+    kind: "clear";
+} | {
+    kind: "new";
+};
+export declare function resolveSlashDispatch(parsed: ParsedSlashInput, text: string): SlashDispatch;
+//# sourceMappingURL=slash-commands.d.ts.map

package/tui/slash-commands.d.ts.map

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

package/tui/slash-commands.js

@@ -0,0 +1,108 @@
+/**
+ * Pure helpers that bridge the universal slash-command catalog (served by
+ * `GET /api/commands?surface=tui`) into the terminal composer.
+ *
+ * The catalog item shape mirrors the server's `SerializedCommand`
+ * (@elizaos/plugin-commands). We keep a local copy of the transport type so
+ * the TUI does not take a runtime dependency on the commands plugin, matching
+ * how the web client (`@elizaos/ui` `client-types-commands`) keeps its own.
+ *
+ * Everything here is pure (no terminal, no I/O) so it is unit-testable. The
+ * side effects (HTTP, transcript mutation) live in `agent-terminal-tui.ts`.
+ */
+/**
+ * The display name for a command (no leading slash). Prefers the first text
+ * alias the user actually types (e.g. `/help` → `help`) and falls back to the
+ * native name. This is what the autocomplete dropdown shows and what the
+ * Editor inserts as `/<name> `.
+ */
+export function commandName(command) {
+    const firstAlias = command.textAliases[0];
+    if (firstAlias)
+        return firstAlias.replace(/^\//, "");
+    return command.nativeName;
+}
+/**
+ * Map a serialized catalog command to the tui `SlashCommand` the
+ * `CombinedAutocompleteProvider` expects. Argument completions are wired only
+ * when the command exposes a single first argument with static `choices`
+ * (the autocomplete provider has no live-source resolution, so dynamic-only
+ * args contribute no suggestions).
+ */
+export function toSlashCommand(command) {
+    const name = commandName(command);
+    const slash = {
+        name,
+        description: command.description,
+    };
+    const firstArg = command.args[0];
+    const choices = firstArg?.choices;
+    if (choices && choices.length > 0) {
+        slash.getArgumentCompletions = (argumentPrefix) => {
+            const query = argumentPrefix.trim().toLowerCase();
+            const matched = query
+                ? choices.filter((choice) => choice.toLowerCase().includes(query))
+                : choices;
+            if (matched.length === 0)
+                return null;
+            return matched.map((choice) => ({ value: choice, label: choice }));
+        };
+    }
+    return slash;
+}
+/** Map the whole catalog to tui slash commands, preserving catalog order. */
+export function toSlashCommands(commands) {
+    return commands.map(toSlashCommand);
+}
+export function matchSlashInput(commands, text) {
+    const trimmed = text.trim();
+    if (!trimmed.startsWith("/"))
+        return null;
+    const body = trimmed.slice(1);
+    const firstSpace = body.indexOf(" ");
+    const token = (firstSpace === -1 ? body : body.slice(0, firstSpace))
+        .trim()
+        .toLowerCase();
+    if (!token)
+        return null;
+    const args = firstSpace === -1 ? "" : body.slice(firstSpace + 1).trim();
+    const aliasTarget = `/${token}`;
+    const command = commands.find((candidate) => candidate.nativeName.toLowerCase() === token ||
+        candidate.key.toLowerCase() === token ||
+        candidate.textAliases.some((alias) => alias.toLowerCase() === aliasTarget));
+    if (!command)
+        return null;
+    return { command, args };
+}
+export function resolveSlashDispatch(parsed, text) {
+    const { command, args } = parsed;
+    const target = command.target;
+    if (target.kind === "client") {
+        if (target.clientAction === "clear-chat")
+            return { kind: "clear" };
+        if (target.clientAction === "new-conversation")
+            return { kind: "new" };
+        // No terminal behavior for fullscreen/palette/show-commands — let the
+        // agent answer (e.g. /help renders its own reply).
+        return { kind: "send", text: text.trim() };
+    }
+    if (target.kind === "navigate") {
+        // A view-scoped navigation we can act on locally. A bare `/views <id>`
+        // resolves the id from the first argument; a pinned `viewId` wins.
+        const viewId = target.viewId ??
+            (commandHasArgSource(command, "views") && args
+                ? args.split(/\s+/)[0]
+                : undefined);
+        if (viewId)
+            return { kind: "navigate-view", viewId };
+        // Tab/section/settings navigation has no terminal equivalent — surface the
+        // command to the agent so it can guide the user.
+        return { kind: "send", text: text.trim() };
+    }
+    // Agent target (the default) — send the literal slash text; an action
+    // handler produces the reply.
+    return { kind: "send", text: text.trim() };
+}
+function commandHasArgSource(command, source) {
+    return command.args.some((arg) => arg.dynamicChoices === source);
+}

package/tui/tui-enabled.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Whether the interactive terminal TUI should run. Kept in its own module
+ * (no `@elizaos/tui` import) so callers can decide *before* importing the
+ * TUI surface — server-only / cloud containers have no TTY and may ship
+ * without `@elizaos/tui` bundled, where importing it would crash boot.
+ */
+export declare function isTerminalTuiEnabled(): boolean;
+//# sourceMappingURL=tui-enabled.d.ts.map

package/tui/tui-enabled.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tui-enabled.d.ts","sourceRoot":"","sources":["../../src/tui/tui-enabled.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,wBAAgB,oBAAoB,IAAI,OAAO,CAQ9C"}

package/tui/tui-enabled.js

@@ -0,0 +1,17 @@
+/**
+ * Whether the interactive terminal TUI should run. Kept in its own module
+ * (no `@elizaos/tui` import) so callers can decide *before* importing the
+ * TUI surface — server-only / cloud containers have no TTY and may ship
+ * without `@elizaos/tui` bundled, where importing it would crash boot.
+ */
+export function isTerminalTuiEnabled() {
+    const value = process.env.ELIZA_TERMINAL_TUI?.trim().toLowerCase();
+    if (value === "0" || value === "false" || value === "off")
+        return false;
+    if (value === "1" || value === "true" || value === "on")
+        return true;
+    if (process.env.CI === "true" || process.env.NODE_ENV === "test") {
+        return false;
+    }
+    return Boolean(process.stdin.isTTY && process.stdout.isTTY);
+}

package/types/agent-skills.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-skills.d.ts","sourceRoot":"","sources":["../../src/types/agent-skills.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,sBAAsB;IACrC,eAAe,IAAI,KAAK,CAAC;QACvB,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC,CAAC;IACH,oBAAoB,CAClB,IAAI,EAAE,MAAM,GACX;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,eAAe,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;CACnE"}

package/types/config-like.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-like.d.ts","sourceRoot":"","sources":["../../src/types/config-like.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,oBAAoB;IACnC,KAAK,CAAC,EAAE;QACN,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC;CACH;AAED,MAAM,WAAW,oBAAoB;IACnC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB"}

package/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC"}