termux-dev 1.8.0 → 1.8.2

package/dist/core/locales/fr.js

@@ -207,4 +207,59 @@ export const fr = {
     'rewind.filesNo': 'Non, seulement la conversation',
     'rewind.done': 'De retour à votre message. Ce qui a suivi a disparu, pour le modèle aussi. Modifiez le message et envoyez-le.',
     'rewind.doneImages': 'De retour à votre message (ses images n’ont pas été gardées, joignez-les de nouveau). Ce qui a suivi a disparu, pour le modèle aussi.',
+    // ── first run and the prompts around it
+    'welcome.tagline': 'Un agent de programmation IA pour le terminal',
+    'welcome.intro': 'Configurons tout. Cela prend environ une minute.',
+    'welcome.step.language': 'Langue',
+    'welcome.step.provider': 'Fournisseur',
+    'welcome.step.key': 'Clé API',
+    'welcome.step.model': 'Modèle',
+    'welcome.keyNote': 'Ta clé reste sur cet ordinateur, dans ~/.devxrc.json.',
+    'onboard.language.title': 'langue',
+    'onboard.language.note': 'Tu pourras la changer plus tard dans /settings.',
+    'onboard.provider.title': 'fournisseur',
+    'onboard.provider.placeholder': 'tape pour trouver un fournisseur',
+    'onboard.provider.note': 'Le service qui te donne les modèles. Pas dans la liste ? Choisis Adresse personnalisée.',
+    'onboard.custom': 'Adresse personnalisée',
+    'onboard.customDetail': 'Toute adresse compatible OpenAI',
+    'onboard.baseUrl.title': 'adresse',
+    'onboard.baseUrl.label': 'URL de base de l’API',
+    'onboard.baseUrl.placeholder': 'https://api.example.com/v1',
+    'onboard.key.title': 'clé api',
+    'onboard.key.label': 'Colle ta clé API pour {provider}',
+    'onboard.key.note': 'Ce que tu tapes est masqué. Échap revient en arrière.',
+    'onboard.key.useSaved': 'Utiliser la clé enregistrée',
+    'onboard.key.enterNew': 'Saisir une nouvelle clé',
+    'onboard.key.savedTitle': 'une clé est enregistrée pour {provider}',
+    'onboard.model.title': 'modèle',
+    'onboard.model.placeholder': 'tape pour trouver un modèle',
+    'onboard.model.custom': 'Saisir un nom de modèle',
+    'onboard.model.customDetail': 'Tout identifiant de modèle',
+    'onboard.model.label': 'Nom du modèle (par exemple gpt-4o)',
+    'onboard.model.fetching': 'Récupération de la liste des modèles...',
+    'onboard.model.manual': 'La liste des modèles n’a pas pu être récupérée, saisis le nom du modèle.',
+    'onboard.model.context': 'contexte de {n}',
+    'onboard.model.anthropic': 'format Anthropic',
+    'onboard.back': 'Retour',
+    'onboard.back.detail': 'Garder le réglage actuel',
+    'onboard.done': 'Terminé. Tes choix sont enregistrés dans ~/.devxrc.json.',
+    'finder.placeholder': 'tape pour filtrer',
+    'finder.empty': 'Aucun résultat',
+    'finder.hint.filter': 'filtrer',
+    'picker.hint.move': 'déplacer',
+    'picker.hint.select': 'choisir',
+    'picker.hint.cancel': 'annuler',
+    'picker.hint.confirm': 'confirmer',
+    'welcome.step.theme': 'Thème',
+    'onboard.theme.title': 'thème',
+    'onboard.theme.note': 'Les couleurs de l’interface. Tu peux les changer à tout moment avec /theme.',
+    'resume.title': 'reprendre',
+    'resume.placeholder': 'tape pour filtrer les sessions',
+    'resume.msgs': '{n} msgs',
+    'sessions.deleteTitle': 'supprimer des sessions',
+    'sessions.deleteAll': 'Supprimer les {n} sessions',
+    'commands.title': 'commandes',
+    'commands.placeholder': 'tape pour trouver une commande',
+    'compact.done': 'Contexte compacté, résumé conservé',
+    'compact.summary': 'ce que le modèle a écrit',
 };

package/dist/core/locales/ja.js

@@ -207,4 +207,59 @@ export const ja = {
     'rewind.filesNo': 'いいえ、会話だけ',
     'rewind.done': 'あなたのメッセージに戻りました。以降の内容はモデルからも消えています。メッセージを編集して送信してください。',
     'rewind.doneImages': 'あなたのメッセージに戻りました（画像は保持されません。再度添付してください）。以降の内容はモデルからも消えています。',
+    // ── first run and the prompts around it
+    'welcome.tagline': 'ターミナルで使える AI コーディングエージェント',
+    'welcome.intro': '設定を済ませましょう。1 分ほどで終わります。',
+    'welcome.step.language': '言語',
+    'welcome.step.provider': 'プロバイダー',
+    'welcome.step.key': 'API キー',
+    'welcome.step.model': 'モデル',
+    'welcome.keyNote': 'キーはこのコンピューターの ~/.devxrc.json にだけ保存されます。',
+    'onboard.language.title': '言語',
+    'onboard.language.note': 'あとで /settings から変更できます。',
+    'onboard.provider.title': 'プロバイダー',
+    'onboard.provider.placeholder': '入力してプロバイダーを探す',
+    'onboard.provider.note': 'モデルを提供するサービスです。一覧にない場合は「独自のアドレス」を選んでください。',
+    'onboard.custom': '独自のアドレス',
+    'onboard.customDetail': 'OpenAI 互換の任意のアドレス',
+    'onboard.baseUrl.title': 'アドレス',
+    'onboard.baseUrl.label': 'API のベース URL',
+    'onboard.baseUrl.placeholder': 'https://api.example.com/v1',
+    'onboard.key.title': 'api キー',
+    'onboard.key.label': '{provider} の API キーを貼り付けてください',
+    'onboard.key.note': '入力内容は表示されません。Esc で戻ります。',
+    'onboard.key.useSaved': '保存済みのキーを使う',
+    'onboard.key.enterNew': '新しいキーを入力',
+    'onboard.key.savedTitle': '{provider} のキーは保存済みです',
+    'onboard.model.title': 'モデル',
+    'onboard.model.placeholder': '入力してモデルを探す',
+    'onboard.model.custom': 'モデル名を入力',
+    'onboard.model.customDetail': '任意のモデル ID',
+    'onboard.model.label': 'モデル名（例: gpt-4o）',
+    'onboard.model.fetching': 'モデル一覧を取得しています...',
+    'onboard.model.manual': 'モデル一覧を取得できませんでした。モデル名を入力してください。',
+    'onboard.model.context': '{n} コンテキスト',
+    'onboard.model.anthropic': 'Anthropic 形式',
+    'onboard.back': '戻る',
+    'onboard.back.detail': '現在の設定を維持',
+    'onboard.done': '完了です。選択内容は ~/.devxrc.json に保存されました。',
+    'finder.placeholder': '入力して絞り込み',
+    'finder.empty': '一致なし',
+    'finder.hint.filter': '絞り込み',
+    'picker.hint.move': '移動',
+    'picker.hint.select': '選択',
+    'picker.hint.cancel': 'キャンセル',
+    'picker.hint.confirm': '確認',
+    'welcome.step.theme': 'テーマ',
+    'onboard.theme.title': 'テーマ',
+    'onboard.theme.note': 'インターフェースの配色です。/theme でいつでも変更できます。',
+    'resume.title': '再開',
+    'resume.placeholder': '入力してセッションを絞り込み',
+    'resume.msgs': '{n} 件',
+    'sessions.deleteTitle': 'セッションの削除',
+    'sessions.deleteAll': '{n} 件すべてのセッションを削除',
+    'commands.title': 'コマンド',
+    'commands.placeholder': '入力してコマンドを探す',
+    'compact.done': 'コンテキスト圧縮済み、要約を保持',
+    'compact.summary': 'モデルが書いた内容',
 };

package/dist/core/locales/pt.js

@@ -207,4 +207,59 @@ export const pt = {
     'rewind.filesNo': 'Não, só a conversa',
     'rewind.done': 'De volta à sua mensagem. O que veio depois sumiu, para o modelo também. Edite a mensagem e envie.',
     'rewind.doneImages': 'De volta à sua mensagem (as imagens dela não foram mantidas, anexe de novo). O que veio depois sumiu, para o modelo também.',
+    // ── first run and the prompts around it
+    'welcome.tagline': 'Um agente de programação com IA para o terminal',
+    'welcome.intro': 'Vamos configurar tudo. Leva cerca de um minuto.',
+    'welcome.step.language': 'Idioma',
+    'welcome.step.provider': 'Provedor',
+    'welcome.step.key': 'Chave de API',
+    'welcome.step.model': 'Modelo',
+    'welcome.keyNote': 'Sua chave fica neste computador, em ~/.devxrc.json.',
+    'onboard.language.title': 'idioma',
+    'onboard.language.note': 'Você pode mudar depois em /settings.',
+    'onboard.provider.title': 'provedor',
+    'onboard.provider.placeholder': 'digite para encontrar um provedor',
+    'onboard.provider.note': 'O serviço que fornece os modelos. Não está na lista? Escolha Endereço próprio.',
+    'onboard.custom': 'Endereço próprio',
+    'onboard.customDetail': 'Qualquer endereço compatível com OpenAI',
+    'onboard.baseUrl.title': 'endereço',
+    'onboard.baseUrl.label': 'URL base da API',
+    'onboard.baseUrl.placeholder': 'https://api.example.com/v1',
+    'onboard.key.title': 'chave de api',
+    'onboard.key.label': 'Cole sua chave de API para {provider}',
+    'onboard.key.note': 'O que você digita fica oculto. Esc volta.',
+    'onboard.key.useSaved': 'Usar a chave salva',
+    'onboard.key.enterNew': 'Inserir uma nova chave',
+    'onboard.key.savedTitle': 'há uma chave salva para {provider}',
+    'onboard.model.title': 'modelo',
+    'onboard.model.placeholder': 'digite para encontrar um modelo',
+    'onboard.model.custom': 'Digitar o nome de um modelo',
+    'onboard.model.customDetail': 'Qualquer id de modelo',
+    'onboard.model.label': 'Nome do modelo (por exemplo gpt-4o)',
+    'onboard.model.fetching': 'Buscando a lista de modelos...',
+    'onboard.model.manual': 'Não foi possível obter a lista de modelos, digite o nome do modelo.',
+    'onboard.model.context': 'contexto de {n}',
+    'onboard.model.anthropic': 'formato Anthropic',
+    'onboard.back': 'Voltar',
+    'onboard.back.detail': 'Manter o que está definido',
+    'onboard.done': 'Pronto. Suas escolhas estão salvas em ~/.devxrc.json.',
+    'finder.placeholder': 'digite para filtrar',
+    'finder.empty': 'Nada encontrado',
+    'finder.hint.filter': 'filtrar',
+    'picker.hint.move': 'mover',
+    'picker.hint.select': 'escolher',
+    'picker.hint.cancel': 'cancelar',
+    'picker.hint.confirm': 'confirmar',
+    'welcome.step.theme': 'Tema',
+    'onboard.theme.title': 'tema',
+    'onboard.theme.note': 'As cores da interface. Você pode mudá-las a qualquer momento com /theme.',
+    'resume.title': 'retomar',
+    'resume.placeholder': 'digite para filtrar sessões',
+    'resume.msgs': '{n} msgs',
+    'sessions.deleteTitle': 'excluir sessões',
+    'sessions.deleteAll': 'Excluir todas as {n} sessões',
+    'commands.title': 'comandos',
+    'commands.placeholder': 'digite para encontrar um comando',
+    'compact.done': 'Contexto compactado, resumo mantido',
+    'compact.summary': 'o que o modelo escreveu',
 };

package/dist/core/locales/ru.js

@@ -207,4 +207,59 @@ export const ru = {
     'rewind.filesNo': 'Нет, только разговор',
     'rewind.done': 'Вы вернулись к своему сообщению. Всё, что было после него, стёрто, и для модели тоже. Поправьте сообщение и отправьте.',
     'rewind.doneImages': 'Вы вернулись к своему сообщению (картинки из него не сохранились, приложите их снова). Всё, что было после, стёрто, и для модели тоже.',
+    // ── first run and the prompts around it
+    'welcome.tagline': 'Терминальный ИИ-агент для программирования',
+    'welcome.intro': 'Давай всё настроим, это займёт около минуты.',
+    'welcome.step.language': 'Язык',
+    'welcome.step.provider': 'Провайдер',
+    'welcome.step.key': 'API-ключ',
+    'welcome.step.model': 'Модель',
+    'welcome.keyNote': 'Твой ключ остаётся на этом компьютере, в ~/.devxrc.json.',
+    'onboard.language.title': 'язык',
+    'onboard.language.note': 'Позже его можно сменить в /settings.',
+    'onboard.provider.title': 'провайдер',
+    'onboard.provider.placeholder': 'начни вводить название',
+    'onboard.provider.note': 'Сервис, который даёт модели. Нет в списке? Выбери свой адрес.',
+    'onboard.custom': 'Свой адрес',
+    'onboard.customDetail': 'Любой адрес, совместимый с OpenAI',
+    'onboard.baseUrl.title': 'адрес',
+    'onboard.baseUrl.label': 'Базовый URL API',
+    'onboard.baseUrl.placeholder': 'https://api.example.com/v1',
+    'onboard.key.title': 'api-ключ',
+    'onboard.key.label': 'Вставь API-ключ для {provider}',
+    'onboard.key.note': 'Вводимое скрыто. Esc возвращает назад.',
+    'onboard.key.useSaved': 'Использовать сохранённый ключ',
+    'onboard.key.enterNew': 'Ввести новый ключ',
+    'onboard.key.savedTitle': 'ключ для {provider} уже сохранён',
+    'onboard.model.title': 'модель',
+    'onboard.model.placeholder': 'начни вводить название',
+    'onboard.model.custom': 'Ввести название модели',
+    'onboard.model.customDetail': 'Любой id модели',
+    'onboard.model.label': 'Название модели (например, gpt-4o)',
+    'onboard.model.fetching': 'Загружаю список моделей...',
+    'onboard.model.manual': 'Список моделей получить не удалось, введи название модели.',
+    'onboard.model.context': 'контекст {n}',
+    'onboard.model.anthropic': 'формат Anthropic',
+    'onboard.back': 'Назад',
+    'onboard.back.detail': 'Оставить как сейчас',
+    'onboard.done': 'Готово. Выбор сохранён в ~/.devxrc.json.',
+    'finder.placeholder': 'начни вводить для фильтра',
+    'finder.empty': 'Ничего не найдено',
+    'finder.hint.filter': 'фильтр',
+    'picker.hint.move': 'движение',
+    'picker.hint.select': 'выбрать',
+    'picker.hint.cancel': 'отмена',
+    'picker.hint.confirm': 'подтвердить',
+    'welcome.step.theme': 'Тема',
+    'onboard.theme.title': 'тема',
+    'onboard.theme.note': 'Цвета интерфейса. Их можно сменить в любой момент командой /theme.',
+    'resume.title': 'продолжить',
+    'resume.placeholder': 'начни вводить для поиска сессии',
+    'resume.msgs': 'сообщ.: {n}',
+    'sessions.deleteTitle': 'удаление сессий',
+    'sessions.deleteAll': 'Удалить все сессии ({n})',
+    'commands.title': 'команды',
+    'commands.placeholder': 'начни вводить название команды',
+    'compact.done': 'Контекст сжат, краткое содержание сохранено',
+    'compact.summary': 'что написала модель',
 };

package/dist/core/locales/uk.js

@@ -207,4 +207,59 @@ export const uk = {
     'rewind.filesNo': 'Ні, лише розмову',
     'rewind.done': 'Ви повернулися до свого повідомлення. Усе, що було після нього, стерто, і для моделі теж. Поправте повідомлення й надішліть.',
     'rewind.doneImages': 'Ви повернулися до свого повідомлення (картинки з нього не збереглися, додайте їх знову). Усе, що було після, стерто, і для моделі теж.',
+    // ── first run and the prompts around it
+    'welcome.tagline': 'Термінальний ШІ-агент для програмування',
+    'welcome.intro': 'Налаштуймо все, це займе близько хвилини.',
+    'welcome.step.language': 'Мова',
+    'welcome.step.provider': 'Провайдер',
+    'welcome.step.key': 'API-ключ',
+    'welcome.step.model': 'Модель',
+    'welcome.keyNote': 'Твій ключ залишається на цьому комп’ютері, у ~/.devxrc.json.',
+    'onboard.language.title': 'мова',
+    'onboard.language.note': 'Пізніше її можна змінити в /settings.',
+    'onboard.provider.title': 'провайдер',
+    'onboard.provider.placeholder': 'почни вводити назву',
+    'onboard.provider.note': 'Сервіс, що надає моделі. Немає в списку? Обери власну адресу.',
+    'onboard.custom': 'Власна адреса',
+    'onboard.customDetail': 'Будь-яка адреса, сумісна з OpenAI',
+    'onboard.baseUrl.title': 'адреса',
+    'onboard.baseUrl.label': 'Базовий URL API',
+    'onboard.baseUrl.placeholder': 'https://api.example.com/v1',
+    'onboard.key.title': 'api-ключ',
+    'onboard.key.label': 'Встав API-ключ для {provider}',
+    'onboard.key.note': 'Введене приховано. Esc повертає назад.',
+    'onboard.key.useSaved': 'Використати збережений ключ',
+    'onboard.key.enterNew': 'Ввести новий ключ',
+    'onboard.key.savedTitle': 'ключ для {provider} уже збережено',
+    'onboard.model.title': 'модель',
+    'onboard.model.placeholder': 'почни вводити назву',
+    'onboard.model.custom': 'Ввести назву моделі',
+    'onboard.model.customDetail': 'Будь-який id моделі',
+    'onboard.model.label': 'Назва моделі (наприклад, gpt-4o)',
+    'onboard.model.fetching': 'Завантажую список моделей...',
+    'onboard.model.manual': 'Список моделей отримати не вдалося, введи назву моделі.',
+    'onboard.model.context': 'контекст {n}',
+    'onboard.model.anthropic': 'формат Anthropic',
+    'onboard.back': 'Назад',
+    'onboard.back.detail': 'Залишити як зараз',
+    'onboard.done': 'Готово. Вибір збережено в ~/.devxrc.json.',
+    'finder.placeholder': 'почни вводити для фільтра',
+    'finder.empty': 'Нічого не знайдено',
+    'finder.hint.filter': 'фільтр',
+    'picker.hint.move': 'рух',
+    'picker.hint.select': 'вибрати',
+    'picker.hint.cancel': 'скасувати',
+    'picker.hint.confirm': 'підтвердити',
+    'welcome.step.theme': 'Тема',
+    'onboard.theme.title': 'тема',
+    'onboard.theme.note': 'Кольори інтерфейсу. Їх можна змінити будь-коли командою /theme.',
+    'resume.title': 'продовжити',
+    'resume.placeholder': 'почни вводити для пошуку сесії',
+    'resume.msgs': 'повід.: {n}',
+    'sessions.deleteTitle': 'видалення сесій',
+    'sessions.deleteAll': 'Видалити всі сесії ({n})',
+    'commands.title': 'команди',
+    'commands.placeholder': 'почни вводити назву команди',
+    'compact.done': 'Контекст стиснуто, виклад збережено',
+    'compact.summary': 'що написала модель',
 };

package/dist/core/locales/zh.js

@@ -207,4 +207,59 @@ export const zh = {
     'rewind.filesNo': '否，只回退对话',
     'rewind.done': '已回到你的消息。之后的内容已被清除，模型也看不到了。修改消息后发送。',
     'rewind.doneImages': '已回到你的消息（其中的图片未保留，请重新添加）。之后的内容已被清除，模型也看不到了。',
+    // ── first run and the prompts around it
+    'welcome.tagline': '终端里的 AI 编程助手',
+    'welcome.intro': '我们来完成设置，大约只需一分钟。',
+    'welcome.step.language': '语言',
+    'welcome.step.provider': '服务商',
+    'welcome.step.key': 'API 密钥',
+    'welcome.step.model': '模型',
+    'welcome.keyNote': '你的密钥只保存在这台电脑上，位于 ~/.devxrc.json。',
+    'onboard.language.title': '语言',
+    'onboard.language.note': '之后可以在 /settings 中更改。',
+    'onboard.provider.title': '服务商',
+    'onboard.provider.placeholder': '输入以查找服务商',
+    'onboard.provider.note': '提供模型的服务。没有找到？请选择自定义地址。',
+    'onboard.custom': '自定义地址',
+    'onboard.customDetail': '任何兼容 OpenAI 的地址',
+    'onboard.baseUrl.title': '地址',
+    'onboard.baseUrl.label': 'API 的基础 URL',
+    'onboard.baseUrl.placeholder': 'https://api.example.com/v1',
+    'onboard.key.title': 'api 密钥',
+    'onboard.key.label': '粘贴 {provider} 的 API 密钥',
+    'onboard.key.note': '输入的内容不会显示。按 Esc 返回。',
+    'onboard.key.useSaved': '使用已保存的密钥',
+    'onboard.key.enterNew': '输入新密钥',
+    'onboard.key.savedTitle': '已保存 {provider} 的密钥',
+    'onboard.model.title': '模型',
+    'onboard.model.placeholder': '输入以查找模型',
+    'onboard.model.custom': '输入模型名称',
+    'onboard.model.customDetail': '任意模型 ID',
+    'onboard.model.label': '模型名称（例如 gpt-4o）',
+    'onboard.model.fetching': '正在获取模型列表...',
+    'onboard.model.manual': '无法获取模型列表，请输入模型名称。',
+    'onboard.model.context': '{n} 上下文',
+    'onboard.model.anthropic': 'Anthropic 格式',
+    'onboard.back': '返回',
+    'onboard.back.detail': '保持当前设置',
+    'onboard.done': '完成。你的选择已保存到 ~/.devxrc.json。',
+    'finder.placeholder': '输入以筛选',
+    'finder.empty': '没有匹配项',
+    'finder.hint.filter': '筛选',
+    'picker.hint.move': '移动',
+    'picker.hint.select': '选择',
+    'picker.hint.cancel': '取消',
+    'picker.hint.confirm': '确认',
+    'welcome.step.theme': '主题',
+    'onboard.theme.title': '主题',
+    'onboard.theme.note': '界面的配色。随时可以用 /theme 更改。',
+    'resume.title': '恢复会话',
+    'resume.placeholder': '输入以筛选会话',
+    'resume.msgs': '{n} 条消息',
+    'sessions.deleteTitle': '删除会话',
+    'sessions.deleteAll': '删除全部 {n} 个会话',
+    'commands.title': '命令',
+    'commands.placeholder': '输入以查找命令',
+    'compact.done': '上下文已压缩，摘要已保留',
+    'compact.summary': '模型写的内容',
 };

package/dist/core/loop.js

@@ -32,6 +32,17 @@ export function getActionDescription(toolName, args) {
     if (t === 'bash' || t === 'execute_command' || t === 'run_command' || t === 'exec') {
         return `→ Run: ${args.command || args.cmd || ''}`;
     }
+    if (t === 'background') {
+        const id = args.id ? ` ${args.id}` : '';
+        switch (args.action) {
+            case 'start': return `→ Background: ${args.label ? `${args.label} · ` : ''}${args.command || ''}`;
+            case 'list': return `→ Background: list tasks`;
+            case 'output': return `→ Background: output${id}`;
+            case 'wait': return `→ Background: wait${id}${args.pattern ? ` for /${args.pattern}/` : ''}`;
+            case 'stop': return `→ Background: stop${id}`;
+            default: return `→ Background`;
+        }
+    }
     if (t === 'todo_list' || t === 'update_todos') {
         return `→ Update Plan & Tasks`;
     }
@@ -83,6 +94,12 @@ export class Agent {
                 this.history.addMessage(message);
                 yield { type: 'user_message', content: message.content };
             }
+            // A background task ended or printed what was asked for: the model learns it before it decides.
+            const news = hooks?.takeNotes?.();
+            if (news) {
+                this.history.addMessage({ role: 'user', content: news });
+                yield { type: 'background_note', content: news };
+            }
             const toolDefinitions = Array.from(this.tools.values()).map((t) => t.definition);
             // Tool schemas are sent with every request and count against the context window.
             const schemaTokens = toolSchemaTokens(toolDefinitions);
@@ -207,7 +224,7 @@ export class Agent {
             }
             if (!response.toolCalls || response.toolCalls.length === 0) {
                 // The user wrote something while the model was finishing: answer it instead of stopping.
-                if (hooks?.hasPending?.()) {
+                if (hooks?.hasPending?.() || hooks?.hasNotes?.()) {
                     iterations++;
                     continue;
                 }

package/dist/core/types.js

@@ -1 +1 @@
-export const DEVX_VERSION = '1.8.0';
+export const DEVX_VERSION = '1.8.2';

package/dist/permissions/guard.js

@@ -277,7 +277,7 @@ function hasComplexChainingOrRedirection(commandStr) {
         commandStr.includes('\r'));
 }
 // ───────────────────────── guard ─────────────────────────
-const SHELL_TOOLS = new Set(['bash', 'exec', 'run_command', 'execute_command']);
+const SHELL_TOOLS = new Set(['bash', 'background', 'exec', 'run_command', 'execute_command']);
 const READ_TOOLS = new Set(['read_file', 'view_file', 'read', 'list_dir', 'list_files', 'ls', 'search', 'grep_search', 'grep', 'diagnose_code']);
 const WRITE_TOOLS = new Set(['write_file', 'edit_file', 'make_dir', 'mkdir', 'create_file', 'write_to_file', 'patch']);
 function pathArg(args) {
@@ -409,6 +409,8 @@ export function buildPermissionRequest(toolName, args) {
             notes.push('looks destructive or runs downloaded code');
         else if (shellTouchesSecrets(cmd))
             notes.push('reads a credentials / secrets file: its content would reach the model');
+        if (t === 'background')
+            notes.push('keeps running in the background until it ends or you stop it');
         return { title: t === 'bash' ? 'bash' : toolName, danger, lines: cmd.split('\n'), notes };
     }
     if (t === 'mcp_manage') {

package/dist/prompts/builder.js

@@ -34,7 +34,8 @@ export async function buildSystemPrompt(planMode) {
         prompt += `- Before using tools on a task, say in one short line what you are about to do. Do not narrate every step.\n`;
         prompt += `- Do the whole task step by step. For a task with several steps, keep the checklist with 'todo_list'.\n`;
         prompt += `- Read a file before you edit it. Change only what the task needs, with 'edit_file' for small changes. Do not rewrite a whole file or touch unrelated code.\n`;
-        prompt += `- 'bash' stops after 120 s and cuts long output: give long jobs a timeout or run them in the background, and print only what you need (head, tail, grep).\n`;
+        prompt += `- 'bash' stops after 120 s and cuts long output: give a long job a timeout, and print only what you need (head, tail, grep).\n`;
+        prompt += `- Anything that keeps running (dev server, watcher, long test run or build) goes to the 'background' tool, not to 'bash': action 'start' returns at once and the work goes on while you continue. Set notify_on to a regex ('ready|listening|error|FAIL') to be told when such a line appears; you are always told when a task ends. Then do other work or finish your answer: do not poll. To wait for a line use action 'wait' with a pattern, to read output use 'output', to end it use 'stop'. The user sees the tasks under /tasks. Never start the same server twice: check 'list' first.\n`;
         prompt += `- After you change code, run 'diagnose_code' and fix what it reports. Install missing dependencies with 'install_package'.\n`;
         prompt += `- After you create or change a web page or frontend app, start the local preview with 'serve_preview' (action 'start').\n`;
         if (MemoryManager.enabled)

package/dist/tools/background.js

@@ -0,0 +1,118 @@
+import { MAX_BACKGROUND_TASKS, formatDuration, getBackgroundManager } from '../core/background.js';
+const ACTIONS = ['start', 'list', 'output', 'wait', 'stop'];
+/** One line per task: `bg1 running 2m 03s  npm run dev`. */
+export function describeTask(info, now = Date.now()) {
+    const age = formatDuration((info.endedAt ?? now) - info.startedAt);
+    const state = info.status === 'running' ? 'running'
+        : info.status === 'stopped' ? 'stopped'
+            : info.status === 'exited' ? 'finished (exit 0)'
+                : `failed (exit ${info.code ?? '?'})`;
+    const watch = info.watching && info.status === 'running' ? `  [watching /${info.watching}/]` : '';
+    return `${info.id}  ${state}  ${age}  ${info.label}${watch}`;
+}
+function outputBlock(text, omitted) {
+    if (!text)
+        return '(no output)';
+    return (omitted > 0 ? `[... ${omitted} earlier line${omitted === 1 ? '' : 's'} left out ...]\n` : '') + text;
+}
+export const backgroundTool = {
+    name: 'background',
+    definition: {
+        name: 'background',
+        description: 'Run a long-lived command in the background and keep working: dev servers, file watchers, long builds or test runs. ' +
+            'Do NOT use it for commands that finish quickly (use bash). Actions: ' +
+            '"start" (command, optional label, notify_on, max_runtime_seconds) launches it and returns its id and first output; ' +
+            '"list" shows all tasks; ' +
+            '"output" (id) reads what the task printed since the last read (mode "tail" gives the last lines instead; "grep" filters lines); ' +
+            '"wait" (id, optional pattern, timeout_seconds) blocks until the task ends, a line matches the regex, or the time is up; ' +
+            '"stop" (id) ends the task. ' +
+            'Set "notify_on" (a regex such as "ready|listening|error|FAIL") to be told when such a line appears, and you are always told when a task ends: ' +
+            'then you do not need to poll. Never poll in a loop; wait with a pattern instead. ' +
+            `At most ${MAX_BACKGROUND_TASKS} tasks run at once, and all of them are stopped when devx exits.`,
+        parameters: {
+            type: 'object',
+            properties: {
+                action: { type: 'string', enum: [...ACTIONS], description: 'What to do' },
+                command: { type: 'string', description: 'start: the shell command' },
+                label: { type: 'string', description: 'start: a short name shown to the user, e.g. "dev server"' },
+                notify_on: { type: 'string', description: 'start: regex; a matching output line is reported to you' },
+                max_runtime_seconds: { type: 'number', description: 'start: stop the task after this many seconds (default: no limit)' },
+                id: { type: 'string', description: 'output / wait / stop: the task id (bg1, bg2, ...)' },
+                mode: { type: 'string', enum: ['new', 'tail'], description: 'output: "new" (default) = since the last read, "tail" = last lines' },
+                lines: { type: 'number', description: 'output: how many lines at most (default 200 for new, 40 for tail)' },
+                grep: { type: 'string', description: 'output: only lines that match this regex' },
+                pattern: { type: 'string', description: 'wait: regex of an output line to wait for (default: wait for the end)' },
+                timeout_seconds: { type: 'number', description: 'wait: give up after this long (default 60, max 600)' },
+            },
+            required: ['action'],
+        },
+    },
+    validateArgs(args) {
+        if (!args || !ACTIONS.includes(args.action))
+            throw new Error(`action must be one of: ${ACTIONS.join(', ')}`);
+        if (args.action === 'start' && (!args.command || typeof args.command !== 'string'))
+            throw new Error('command is required for "start"');
+        if (['output', 'wait', 'stop'].includes(args.action) && !args.id)
+            throw new Error(`id is required for "${args.action}" (see action "list")`);
+    },
+    async execute(args, _config, context) {
+        const manager = getBackgroundManager();
+        const action = args.action;
+        try {
+            if (action === 'start') {
+                const info = manager.start(args.command, {
+                    label: args.label,
+                    notifyOn: args.notify_on,
+                    maxRuntimeSeconds: Number(args.max_runtime_seconds) || 0,
+                });
+                // Give it a moment: a command that dies at once (wrong script, busy port) should be seen now.
+                const first = await manager.wait(info.id, { timeoutSeconds: 1.5, signal: context?.signal });
+                const now = manager.get(info.id);
+                const out = manager.read(info.id, { mode: 'new', lines: 30 });
+                const head = now.status === 'running'
+                    ? `Started ${now.id} (pid ${now.pid ?? '?'}): ${now.label}. It runs in the background.`
+                    : `${describeTask(now)} - it ended right after the start.`;
+                const hint = now.status === 'running'
+                    ? '\nYou will be told when it ends' + (now.watching ? ' or prints a line matching the pattern' : '') + '. Use "output" to read more, "wait" to wait for a line.'
+                    : '';
+                return `${head}${hint}\n${outputBlock(out.text, out.omitted)}${first.reason === 'aborted' ? '\n[Operation cancelled by user]' : ''}`;
+            }
+            if (action === 'list') {
+                const tasks = manager.list();
+                return tasks.length === 0 ? 'No background tasks.' : tasks.map((t) => describeTask(t)).join('\n');
+            }
+            if (action === 'output') {
+                const info = manager.get(String(args.id));
+                const out = manager.read(String(args.id), {
+                    mode: args.mode === 'tail' ? 'tail' : 'new',
+                    lines: args.lines,
+                    grep: args.grep,
+                });
+                return `${info ? describeTask(info) : args.id}\n${outputBlock(out.text, out.omitted)}`;
+            }
+            if (action === 'wait') {
+                const result = await manager.wait(String(args.id), {
+                    pattern: args.pattern,
+                    timeoutSeconds: Number(args.timeout_seconds) || 60,
+                    signal: context?.signal,
+                });
+                const info = manager.get(String(args.id));
+                const out = manager.read(String(args.id), { mode: 'new', lines: 60 });
+                const why = result.reason === 'match' ? `A line matched: ${result.line}`
+                    : result.reason === 'exit' ? 'The task has ended.'
+                        : result.reason === 'timeout' ? 'Timed out; the task is still running.'
+                            : '[Operation cancelled by user]';
+                return `${why}\n${describeTask(info)}\n${outputBlock(out.text, out.omitted)}`;
+            }
+            // stop
+            const before = manager.get(String(args.id));
+            if (before && before.status !== 'running')
+                return `${describeTask(before)} (already ended)`;
+            const info = await manager.stop(String(args.id));
+            return `Stopped. ${describeTask(info)}`;
+        }
+        catch (err) {
+            return `Error: ${err.message}`;
+        }
+    },
+};

package/dist/tools/bash.js

@@ -63,6 +63,8 @@ export function runShell(command, options = {}) {
         const stderrDecoder = new StringDecoder('utf8');
         let stopReason = '';
         let killTimer;
+        let killRepeat;
+        let settled = false;
         const killProcessTree = (force) => {
             if (!proc.pid)
                 return;
@@ -90,6 +92,10 @@ export function runShell(command, options = {}) {
             killProcessTree(false);
             // Commands can ignore SIGTERM. Do not leave them running after cancellation.
             killTimer = setTimeout(() => killProcessTree(true), 1000);
+            // On Windows a command such as `npm test` starts its child a moment later, after the first
+            // kill has looked at the tree: kill again until the process is gone.
+            if (isWin)
+                killRepeat = setInterval(() => killProcessTree(true), 700);
         };
         const onAbort = () => stop('[Operation cancelled by user]');
         const timeout = setTimeout(() => stop(`[Process killed due to timeout after ${timeoutSeconds}s. ` +
@@ -108,14 +114,30 @@ export function runShell(command, options = {}) {
         const cleanup = () => {
             clearTimeout(timeout);
             clearTimeout(killTimer);
+            clearInterval(killRepeat);
             signal?.removeEventListener('abort', onAbort);
         };
-        proc.on('close', (code) => {
+        const finish = (code) => {
+            if (settled)
+                return;
+            settled = true;
             if (stopReason)
                 killProcessTree(true);
             output.push(stdoutDecoder.end() + stderrDecoder.end());
             cleanup();
             resolve({ output: output.toString(), code, stopReason });
+        };
+        proc.on('close', finish);
+        // After a cancel or a timeout the shell is gone, but a child that got away can keep the pipes
+        // open for good: do not wait for them for more than a moment.
+        proc.on('exit', (code) => {
+            if (!stopReason)
+                return;
+            setTimeout(() => {
+                proc.stdout?.destroy();
+                proc.stderr?.destroy();
+                finish(code);
+            }, 300);
         });
         proc.on('error', (err) => {
             cleanup();

package/dist/tools/index.js

@@ -1,5 +1,6 @@
 import { readFileTool, writeFileTool, editFileTool, listDirTool, mkdirTool } from './fs.js';
 import { bashTool } from './bash.js';
+import { backgroundTool } from './background.js';
 import { searchTool } from './search.js';
 import { askQuestionsTool } from './questions.js';
 import { webSearchTool, fetchUrlTool } from './web.js';
@@ -17,6 +18,6 @@ export function getTools(planMode) {
     if (planMode) {
         return [...baseTools, ...mcpTools];
     }
-    return [...baseTools, writeFileTool, editFileTool, mkdirTool, bashTool, diagnoseCodeTool, installPackageTool, servePreviewTool, mcpManageTool, ...mcpTools];
+    return [...baseTools, writeFileTool, editFileTool, mkdirTool, bashTool, backgroundTool, diagnoseCodeTool, installPackageTool, servePreviewTool, mcpManageTool, ...mcpTools];
 }
 export { webSearchTool, fetchUrlTool, diagnoseCodeTool, installPackageTool, saveMemoryTool, planReadyTool, lastPlanReady, resetPlanReady, todoListTool, currentTodoList, resetTodoList, servePreviewTool };