dsh-nextsteps 1.2.0 → 1.3.0

package/README.md

@@ -1,8 +1,8 @@
 # dsh-nextsteps
 
-[![npm](https://img.shields.io/npm/v/dsh-nextsteps)](https://www.npmjs.com/package/dsh-nextsteps)
-[![license](https://img.shields.io/github/license/klaus-2/dsh-nextsteps)](LICENSE)
-[![DeepSeek Harness](https://img.shields.io/badge/DeepSeek%20Harness-plugin-e5484d)](https://github.com/deepseek-ai/deepseek-harness)
+English · [Português (Brasil)](README.pt-BR.md) · [简体中文](README.zh-CN.md)
+
+[![npm](https://img.shields.io/npm/v/dsh-nextsteps)](https://www.npmjs.com/package/dsh-nextsteps) [![license](https://img.shields.io/github/license/klaus-2/dsh-nextsteps)](LICENSE) [![DeepSeek Harness](https://img.shields.io/badge/DeepSeek%20Harness-plugin-e5484d)](https://github.com/deepseek-ai/deepseek-harness)
 
 **Every finished agent turn ends with ready-to-click next steps.**
 
@@ -12,21 +12,24 @@
 dsh plugin --profile web add dsh-nextsteps
 ```
 
-## How it works
+## Product tour
+
+![Nextsteps demo loop](docs/assets/demo.svg)
 
-1. The plugin registers a native `suggest_followups` agent tool with a strict JSON Schema.
-2. At the end of its turn, the model calls it with about three followup prompts.
-3. Each completed turn renders its own suggestion cards — attributed to that turn, never repeated across messages.
-4. Click a card: the prompt is sent verbatim as your next queued message and the card flips to a sent state.
+1. Ask anything. The model works, answers, and calls the native `suggest_followups` tool right before its final answer.
+2. The completed turn renders its own suggestion cards — attributed to that turn, never repeated across messages.
+3. Click a card: the prompt is sent verbatim as your next queued message and the card flips to a sent state.
+4. Everything survives restarts: cards, their turn attribution, and which ones you already clicked.
+5. Open the dsh settings → **Nextsteps** to pick the generation language (15 languages or Auto), how many suggestions you get per turn (1–6), and whether the small header shows.
 
 ## Features
 
-- Per-turn attribution — suggestions stay attached to the turn that produced them, across reloads.
+- Per-turn attribution — suggestions stay attached to the turn that produced them, across reloads and app restarts.
 - One-click send through the session's own conversation controller, with a composer fallback.
-- Clicked cards persist (content-addressed keys) and stay marked after reloads.
+- Persistent captures: clicked cards stay marked after restarts (content-addressed keys, turn backfilled from history).
 - Model-supplied labels, with automatic truncation when absent; strict payload validation with corrective model feedback.
 - Settings page inside the dsh settings — language, followups per turn, header visibility, updates.
-- Followups generated in the selected language (Auto follows the conversation).
+- Followups generated in the selected language — 15 languages or Auto, which follows the conversation.
 - In-app updater — version check, one-click install, release notes, restart prompt.
 - UI in English, Português (Brasil) and 简体中文.
 

package/README.pt-BR.md

@@ -0,0 +1,57 @@
+# dsh-nextsteps
+
+[English](README.md) · Português (Brasil) · [简体中文](README.zh-CN.md)
+
+[![npm](https://img.shields.io/npm/v/dsh-nextsteps)](https://www.npmjs.com/package/dsh-nextsteps) [![license](https://img.shields.io/github/license/klaus-2/dsh-nextsteps)](LICENSE) [![DeepSeek Harness](https://img.shields.io/badge/DeepSeek%20Harness-plugin-e5484d)](https://github.com/deepseek-ai/deepseek-harness)
+
+**Cada turno concluído do agente termina com próximos passos prontos para clicar.**
+
+`dsh-nextsteps` é um plugin do [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) que faz o modelo sugerir cerca de três prompts de followup ao final de cada turno, renderiza-os como cards clicáveis sob o turno concluído e envia o prompt clicado como sua próxima mensagem — um clique, zero digitação.
+
+```
+dsh plugin --profile web add dsh-nextsteps
+```
+
+## Tour do produto
+
+![Demo do Nextsteps](docs/assets/demo.svg)
+
+1. Pergunte qualquer coisa. O modelo trabalha, responde e chama a tool nativa `suggest_followups` logo antes da resposta final.
+2. O turno concluído renderiza seus próprios cards de sugestão — atribuídos àquele turno, nunca repetidos entre mensagens.
+3. Clique num card: o prompt é enviado literalmente como sua próxima mensagem na fila e o card muda para o estado de enviado.
+4. Tudo sobrevive a restarts: os cards, a atribuição de turno e os que você já clicou.
+5. Abra as configurações do dsh → **Nextsteps** para escolher o idioma de geração (15 idiomas ou Automático), quantas sugestões por turno (1–6) e se o pequeno cabeçalho aparece.
+
+## Funcionalidades
+
+- Atribuição por turno — as sugestões ficam ligadas ao turno que as gerou, através de reloads e restarts do app.
+- Envio com um clique pelo próprio controlador de conversa da sessão, com fallback pelo composer.
+- Capturas persistentes: cards clicados continuam marcados após restarts (chaves endereçadas por conteúdo, turno retro-preenchido do histórico).
+- Rótulos fornecidos pelo modelo, com truncamento automático quando ausentes; validação estrita do payload com feedback corretivo ao modelo.
+- Página de configurações dentro das configurações do dsh — idioma, followups por turno, visibilidade do cabeçalho, atualizações.
+- Followups gerados no idioma selecionado — 15 idiomas ou Automático, que segue a conversa.
+- Atualizador in-app — verificação de versão, instalação com um clique, notas de release, pedido de reinício.
+- Interface em English, Português (Brasil) e 简体中文.
+
+## Configurações
+
+Abra as configurações do dsh e encontre a seção **Nextsteps**:
+
+| Configuração | O que faz |
+| --- | --- |
+| Idioma | O idioma em que o modelo escreve os followups. `Automático` segue a conversa. |
+| Followups por turno | Quantas sugestões o modelo produz (1–6). |
+| Mostrar cabeçalho | O pequeno rótulo acima dos cards. |
+
+## Atualizações
+
+A mesma página de configurações verifica novos releases no GitHub. Quando uma versão mais nova é publicada no npm, **Atualizar agora** instala pelo gerenciador de plugins do dsh e pede reinício. As atualizações instalam somente o pacote npm `dsh-nextsteps` — cópias renomeadas ou de desenvolvimento são detectadas e deixadas em paz.
+
+## Requisitos
+
+- DeepSeek Harness 0.2.x (desktop, perfil web).
+- Node.js 20+.
+
+## Licença
+
+[MIT](LICENSE)

package/README.zh-CN.md

@@ -0,0 +1,57 @@
+# dsh-nextsteps
+
+[English](README.md) · [Português (Brasil)](README.pt-BR.md) · 简体中文
+
+[![npm](https://img.shields.io/npm/v/dsh-nextsteps)](https://www.npmjs.com/package/dsh-nextsteps) [![license](https://img.shields.io/github/license/klaus-2/dsh-nextsteps)](LICENSE) [![DeepSeek Harness](https://img.shields.io/badge/DeepSeek%20Harness-plugin-e5484d)](https://github.com/deepseek-ai/deepseek-harness)
+
+**每个智能体回合的结尾，都是可以一键继续的下一步。**
+
+`dsh-nextsteps` 是 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) 的插件：模型在每个回合结束时建议大约三个后续提示，以可点击的卡片渲染在已完成的回合下方；点击后该提示即原样作为你的下一条消息发送——一次点击，无需输入。
+
+```
+dsh plugin --profile web add dsh-nextsteps
+```
+
+## 产品导览
+
+![Nextsteps 演示](docs/assets/demo.svg)
+
+1. 随意提问。模型完成工作、给出回答，并在最终回答之前调用原生的 `suggest_followups` 工具。
+2. 已完成的回合渲染出属于自己的建议卡片——归属于该回合，不会跨消息重复。
+3. 点击卡片：提示原样作为你的下一条排队消息发送，卡片翻转为已发送状态。
+4. 一切在重启后依然保留：卡片、回合归属、以及你已经点击过的那些。
+5. 打开 dsh 设置 → **Nextsteps**，选择生成语言（15 种语言或"自动"）、每回合的建议数量（1–6）、以及是否显示小标题。
+
+## 功能
+
+- 按回合归属——建议始终附着在产生它的回合上，跨刷新与应用重启。
+- 通过会话自身的对话控制器一键发送，并有 composer 兜底。
+- 持久化捕获：已点击的卡片在重启后保持标记（内容寻址键，回合由历史回填）。
+- 模型提供的标签，缺失时自动截断；严格的负载校验，并向模型反馈纠错。
+- dsh 设置内置配置页——语言、每回合建议数、标题可见性、更新。
+- 以所选语言生成后续提示——15 种语言或"自动"（跟随对话语言）。
+- 应用内更新器——版本检查、一键安装、发布说明、重启提示。
+- 界面支持 English、Português (Brasil)、简体中文。
+
+## 设置
+
+打开 dsh 设置，找到 **Nextsteps** 部分：
+
+| 设置 | 作用 |
+| --- | --- |
+| 语言 | 模型撰写后续提示使用的语言。`自动` 跟随对话语言。 |
+| 每回合提示数 | 模型生成的建议数量（1–6）。 |
+| 显示标题 | 卡片上方的小标题。 |
+
+## 更新
+
+同一个设置页会检查 GitHub 上的新版本。当 npm 上发布了更新的版本时，**立即更新** 会通过 dsh 插件管理器安装并提示重启。更新只会安装 npm 包 `dsh-nextsteps`——重命名或开发副本会被识别并保持不动。
+
+## 环境要求
+
+- DeepSeek Harness 0.2.x（桌面版，web profile）。
+- Node.js 20+。
+
+## 许可证
+
+[MIT](LICENSE)

package/client.js

@@ -343,11 +343,27 @@ window.__ModuleLoader__.load({
       { value: "vi", label: "Tiếng Việt" }
 ];
     const NPM_NAME = 'dsh-nextsteps';
+    const MODELS_ROUTE = '/api/dsh-nextsteps.models';
+    const GENERATE_ROUTE = '/api/dsh-nextsteps.generate';
+    let modelCatalogCache = undefined;
+
+    async function loadModelCatalog(force) {
+      if (modelCatalogCache === undefined || force === true) {
+        try {
+          const response = await fetch(MODELS_ROUTE, { cache: 'no-store' });
+          const data = await response.json();
+          if (data !== null && typeof data === 'object' && data.ok === true) modelCatalogCache = data;
+        } catch (error) {
+          console.warn('dsh-nextsteps: model catalog unavailable:', error);
+        }
+      }
+      return modelCatalogCache;
+    }
     const ICON_DATAURI = 'data:image/svg+xml;utf8,%3Csvg%20xmlns%3D%22http%3A%2F%2Fwww.w3.org%2F2000%2Fsvg%22%20viewBox%3D%220%200%20256%20256%22%20role%3D%22img%22%20aria-label%3D%22Nextsteps%20icon%22%3E%0A%20%20%3Crect%20width%3D%22256%22%20height%3D%22256%22%20rx%3D%2256%22%20fill%3D%22%230d0d10%22%2F%3E%0A%20%20%3Crect%20x%3D%2252%22%20y%3D%2264%22%20width%3D%22152%22%20height%3D%2244%22%20rx%3D%2210%22%20fill%3D%22%231f242b%22%20stroke%3D%22%234b5563%22%20stroke-width%3D%223%22%2F%3E%0A%20%20%3Crect%20x%3D%2252%22%20y%3D%22124%22%20width%3D%22152%22%20height%3D%2244%22%20rx%3D%2210%22%20fill%3D%22%231f242b%22%20stroke%3D%22%234b5563%22%20stroke-width%3D%223%22%2F%3E%0A%20%20%3Crect%20x%3D%2252%22%20y%3D%22184%22%20width%3D%22152%22%20height%3D%2244%22%20rx%3D%2210%22%20fill%3D%22%23e5484d%22%2F%3E%0A%20%20%3Cpath%20d%3D%22M84%20206h72M136%20194l14%2012-14%2012%22%20stroke%3D%22%23ffffff%22%20stroke-width%3D%228%22%20stroke-linecap%3D%22round%22%20stroke-linejoin%3D%22round%22%20fill%3D%22none%22%2F%3E%0A%20%20%3Cpath%20d%3D%22M76%2086h96M76%20146h96%22%20stroke%3D%22%236b7280%22%20stroke-width%3D%227%22%20stroke-linecap%3D%22round%22%2F%3E%0A%3C%2Fsvg%3E%0A';
     const SETTINGS_ROUTE = '/api/dsh-nextsteps.settings';
     const UPDATE_ROUTE = '/api/dsh-nextsteps.update';
     const DICTIONARIES = {
-      en: {"header":"Suggested followups","showEarlier":"Show earlier suggestions","hideEarlier":"Hide earlier suggestions","srFollowupSent":"Followup sent","sendFailed":"Could not send: ","intro":"Suggested next-step prompts under every finished agent turn — one click sends the followup.","setLanguage":"Language","setLanguageTip":"Followups are generated in this language. Auto follows the conversation.","optAuto":"Auto (follow the conversation)","optEn":"English","optPt":"Português (Brasil)","optZh":"简体中文","setMax":"Followups per turn","setMaxTip":"How many suggested prompts the model should produce (1-6).","setHeader":"Show header","setHeaderTip":"The small “Suggested followups” label above the cards.","updates":"Updates","current":"Version","checking":"Checking…","upToDate":"up to date","available":"{v} is available","manualCopy":"Development or renamed copy — update it manually.","installing":"Installing {v}…","restartMsg":"Version {v} was installed. Restart the dsh to use it.","noReleases":"No releases published yet","checkFailed":"Update check failed ({e})","updateNow":"Update now","check":"Check for updates","openRelease":"Open release page","releaseNotes":"Release notes","repo":"GitHub repository","issues":"Report an issue"},
+      en: {"header":"Suggested followups","showEarlier":"Show earlier suggestions","hideEarlier":"Hide earlier suggestions","srFollowupSent":"Followup sent","sendFailed":"Could not send: ","intro":"Suggested next-step prompts under every finished agent turn — one click sends the followup.","setLanguage":"Language","setLanguageTip":"Followups are generated in this language. Auto follows the conversation.","optAuto":"Auto (follow the conversation)","optEn":"English","optPt":"Português (Brasil)","optZh":"简体中文",setModel:"Model","setModelTip":"The model that generates the suggestions. Auto keeps them inside the main turn.","optModelAuto":"Auto (same model as the chat)",setModel:"Modelo","setModelTip":"O modelo que gera as sugestões. Automático as mantém no turno principal.","optModelAuto":"Automático (mesmo modelo da conversa)",setModel:"模型","setModelTip":"生成建议的模型。自动会跟随对话所用的模型。","optModelAuto":"自动（与对话相同的模型）","setMax":"Followups per turn","setMaxTip":"How many suggested prompts the model should produce (1-6).","setHeader":"Show header","setHeaderTip":"The small “Suggested followups” label above the cards.","updates":"Updates","current":"Version","checking":"Checking…","upToDate":"up to date","available":"{v} is available","manualCopy":"Development or renamed copy — update it manually.","installing":"Installing {v}…","restartMsg":"Version {v} was installed. Restart the dsh to use it.","noReleases":"No releases published yet","checkFailed":"Update check failed ({e})","updateNow":"Update now","check":"Check for updates","openRelease":"Open release page","releaseNotes":"Release notes","repo":"GitHub repository","issues":"Report an issue"},
       'pt-BR': {"header":"Sugestões de acompanhamento","showEarlier":"Mostrar sugestões anteriores","hideEarlier":"Ocultar sugestões anteriores","srFollowupSent":"Follow-up enviado","sendFailed":"Não consegui enviar: ","intro":"Sugestões de próximos passos sob cada turno concluído do agente — um clique envia o followup.","setLanguage":"Idioma","setLanguageTip":"Os followups são gerados neste idioma. Automático segue a conversa.","optAuto":"Automático (segue a conversa)","optEn":"English","optPt":"Português (Brasil)","optZh":"简体中文","setMax":"Followups por turno","setMaxTip":"Quantas sugestões o modelo deve produzir (1-6).","setHeader":"Mostrar cabeçalho","setHeaderTip":"O rótulo pequeno “Sugestões de acompanhamento” acima dos cartões.","updates":"Atualizações","current":"Versão","checking":"Verificando…","upToDate":"em dia","available":"{v} disponível","manualCopy":"Cópia de desenvolvimento ou renomeada — atualize manualmente.","installing":"Instalando {v}…","restartMsg":"Versão {v} instalada. Reinicie o dsh para usá-la.","noReleases":"Nenhum release publicado ainda","checkFailed":"Falha ao verificar atualizações ({e})","updateNow":"Atualizar agora","check":"Verificar atualizações","openRelease":"Abrir página do release","releaseNotes":"Notas do release","repo":"Repositório no GitHub","issues":"Reportar um problema"},
       'zh-CN': {"header":"建议的后续操作","showEarlier":"显示较早的建议","hideEarlier":"隐藏较早的建议","srFollowupSent":"后续操作已发送","sendFailed":"发送失败：","intro":"在每个智能体回合完成后的下方推荐下一步提示——单击即可发送。","setLanguage":"语言","setLanguageTip":"后续操作提示将以此语言生成。“自动”会跟随对话语言。","optAuto":"自动（跟随对话）","optEn":"English","optPt":"Português (Brasil)","optZh":"简体中文","setMax":"每回合提示数","setMaxTip":"模型应生成的建议提示数量（1-6）。","setHeader":"显示标题","setHeaderTip":"卡片上方的小标题“建议的后续操作”。","updates":"更新","current":"版本","checking":"检查中…","upToDate":"已是最新","available":"{v} 可用","manualCopy":"开发或重命名的副本——请手动更新。","installing":"正在安装 {v}…","restartMsg":"版本 {v} 已安装。请重启 dsh 以使用。","noReleases":"尚未发布任何版本","checkFailed":"检查更新失败（{e}）","updateNow":"立即更新","check":"检查更新","openRelease":"打开发布页","releaseNotes":"发布说明","repo":"GitHub 仓库","issues":"反馈问题"}
     };
@@ -456,6 +472,7 @@ window.__ModuleLoader__.load({
       return function SuggestFollowupsTail(props) {
         const sessionId = typeof props.sessionId === 'string' ? props.sessionId : '';
         const turn = turnIdOf(props.turn);
+        const afterSeq = props.turn !== null && typeof props.turn === 'object' && Number.isSafeInteger(props.turn.end?.seq) ? props.turn.end.seq : undefined;
         const [, refresh] = React.useReducer((count) => count + 1, 0);
         React.useEffect(() => {
           captureListeners.add(refresh);
@@ -463,9 +480,26 @@ window.__ModuleLoader__.load({
             captureListeners.delete(refresh);
           };
         }, []);
-
-
-
+        const generatedRef = React.useRef(null);
+        React.useEffect(() => {
+          if (pluginSettings.model === '' || sessionId === '' || turn === undefined || afterSeq === undefined) return undefined;
+          const key = sessionId + '|' + turn;
+          if (generatedRef.current === key) return undefined;
+          if (captureForTurn(sessionId, turn) !== null) return undefined;
+          generatedRef.current = key;
+          let alive = true;
+          (async () => {
+            try {
+              const response = await fetch(GENERATE_ROUTE, { method: 'POST', headers: { 'content-type': 'application/json' }, body: JSON.stringify({ sessionId, afterSeq }) });
+              const data = await response.json();
+              if (!alive || !response.ok || data === null || typeof data !== 'object' || !Array.isArray(data.followups) || data.followups.length === 0) return;
+              rememberCapture(sessionId, 'generated-' + turn, turn, validateFollowups(data.followups));
+            } catch (error) {
+              console.warn('dsh-nextsteps: generation failed:', error);
+            }
+          })();
+          return () => { alive = false; };
+        }, [sessionId, turn, afterSeq]);
         let entry = turn !== undefined ? captureForTurn(sessionId, turn) : newestCapture(sessionId);
         if (entry === null) {
           const unclaimed = unclaimedCaptures(sessionId, turn);
@@ -490,13 +524,19 @@ window.__ModuleLoader__.load({
           refreshPluginSettings().then((loaded) => setSettings({ ...loaded }));
           check();
         }, []);
+        const [models, setModels] = React.useState(() => modelCatalogCache);
+        React.useEffect(() => {
+          let alive = true;
+          loadModelCatalog(true).then((catalog) => { if (alive) setModels(catalog); });
+          return () => { alive = false; };
+        }, []);
         const save = async (patch) => {
           const merged = { ...settings, ...patch };
           setSettings(merged);
           try {
             const response = await fetch(SETTINGS_ROUTE, { method: 'POST', headers: { 'content-type': 'application/json' }, body: JSON.stringify(patch) });
             const data = await response.json();
-            if (data !== null && typeof data === 'object' && data.ok === true && data.settings !== null && typeof data.settings === 'object') setSettings(data.settings);
+            if (data !== null && typeof data === 'object' && data.ok === true && data.settings !== null && typeof data.settings === 'object') { pluginSettings = data.settings; setSettings(data.settings); }
           } catch (error) {
             console.warn('dsh-nextsteps: settings save failed:', error);
           }
@@ -564,6 +604,10 @@ window.__ModuleLoader__.load({
           row(t('setLanguage'), t('setLanguageTip'), h('select', { value: settings.lang, onChange: (event) => save({ lang: event.target.value }), style: controlStyle, 'aria-label': t('setLanguage') },
                       h('option', { value: 'auto' }, t('optAuto')),
           ...LANGUAGE_OPTIONS.map((option) => h('option', { key: option.value, value: option.value }, option.label))), 'lang'),
+          row(t('setModel'), t('setModelTip'), (models === undefined || (models.groups ?? []).length === 0) ? h('span', { style: { fontSize: 12, color: 'var(--dsw-alias-label-tertiary)' } }, t('checking')) : h('select', { value: settings.model, onChange: (event) => save({ model: event.target.value }), style: controlStyle, 'aria-label': t('setModel') },
+            h('option', { value: '' }, t('optModelAuto')),
+            ...(models.groups ?? []).map((group) => h('optgroup', { key: group.id, label: group.name },
+              group.models.map((entry) => h('option', { key: group.id + '/' + entry.id, value: group.id + '/' + entry.id }, entry.name === entry.id ? entry.name : entry.name + ' (' + entry.id + ')'))))), 'model'),
           row(t('setMax'), t('setMaxTip'), h('input', { type: 'number', min: 1, max: 6, value: settings.maxFollowups, onChange: (event) => save({ maxFollowups: Number(event.target.value) }), style: { ...controlStyle, width: 64 }, 'aria-label': t('setMax') }), 'max'),
           row(t('setHeader'), t('setHeaderTip'), h('input', { type: 'checkbox', checked: settings.showHeader, onChange: (event) => save({ showHeader: event.target.checked }), 'aria-label': t('setHeader') }), 'header'),
           h('div', { style: { display: 'flex', alignItems: 'center', justifyContent: 'space-between', gap: 24, padding: '14px 0', borderBottom: '.5px solid var(--dsw-alias-border-l1)', flexWrap: 'wrap' } },

package/index.js

@@ -6,11 +6,13 @@ import path from 'node:path';
 
 const TOOL_NAME = 'suggest_followups';
 const name = 'dsh-nextsteps';
-const inject = ['tools', 'connection'];
+const inject = ['tools', 'connection', 'sessionQuery'];
 const NPM_NAME = 'dsh-nextsteps';
 const RELEASES_URL = 'https://api.github.com/repos/klaus-2/dsh-nextsteps/releases/latest';
 const SETTINGS_FILE = path.join(homedir(), '.dsh', 'dsh-nextsteps', 'settings.json');
 const PACKAGE = JSON.parse(readFileSync(new URL('./package.json', import.meta.url), 'utf8'));
+const GENERATE_TIMEOUT_MS = 30000;
+const GENERATE_MAX_TOKENS = 500;
 
 const LANGUAGE_NAMES = {
   auto: "the same language as the conversation",
@@ -31,16 +33,25 @@ const LANGUAGE_NAMES = {
   'vi': "Vietnamese"
 };
 
+function modelKeyOf(stored) {
+  if (stored === null || typeof stored !== 'object') return '';
+  if (typeof stored.model === 'string') return stored.model.includes('/') ? stored.model : '';
+  const provider = typeof stored.provider === 'string' ? stored.provider : '';
+  const model = typeof stored.model === 'string' ? stored.model : '';
+  return provider !== '' && model !== '' ? `${provider}/${model}` : '';
+}
+
 function settingsLoad() {
   try {
     const stored = JSON.parse(readFileSync(SETTINGS_FILE, 'utf8')) ?? {};
     return {
       lang: ["auto","en","pt-BR","zh-CN","es","fr","de","it","ja","ko","ru","ar","hi","id","tr","vi"].includes(stored.lang) ? stored.lang : 'auto',
       maxFollowups: Number.isInteger(stored.maxFollowups) && stored.maxFollowups >= 1 && stored.maxFollowups <= 6 ? stored.maxFollowups : 3,
-      showHeader: stored.showHeader !== false
+      showHeader: stored.showHeader !== false,
+      model: typeof stored.model === 'string' ? (stored.model.includes('/') ? stored.model : '') : modelKeyOf(stored)
     };
   } catch {
-    return { lang: 'auto', maxFollowups: 3, showHeader: true };
+    return { lang: 'auto', maxFollowups: 3, showHeader: true, model: '' };
   }
 }
 
@@ -156,6 +167,114 @@ function parseVersion(value) {
   return match ? [Number(match[1]), Number(match[2]), Number(match[3])] : undefined;
 }
 
+const get = (ctx, serviceName) => { try { return ctx.get?.(serviceName); } catch { return undefined; } };
+
+async function modelCatalog(ctx) {
+  const llm = get(ctx, 'llm');
+  const fallback = get(ctx, 'agentDefaultModel')?.currentSelection?.();
+  const out = {
+    default: typeof fallback?.provider === 'string' && typeof fallback?.model === 'string' && fallback.provider !== '' && fallback.model !== ''
+      ? { provider: fallback.provider, model: fallback.model }
+      : undefined,
+    groups: []
+  };
+  if (llm?.listProviders === undefined) return out;
+  for (const provider of llm.listProviders()) {
+    try {
+      const models = (await llm.listModels(provider.id)).map((entry) => ({ id: entry.id, name: entry.name }));
+      if (models.length > 0) out.groups.push({ id: provider.id, name: provider.name ?? provider.id, models });
+    } catch {
+      continue;
+    }
+  }
+  return out;
+}
+
+function turnTranscript(events, afterSeq) {
+  const lines = [];
+  for (const entry of events) {
+    const event = entry?.event ?? entry;
+    if (event === null || typeof event !== 'object') continue;
+    if (Number.isSafeInteger(afterSeq) && Number.isSafeInteger(event.seq) && event.seq > afterSeq) break;
+    if (event.type === 'user/message' && typeof event.data?.text === 'string') lines.push(`User: ${event.data.text.slice(0, 2000)}`);
+    else if (event.type === 'agent/message' && typeof event.data?.text === 'string') lines.push(`Assistant: ${event.data.text.slice(0, 2000)}`);
+    else if (event.type === 'tool/call' && typeof event.data?.name === 'string') lines.push(`Tool call: ${event.data.name}`);
+  }
+  return lines.join('\n\n');
+}
+
+function generateSystem(settings) {
+  const language = LANGUAGE_NAMES[settings.lang] ?? LANGUAGE_NAMES.auto;
+  return [
+    'You suggest followup prompts the user of a coding-agent chat may want next. You answer with JSON only — no prose, no code fence.',
+    `Output shape: {"followups":[{"prompt":"...","label":"..."}]} with exactly ${settings.maxFollowups} items.`,
+    'Each prompt is one short sentence in the user\'s first-person voice, goal-oriented, standing alone without the transcript; each label is 2-5 words.',
+    `Write every prompt and label in ${language}.`,
+    'Good suggestions: alternatives to the latest change, related features, cleanup, tests, verification steps. If the transcript shows remaining plan steps, one suggestion may continue the next step.'
+  ].join('\n');
+}
+
+function followupsFromModelText(text) {
+  if (typeof text !== 'string' || text === '') return undefined;
+  let parsed;
+  try {
+    parsed = JSON.parse(text.replace(/^```(?:json)?\s*/i, '').replace(/```\s*$/i, '').trim());
+  } catch {
+    const start = text.indexOf('{');
+    const end = text.lastIndexOf('}');
+    if (start === -1 || end <= start) return undefined;
+    try { parsed = JSON.parse(text.slice(start, end + 1)); } catch { return undefined; }
+  }
+  const followups = coerceFollowups(parsed);
+  if (followups === undefined) return undefined;
+  return followups.slice(0, 6).map((entry) => ({ prompt: String(entry.prompt).slice(0, 200), label: entry.label === null ? null : String(entry.label).slice(0, 40) }));
+}
+
+async function generateForTurn(ctx, settings, sessionId, afterSeq, signal) {
+  const sessionQuery = get(ctx, 'sessionQuery');
+  if (sessionQuery?.observeSession === undefined) throw new Error('the sessionQuery service is unavailable');
+  const observation = await sessionQuery.observeSession(sessionId, { signal, projectionMode: 'none' });
+  let transcript;
+  try {
+    const events = observation.events ?? [];
+    const last = events.at(-1)?.event ?? events.at(-1);
+    if (last?.type !== 'turn/end' || last.data?.reason?.kind !== 'completed' || last.seq !== afterSeq) {
+      throw Object.assign(new Error('the chat moved on'), { status: 409 });
+    }
+    transcript = turnTranscript(events, afterSeq);
+  } finally {
+    observation[Symbol.dispose]?.();
+  }
+  if (transcript.trim() === '') return { followups: [] };
+  const catalog = await modelCatalog(ctx);
+  const route = settings.model !== ''
+    ? (() => {
+      const slash = settings.model.indexOf('/');
+      const provider = settings.model.slice(0, slash);
+      const model = settings.model.slice(slash + 1);
+      if (catalog.groups.some((group) => group.id === provider && group.models.some((entry) => entry.id === model))) return { provider, model };
+      throw Object.assign(new Error('the selected model is no longer listed'), { status: 409 });
+    })()
+    : catalog.default;
+  if (route === undefined) throw Object.assign(new Error('no model is selected'), { status: 409 });
+  const llm = get(ctx, 'llm');
+  if (llm?.prepareCall === undefined) throw new Error('the llm service is unavailable');
+  const timeout = AbortSignal.timeout(GENERATE_TIMEOUT_MS);
+  const callSignal = signal === undefined ? timeout : AbortSignal.any([signal, timeout]);
+  const call = await llm.prepareCall(route, callSignal, (controls, model) => {
+    const cap = Number.isSafeInteger(model?.defaultMaxTokens) && model.defaultMaxTokens > 0 ? Math.min(GENERATE_MAX_TOKENS, model.defaultMaxTokens) : GENERATE_MAX_TOKENS;
+    return { ...controls, maxTokens: cap };
+  });
+  let text = '';
+  let finish;
+  for await (const chunk of call.stream({ ...call.config, system: generateSystem(settings), signal: callSignal, messages: [{ role: 'user', content: [{ type: 'text', text: `<transcript>\n${transcript}\n</transcript>\n\nSuggest the followup prompts.` }] }] })) {
+    if (chunk.type === 'text-delta') text += chunk.text;
+    else if (chunk.type === 'finish') finish = chunk.reason;
+  }
+  if (finish?.kind === 'error' || finish?.kind === 'aborted') throw new Error(finish.failure?.message || `the model call ended: ${finish.kind}`);
+  return { followups: followupsFromModelText(text) ?? [], model: route.model };
+}
+
 function newerVersion(latest, current) {
   for (let index = 0; index < 3; index += 1) {
     if ((latest[index] ?? 0) !== (current[index] ?? 0)) return (latest[index] ?? 0) > (current[index] ?? 0);
@@ -181,20 +300,22 @@ async function checkUpdate(fetchImpl = fetch, pkg = PACKAGE, signal) {
 
 async function apply(ctx) {
   let settings = settingsLoad();
+  const json = (value, status = 200) => new Response(JSON.stringify(value), { status, headers: { 'content-type': 'application/json; charset=utf-8', 'cache-control': 'no-store' } });
+  const isExternal = (next) => typeof next.model === 'string' && next.model !== '';
   try {
-    ctx.tools.register(toolSpec(settings));
+    if (!isExternal(settings)) ctx.tools.register(toolSpec(settings));
   } catch (error) {
     console.error('dsh-nextsteps: tool registration failed:', error);
   }
   const reapplyTool = (next) => {
     settings = next;
     try {
-      ctx.tools.register(toolSpec(settings));
+      if (isExternal(next)) ctx.tools.unregister(TOOL_NAME);
+      else ctx.tools.register(toolSpec(settings));
     } catch (error) {
       console.error('dsh-nextsteps: tool re-registration failed:', error);
     }
   };
-  const json = (value, status = 200) => new Response(JSON.stringify(value), { status, headers: { 'content-type': 'application/json; charset=utf-8', 'cache-control': 'no-store' } });
   ctx.connection?.fetch?.register({
     path: '/api/dsh-nextsteps.settings',
     methods: ['GET', 'POST'],
@@ -207,16 +328,50 @@ async function apply(ctx) {
       const next = {
         lang: ["auto","en","pt-BR","zh-CN","es","fr","de","it","ja","ko","ru","ar","hi","id","tr","vi"].includes(body?.lang) ? body.lang : current.lang,
         maxFollowups: Number.isInteger(body?.maxFollowups) && body.maxFollowups >= 1 && body.maxFollowups <= 6 ? body.maxFollowups : current.maxFollowups,
-        showHeader: typeof body?.showHeader === 'boolean' ? body.showHeader : current.showHeader
+        showHeader: typeof body?.showHeader === 'boolean' ? body.showHeader : current.showHeader,
+        model: typeof body?.model === 'string' && body.model.includes('/') ? body.model : body?.model === '' || body?.model === undefined || body?.model === null ? '' : current.model
       };
       await settingsSave(next);
       reapplyTool(next);
       return json({ ok: true, settings: next });
     }
   });
+  ctx.connection?.fetch?.register({
+    path: '/api/dsh-nextsteps.models',
+    methods: ['GET'],
+    requestBody: 'buffered',
+    fetch: async (request) => {
+      try {
+        const catalog = await modelCatalog(ctx);
+        return json({ ok: true, ...catalog });
+      } catch (error) {
+        return json({ error: String(error?.message ?? error) }, 502);
+      }
+    }
+  });
+  ctx.connection?.fetch?.register({
+    path: '/api/dsh-nextsteps.generate',
+    methods: ['POST'],
+    requestBody: 'buffered',
+    fetch: async (request) => {
+      let body;
+      try { body = await request.json(); } catch { return json({ error: 'bad request' }, 400); }
+      if (typeof body?.sessionId !== 'string' || body.sessionId === '' || !Number.isSafeInteger(body?.afterSeq) || body.afterSeq < 0) {
+        return json({ error: 'bad request' }, 400);
+      }
+      try {
+        const result = await generateForTurn(ctx, settings, body.sessionId, body.afterSeq, request.signal);
+        return json({ ok: true, rev: PLUGIN_REV, ...result });
+      } catch (error) {
+        const status = error?.status === 409 || error?.status === 400 ? error.status : 502;
+        return json({ error: String(error?.message ?? error) }, status);
+      }
+    }
+  });
   ctx.connection?.fetch?.register({
     path: '/api/dsh-nextsteps.update',
     methods: ['GET'],
+    requestBody: 'buffered',
     fetch: async (request) => {
       try {
         const info = await checkUpdate(fetch, PACKAGE, request.signal);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-nextsteps",
-  "version": "1.2.0",
+  "version": "1.3.0",
   "type": "module",
   "exports": {
     ".": "./index.js",
@@ -14,7 +14,9 @@
     "lib/locale",
     "docs/assets/icon.png",
     "README.md",
-    "LICENSE"
+    "LICENSE",
+    "README.pt-BR.md",
+    "README.zh-CN.md"
   ],
   "dsh": {
     "bundle": {