@yanglaofish/fishtools 0.5.2 → 0.6.0

package/manual/packages/fst-cli/src/terminal/view.js

@@ -1,10 +1,10 @@
-import { readdirSync, statSync } from 'node:fs';
-import path from 'node:path';
-import { homedir } from 'node:os';
-import { TUI, Text, Container, Editor, SelectList, ProcessTerminal, CombinedAutocompleteProvider, matchesKey, truncateToWidth, visibleWidth } from '@mariozechner/pi-tui';
+import {FileAutocomplete,createAutocompleteProbe} from './file-autocomplete.js';
+export {FileAutocomplete} from './file-autocomplete.js';
+import { TUI, Text, Container, Editor, SelectList, ProcessTerminal, matchesKey, truncateToWidth, visibleWidth } from '@mariozechner/pi-tui';
 import { MarkdownLogViewer } from './log-viewer.js';
 import { RunViewer, mouseOn, mouseOff, mouseWheel } from './run-viewer.js';
 import {RunFeed} from './run-feed.js';
+import {presentationCatalog} from './run-presentation.js';
 import { logo } from './presentation.js';
 import { VERSION } from '@mytools/core/version';
 import {cleanText as safe,palette,menuTheme as theme,fitLine,shortenPath} from './theme.js';
@@ -13,44 +13,9 @@ export const cancelled=()=>Object.assign(new Error('已返回主菜单'),{code:'
 // 上游菜单按字符数分配描述宽度，中文双宽字符需要再按终端列宽收口。
 function fit(component){const render=component.render.bind(component);component.render=width=>render(width).map(line=>truncateToWidth(line,width));return component;}
 
-// Pi 的 @ 模糊搜索依赖额外的 fd 程序。这里按目录补全，离线目标机无需安装 fd。
-export class FileAutocomplete extends CombinedAutocompleteProvider{
-  constructor(commands,baseDir,workflows=[]){super(commands,baseDir);this.baseDir=baseDir;this.workflows=workflows;}
-  getSuggestions(lines,line,col){
-    const run=lines[line].slice(0,col).match(/^\/run\s+([^@"\s]*)$/);
-    if(run){
-      const query=run[1].toLowerCase(),items=this.workflows.filter(flow=>`${flow.id} ${flow.title??''}`.toLowerCase().includes(query)).map(flow=>({value:flow.id,label:flow.title??flow.id,description:flow.id,workflow:true}));
-      return items.length?{prefix:run[1],items}:null;
-    }
-    const prefix=lines[line].slice(0,col).match(/(?:^|\s)(@"[^"\n]*|@[^\s]*)$/)?.[1];
-    if(!prefix)return super.getSuggestions(lines,line,col);
-    const raw=prefix.slice(1).replace(/^"/,'').replaceAll('\\','/');
-    const expanded=raw.startsWith('~/')?path.join(homedir(),raw.slice(2)):raw;
-    const absolute=path.resolve(this.baseDir,expanded||'.');
-    const directory=!raw||raw.endsWith('/')?absolute:path.dirname(absolute);
-    const query=!raw||raw.endsWith('/')?'':path.basename(absolute).toLowerCase();
-    try{
-      const items=readdirSync(directory,{withFileTypes:true}).filter(e=>e.name.toLowerCase().startsWith(query)).map(e=>{
-        let dir=e.isDirectory();if(e.isSymbolicLink()){try{dir=statSync(path.join(directory,e.name)).isDirectory();}catch{}}
-        const head=raw.slice(0,raw.lastIndexOf('/')+1),file=head+e.name+(dir?'/':'');
-        return {value:`@${/[\s"]/.test(file)?JSON.stringify(file):file}`,label:safe(e.name)+(dir?'/':''),description:dir?'目录':'文件',directory:dir};
-      }).sort((a,b)=>(b.description==='目录')-(a.description==='目录')||a.label.localeCompare(b.label)).slice(0,100);
-      return items.length?{prefix,items}:null;
-    }catch{return null;}
-  }
-  getForceFileSuggestions(lines,line,col){return this.getSuggestions(lines,line,col);}
-  applyCompletion(lines,line,col,item,prefix){
-    if(item.workflow){const next=[...lines],before=lines[line].slice(0,col-prefix.length),text=item.value+' ';next[line]=before+text+lines[line].slice(col);return {lines:next,cursorLine:line,cursorCol:before.length+text.length};}
-    if(!prefix.startsWith('@'))return super.applyCompletion(lines,line,col,item,prefix);
-    const before=lines[line].slice(0,col-prefix.length);
-    let after=lines[line].slice(col);if(after.startsWith('"'))after=after.slice(1);
-    const completed=item.value+(item.directory?'':' '),next=[...lines];next[line]=before+completed+after;
-    return {lines:next,cursorLine:line,cursorCol:before.length+completed.length-(item.directory&&item.value.endsWith('"')?1:0)};
-  }
-}
-
 export class TerminalView{
-  constructor({baseDir,previewLabel,terminal=new ProcessTerminal()}={}){
+  constructor({baseDir,previewLabel,terminal=new ProcessTerminal(),fileAutocompleteOptions={}}={}){
+    this.fileAutocompleteOptions=fileAutocompleteOptions;this.fileProviders=new Set();
     this.baseDir=baseDir;this.terminal=terminal;this.tui=new TUI(terminal);this.logs=[];this.runViews=new Map();
     this.historyOffset=0;this.commandHistory=[];this.commandHistoryIndex=null;this.feed=new RunFeed(()=>this.refreshTranscript());
     const originalStart=terminal.start.bind(terminal);
@@ -69,6 +34,7 @@ export class TerminalView{
       }
       if(matchesKey(data,'ctrl+c')){if(this.runViewer){this.runViewer.onClose();return;}if(this.cancelRun)this.cancelRun();this.pending?.reject(cancelled());return;}
       if(matchesKey(data,'escape')&&this.pending&&!this.logViewer&&!this.runViewer){
+        this.editor?.autocompleteProvider?.cancelPending?.();
         // 编辑器自己处理补全菜单 Escape，第二次 Escape 返回上一级。
         if(this.editor?.isShowingAutocomplete?.()){input(data);return;}
         this.pending.reject(cancelled());return;
@@ -87,10 +53,11 @@ export class TerminalView{
         }
         lines.push(line);
       }
-      lines.push(this.homeInput?(width<45?`/ 操作 · ! 命令 · Ctrl+O ${this.feed.expanded?'收起':'展开'}`:`/ 操作 · ! 命令 · Ctrl+O ${this.feed.expanded?'收起':'展开'}详情 · /logs 回看 · Ctrl+C 退出`):this.editor&&this.multilineInput?'↑↓ 移动 · Tab 补全 · Esc 返回 · Ctrl+C 退出':(width<45?'↑↓ 选择  Enter 确认  Esc 返回':'↑↓ 选择   Enter 确认   Tab 补全   Esc 返回   Ctrl+C 退出'));
+      lines.push(this.homeInput?(width<45?`/ 操作 · ! 命令 · Ctrl+O ${this.feed.expanded?'收起':'展开'}`:`/ 操作 · ! 命令 · Ctrl+O ${this.feed.expanded?'收起':'展开'}原始输出 · /logs 回看 · Ctrl+C 退出`):this.editor&&this.multilineInput?'↑↓ 移动 · Tab 补全 · Esc 返回 · Ctrl+C 退出':(width<45?'↑↓ 选择  Enter 确认  Esc 返回':'↑↓ 选择   Enter 确认   Tab 补全   Esc 返回   Ctrl+C 退出'));
       return lines.map(line=>line?fitLine(' '+palette.muted(line),width):'');
     };
-    const renderTranscript=this.transcript.render.bind(this.transcript);
+    const renderText=this.transcript.render.bind(this.transcript);
+    const renderTranscript=width=>{if(this.transcriptWidth!==width)this.updateTranscript(width);return renderText(width);};
     this.headingLines=(width,mark='FISHtools')=>{
       const room=Math.max(1,width-2),lines=[''];
       const summary=(this.summaryText??'').split('\n');
@@ -151,14 +118,31 @@ export class TerminalView{
     this.tui.requestRender();return true;
   }
   async close(){
-    if(this.closed)return;this.closed=true;
-    this.feed.close();
-    // Pi 的渲染排在 nextTick；先排空最后一帧，再恢复终端，避免退出后隐藏光标。
-    await new Promise(resolve=>process.nextTick(resolve));this.tui.stop();
-    if(this.started)this.terminal.write(mouseOff+'\x1b[?1049l');
-    if(this.terminal instanceof ProcessTerminal)process.stdin.pause();
+    if(this.closing)return this.closing;this.closed=true;
+    return this.closing=(async()=>{
+      try{
+        await Promise.all([...this.fileProviders].map(provider=>provider.close()));this.fileProviders.clear();
+        return await this.fileProbe?.close();
+      }finally{
+        this.feed.close();
+        // Pi 的渲染排在 nextTick；先排空最后一帧，再恢复终端，避免退出后隐藏光标。
+        await new Promise(resolve=>process.nextTick(resolve));this.tui.stop();
+        if(this.started)this.terminal.write(mouseOff+'\x1b[?1049l');
+        if(this.terminal instanceof ProcessTerminal)process.stdin.pause();
+      }
+    })();
   }
   summary(text){this.summaryText=safe(text);this.tui.requestRender();}
+  recordCommand(text,{display=false}={}){
+    // 表单参数不写入可召回命令；Shell 原文仍保留末尾换行。
+    const command=text.trimStart().startsWith('!')?text:text.trim();
+    if(!command)return;
+    if(this.commandHistory.at(-1)!==command){
+      this.commandHistory.push(command);if(this.commandHistory.length>100)this.commandHistory.shift();
+      this.commandHistoryIndex=null;this.onHistoryChange?.();
+    }
+    if(display)this.feed.message('› '+safe(command));
+  }
   beginCommand(text){
     const name=text.trim().split(/\s+/)[0].replace(/^\//,'');
     const labels={workflows:'工作流',run:'运行工作流',plugin:'插件管理',plugins:'插件管理',config:'工具配置',pack:'打包',logs:'执行记录',runs:'执行记录',tools:'工具',help:'帮助',exit:'退出'};
@@ -168,19 +152,22 @@ export class TerminalView{
   endCommand(){
     this.commandLocation=null;this.tui.requestRender();
   }
-  transcriptText(){return [...this.logs,this.feed.text()].filter(Boolean).join('\n\n');}
+  transcriptText(width=this.terminal.columns){return [...this.logs,this.feed.text(Math.max(1,width-2))].filter(Boolean).join('\n\n');}
   refreshTranscript(){
     const width=this.terminal.columns,previous=this.transcript.render===undefined?0:new Text(safe(this.lastTranscript??''),1,0).render(width).length;
-    const text=safe(this.transcriptText());
+    const text=safe(this.transcriptText(width));
     if(this.historyOffset>0)this.historyOffset=Math.max(0,this.historyOffset+new Text(text,1,0).render(width).length-previous);
-    this.lastTranscript=text;this.transcript.setText(text.split('\n').map(line=>line.startsWith('✗ ')?palette.error(line):/^[›✓●] /.test(line)?palette.brand(line):line.startsWith('↩ ')?palette.muted(line):line).join('\n'));this.tui.requestRender();
+    this.updateTranscript(width,text);this.tui.requestRender();this.onHistoryChange?.();
+  }
+  updateTranscript(width,text=safe(this.transcriptText(width))){
+    this.transcriptWidth=width;this.lastTranscript=text;this.transcript.setText(text.split('\n').map(line=>line.startsWith('✗ ')?palette.error(line):/^[›✓●] /.test(line)?palette.brand(line):line.startsWith('↩ ')?palette.muted(line):line).join('\n'));
   }
   trackRun(options){this.feed.track(options);}
   clearMessages(){this.logs=[];this.refreshTranscript();}
   show(message,{kind='message'}={}){
     const text=safe(message).slice(0,6000);
     const formatted=kind==='welcome'?text.split('\n').map((line,i)=>i===0?palette.text(line):palette.muted(line)).join('\n'):text;
-    if(kind!=='welcome'){this.feed.message(formatted);return;}
+    if(kind!=='welcome'){this.feed.message(safe(message));return;}
     this.logs.push(formatted);this.logs=this.logs.slice(-6);this.refreshTranscript();
   }
   async viewMarkdown(title,text){
@@ -190,7 +177,7 @@ export class TerminalView{
     try{
       await new Promise((resolve,reject)=>{
         this.pending={resolve,reject};
-        this.logViewer=new MarkdownLogViewer({title:safe(title),text:safe(text),terminal:this.terminal,onClose:resolve,requestRender:()=>this.tui.requestRender()});
+        this.logViewer=new MarkdownLogViewer({title:safe(title),text,terminal:this.terminal,onClose:resolve,requestRender:()=>this.tui.requestRender()});
         this.terminal.write(mouseOn);
         // Overlay 的基底为空，旧 transcript 不再撑高滚动区域；关闭后原样恢复。
         this.tui.children=[];
@@ -204,25 +191,47 @@ export class TerminalView{
     }
   }
   async observeRun({app,runId,record,flow,workflows=[],initialView}){
-    const previousPending=this.pending??null,children=this.tui.children;let overlay,unsubscribe,readPages=false;
+    let options={app,runId,record,flow,workflows,initialView};
+    for(;;){
+      const output=await this.observeRunPage(options);if(output===undefined)return;
+      await this.viewMarkdown('执行结果',output);options={...options,record:undefined,initialView:undefined};
+    }
+  }
+  async observeRunPage({app,runId,record,flow,workflows=[],initialView}){
+    const previousPending=this.pending??null,children=this.tui.children;let overlay,unsubscribe,unsubscribeFinished,elapsedTimer,readPages=false,renderedOutput;
     const initial=app.getRun(runId)??record??await app.readRun(runId);
     if(!initial)throw new Error('这次运行记录已不存在');
     try{
       await new Promise((resolve,reject)=>{
         this.pending={resolve,reject};
-        this.runViewer=new RunViewer({record:initial,flow:initial.status==='running'?flow:undefined,workflows,catalog:app.catalog?.()??[],terminal:this.terminal,onClose:resolve,onCancel:()=>app.cancelRun(runId),onReadLogs:app.readLogPage?()=>{readPages=true;resolve();}:undefined,requestRender:()=>this.tui.requestRender()});
-        Object.assign(this.runViewer,this.runViews.get(runId)??{});
-        if(initialView!==undefined){this.runViewer.view=initialView;this.runViewer.offset=0;}
-        unsubscribe=app.subscribe(event=>{if(event.runId===runId)this.runViewer?.update(app.getRun(runId));});
+        const viewer=new RunViewer({record:initial,flow:initial.status==='running'?flow:undefined,workflows,catalog:presentationCatalog(app),terminal:this.terminal,onClose:resolve,onCancel:()=>app.cancelRun(runId),onReadLogs:app.readLogPage?()=>{readPages=true;resolve();}:undefined,onReadOutput:()=>{renderedOutput=width=>viewer.getRenderedOutput(width,{markdown:true});resolve();},requestRender:()=>this.tui.requestRender()});
+        this.runViewer=viewer;Object.assign(viewer,this.runViews.get(runId)??{});
+        if(initialView!==undefined){viewer.view=initialView;viewer.offset=0;}
+        const stopElapsed=()=>{if(elapsedTimer){clearInterval(elapsedTimer);elapsedTimer=null;}};
+        const finish=record=>{
+          if(this.runViewer!==viewer)return;
+          viewer.update(record);stopElapsed();
+        };
+        // 收尾晚于终态事件时补最终状态；关闭页面解除监听，不让长任务留住旧阅读器。
+        unsubscribeFinished=this.feed.subscribeFinished(runId,finish);
+        unsubscribe=app.subscribe(event=>{if(event.runId===runId&&this.runViewer===viewer)viewer.update(app.getRun(runId));});
+        if(initial.status==='running')elapsedTimer=setInterval(()=>{
+          const record=app.getRun(runId)??this.feed.runs.get(runId)?.record;viewer.update(record);
+          if(!record||record.status!=='running')stopElapsed();
+          if(!record&&app.readRun)void app.readRun(runId).then(record=>{if(this.runViewer===viewer)viewer.update(record);},()=>{});
+        },1000);
+        elapsedTimer?.unref?.();
         this.tui.children=[];this.terminal.write(mouseOn);
         overlay=this.tui.showOverlay(this.runViewer,{width:'100%',maxHeight:'100%',anchor:'top-left',margin:0});this.tui.requestRender(true);
       });
     }finally{
       if(this.runViewer){const {view,selected,offset,follow,allLogs,raw}=this.runViewer;this.runViews.set(runId,{view,selected,offset,follow,allLogs,raw});}
       if(this.runViews.size>30)this.runViews.delete(this.runViews.keys().next().value);
-      unsubscribe?.();this.runViewer=null;this.tui.children=children;this.pending=previousPending;overlay?.hide();this.terminal.write(mouseOff);this.tui.requestRender(true);
+      unsubscribe?.();unsubscribeFinished?.();this.runViewer=null;this.tui.children=children;this.pending=previousPending;overlay?.hide();this.terminal.write(mouseOff);this.tui.requestRender(true);
+      if(elapsedTimer)clearInterval(elapsedTimer);
     }
     if(readPages)await this.viewLogPages(app,runId);
+    return renderedOutput;
   }
   async viewLogPages(app,id){
     let cursor=0;const previous=[];
@@ -242,17 +251,16 @@ export class TerminalView{
   }
   async ask(message,component){
     fit(component);
-    const title=new Text(palette.brand('› ')+palette.text(safe(message)),1,0);
-    const renderTitle=title.render.bind(title);
-    title.render=width=>[fitLine(' '+palette.border('─'.repeat(Math.max(1,width-2))),width),...renderTitle(width)];
-    if(message.startsWith('fst >'))title.render=()=>[];
+    const title=new Text('',1,0);
+    // 参数预览可随窗口尺寸重新排版；普通字符串标题保持原有行为。
+    title.render=width=>{
+      const text=typeof message==='function'?message(width,this.terminal.rows):message;
+      return [fitLine(' '+palette.border('─'.repeat(Math.max(1,width-2))),width),...new Text(palette.brand('› ')+palette.text(safe(text)),1,0).render(width)];
+    };
+    if(typeof message==='string'&&message.startsWith('fst >'))title.render=()=>[];
     this.prompt.clear();this.prompt.addChild(title);this.prompt.addChild(component);this.tui.setFocus(component);this.tui.requestRender();
     try{return await new Promise((resolve,reject)=>{this.pending={resolve,reject};component.onSubmit=text=>{
-      // Shell 历史保留末尾换行，避免再次执行时改变反斜杠续行等语义。
-      const historyText=text.trimStart().startsWith('!')?text:text.trim();
-      if(this.homeInput&&historyText&&this.commandHistory.at(-1)!==historyText){
-        this.commandHistory.push(historyText);if(this.commandHistory.length>100)this.commandHistory.shift();
-      }
+      if(this.homeInput)this.recordCommand(text);
       resolve(text);
     };component.onSelect=item=>resolve(item.value);component.onCancel=()=>reject(cancelled());});}
     finally{if(this.homeInput)this.terminal.write(mouseOff);this.pending=null;this.editor=null;this.homeInput=false;this.multilineInput=false;this.prompt.clear();this.tui.requestRender();}
@@ -298,14 +306,41 @@ export class TerminalView{
     if(this.homeInput)this.terminal.write(mouseOn);
     this.editor=editor;editor.setText(this.homeInput?(this.homeDraft??value):value);
     if(this.homeInput)this.homeDraft=undefined;
-    if(files||commands.length)editor.setAutocompleteProvider(new FileAutocomplete(commands,this.baseDir,workflows));
-    return this.ask(message,editor);
+    let provider;
+    if(files||commands.length){
+      // 预算属于整个终端；未退出的 worker 不能因切换输入框而被遗忘。
+      this.fileProbe??=createAutocompleteProbe(this.fileAutocompleteOptions);
+      provider=new FileAutocomplete(commands,this.baseDir,workflows,{...this.fileAutocompleteOptions,probe:this.fileProbe,ownsProbe:false,files,onUpdate:snapshot=>{
+        const cursor=editor.getCursor();
+        if(this.closed||this.editor!==editor||!this.pending||this.logViewer||this.runViewer||editor.getText()!==snapshot.lines.join('\n')||cursor.line!==snapshot.line||cursor.col!==snapshot.col)return;
+        // pi-tui 的 updateAutocomplete 只更新已打开的菜单；冷缓存要用此入口重新建立候选。
+        // 此调用只更新菜单，绝不调用 applyCompletion 或合成 Tab 按键。
+        editor.tryTriggerAutocomplete();this.tui.requestRender();
+      }});
+      this.fileProviders.add(provider);editor.setAutocompleteProvider(provider);
+      const input=editor.handleInput.bind(editor);
+      editor.handleInput=data=>{
+        const before=editor.getText();provider.cancelPending();input(data);
+        const cursor=editor.getCursor(),text=editor.getLines()[cursor.line].slice(0,cursor.col);
+        // 冷缓存时上游已收起菜单，继续输入不会走 updateAutocomplete，需再次触发查询。
+        if(editor.getText()!==before&&text&&!/\s$/.test(text)&&!editor.isShowingAutocomplete())editor.tryTriggerAutocomplete();
+      };
+    }
+    return this.ask(message,editor).finally(async()=>{if(provider){await provider.close();this.fileProviders.delete(provider);}});
   }
   async select(message,items){
     if(!items.length)throw new Error('当前没有可选择的项目');
-    const list=new SelectList(items.map(i=>({...i,label:safe(i.label).replace(/\s+/g,' '),description:i.description?safe(i.description).replace(/\s+/g,' '):undefined})),8,theme);
+    const visibleItems=()=>items.filter(item=>!item.hidden?.()).map(i=>({...i,label:safe(i.label).replace(/\s+/g,' '),description:i.description?safe(i.description).replace(/\s+/g,' '):undefined}));
+    const list=new SelectList(visibleItems(),8,theme);
     list.render=width=>{
-      const reserved=this.headingLines(width).length+new Text(palette.text(safe(message)),1,0).render(width).length+this.hint.render(width).length+2;
+      // 缩放窗口后保留当前选项；只显示此刻确实需要的展开入口。
+      const selected=list.getSelectedItem()?.value;
+      const previousIndex=list.selectedIndex;
+      list.filteredItems=visibleItems();
+      const selectedIndex=list.filteredItems.findIndex(item=>item.value===selected);
+      list.selectedIndex=selectedIndex>=0?selectedIndex:Math.min(previousIndex,list.filteredItems.length-1);
+      const text=typeof message==='function'?message(width,this.terminal.rows):message;
+      const reserved=this.headingLines(width).length+new Text(palette.text(safe(text)),1,0).render(width).length+this.hint.render(width).length+2;
       list.maxVisible=Math.max(1,Math.min(8,this.terminal.rows-reserved));
       const start=Math.max(0,Math.min(list.selectedIndex-Math.floor(list.maxVisible/2),list.filteredItems.length-list.maxVisible));
       const end=Math.min(start+list.maxVisible,list.filteredItems.length),lines=[];

package/manual/packages/fst-cli/src/terminal/workflow-menu.js

@@ -3,7 +3,7 @@ export async function workflowMenu(session){
   while(true){
     const workflows=await app.listWorkflows();
     const choice=await ui.select('工作流 · 选择后编辑或执行',[
-      ...workflows.map(flow=>({value:`workflow:${flow.id}`,label:flow.title??flow.id,description:`${flow.id} · ${flow.steps.length} 步`})),
+      ...workflows.map(flow=>({value:`workflow:${flow.id}`,label:flow.title??flow.id,description:flow.status==='invalid'?flow.diagnostic.message:`${flow.id} · ${flow.steps.length} 步`})),
       ...(!app.project.readOnly?[{value:'new',label:'＋ 新建工作流'}]:[]),
       ...(session.dirty?[{value:'draft',label:`继续编辑草稿：${session.flow.title}`}]:[]),
       {value:'back',label:'返回主面板'},
@@ -11,10 +11,12 @@ export async function workflowMenu(session){
     if(choice==='back')return;
     try{
       const id=choice.startsWith('workflow:')?choice.slice(9):null;
+      const selected=workflows.find(flow=>flow.id===id);
+      if(selected?.status==='invalid'){ui.show(`工作流不可用：${selected.diagnostic.message}`);continue;}
       if(choice==='new'){if(await session.execute('/new')===false)continue;}
       else if(choice!=='draft'&&session.flow?.id!==id){
         if(!await session.discard())continue;
-        session.flow=structuredClone(workflows.find(flow=>flow.id===id));session.dirty=false;
+        session.loadWorkflow(workflows.find(flow=>flow.id===id));
       }
       if(await editWorkflow(session)==='running')return;
     }catch(error){if(error.code!=='PROMPT_CANCELLED')throw error;}
@@ -30,18 +32,23 @@ async function editWorkflow(session){
       ...(!app.project.readOnly?[
         {value:'add',label:'添加步骤 / 控制流'}, {value:'steps',label:'编辑步骤、参数与顺序'},
         {value:'outputs',label:'设置最终输出'},{value:'save',label:'保存工作流'},
-        {value:'duplicate',label:'复制为新工作流（包含当前未保存修改）'},
-        {value:'delete',label:'删除工作流（保留可恢复备份）'},
+        {value:'duplicate',label:`复制为新工作流${session.dirty?'（包含当前未保存修改）':''}`},
+        {value:'delete',label:'删除工作流'},
       ]:[{value:'steps',label:'查看步骤'}]),
-      {value:'back',label:'返回工作流列表（保留草稿）'},
+      {value:'back',label:`返回工作流列表${session.dirty?'（保留草稿）':''}`},
     ]);
     if(choice==='back')return;
     try{
       if(choice==='delete'){
-        if(!await ui.confirm(`删除 ${flow.title??flow.id}？已保存文件会移入备份，未保存修改将放弃。`))continue;
         const exists=(await app.listWorkflows()).some(w=>w.id===flow.id);
-        const backup=exists?await app.removeWorkflow(flow.id):null;
-        session.flow=null;session.dirty=false;ui.show(backup?`工作流已移入备份：${backup}`:'未保存的草稿已删除。');return;
+        const operation=await ui.select(`删除 ${flow.title??flow.id}？${session.dirty?'当前未保存修改将放弃。':''}`, [
+          {value:'cancel',label:'取消，返回'},
+          ...(exists?[{value:'backup',label:'备份后删除',description:'保留已保存文件，可恢复'},
+            {value:'delete',label:'直接删除',description:'不创建本次删除的备份'}]:[{value:'delete',label:'丢弃未保存的草稿'}]),
+        ]);
+        if(operation==='cancel')continue;
+        const backup=exists?await app.removeWorkflow(flow.id,{backup:operation==='backup'}):null;
+        session.loadWorkflow(null);ui.show(backup?`工作流已移入备份：${backup}`:exists?'工作流已删除，未创建本次删除的备份。':'未保存的草稿已丢弃。');return;
       }
       if(choice==='run'){
         if(await session.startRun([],{draft:true}))return 'running';
@@ -55,6 +62,6 @@ async function duplicateIntoSession(session,source){
   const title=(await session.ui.input('新工作流名称',{value:`${source.title??source.id} 副本`,files:false})).trim();
   if(!title)throw new Error('名称不能为空');
   const {definition}=await session.app.duplicateWorkflow(source,{title});
-  session.flow=structuredClone(definition);session.dirty=false;
-  session.ui.show(`已创建副本：${definition.title}（${definition.id}）。原工作流 ${source.id} 未修改。可在父工作流中依次加入原版和副本两个子流程步骤，比较输出和耗时。`);
+  session.loadWorkflow(definition);
+  session.ui.show(`已创建副本：${definition.title}（${definition.id}）。原工作流 ${source.id} 未修改。`);
 }

package/manual/packages/fst-devtools/README.md

@@ -19,6 +19,8 @@
 
 ## 维护与验证
 
+`plugin lint` 的 `UNMANAGED_PROCESS` 迁移警告识别可追溯的 child_process、execa、cross-spawn、shelljs.exec 及平台底层 runProcess 调用，指向文件行列并建议上下文 ctx.runProcess。只导入未调用、注释、字符串及无法确认的局部重名不据此告警。诊断保持 warning，不拒绝旧插件；复杂动态代码、依赖内部和解释器内部不保证覆盖，不构成安全隔离。
+
 本模块负责上述职责的实现、文档与回归；跨模块接口调整需要同时检查生产者与消费者。具体维护人员尚未指定。
 
 在仓库根目录执行：

package/manual/packages/fst-devtools/package.json

@@ -16,14 +16,14 @@
   ],
   "license": "MIT",
   "engines": {
-    "node": ">=24.15.0"
+    "node": "^22.22.2 || >=24.0.0"
   },
   "dependencies": {
     "@mytools/sdk": "0.1.0",
     "@mytools/fst-platform": "0.1.0",
     "@mytools/fst-plugin": "0.1.0",
     "semver": "7.7.4",
-    "validate-npm-package-name": "8.0.0",
+    "validate-npm-package-name": "7.0.2",
     "acorn": "8.19.0"
   }
 }

package/manual/packages/fst-devtools/src/plugin-quality.js

@@ -3,6 +3,7 @@ import {readFile,realpath} from 'node:fs/promises';
 import {isBuiltin,createRequire} from 'node:module';
 import {fileURLToPath,pathToFileURL} from 'node:url';
 import {parse} from 'acorn';
+import {inspectProcessUsage} from './process-usage.js';
 
 const nonempty=value=>typeof value==='string'&&value.trim().length>0;
 function inspectSchema(schema,location,warning,seen=new WeakSet()){
@@ -84,6 +85,8 @@ function sourceReferences(ast,commonjs,warning,location){
       base?.type==='MemberExpression'&&!base.computed&&base.property.name==='url'&&base.object.type==='MetaProperty'&&base.object.meta.name==='import')loaders.add(node.id.name);
   });
   // 保守跳过文件内重名绑定；不把局部对象当作 Node 全局对象。
+  const isRequire=node=>node.callee?.type==='Identifier'&&((commonjs&&!bindings.has('require')&&node.callee.name==='require')||loaders.has(node.callee.name));
+  inspectProcessUsage(ast,{bindings,isRequire,walk},warning,location);
   walk(ast,node=>{
     const at=`${location}:${node.loc.start.line}:${node.loc.start.column+1}`;
     if(['ImportDeclaration','ExportNamedDeclaration','ExportAllDeclaration','ImportExpression'].includes(node.type)&&typeof node.source?.value==='string'){
@@ -91,7 +94,7 @@ function sourceReferences(ast,commonjs,warning,location){
     }
     if(node.type!=='CallExpression')return;
     const callee=node.callee;
-    if(callee.type==='Identifier'&&((commonjs&&!bindings.has('require')&&callee.name==='require')||loaders.has(callee.name))&&typeof node.arguments[0]?.value==='string'){
+    if(isRequire(node)&&typeof node.arguments[0]?.value==='string'){
       references.push({specifier:node.arguments[0].value,at,commonjs:true});
     }
     if(!bindings.has('console')&&callee.type==='MemberExpression'&&callee.object.type==='Identifier'&&callee.object.name==='console'&&

package/manual/packages/fst-devtools/src/plugin-tools.js

@@ -38,6 +38,7 @@ export async function lintPluginDirectory(directory){
   const quality=await import('./plugin-quality.js');
   return {...await inspectPluginDirectory(directory,quality),notes:[...validationNotes(),
     {code:'STATIC_SCAN_LIMITS',message:'源码检查仅覆盖入口可达的本地 JavaScript 和字面量依赖；动态加载、别名调用和局部重名可能无法识别。质量警告不会修改文件，也不代表运行结果或安全保证。'},
+    {code:'UNMANAGED_PROCESS_LIMITS',message:'进程检查只定位可识别的直接调用；动态计算、复杂别名、依赖包及 Python/Shell 内部执行不保证覆盖。迁移警告不阻止旧插件加载，不构成安全隔离或自动提权。'},
   ]};
 }
 
@@ -125,7 +126,7 @@ async function inspectPluginDirectory(directory,quality){
 }
 
 function scaffold(name){
-  const packageJson={name,version:'1.0.0',type:'module',main:'index.js',files:['index.js','test','README.md','LICENSE'],scripts:{test:'node --test'},license:'MIT',engines:{node:'>=24.15.0'}};
+  const packageJson={name,version:'1.0.0',type:'module',main:'index.js',files:['index.js','test','README.md','LICENSE'],scripts:{test:'node --test'},license:'MIT',engines:{node:'^22.22.2 || >=24.0.0'}};
   const plugin=`// 直接导出插件定义，无需安装内部 SDK。\nexport default {\n  id:${JSON.stringify(name)},version:'1.0.0',sdk:'^0.1.0',\n  title:'嵌套输入示例',description:'演示业务结果、嵌套输入和判定预设。',\n  platforms:['win32','linux','darwin'],architectures:['x64','arm64'],\n  actions:{\n    check:{\n      title:'检查请求',description:'根据嵌套请求生成业务结果。',\n      input:{type:'object',properties:{request:{type:'object',properties:{name:{type:'string',minLength:1,title:'姓名'},enabled:{type:'boolean',title:'启用'}},required:['name','enabled'],additionalProperties:false}},required:['request'],additionalProperties:false},\n      output:{type:'object',properties:{ok:{type:'boolean'},message:{type:'string'}},required:['ok','message'],additionalProperties:false},\n      conditions:{passed:{title:'业务通过',path:'ok',op:'eq',value:true}},\n      requirements:{privilege:{win32:{level:'user'},linux:{level:'user'}}},\n      async run({request},{signal}={}){\n        signal?.throwIfAborted?.();\n        return request.enabled?{ok:true,message:\`你好，\${request.name}\`}:{ok:false,message:'已禁用'};\n      },\n    },\n  },\n};\n`;
   const testSource=`import test from 'node:test';\nimport assert from 'node:assert/strict';\nimport plugin from '../index.js';\n\ntest('嵌套参数和业务判定',async()=>{\n  assert.deepEqual(await plugin.actions.check.run({request:{name:'阿青',enabled:true}}),{ok:true,message:'你好，阿青'});\n  assert.deepEqual(await plugin.actions.check.run({request:{name:'阿青',enabled:false}}),{ok:false,message:'已禁用'});\n});\n`;
   const readme=`# ${name}\n\n可独立安装的 Fishtools 插件示例，不依赖尚未公开发布的 SDK。\n\n## 使用\n\n在本目录运行 \`npm test\`，并运行 \`fst plugin validate .\` 检查声明。安装后可将 \`${name}:check\` 加入工作流。\n\n输入示例：\n\n\`\`\`json\n{"request":{"name":"阿青","enabled":true}}\n\`\`\`\n\n输出含 \`ok\` 与 \`message\`。\`ok:false\` 表示业务未通过，但动作仍正常返回；\`conditions.passed\` 可供工作流分支使用。请同步修改 package.json 和 index.js 中的名称、版本，并根据实际支持情况调整 platforms / architectures。\n`;

package/manual/packages/fst-devtools/src/process-usage.js

@@ -0,0 +1,62 @@
+const processMembers=new Set(['spawn','spawnSync','exec','execSync','execFile','execFileSync','fork']);
+const sources=new Set(['node:child_process','child_process','execa','cross-spawn','shelljs','@mytools/fst-platform']);
+const property=node=>node.computed?node.property?.value:node.property?.name;
+
+function launches({source,members}){
+  const names=members[0]==='default'?members.slice(1):members;
+  if(['node:child_process','child_process'].includes(source))return names.length===1&&processMembers.has(names[0]);
+  if(source==='execa')return names.length===0||names.length===1&&['execa','execaSync','execaCommand','execaCommandSync','execaNode','$'].includes(names[0]);
+  if(source==='cross-spawn')return names.length===0||names.length===1&&['spawn','sync'].includes(names[0]);
+  if(source==='shelljs')return names.length===1&&names[0]==='exec';
+  return source==='@mytools/fst-platform'&&names.length===1&&names[0]==='runProcess';
+}
+
+// 仅诊断能追溯到已知模块的调用，不以模块导入本身判定违规，也不执行源码。
+export function inspectProcessUsage(ast,{bindings,isRequire,walk},warning,location){
+  const imported=new Map(),variables=new Map(),mutated=new Set();
+  const rootName=node=>node?.type==='Identifier'?node.name:node?.type==='MemberExpression'?rootName(node.object):undefined;
+  walk(ast,node=>{
+    if(node.type==='ImportDeclaration'&&sources.has(node.source.value))for(const spec of node.specifiers){
+      imported.set(spec.local.name,{source:node.source.value,members:spec.type==='ImportNamespaceSpecifier'?[]:[spec.type==='ImportDefaultSpecifier'?'default':spec.imported.name??spec.imported.value]});
+    }
+    if(node.type==='VariableDeclarator'){
+      if(node.id.type==='Identifier')variables.set(node.id.name,{value:node.init,members:[]});
+      else if(node.id.type==='ObjectPattern')for(const spec of node.id.properties){
+        if(spec.type==='Property'&&spec.value.type==='Identifier'&&(!spec.computed||typeof spec.key.value==='string'))variables.set(spec.value.name,{value:node.init,members:[spec.computed?spec.key.value:spec.key.name??spec.key.value]});
+      }
+    }
+    if(['AssignmentExpression','UpdateExpression','UnaryExpression'].includes(node.type)){
+      const target=node.left??node.argument;
+      if(target?.type==='MemberExpression'&&(node.type!=='UnaryExpression'||node.operator==='delete'))mutated.add(rootName(target));
+      if(node.type==='UpdateExpression'&&target?.type==='Identifier')mutated.add(target.name);
+    }
+  });
+  function resolve(node,seen=new Set()){
+    if(!node)return;
+    if(node.type==='AwaitExpression'||node.type==='ChainExpression')return resolve(node.argument??node.expression,seen);
+    if(node.type==='Identifier'){
+      if(bindings.get(node.name)!==1||mutated.has(node.name)||seen.has(node.name))return;
+      if(imported.has(node.name))return imported.get(node.name);
+      const variable=variables.get(node.name);if(!variable)return;
+      const result=resolve(variable.value,new Set([...seen,node.name]));
+      return result&&{source:result.source,members:[...result.members,...variable.members]};
+    }
+    if(node.type==='MemberExpression'){
+      const name=property(node);if(typeof name!=='string')return;
+      const result=resolve(node.object,seen);return result&&{source:result.source,members:[...result.members,name]};
+    }
+    // Execa 的对象参数只绑定选项，返回的函数被调用时才启动程序。
+    if(node.type==='CallExpression'&&node.arguments[0]?.type==='ObjectExpression'){
+      const target=resolve(node.callee,seen);
+      if(target?.source==='execa'&&launches(target))return target;
+    }
+    const source=node.type==='ImportExpression'?node.source?.value:node.type==='CallExpression'&&isRequire(node)?node.arguments[0]?.value:undefined;
+    if(sources.has(source))return {source,members:[]};
+  }
+  walk(ast,node=>{
+    if(!['CallExpression','TaggedTemplateExpression'].includes(node.type))return;
+    const target=resolve(node.callee??node.tag);if(!target||!launches(target))return;
+    if(target.source==='execa'&&node.type==='CallExpression'&&node.arguments[0]?.type==='ObjectExpression')return;
+    warning('UNMANAGED_PROCESS',`直接调用 ${target.source}${target.members.length?'.'+target.members.join('.'):''} 可能绕过统一执行记录、取消与代理规则；执行外部程序请改用 ctx.runProcess(file, args, options)。此提示不代表该调用已执行`,`${location}:${node.loc.start.line}:${node.loc.start.column+1}`);
+  });
+}

package/manual/packages/fst-logs/README.md

@@ -4,7 +4,7 @@
 
 ## 职责与边界
 
-运行日志写入器、串行落盘、有界事件缓存、快照、历史分页、保留和体积统计。运行调度由 core 负责。
+运行日志写入器、串行落盘、有界事件缓存、快照、历史分页、保留和体积统计，以及 TUI 会话元数据和完整交互摘要存储。运行调度由 core 负责。
 
 内部依赖：`@mytools/sdk`。
 ## 公开入口
@@ -15,6 +15,7 @@
 | `@mytools/fst-logs/markdown` | `./src/markdown-log.js` |
 | `@mytools/fst-logs/steps` | `./src/step-summaries.js` |
 | `@mytools/fst-logs/preview` | `./src/run-preview.js` |
+| `@mytools/fst-logs/sessions` | `./src/session-history.js` |
 | `@mytools/fst-logs/package.json` | `./package.json` |
 
 仅依赖 exports 声明的入口，禁止消费者跨包读取 src/bin 私有文件。入口路径由本模块维护，修改协议时同步消费方回归。
@@ -56,6 +57,26 @@ maxValueBytes 至少为 2，连预览本身也容不下时省略字段值并保
 
 拒绝日志根目录、运行目录或正文文件链接，已有同 ID 日志拒绝覆盖。体积统计和保留策略仅涉及 `run.md`、`events.jsonl`、`result.json`、`run.meta.json` 四个约定文件；业务文件和子目录保持保留。统计不递归、不读取正文。普通文件系统检查不能提供针对恶意并发路径替换的操作系统安全沙箱。
 
+## TUI 会话持久化
+
+`createSessionHistory(directory,{projectDir,maxBytes=2097152,maxEntryBytes=65536,maxPageBytes=524288,maxPendingBytes=8388608})` 从 `/sessions` 入口创建会话存储器。调用方决定本地会话目录，测试必须使用临时目录，不能写入真实 `FISHTOOLS_HOME`。会话使用严格 UUID 格式的 ID，按工作区绝对路径保存 `sessionOwner`；Windows 路径比较忽略大小写。
+
+每个会话有两个文件：`<id>.json` 保存轻量元数据和最近视图，`<id>.jsonl` 持续追加全部交互摘要。输入、反馈、运行开始和最终结果都应由 TUI 逐条追加；最近视图的条目数量限制不会删除 JSONL 中更早的交互。完整进程输出继续放在原运行日志中，会话摘要只保存有界结果预览与对应运行 ID。会话文件默认使用可直接读取的 UTF-8 JSON，不自动加密、压缩或删除历史。
+
+| 方法 | 行为 |
+| --- | --- |
+| `save(snapshot)` | 保存 `schemaVersion:1`、UUID `id`、`startedAt`、`updatedAt`、可选 `resumedFrom`、`commandHistory` 字符串数组和 `feed` 最近视图数组，并自动写入 `sessionOwner`；其余 JSON 字段同样保留 |
+| `read(id)` | 校验归属后返回当前元数据；不加载完整交互正文 |
+| `list()` | 按最近更新时间列出轻量摘要：`schemaVersion`、`id`、`sessionOwner`、`startedAt`、`updatedAt`、可选 `resumedFrom`、`commandCount`、`feedCount` |
+| `append(id,entry)` | 在已保存元数据的会话中追加一个 JSON 对象；保留条目原结构，并等待文件写入和同步完成 |
+| `page(id,{cursor=0,limit=100})` | 返回 `{entries,cursor,nextCursor,hasMore,totalBytes}`；`cursor` 是完整 JSONL 记录边界的字节位置，`limit` 是条目数，上限 200 |
+
+同一进程中，同目录、同 ID 的保存、追加和分页按调用顺序串行执行，包括多个存储器实例。保存通过独占创建临时文件、同步写入和原子替换完成；更新时间更旧的快照被跳过，同一毫秒的快照按调用顺序保存。已有会话不能改变开始时间。恢复必须新建 UUID、复制所需视图，并将旧 ID 写入 `resumedFrom`，原会话和交互日志继续保留。
+
+`maxBytes` 限制每份元数据，`maxEntryBytes` 限制每条 JSON 正文，`maxPageBytes` 限制每页 JSONL 原始字节，`maxPendingBytes` 限制尚未完成的写入队列。分页预算必须容纳单条最大记录及换行。交互日志总长度可持续增长，每次分页只读取有界窗口；不会为了查看会话把整份 JSONL 加载进内存。超限分别返回 `SESSION_METADATA_LIMIT`、`SESSION_ENTRY_LIMIT` 或 `SESSION_QUEUE_LIMIT`，不静默截断用户记录；调用方应保留错误反馈并提示用户。一次失败不会阻止后续读取或重试。
+
+元数据损坏、过大或来自其他工作区时，`list()` 跳过该会话，直接 `read()` 明确报错。损坏的已有元数据拒绝覆盖。根目录或文件链接、不安全 ID、非法游标均被拒绝；JSONL 末尾缺少换行时拒绝继续追加，避免把新输入接到未完成的旧记录后。普通文件系统检查无法替代针对恶意并发路径替换的操作系统安全沙箱。
+
 ## 维护与验证
 
 本模块负责上述职责的实现、文档与回归；跨模块接口调整需要同时检查生产者与消费者。具体维护人员尚未指定。
@@ -63,5 +84,5 @@ maxValueBytes 至少为 2，连预览本身也容不下时省略字段值并保
 在仓库根目录执行：
 
 ```sh
-node --test tests/log-streaming.test.js tests/modules.test.js tests/module-interfaces.test.js tests/run-logs.test.js tests/live-output.test.js
+node --test tests/session-history.test.js tests/log-streaming.test.js tests/modules.test.js tests/module-interfaces.test.js tests/run-logs.test.js tests/live-output.test.js
 ```

package/manual/packages/fst-logs/package.json

@@ -8,6 +8,7 @@
     ".": "./src/run-logs.js",
     "./steps": "./src/step-summaries.js",
     "./preview": "./src/run-preview.js",
+    "./sessions": "./src/session-history.js",
     "./markdown": "./src/markdown-log.js",
     "./package.json": "./package.json"
   },
@@ -18,7 +19,7 @@
   ],
   "license": "MIT",
   "engines": {
-    "node": ">=24.15.0"
+    "node": "^22.22.2 || >=24.0.0"
   },
   "dependencies": {
     "@mytools/sdk": "0.1.0"

package/manual/packages/fst-logs/src/file-identity.js

@@ -0,0 +1,23 @@
+import {lstat,open} from 'node:fs/promises';
+
+export function sameFileIdentity(pathStat,handleStat,platform=process.platform){
+  if(pathStat.ino!==handleStat.ino)return false;
+  // 早期 libuv 的 Windows 路径查询返回 64 位卷号，句柄查询只有低 32 位。
+  // 与维护版本的 VolumeSerialNumber.LowPart 口径一致；文件 ID 仍完整比较。
+  const device=stat=>platform==='win32'?BigInt.asUintN(32,stat.dev):stat.dev;
+  return device(pathStat)===device(handleStat);
+}
+
+export async function samePathFileIdentity(file,pathStat,handleStat,platform=process.platform){
+  if(sameFileIdentity(pathStat,handleStat,platform))return true;
+  if(platform!=='win32'||pathStat.dev!==0n||pathStat.ino!==handleStat.ino)return false;
+  // 某些 Windows 文件系统的早期路径查询缺少卷号，不能直接将 0 当作通配符。
+  // 用第二个只读句柄证明当前路径与主句柄的完整身份，再确认路径仍非链接。
+  const probe=await open(file,'r');
+  try{
+    const proof=await probe.stat({bigint:true});
+    if(!proof.isFile()||proof.ino!==handleStat.ino||proof.dev!==handleStat.dev)return false;
+    const current=await lstat(file,{bigint:true});
+    return current.isFile()&&!current.isSymbolicLink()&&current.ino===pathStat.ino&&(current.dev===0n||sameFileIdentity(current,handleStat,platform));
+  }finally{await probe.close();}
+}

package/manual/packages/fst-logs/src/markdown-log.js

@@ -1,5 +1,5 @@
 const names={
-  'run.started':'运行开始','run.succeeded':'运行成功','run.failed':'运行失败','run.cancelled':'运行取消','run.stopped':'运行停止',
+  'run.started':'运行开始','run.input':'运行输入','run.succeeded':'运行成功','run.failed':'运行失败','run.cancelled':'运行取消','run.stopped':'运行停止',
   'workflow.started':'工作流开始','workflow.succeeded':'工作流完成','workflow.stopped':'工作流停止',
   'step.started':'步骤开始','step.succeeded':'步骤成功','step.failed':'步骤失败','step.cancelled':'步骤取消','step.skipped':'步骤跳过','step.stopped':'步骤停止',log:'插件日志',
 };
@@ -28,7 +28,8 @@ function errorText(error){
 }
 
 export function markdownHeader(run){
-  return '# Fishtools 运行日志\n\n'+block(`运行 ID：${run.id}\n工作流或命令：${run.workflowId}\n开始时间：${run.startedAt}`)+'## 执行过程\n\n';
+  const kind={workflow:'工作流',action:'插件动作',command:'插件命令',shell:'系统命令'}[run.kind];
+  return '# Fishtools 运行日志\n\n'+block(`运行 ID：${run.id}\n工作流或命令：${run.workflowId}${kind?`\n执行类型：${kind}`:''}${run.sessionId?`\n启动会话：${run.sessionId}`:''}\n开始时间：${run.startedAt}`)+'## 执行过程\n\n';
 }
 
 export function markdownEvent(event){
@@ -41,7 +42,7 @@ export function markdownEvent(event){
   if(event.message)output+=block(event.message);
   if(event.reason!==undefined)output+='停止或跳过原因：\n\n'+block(event.reason);
   if(event.data!==undefined)output+='附加信息：\n\n'+block(event.data,'json');
-  if(event.input!==undefined)output+='步骤输入：\n\n'+block(event.input,'json');
+  if(event.input!==undefined)output+=(event.type==='run.input'?'运行输入：\n\n':'步骤输入：\n\n')+block(event.input,'json');
   if(event.output!==undefined)output+='步骤输出：\n\n'+block(event.output,'json');
   if(event.error)output+=errorText(event.error);
   return output;