@yanglaofish/fishtools 0.4.0 → 0.5.1

package/node_modules/@mytools/core/src/host.js

@@ -1,139 +0,0 @@
-import { Context } from 'cordis';
-import semver from 'semver';
-import { SDK_VERSION, FlowError } from '@mytools/sdk';
-import { validate, emptyObject } from './validation.js';
-import {validateDeclarations,validateCommands} from './contracts.js';
-import {prepareEnvironments,platformWarnings} from './environments.js';
-import path from 'node:path';
-import {mkdir} from 'node:fs/promises';
-import {createHash} from 'node:crypto';
-import {createRuntime} from './runtime.js';
-import {pluginError} from './diagnostics.js';
-
-export async function createHost({ plugins = [], config = {}, services = {}, environmentOverrides={},runtimeEnabled=true } = {}) {
-  const ctx = new Context();
-  const actions = new Map();
-  const definitions = new Map();
-  const extensions = new Map();
-  const serviceNames = new Set();
-  const commandNames=new Set(),commands=new Map();
-  function bindContext(context){
-    const bound={...services,...context},execute=bound.runProcess;
-    // 面向用户的输出与诊断日志共用持久化通道，只区分默认可见性。
-    bound.print=(message,data)=>Promise.resolve(bound.log?.(message,data,{audience:'user'}));
-    if(typeof execute==='function')bound.runProcess=(file,args,options={})=>{
-      const signal=context.signal&&options.signal?AbortSignal.any([context.signal,options.signal]):context.signal??options.signal;
-      return execute(file,args,{...options,signal,onOutput:async({stream,message})=>{
-        await bound.log?.(message,undefined,{stream});
-        await options.onOutput?.({stream,message});
-      }});
-    };
-    return bound;
-  }
-  async function pluginContext(plugin,action,context){
-    const bound=bindContext(context),application=services.application;
-    const projectDir=application?.projectDir;
-    // 固定长度摘要避免 scoped 包名分隔符、大小写碰撞及合法长包名超出文件名上限。
-    const stateDir=projectDir&&!application.project.readOnly?path.join(projectDir,'.flow','plugin-state',createHash('sha256').update(plugin.id).digest('hex')):undefined;
-    if(stateDir)await mkdir(stateDir,{recursive:true});
-    for(const message of platformWarnings(plugin))await bound.log?.(message,{code:'PLATFORM_MISMATCH'},{audience:'user'});
-    const environments=await prepareEnvironments(plugin,action,environmentOverrides[plugin.id],{cwd:projectDir??process.cwd()});
-    context.signal?.throwIfAborted();
-    return {...bound,projectDir,stateDir,environments};
-  }
-  for (const entry of plugins) {
-    const plugin = entry.plugin ?? entry;
-    validateDeclarations(plugin);validateCommands(plugin,commandNames);
-    if (!plugin.id || definitions.has(plugin.id)) throw new FlowError(`插件标识缺失或重复：${plugin.id}`, {code:'VALIDATION'});
-    if (!semver.satisfies(SDK_VERSION, plugin.sdk ?? '^0.1.0')) throw new FlowError(`插件 ${plugin.id} 与 SDK ${SDK_VERSION} 不兼容`, {code:'VALIDATION'});
-    for(const [name,action] of Object.entries(plugin.actions??{})){
-      if(typeof action?.run!=='function')throw new FlowError(`动作 ${plugin.id}:${name} 缺少执行函数`);
-    }
-    for(const [name,extension] of Object.entries(plugin.services??{})){
-      if(serviceNames.has(name))throw new FlowError(`服务重复：${name}`);
-      if(typeof extension!=='function')throw new FlowError(`服务 ${name} 缺少执行函数`);
-      serviceNames.add(name);
-    }
-    definitions.set(plugin.id, {...plugin, root:entry.root});
-  }
-  const settingsById=new Map();
-  for (const plugin of definitions.values()) {
-    for (const [id, range] of Object.entries(plugin.dependencies ?? {})) {
-      if (!definitions.has(id) || !semver.satisfies(definitions.get(id).version,range)) throw new FlowError(`插件 ${plugin.id} 缺少兼容依赖 ${id}@${range}`,{code:'VALIDATION'});
-    }
-    const settings = validate(plugin.config, config[plugin.id] ?? {}, `${plugin.id} 配置`);
-    settingsById.set(plugin.id,settings);
-  }
-  const runtime=createRuntime(ctx,definitions,{enabled:runtimeEnabled});
-  try{
-  for (const plugin of definitions.values()) {
-    const settings=settingsById.get(plugin.id);
-    runtime.register(plugin,settings,scope=>{
-    for(const [name,command] of Object.entries(plugin.commands??{})){
-      const action=command.action?plugin.actions[command.action]:command;
-      commands.set(name,{...command,name,plugin:plugin.id,input:action.input,output:action.output,description:command.description??action.description??action.title??name,config:settings});
-      scope.on('dispose',()=>commands.delete(name));
-    }
-      for (const [name, action] of Object.entries(plugin.actions ?? {})) {
-        const id = `${plugin.id}:${name}`;
-        if (typeof action.run !== 'function') throw new FlowError(`动作 ${id} 缺少执行函数`);
-        actions.set(id, {...action, id, plugin:plugin.id, config:settings, root:plugin.root});
-        scope.on('dispose', () => actions.delete(id));
-      }
-      for (const [name, extension] of Object.entries(plugin.services ?? {})) {
-        if (extensions.has(name)) throw new FlowError(`服务重复：${name}`);
-        extensions.set(name, {run:extension,plugin:plugin.id});
-        scope.on('dispose',()=>extensions.delete(name));
-      }
-    });
-  }
-  await runtime.start();
-  }catch(error){
-    try{await runtime.close();}catch(cleanup){if(cleanup.message!==error.message)throw new AggregateError([error,cleanup],`${error.message}；${cleanup.message}`);}
-    throw error;
-  }
-  return {
-    definitions, actions,
-    warnings:[...definitions.values()].flatMap(plugin=>platformWarnings(plugin).map(message=>({plugin:plugin.id,message}))),
-    hasRuntime:runtime.hasRuntime,
-    runtimeStatus:()=>runtime.status(),
-    commands(){return [...commands.values()].map(({run,config,...metadata})=>structuredClone(metadata));},
-    async invokeCommand(name,input,context={}){
-      runtime.assertOpen();
-      const command=commands.get(name);if(!command)throw new FlowError(`命令不存在：/${name}`);
-      if(command.action)return this.invoke(`${command.plugin}:${command.action}`,input,context);
-      if(!context.ui)throw new FlowError(`交互命令 /${name} 需要在 TUI 中调用`);
-      const plugin=definitions.get(command.plugin);
-      try{
-      const getService=runtime.bindServices(plugin.id);
-      context.signal?.throwIfAborted();
-      const result=await command.run(validate(command.input??emptyObject,input,`/${name} 输入`),{...await pluginContext(plugin,undefined,context),getService,config:command.config,resourceDir:plugin.root});
-      context.signal?.throwIfAborted();
-      return validate(command.output,JSON.parse(JSON.stringify(result??{})),`/${name} 输出`,{useDefaults:false});
-      }catch(cause){throw pluginError(cause,{plugin:plugin.id,command:`/${name}`});}
-    },
-    catalog() { return [...actions.values()].map(({run,config,root,...metadata})=>structuredClone(metadata)); },
-    async invoke(id, input, context = {}) {
-      runtime.assertOpen();
-      const action = actions.get(id);
-      if (!action) throw new FlowError(`动作不存在：${id}`, {code:'VALIDATION'});
-      try{
-      const getService=runtime.bindServices(action.plugin);
-      context.signal?.throwIfAborted();
-      const result = await action.run(validate(action.input ?? emptyObject,input,`${id} 输入`), {...await pluginContext(definitions.get(action.plugin),action,context),getService, config:action.config, resourceDir:action.root});
-      context.signal?.throwIfAborted();
-      // 通过 JSON 边界验证返回值，避免函数、循环引用等进入工作流状态。
-      const encoded = JSON.stringify(result);
-      if (encoded === undefined) throw new FlowError(`${id} 输出必须可 JSON 序列化`);
-      return validate(action.output, JSON.parse(encoded),`${id} 输出`,{useDefaults:false});
-      }catch(cause){throw pluginError(cause,{plugin:action.plugin,action:id});}
-    },
-    async service(name,options) {
-      runtime.assertOpen();
-      if (!extensions.has(name)) throw new FlowError(`未安装提供 ${name} 的插件`);
-      const extension=extensions.get(name);runtime.assertActive(extension.plugin);
-      return extension.run(services,options);
-    },
-    close:()=>runtime.close(),
-  };
-}

package/node_modules/@mytools/core/src/run-logs.js

@@ -1,63 +0,0 @@
-import path from 'node:path';
-import {readdir,readFile,lstat,unlink,rmdir} from 'node:fs/promises';
-import {FlowError} from '@mytools/sdk';
-import {markdownHeader,markdownEvent,markdownResult} from './markdown-log.js';
-
-const validId=id=>typeof id==='string'&&/^[a-f0-9-]{36}$/.test(id);
-export function validateKeepRuns(value){
-  if(value!==null&&(!Number.isSafeInteger(value)||value<1))throw new FlowError('日志保留次数必须为正整数；null 表示不自动清理');
-  return value;
-}
-
-export function createRunLogs(directory,{projectDir,allowLegacy=false}){
-  const root=path.resolve(directory);let cleaning=Promise.resolve();
-  const owner=process.platform==='win32'?projectDir.toLowerCase():projectDir;
-  function location(id){if(!validId(id))throw new FlowError('运行 ID 无效');return path.join(root,id);}
-  async function regular(file){try{return (await lstat(file)).isFile();}catch(error){if(error.code==='ENOENT')return false;throw error;}}
-  async function read(id){
-    const dir=location(id);if(!(await lstat(dir)).isDirectory()||(await lstat(dir)).isSymbolicLink())throw new FlowError('日志目录无效');
-    const file=path.join(dir,'result.json');if(!await regular(file))throw new FlowError('运行记录不存在');
-    const result=JSON.parse(await readFile(file,'utf8'));if(result.id!==id)throw new FlowError('运行记录 ID 不匹配');
-    if(result.logOwner!==owner&&!(allowLegacy&&result.logOwner===undefined))throw new FlowError('运行记录不属于此项目');
-    return result;
-  }
-  async function list(){
-    let entries;try{entries=await readdir(root,{withFileTypes:true});}catch(error){if(error.code==='ENOENT')return [];throw error;}
-    const results=[];
-    for(const entry of entries){
-      if(!entry.isDirectory()||!validId(entry.name))continue;
-      try{
-        const record=await read(entry.name);
-        if(typeof record.workflowId==='string'&&['succeeded','failed','cancelled','stopped'].includes(record.status)&&Number.isFinite(Date.parse(record.finishedAt)))results.push(record);
-      }catch(error){if(error.code==='EACCES'||error.code==='EPERM')throw error;}
-    }
-    return results.sort((a,b)=>Date.parse(b.finishedAt)-Date.parse(a.finishedAt)||b.id.localeCompare(a.id));
-  }
-  return {
-    list,read,owner,
-    async markdown(id){
-      const dir=location(id);const stat=await lstat(dir);if(!stat.isDirectory()||stat.isSymbolicLink())throw new FlowError('日志目录无效');
-      const run=await read(id),file=path.join(dir,'run.md');if(await regular(file))return readFile(file,'utf8');
-      return markdownHeader(run)+(run.events??[]).map(markdownEvent).join('')+markdownResult(run);
-    },
-    prune(keepRuns,protectedIds){
-      const job=cleaning.then(async()=>{
-        if(keepRuns===null)return [];
-        validateKeepRuns(keepRuns);
-        const ended=await list(),removed=[];
-        for(const run of ended.slice(keepRuns)){
-          if(protectedIds.has(run.id))continue;
-          const dir=location(run.id);
-          // 只删除本工具的三个日志文件；不递归删除目录或插件生成的业务结果。
-          for(const name of ['run.md','events.jsonl','result.json']){
-            const file=path.join(dir,name);
-            if(await regular(file))try{await unlink(file);}catch(error){if(error.code!=='ENOENT')throw error;}
-          }
-          try{await rmdir(dir);}catch(error){if(!['ENOTEMPTY','EEXIST','ENOENT'].includes(error.code))throw error;}
-          removed.push(run.id);
-        }
-        return removed;
-      });cleaning=job.catch(()=>{});return job;
-    },
-  };
-}

package/node_modules/@mytools/core/src/terminal/run-feed.js

@@ -1,78 +0,0 @@
-import {readableValue,readableError,readableTimeline} from './run-presentation.js';
-import {runStatuses} from './run-viewer.js';
-
-// 主面板按事件到达顺序追加；运行快照另存，配置菜单不会清掉执行记录。
-export class RunFeed{
-  constructor(refresh){this.refresh=refresh;this.runs=new Map();this.entries=[];this.subscriptions=new Map();this.expanded=false;}
-  track({app,runId,title,input}){
-    if(this.runs.has(runId))return;
-    const record=app.getRun(runId),item={app,record,title,input,count:0,ended:false,steps:new Map(),catalog:new Map((app.catalog?.()??[]).map(action=>[action.id,action]))};
-    this.runs.set(runId,item);
-    this.entries.push({type:'start',item});
-    if(!this.subscriptions.has(app))this.subscriptions.set(app,app.subscribe(event=>{
-      const item=this.runs.get(event.runId);if(!item||item.app!==app)return;
-      this.update(item,event);this.release(app);
-      if(event.type==='log'&&!item.ended)this.scheduleRefresh();
-      else this.flushRefresh();
-    }));
-    this.update(item);this.release(app);this.refresh();
-  }
-  scheduleRefresh(){
-    if(this.refreshTimer)return;
-    this.refreshTimer=setTimeout(()=>{this.refreshTimer=null;this.refresh();},100);
-  }
-  flushRefresh(){
-    if(this.refreshTimer){clearTimeout(this.refreshTimer);this.refreshTimer=null;}
-    this.refresh();
-  }
-  update(item,event){
-    if(event?.type&&!['run.succeeded','run.failed','run.cancelled','run.stopped'].includes(event.type))item.record.events.push(event);
-    else{
-      const record=item.app.getRun(item.record.id);if(!record)return;
-      item.record={...record,events:[...(record.events??[])]};
-    }
-    const {record}=item,events=record.events.slice(item.count);item.count=record.events.length;
-    for(const event of events)if(event.type.startsWith('step.'))item.steps.set(event.callPath,{...item.steps.get(event.callPath),...event});
-    if(events.length){
-      const last=this.entries.at(-1);
-      if(last?.type==='events'&&last.item===item)last.events.push(...events);
-      else this.entries.push({type:'events',item,events});
-    }
-    if(record.status!=='running'&&!item.ended){item.ended=true;this.entries.push({type:'result',item});}
-  }
-  release(app){
-    if([...this.runs.values()].some(item=>item.app===app&&!item.ended))return;
-    this.subscriptions.get(app)?.();this.subscriptions.delete(app);
-  }
-  message(text){this.entries.push({type:'message',text});this.refresh();}
-  compactEvents(entry,seen){
-    const {item}=entry,rows=[];
-    for(const event of entry.events){
-      const key=`${item.record.id}\0${event.callPath}`;
-      if(event.type.startsWith('step.')&&!seen.has(key)){
-        seen.add(key);const latest=item.steps.get(event.callPath),action=item.catalog.get(latest.action);
-        const status=latest.type.slice(5),symbols={started:'●',succeeded:'✓',failed:'✗',cancelled:'×',skipped:'–',stopped:'■'};
-        const name=action?.title??latest.action??latest.stepId??latest.callPath;
-        rows.push(`${symbols[status]??'·'} ${name} · ${status==='started'?'执行中':runStatuses[status]??status}${latest.durationMs!==undefined?' · '+latest.durationMs+' ms':''}${action?.plugin?' · '+action.plugin:''} · ${latest.callPath}`);
-      }
-      if(event.type==='log'&&event.audience==='user')rows.push(`[${event.callPath??item.record.workflowId}] ${event.message??''}${event.data!==undefined?'\n'+readableValue(event.data):''}`);
-      if(event.type==='step.failed'&&![...item.steps.values()].some(step=>step.type==='step.failed'&&step.callPath?.startsWith(event.callPath+'/')))rows.push(`✗ ${event.callPath}\n${readableError(event.error??{message:event.message})}`);
-      if(event.type==='step.stopped'||event.type==='step.skipped')rows.push(`${event.callPath}：${event.reason??event.message??''}`);
-    }
-    return rows.length?`${item.title??item.record.workflowId} · ${item.record.id.slice(0,8)}\n${rows.join('\n')}`:'';
-  }
-  text(){const seen=new Set();return this.entries.map(entry=>{
-    if(entry.type==='message')return entry.text;
-    const {record,title,input}=entry.item,label=`${title??record.workflowId} · ${record.id.slice(0,8)}`;
-    if(entry.type==='start')return [
-      `› ${record.workflowId.startsWith('/')?record.workflowId:'/run '+record.workflowId} · ${label}`,
-      `状态：${runStatuses[record.status]??record.status}`,
-      this.expanded&&input&&Object.keys(input).length?'输入\n'+readableValue(input):'',
-    ].filter(Boolean).join('\n');
-    if(entry.type==='events')return this.expanded?`${label}\n${readableTimeline(entry.events,{values:true})}`:this.compactEvents(entry,seen);
-    return [`结果 · ${label} · ${runStatuses[record.status]??record.status}`,
-      this.expanded&&record.output!==undefined?readableValue(record.output):'',record.error&&(this.expanded||![...entry.item.steps.values()].some(step=>step.type==='step.failed'))?readableError(record.error,{details:this.expanded}):'',record.reason??'',
-    ].filter(Boolean).join('\n');
-  }).filter(Boolean).join('\n\n');}
-  close(){if(this.refreshTimer)clearTimeout(this.refreshTimer);this.refreshTimer=null;for(const unsubscribe of this.subscriptions.values())unsubscribe();this.subscriptions.clear();}
-}