sonex-agent 0.1.0-alpha.1

package/dist/hooks.js

@@ -0,0 +1,216 @@
+import React from 'react';
+import WebSocket from 'ws';
+import terminalImage from 'terminal-image';
+import { API_NOT_RUNNING_DETAIL, API_NOT_RUNNING_MESSAGE } from './constants.js';
+export const PLAYBACK_PROGRESS_INTERVAL_MS = 1000;
+export function isPlaybackStarting(player) {
+    return player.playback_status === "starting";
+}
+export function isPlaybackProgressFrozen(player) {
+    return isPlaybackStarting(player)
+        || player.progress_sync_lost === true
+        || player.paused_for_cache === true;
+}
+/**
+ * Coordinates the should use playback progress timer operation for the CLI UI runtime.
+ *
+ * @param player Input value used by the should use playback progress timer operation.
+ * @param active Input value used by the should use playback progress timer operation.
+ * @returns The computed result for the surrounding CLI UI flow.
+ */
+export function shouldUsePlaybackProgressTimer(player, active = true) {
+    return active
+        && player.is_playing === true
+        && !isPlaybackProgressFrozen(player);
+}
+/**
+ * Coordinates the playback progress at operation for the CLI UI runtime.
+ *
+ * @param player Input value used by the playback progress at operation.
+ * @param now Input value used by the playback progress at operation.
+ * @returns The computed result for the surrounding CLI UI flow.
+ */
+export function playbackProgressAt(player, now) {
+    const base = player.progress_ms ?? 0;
+    if (isPlaybackProgressFrozen(player))
+        return base;
+    const reference = player.progress_anchor_ms ?? player.timestamp ?? player.started_at;
+    const liveOffset = player.is_playing && reference ? Math.max(0, now - reference) : 0;
+    const progress = base + liveOffset;
+    return player.duration_ms > 0 ? Math.min(player.duration_ms, progress) : progress;
+}
+/**
+ * Coordinates the use playback progress operation for the CLI UI runtime.
+ *
+ * @param player Input value used by the use playback progress operation.
+ * @param active Input value used by the use playback progress operation.
+ * @returns The computed result for the surrounding CLI UI flow.
+ */
+export function usePlaybackProgress(player, active = true) {
+    const [now, setNow] = React.useState(Date.now());
+    React.useEffect(() => {
+        if (!shouldUsePlaybackProgressTimer(player, active)) {
+            setNow(Date.now());
+            return;
+        }
+        const timer = setInterval(() => setNow(Date.now()), PLAYBACK_PROGRESS_INTERVAL_MS);
+        return () => clearInterval(timer);
+    }, [
+        active,
+        player.is_playing,
+        player.paused_for_cache,
+        player.progress_anchor_ms,
+        player.progress_ms,
+        player.progress_sync_lost,
+        player.started_at,
+        player.timestamp,
+    ]);
+    return playbackProgressAt(player, now);
+}
+/**
+ * Coordinates the use cover art operation for the CLI UI runtime.
+ *
+ * @param url Input value used by the use cover art operation.
+ * @param width Input value used by the use cover art operation.
+ * @param height Input value used by the use cover art operation.
+ * @returns The computed result for the surrounding CLI UI flow.
+ */
+export function useCoverArt(url, width = 32, height = 16) {
+    const [art, setArt] = React.useState(null);
+    const [failed, setFailed] = React.useState(false);
+    React.useEffect(() => {
+        if (!url) {
+            setArt(null);
+            setFailed(false);
+            return;
+        }
+        let cancelled = false;
+        setArt(null);
+        setFailed(false);
+        const load = async () => {
+            const start = Date.now();
+            try {
+                const response = await fetch(url);
+                if (!response.ok) {
+                    throw new Error(`HTTP ${response.status}`);
+                }
+                const fetchedAt = Date.now();
+                const arrayBuffer = await response.arrayBuffer();
+                const rendered = await terminalImage.buffer(Buffer.from(arrayBuffer), {
+                    width,
+                    height,
+                    preserveAspectRatio: true,
+                });
+                if (process.env.SONEX_PLAYER_DEBUG === '1') {
+                    const decodedAt = Date.now();
+                    console.error(`[sonex-player-debug] cover fetch ${fetchedAt - start}ms decode ${decodedAt - fetchedAt}ms url=${url}`);
+                }
+                if (!cancelled) {
+                    setArt(rendered);
+                }
+            }
+            catch (err) {
+                if (process.env.SONEX_PLAYER_DEBUG === '1') {
+                    const detail = err instanceof Error ? err.message : String(err);
+                    console.error(`[sonex-player-debug] cover fetch/decode failed after ${Date.now() - start}ms: ${detail}`);
+                }
+                if (!cancelled) {
+                    setFailed(true);
+                }
+            }
+        };
+        void load();
+        return () => {
+            cancelled = true;
+        };
+    }, [url, width, height]);
+    return { art, failed };
+}
+/**
+ * Coordinates the is http cover source operation for the CLI UI runtime.
+ *
+ * @param url Input value used by the is http cover source operation.
+ * @returns The computed result for the surrounding CLI UI flow.
+ */
+export function isHttpCoverSource(url) {
+    return Boolean(url && /^https?:\/\//i.test(url));
+}
+/**
+ * Coordinates the use latest callback operation for the CLI UI runtime.
+ *
+ * @param callback Input value used by the use latest callback operation.
+ * @returns The computed result for the surrounding CLI UI flow.
+ */
+export function useLatestCallback(callback) {
+    const ref = React.useRef(callback);
+    React.useEffect(() => {
+        ref.current = callback;
+    }, [callback]);
+    return ref;
+}
+/**
+ * Coordinates the use sonex socket operation for the CLI UI runtime.
+ *
+ * @param url,onEvent,onConnectionChange,onClientError Input value used by the use sonex socket operation.
+ * @returns The computed result for the surrounding CLI UI flow.
+ */
+export function useSonexSocket({ url, onEvent, onConnectionChange, onClientError }) {
+    const wsRef = React.useRef(null);
+    const onEventRef = useLatestCallback(onEvent);
+    const onConnectionChangeRef = useLatestCallback(onConnectionChange);
+    const onClientErrorRef = useLatestCallback(onClientError);
+    React.useEffect(() => {
+        let closedByUser = false;
+        let connectionErrorShown = false;
+        let reconnectTimer = null;
+        const connect = () => {
+            const ws = new WebSocket(url);
+            wsRef.current = ws;
+            ws.onopen = () => {
+                connectionErrorShown = false;
+                onConnectionChangeRef.current?.(true);
+            };
+            ws.onclose = () => {
+                onConnectionChangeRef.current?.(false);
+                if (!closedByUser) {
+                    reconnectTimer = setTimeout(connect, 1500);
+                }
+            };
+            ws.onerror = (err) => {
+                onConnectionChangeRef.current?.(false);
+                if (!connectionErrorShown) {
+                    const detail = err.message || undefined;
+                    onClientErrorRef.current?.(`${API_NOT_RUNNING_MESSAGE}. ${API_NOT_RUNNING_DETAIL}`, detail);
+                    connectionErrorShown = true;
+                }
+            };
+            ws.onmessage = (msg) => {
+                try {
+                    const data = JSON.parse(msg.data.toString());
+                    onEventRef.current(data);
+                }
+                catch (err) {
+                    const detail = err instanceof Error ? err.message : String(err);
+                    onClientErrorRef.current?.("Invalid server message", detail);
+                }
+            };
+        };
+        connect();
+        return () => {
+            closedByUser = true;
+            if (reconnectTimer) {
+                clearTimeout(reconnectTimer);
+            }
+            wsRef.current?.close();
+        };
+    }, [url]);
+    const send = React.useCallback((payload) => {
+        const ws = wsRef.current;
+        if (ws && ws.readyState === ws.OPEN) {
+            ws.send(JSON.stringify(payload));
+            return true;
+        }
+        return false;
+    }, []);
+    return { send };
+}

package/dist/i18n.js

@@ -0,0 +1,291 @@
+export const OFFICIAL_UI_LANGUAGE = "en";
+const messages = {
+    en: {
+        "activity.empty": "Waiting for agent activity.",
+        "api.notRunning.detail": "Start with `sonex`, or run `sonex api` before `sonex tui`.",
+        "api.notRunning.message": "Sonex API is not running",
+        "auth.oauth.return": "Complete the OAuth flow in your browser, then return here.",
+        "auth.oauth.waiting": "Waiting for browser authorization...",
+        "chat.empty": "No messages yet.",
+        "command.lang.description": "Choose the TUI display language.",
+        "help.empty": "No matching commands.",
+        "help.hint": "Use Up/Down to choose, Esc to close.",
+        "help.title": "Sonex commands",
+        "input.label": "Input",
+        "input.placeholder": "Ask Sonex anything.",
+        "input.recommendPending": "Waiting for recommendations...",
+        "language.english": "English",
+        "language.hint": "Esc to close without changing.",
+        "language.saveError": "Language changed for this session, but the setting was not saved.",
+        "language.saved": "Language set to {language}.",
+        "language.simplifiedChinese": "简体中文",
+        "language.title": "Language",
+        "launch.preparing": "Preparing playback",
+        "login.continue": "↑/↓ to select · Enter to continue · Esc to close",
+        "login.warmup": "Complete setup to continue.",
+        "methods.label": "Methods",
+        "panel.confirmHidden": "Confirmation panel hidden.",
+        "panel.helpHidden": "Help panel hidden.",
+        "panel.languageHidden": "Language panel hidden.",
+        "panel.modelHidden": "Model selection panel hidden.",
+        "panel.setupHidden": "Setup panel hidden.",
+        "panel.spotifySetupHidden": "Spotify setup panel hidden.",
+        "providers.label": "Providers",
+        "status.saving": "Saving session...",
+        "status.snoozing": "Idle...",
+        "tips.placeholder": "Tip: use /random to play a recent song.",
+        "trackPanel.playlist": "Playlist",
+        "trackPanel.playlistHidden": "Playlist panel hidden.",
+        "trackPanel.playlistEmpty": "Playlist is empty.",
+        "trackPanel.queue": "Queue",
+        "trackPanel.queueHidden": "Queue panel hidden.",
+        "trackPanel.queueEmpty": "Queue is empty.",
+    },
+    "zh-CN": {
+        "activity.empty": "等待代理活动。",
+        "api.notRunning.detail": "先运行 `sonex`，或在 `sonex tui` 前运行 `sonex api`。",
+        "api.notRunning.message": "Sonex API 未运行",
+        "auth.oauth.return": "在浏览器中完成 OAuth 流程，然后回到这里。",
+        "auth.oauth.waiting": "等待浏览器授权...",
+        "chat.empty": "还没有消息。",
+        "command.lang.description": "选择 TUI 显示语言。",
+        "help.empty": "没有匹配的命令。",
+        "help.hint": "使用上下键选择，Esc 关闭。",
+        "help.title": "Sonex 命令",
+        "input.label": "输入",
+        "input.placeholder": "和 Sonex 说点什么。",
+        "input.recommendPending": "等待Sonex推荐中...",
+        "language.english": "English",
+        "language.hint": "Esc 关闭且不更改。",
+        "language.saveError": "语言已在本会话切换，但设置未保存。",
+        "language.saved": "语言已设置为 {language}。",
+        "language.simplifiedChinese": "简体中文",
+        "language.title": "语言",
+        "launch.preparing": "启动准备中",
+        "login.continue": "↑/↓ to select · Enter to continue · Esc to close",
+        "login.warmup": "开始前先完成一个小设置。",
+        "methods.label": "方式",
+        "panel.confirmHidden": "确认面板已收起。",
+        "panel.helpHidden": "帮助面板已收起。",
+        "panel.languageHidden": "语言面板已收起。",
+        "panel.modelHidden": "模型选择面板已收起。",
+        "panel.setupHidden": "配置面板已收起。",
+        "panel.spotifySetupHidden": "Spotify 配置面板已收起。",
+        "providers.label": "服务",
+        "status.saving": "正在保存会话...",
+        "status.snoozing": "休眠中...",
+        "tips.placeholder": "提示：试试 /random 随机播放。",
+        "trackPanel.playlist": "歌单",
+        "trackPanel.playlistHidden": "歌单面板已收起。",
+        "trackPanel.playlistEmpty": "歌单为空。",
+        "trackPanel.queue": "播放队列",
+        "trackPanel.queueHidden": "播放队列已收起。",
+        "trackPanel.queueEmpty": "播放队列为空。",
+    },
+};
+const shortcutCommandDescriptions = {
+    bye: { en: "save and exit", "zh-CN": "保存会话并退出" },
+    help: { en: "show commands", "zh-CN": "显示可用的 Sonex 命令" },
+    info: { en: "show runtime info", "zh-CN": "显示当前运行信息" },
+    lang: { en: "choose display language", "zh-CN": "选择 TUI 显示语言" },
+    logout: { en: "sign out and exit", "zh-CN": "退出当前 LLM 服务登录并关闭" },
+    model: { en: "switch active model", "zh-CN": "切换当前模型" },
+    player: { en: "detect and set default player", "zh-CN": "检测并设置默认播放器" },
+    playlist: { en: "browse or save playlists", "zh-CN": "浏览或保存播放列表" },
+    queue: { en: "show playback queue", "zh-CN": "显示播放队列" },
+    quit: { en: "save and exit", "zh-CN": "保存会话并退出" },
+    random: { en: "play a recent song", "zh-CN": "从最近歌曲中播放" },
+    recommend: { en: "recommend songs", "zh-CN": "按偏好的音乐口味推荐歌曲" },
+    resume: { en: "resume playback", "zh-CN": "继续当前播放" },
+    sandbox: { en: "check Agent Bash sandbox", "zh-CN": "检查 Agent Bash 沙箱" },
+    spotify: { en: "toggle Spotify mode", "zh-CN": "进入或退出持久化 Spotify 模式" },
+};
+const helpCommandDescriptions = {
+    bye: { en: "save the current session and exit safely", "zh-CN": "保存会话并退出" },
+    exit: { en: "save the current session and exit safely", "zh-CN": "保存会话并退出" },
+    help: { en: "show available Sonex commands", "zh-CN": "显示可用的 Sonex 命令" },
+    info: { en: "show current runtime information", "zh-CN": "显示当前运行信息" },
+    lang: { en: "choose the TUI display language", "zh-CN": "选择 TUI 显示语言" },
+    logout: { en: "sign out from the current LLM provider and exit", "zh-CN": "退出当前 LLM 服务登录并关闭" },
+    model: { en: "switch the active model for this session", "zh-CN": "切换当前模型" },
+    player: { en: "detect available players and set the device default", "zh-CN": "检测可用播放器并设置设备默认值" },
+    playlist: { en: "browse playlists or save the current song", "zh-CN": "浏览或保存播放列表" },
+    queue: { en: "show the playback queue", "zh-CN": "显示播放队列" },
+    random: { en: "play a random song from the recent Sonex queue", "zh-CN": "从最近歌曲中播放" },
+    recommend: { en: "recommend songs based on a taste hint", "zh-CN": "按偏好的音乐口味推荐歌曲" },
+    resume: { en: "resume current local playback", "zh-CN": "继续当前播放" },
+    sandbox: { en: "check or configure the Agent Bash sandbox", "zh-CN": "检查或配置 Agent Bash 沙箱" },
+    spotify: { en: "enter or exit persistent Spotify mode", "zh-CN": "进入或退出持久化 Spotify 模式" },
+};
+const knownText = {
+    "Snoozing...": {
+        en: "Idle...",
+        "zh-CN": "休眠中...",
+    },
+    "Launch preparing...": {
+        en: "Preparing playback...",
+        "zh-CN": "启动准备中...",
+    },
+    "Sonex commands": {
+        en: "Sonex commands",
+        "zh-CN": "Sonex 命令",
+    },
+    "Use Up/Down to choose, Esc to close.": {
+        en: "Use Up/Down to choose, Esc to close.",
+        "zh-CN": "使用上下键选择，Esc 关闭。",
+    },
+    "Spotify setup": {
+        en: "Spotify setup",
+        "zh-CN": "Spotify 设置",
+    },
+    "Paste your Spotify client ID.": {
+        en: "Paste your Spotify client ID.",
+        "zh-CN": "粘贴你的 Spotify Client ID。",
+    },
+    "Spotify client ID": {
+        en: "Spotify client ID",
+        "zh-CN": "Spotify Client ID",
+    },
+    "The /lang command is handled by the TUI for this session.": {
+        en: "The /lang command is handled by the TUI for this session.",
+        "zh-CN": "/lang 命令由本次 TUI 会话处理。",
+    },
+    "Confirm player launch.": {
+        en: "Confirm player launch.",
+        "zh-CN": "确认启动播放器。",
+    },
+    "Allow Sonex to open mpv?": {
+        en: "Allow Sonex to open mpv?",
+        "zh-CN": "允许 Sonex 打开 mpv 吗？",
+    },
+    "YouTube playback is not configured. Open /extension to configure it.": {
+        en: "YouTube playback is not configured. Open /extension to configure it.",
+        "zh-CN": "YouTube 播放尚未配置，请打开 /extension 进行配置。",
+    },
+    "Another YouTube request is still running. Try again shortly.": {
+        en: "Another YouTube request is still running. Try again shortly.",
+        "zh-CN": "另一个 YouTube 请求仍在运行，请稍后再试。",
+    },
+    "Selected YouTube result requires age verification. Choose another candidate or refine the search.": {
+        en: "Selected YouTube result requires age verification. Choose another candidate or refine the search.",
+        "zh-CN": "所选 YouTube 结果需要年龄验证，请选择其他候选或优化搜索。",
+    },
+    "Selected YouTube result is not available. Choose another candidate or refine the search.": {
+        en: "Selected YouTube result is not available. Choose another candidate or refine the search.",
+        "zh-CN": "所选 YouTube 结果不可用，请选择其他候选或优化搜索。",
+    },
+    "YouTube is temporarily unavailable; playback is cooling down.": {
+        en: "YouTube is temporarily unavailable; playback is cooling down.",
+        "zh-CN": "YouTube 暂时不可用，播放正在进入冷却。",
+    },
+    "YouTube is temporarily unavailable; search is cooling down.": {
+        en: "YouTube is temporarily unavailable; search is cooling down.",
+        "zh-CN": "YouTube 暂时不可用，搜索正在进入冷却。",
+    },
+};
+const playerConfirmChoices = {
+    mpv: {
+        en: { label: "mpv", description: "default backend for smooth background playback" },
+        "zh-CN": { label: "mpv", description: "默认播放后端，提供更丝滑的播放体验" },
+    },
+    deny: {
+        en: { label: "Cancel" },
+        "zh-CN": { label: "取消" },
+    },
+};
+export function t(language, key, values = {}) {
+    let text = messages[language][key] ?? messages.en[key];
+    for (const [name, value] of Object.entries(values)) {
+        text = text.replaceAll(`{${name}}`, value);
+    }
+    return text;
+}
+export function languageLabel(language) {
+    return language === "zh-CN" ? t(language, "language.simplifiedChinese") : t(language, "language.english");
+}
+export function localizeSlashCommands(commands, language) {
+    return commands.map((command) => ({
+        ...command,
+        description: shortcutCommandDescriptions[command.name]?.[language] ?? command.description,
+    }));
+}
+export function helpCommandsForLanguage(commands, language) {
+    return commands.map((command) => ({
+        ...command,
+        description: helpCommandDescriptions[command.name]?.[language] ?? command.description,
+    }));
+}
+function translateKnown(value, language) {
+    if (value == null)
+        return value;
+    return knownText[value]?.[language] ?? value;
+}
+function localizeConfirmChoice(choice, stage, language) {
+    const value = String(choice.value || "");
+    const table = stage === "player_confirm" ? playerConfirmChoices : null;
+    const mapped = table?.[value]?.[language];
+    if (!mapped)
+        return choice;
+    return {
+        ...choice,
+        ...mapped,
+        input: choice.input,
+    };
+}
+export function applyLanguageToServerEvent(event, language) {
+    switch (event.type) {
+        case "status":
+            return { ...event, message: translateKnown(event.message, language) ?? event.message };
+        case "activity":
+            return {
+                ...event,
+                title: translateKnown(event.title, language) ?? event.title,
+                detail: translateKnown(event.detail, language) ?? event.detail,
+            };
+        case "spotify_setup":
+            return {
+                ...event,
+                title: translateKnown(event.title, language) ?? event.title,
+                message: translateKnown(event.message, language) ?? event.message,
+                prompt: translateKnown(event.prompt, language) ?? event.prompt,
+            };
+        case "auth_setup":
+            return {
+                ...event,
+                title: translateKnown(event.title, language) ?? event.title,
+                message: translateKnown(event.message, language) ?? event.message,
+                prompt: translateKnown(event.prompt, language) ?? event.prompt,
+            };
+        case "help_panel":
+            return {
+                ...event,
+                title: translateKnown(event.title, language) ?? event.title,
+                hint: translateKnown(event.hint, language) ?? event.hint,
+                commands: helpCommandsForLanguage(event.commands, language),
+            };
+        case "error":
+            return {
+                ...event,
+                message: translateKnown(event.message, language) ?? event.message,
+                detail: translateKnown(event.detail, language) ?? event.detail,
+            };
+        case "confirm":
+            return {
+                ...event,
+                message: translateKnown(event.message, language) ?? event.message,
+                choices: event.choices?.map((choice) => localizeConfirmChoice(choice, event.tool_args.stage, language)) ?? event.choices,
+            };
+        case "bye":
+            return {
+                ...event,
+                message: translateKnown(event.message, language) ?? event.message,
+            };
+        case "chat":
+            return {
+                ...event,
+                text: knownText[event.text]?.[language] ?? event.text,
+            };
+        default:
+            return event;
+    }
+}

package/dist/index.js

@@ -0,0 +1,46 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { render } from 'ink';
+import { App } from './App.js';
+import { createIncrementalStdout } from './terminal-frame-writer.js';
+import { TerminalSurfaceController } from './terminal-surface.js';
+const incrementalStdout = createIncrementalStdout(process.stdout);
+const terminalSurface = new TerminalSurfaceController({
+    isTTY: process.stdout.isTTY === true,
+    write: (value) => {
+        process.stdout.write(value);
+    },
+    resetFrame: incrementalStdout.reset,
+});
+terminalSurface.prepare();
+let app;
+try {
+    app = render(_jsx(App, { terminalSurface: terminalSurface, terminalStdout: process.stdout }), {
+        exitOnCtrlC: false,
+        stdin: process.stdin,
+        stdout: incrementalStdout,
+    });
+}
+catch (error) {
+    terminalSurface.dispose();
+    throw error;
+}
+terminalSurface.attachRendererClear(() => app.clear());
+const cleanup = () => terminalSurface.dispose();
+const stopFromSignal = (exitCode) => {
+    process.exitCode = exitCode;
+    try {
+        app.unmount();
+    }
+    finally {
+        cleanup();
+    }
+};
+const onSigint = () => stopFromSignal(130);
+const onSigterm = () => stopFromSignal(143);
+process.once('SIGINT', onSigint);
+process.once('SIGTERM', onSigterm);
+void app.waitUntilExit().finally(() => {
+    process.removeListener('SIGINT', onSigint);
+    process.removeListener('SIGTERM', onSigterm);
+    cleanup();
+});

package/dist/info-banner.js

@@ -0,0 +1,37 @@
+import { homedir } from 'node:os';
+export function formatWorkingDirectory(cwd, homeDirectory = homedir()) {
+    if (!homeDirectory)
+        return cwd;
+    const windowsStyle = /^[A-Za-z]:[\\/]/.test(cwd) || cwd.includes("\\");
+    const normalizeForComparison = (value) => (windowsStyle ? value.replaceAll("/", "\\").toLowerCase() : value.replaceAll("\\", "/"));
+    const separator = windowsStyle ? "\\" : "/";
+    const normalizedCwd = normalizeForComparison(cwd).replace(/[\\/]+$/, "");
+    const normalizedHome = normalizeForComparison(homeDirectory).replace(/[\\/]+$/, "");
+    if (normalizedCwd === normalizedHome)
+        return "~";
+    if (!normalizedCwd.startsWith(`${normalizedHome}${separator}`))
+        return cwd;
+    const relative = cwd.slice(homeDirectory.replace(/[\\/]+$/, "").length).replace(/^[\\/]+/, "");
+    return relative ? `~${separator}${relative}` : "~";
+}
+export function createInfoBannerItem(authState, cwd, sessionId, { showLogo = false } = {}) {
+    return {
+        type: "info_banner",
+        authState: { ...authState },
+        cwd,
+        sessionId,
+        showLogo,
+    };
+}
+export function isChatMessageItem(item) {
+    return item.type === "message";
+}
+export function chatMessagesForTranscript(items) {
+    return items.filter(isChatMessageItem).map(({ role, content, theme, segments, document }) => ({
+        role,
+        content,
+        ...(theme == null ? {} : { theme }),
+        ...(segments == null ? {} : { segments }),
+        ...(document == null ? {} : { document }),
+    }));
+}

package/dist/input-cursor.js

@@ -0,0 +1,6 @@
+const ANSI_INVERSE_ON = "\u001B[7m";
+const ANSI_INVERSE_OFF = "\u001B[27m";
+export const INPUT_CURSOR_BLINK_INTERVAL_MS = 500;
+export const hideInputCursor = (output) => (output
+    .replaceAll(ANSI_INVERSE_ON, "")
+    .replaceAll(ANSI_INVERSE_OFF, ""));

package/dist/input-routing.js

@@ -0,0 +1,41 @@
+import { hasSlashCommandArguments, matchingSlashCommand } from './commands.js';
+import { resolveConfirmDecisionFromInput, resolveConfirmInputDecision } from './confirm-choice.js';
+export function resolveInputRoute(value, context) {
+    const text = value.trim();
+    if (!text)
+        return { type: 'empty' };
+    if (context.confirm) {
+        const inputDecision = resolveConfirmInputDecision(text, context.selectedConfirmChoice);
+        if (inputDecision)
+            return { type: 'confirm', decision: inputDecision };
+        const decision = resolveConfirmDecisionFromInput(text, context.selectableConfirmChoices);
+        return decision ? { type: 'confirm', decision } : { type: 'ignore' };
+    }
+    if (context.extensionPanelActive) {
+        return context.extensionInputFocused
+            && context.extensionSetupInput
+            ? { type: 'extension_input', value: text }
+            : { type: 'ignore' };
+    }
+    const command = matchingSlashCommand(text);
+    if (!context.authSetupActive && !context.spotifySetupActive) {
+        if (command?.name === 'bye' || command?.name === 'exit') {
+            return { type: 'safe_exit', reason: command.name };
+        }
+        if (command?.name === 'info')
+            return { type: 'info' };
+        if (text.startsWith('/') && !command) {
+            return context.selectedSlashCommand
+                ? { type: 'slash_completion', command: context.selectedSlashCommand }
+                : { type: 'unknown_slash', value: text };
+        }
+        if (command?.needsArgument && !hasSlashCommandArguments(text)) {
+            return { type: 'slash_completion', command };
+        }
+    }
+    if (context.spotifySetupActive)
+        return { type: 'setup_input', channel: 'spotify', value: text };
+    if (context.authSetupActive)
+        return { type: 'setup_input', channel: 'auth', value: text };
+    return { type: 'user_input', value: text, command };
+}

package/dist/launch-preparing.js

@@ -0,0 +1,30 @@
+export const LAUNCH_PREPARING_INTERVAL_MS = 1000;
+/**
+ * Coordinates the launch preparing text operation for the CLI UI runtime.
+ *
+ * @param frame Input value used by the launch preparing text operation.
+ * @returns The computed result for the surrounding CLI UI flow.
+ */
+export function launchPreparingText(frame, language = "en") {
+    const dotCount = (Math.max(0, frame) % 3) + 1;
+    const base = language === "zh-CN" ? "播放准备中" : "Preparing playback";
+    return `${base}${'.'.repeat(dotCount)}`;
+}
+/**
+ * Coordinates the should start launch preparing operation for the CLI UI runtime.
+ *
+ * @param activity Input value used by the should start launch preparing operation.
+ * @returns The computed result for the surrounding CLI UI flow.
+ */
+export function shouldStartLaunchPreparing(activity) {
+    const launchPreparingTitles = new Set([
+        'Searching Spotify',
+        'Searching online audio',
+        'Caching online audio',
+        'Searching YouTube',
+        'Caching YouTube audio',
+    ]);
+    return activity.kind === 'tool'
+        && activity.status === 'pending'
+        && launchPreparingTitles.has(activity.title);
+}