@yanglaofish/fishtools 0.3.0 → 0.5.0

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

@@ -1,41 +0,0 @@
-import {FlowError} from '@mytools/sdk';
-import {conditionOperators} from './control.js';
-
-export const builtinCommands=[
-  ['workflows','选择已有工作流'],['new','新建工作流'],['add','添加插件能力或子工作流'],
-  ['steps','设置步骤参数、排序或删除'],['outputs','设置最终输出'],['save','保存工作流'],
-  ['run','运行工作流，可附带 @参数.json'],['runs','运行记录：选择任意一次执行，查看进度、结果和日志'],['logs','查看运行日志'],['plugin','管理插件'],['plugins','管理插件（兼容旧入口）'],['config','配置 Fishtools'],['tools','Web 与离线文档'],
-  ['pack','选择工作流打包'],['web','启动 Web 工作台'],['docs','阅读离线开发与使用文档'],['help','查看操作说明'],['exit','退出终端工作台'],
-].map(([name,description])=>({name,description}));
-
-export function validateDeclarations(plugin){
-  for(const [name,action] of Object.entries(plugin.actions??{})){
-    if(action.conditions!==undefined&&(!action.conditions||typeof action.conditions!=='object'||Array.isArray(action.conditions)))throw new FlowError(`动作 ${name} 的 conditions 必须为对象`,{code:'VALIDATION'});
-    for(const [key,preset] of Object.entries(action.conditions??{})){
-      if(!preset||typeof preset.title!=='string'||!preset.title.trim()||typeof preset.path!=='string'||!preset.path||preset.path.split('.').some(p=>!p||['__proto__','constructor','prototype'].includes(p))||!conditionOperators.includes(preset.op)||(preset.op!=='exists'&&!Object.hasOwn(preset,'value')))throw new FlowError(`动作 ${name} 的判定预设 ${key} 无效`,{code:'VALIDATION'});
-      let schema=action.output;
-      for(const part of preset.path.split('.')){
-        if(schema?.properties&&Object.hasOwn(schema.properties,part))schema=schema.properties[part];
-        else if(schema?.type==='array'&&/^\d+$/.test(part))schema=schema.items;
-        else throw new FlowError(`判定预设 ${key} 引用了未声明的输出字段 ${preset.path}`,{code:'VALIDATION'});
-      }
-    }
-  }
-  for(const key of ['platforms','architectures'])if(plugin[key]!==undefined&&(!Array.isArray(plugin[key])||!plugin[key].every(x=>typeof x==='string'&&x)))throw new FlowError(`${plugin.id} 的 ${key} 必须是字符串数组`);
-  for(const declarations of [plugin.environments,...Object.values(plugin.actions??{}).map(a=>a.environments)]){
-    for(const [id,e] of Object.entries(declarations??{})){
-      if(!/^[\w-]+$/.test(id)||!e||!['host','bundled','tool'].includes(e.source))throw new FlowError(`环境声明无效：${plugin.id}/${id}`);
-      if(e.allowedSources&&(!Array.isArray(e.allowedSources)||!e.allowedSources.includes(e.source)||!e.allowedSources.every(x=>['host','bundled','tool'].includes(x))))throw new FlowError(`环境来源范围无效：${id}`);
-      if(e.source==='tool'&&id!=='node')throw new FlowError(`工具尚未提供环境：${id}`);
-    }
-  }
-}
-
-export function validateCommands(plugin,registered){
-  for(const [name,c] of Object.entries(plugin.commands??{})){
-    if(!/^[a-zA-Z][\w.-]*$/.test(name)||builtinCommands.some(x=>x.name===name)||registered.has(name))throw new FlowError(`命令名称无效或冲突：/${name}`);
-    if(!c||Boolean(c.action)===Boolean(c.run)||c.run&&typeof c.run!=='function')throw new FlowError(`命令 /${name} 必须声明 action 或 run`);
-    if(c.action&&!plugin.actions?.[c.action])throw new FlowError(`命令 /${name} 指向不存在的动作：${c.action}`);
-    registered.add(name);
-  }
-}

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

@@ -1,124 +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 {resolveEnvironments} from './environments.js';
-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;
-  }
-  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,
-    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} 输入`),{...bindContext(context),getService,config:command.config,resourceDir:plugin.root,environments:resolveEnvironments(plugin,undefined,environmentOverrides[plugin.id])});
-      context.signal?.throwIfAborted();
-      return validate(command.output,JSON.parse(JSON.stringify(result??{})),`/${name} 输出`);
-      }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} 输入`), {...bindContext(context),getService, config:action.config, resourceDir:action.root,environments:resolveEnvironments(definitions.get(action.plugin),action,environmentOverrides[action.plugin])});
-      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} 输出`);
-      }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/plugins.js

@@ -1,55 +0,0 @@
-import { createRequire } from 'node:module';
-import { pathToFileURL } from 'node:url';
-import { readFile, writeFile, mkdir, access } from 'node:fs/promises';
-import path from 'node:path';
-import { randomUUID } from 'node:crypto';
-import { runProcess } from './process.js';
-import { FlowError } from '@mytools/sdk';
-
-export async function readJson(file,fallback) {
-  try { return JSON.parse(await readFile(file,'utf8')); }
-  catch(e) { if(e.code==='ENOENT' && fallback!==undefined) return fallback; throw e; }
-}
-export async function loadPlugin(spec,base) {
-  const req=createRequire(path.join(base,'package.json'));
-  let entry;
-  if(path.isAbsolute(spec) || spec.startsWith('.')) {
-    const root=path.resolve(base,spec), pkg=await readJson(path.join(root,'package.json'));
-    entry=path.resolve(root,pkg.main??'index.js');
-  } else {
-    try {entry=req.resolve(spec);} catch {entry=createRequire(import.meta.url).resolve(spec);}
-  }
-  let root=path.dirname(entry);
-  while(root!==path.dirname(root)) {
-    try {await access(path.join(root,'package.json'));break;} catch {root=path.dirname(root);}
-  }
-  const module=await import(pathToFileURL(entry).href);
-  return {plugin:module.default,root};
-}
-export async function npm(args,options={}) {
-  const candidates=[path.join(path.dirname(process.execPath),'node_modules/npm/bin/npm-cli.js'),process.env.npm_execpath].filter(Boolean);
-  for(const cli of candidates) {
-    try {await access(cli);} catch {continue;}
-    return runProcess(process.execPath,[cli,...args],{timeout:180000,...options});
-  }
-  return runProcess('npm',args,{timeout:180000,...options});
-}
-
-export async function installGeneration(projectDir,{add,remove,state}) {
-  const root=path.join(projectDir,'.flow','installations',randomUUID());
-  await mkdir(root,{recursive:true});
-  const dependencies={...(state?.dependencies??{})};
-  if(remove) delete dependencies[remove];
-  await writeFile(path.join(root,'package.json'),JSON.stringify({name:'flow-project-plugins',private:true,dependencies},null,2));
-  let source=add;
-  if(add) {
-    try {await access(path.resolve(projectDir,add));source=path.resolve(projectDir,add);} catch {}
-    if(source.startsWith('-')) throw new FlowError('插件来源不能以选项符号开头',{code:'VALIDATION'});
-  }
-  const result=await npm(['install',...(source?[source]:[]),'--save-exact','--ignore-scripts','--install-links','--no-audit','--no-fund'],{cwd:root});
-  if(result.exitCode!==0) throw new FlowError(`插件安装失败：${result.stderr}`,{code:'INSTALL_FAILED'});
-  const pkg=await readJson(path.join(root,'package.json'));
-  const loaded=[];
-  for(const name of Object.keys(pkg.dependencies??{})) loaded.push(await loadPlugin(name,root));
-  return {state:{root,dependencies:pkg.dependencies??{}},loaded};
-}

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;
-    },
-  };
-}