@flowweave-ai/cli 0.1.1 → 0.1.3

package/README.md

@@ -10,18 +10,20 @@ flowweave health --ready
 
 配置只保存基础 URL 到 `~/.config/flowweave/config.json`（可由 `FLOWWEAVE_CONFIG_PATH` 覆盖）。当前平台不需要登录。
 
-页面域命令包括 `node`、`node-directory`、`capability`、`environment`、`flow`、`run`、`model` 和 `agent`。它们分别覆盖节点资产、能力仓库、终端环境、流程编排、FlowRun、大模型配置与 Agent 工作台的常用原子操作。每个命令的 JSON 请求体与在线 OpenAPI 一致；运行 `flowweave <域> --help` 查看映射。
+页面域命令包括 `node`、`node-directory`、`capability`、`environment`、`credential`、`flow`、`run`、`model` 和 `agent`。它们分别覆盖节点资产、能力仓库、终端环境、认证管理、流程编排、FlowRun、大模型配置与 Agent 工作台的常用原子操作。每个命令的 JSON 请求体与在线 OpenAPI 一致；运行 `flowweave <域> --help` 查看映射。
 
 常用命令示例：
 
-`flowweave node create --data-file ./node.json`、`flowweave capability import --type SKILL --file ./skill.zip`、`flowweave environment create --data '{"name":"Python"}'`、`flowweave flow create --data-file ./flow.json`、`flowweave run start --flow <flow-id> --environment-version <version-id>`。
+`flowweave node-directory delete-many --id <directory-id> --id <directory-id> --dry-run`、`flowweave credential delete-many --id <credential-id> --id <credential-id>`、`flowweave environment publish <setup-session-id> --description '升级 Python 依赖'`、`flowweave agent file-delete <workspace-id> --path /runtime/workspace/project/report.md --path /runtime/workspace/project/output`、`flowweave run workspace-delete <run-id> --attempt <attempt-id> --path /runtime/workspace/project/result.txt`。
+
+节点目录批量删除、Agent Workspace 文件树删除和 FlowRun 节点工作区删除都使用 JSON 数组请求体。重复传入 `--id` 或 `--path` 即可批量选择；先读取真实资源与路径，并用 `--dry-run` 核对 DELETE URL、范围 query 和请求体。FlowRun 工作目录删除使用 `flowweave run work-directory-delete <run-id> --attempt <attempt-id> --work-directory <directory-id>`。
 
 `api`、`upload`、`ws` 是完整契约入口：任意当前或未来的 REST、multipart、WebSocket 原子接口均可直接调用，不需要等待 CLI 发布。`ws` 使用 Node 原生 WebSocket；当前公开 FlowWeave WebSocket 接口无需自定义请求头。写操作支持 `--dry-run`，并可使用 `-H 'Idempotency-Key: …'` 传入一次性幂等键。对于没有快捷命令的新接口，先运行 `flowweave openapi --paths`，再通过通用命令调用。
 
 安装页面域 skill：
 
 ```bash
-npx skills add ZME7777777/FlowWeave -g -y --full-depth
+npx skills add ZME7777777/FlowWeave -g -y
 ```
 
 仓库尚未发布该 npm 包前，进入 `packages/cli` 后运行 `npm pack` 生成 tarball，并以 `npm install -g ./flowweave-ai-cli-*.tgz` 安装。发布到 npm registry 需要拥有 `@flowweave-ai` scope 的发布权限；本仓库不会自动发布。

package/bin/flowweave.mjs

@@ -26,13 +26,14 @@ function usage() {
 
 页面域原子操作：
   node <list|get|create|update|delete> [ID] [--data JSON|--data-file FILE]
-  node-directory <list|create> [--data JSON|--data-file FILE]
+  node-directory <list|create|delete|delete-many> [ID] [--id ID ...]
   capability <list|validate|commit|import> ...
   environment <list|get|create|update|delete|setup|publish|stop|version-delete> ...
+  credential <list|create|update|delete|delete-many> ...
   flow <list|get|create|update|validate|delete> ...
-  run <list|get|start|delete|runtime|replace|cancel|complete|events> ...
+  run <list|get|start|delete|runtime|replace|cancel|complete|events|workspace-delete|work-directory-delete> ...
   model <list|create|update|delete|discover|test|oauth-start|oauth-poll|oauth-status|oauth-revoke> ...
-  agent <default|workspace|runtime|conversations|conversation|create|send|interrupt|resume> ...
+  agent <default|workspace|runtime|conversations|conversation|create|send|interrupt|resume|work-directories|work-directory-create|work-directory-delete|file-delete> ...
 
 所有写入操作都可加 --dry-run 仅查看最终请求。运行 flowweave <命令> --help 查看该命令说明。`;
 }
@@ -130,9 +131,9 @@ function pathUrl(baseUrl, path, { raw = false, query = [] } = {}) {
 function headers(args) { return Object.fromEntries(pairs(optionValues(args, '-H').concat(optionValues(args, '--header')), ':', '--header').map(([name, value]) => [name.trim(), value.trim()])); }
 function queries(args) { return pairs(optionValues(args, '-q').concat(optionValues(args, '--query')), '=', '--query'); }
 
-async function request(method, path, args, { raw = false, body, form } = {}) {
+async function request(method, path, args, { raw = false, body, form, query = [] } = {}) {
   const { baseUrl } = await loadConfig();
-  const url = pathUrl(baseUrl, path, { raw, query: queries(args) });
+  const url = pathUrl(baseUrl, path, { raw, query: [...queries(args), ...query] });
   const requestBody = body === undefined ? await payload(args) : body;
   if (flag(args, '--dry-run')) return { method, url: url.toString(), payload: requestBody ?? form ?? null };
   const requestHeaders = { Accept: 'application/json', ...headers(args) };
@@ -189,6 +190,22 @@ async function crud(command, args) {
   return request(methods[action], id ? `${route}/${id}` : route, args);
 }
 
+async function nodeDirectory(args) {
+  const [action, id] = positional(args);
+  if (action === 'list') return request('GET', '/node-directories', args);
+  if (action === 'create') return request('POST', '/node-directories', args);
+  if (action === 'delete') {
+    if (!id) throw new CliError('node-directory delete 必须提供目录 ID');
+    return request('DELETE', `/node-directories/${id}`, args);
+  }
+  if (action === 'delete-many') {
+    const ids = optionValues(args, '--id');
+    if (!ids.length) throw new CliError('node-directory delete-many 至少需要一个 --id');
+    return request('DELETE', '/node-directories', args, { body: { ids } });
+  }
+  throw new CliError('node-directory 支持 list|create|delete|delete-many');
+}
+
 async function capability(args) {
   const [action, id] = positional(args);
   if (action === 'list') return request('GET', '/capabilities', args);
@@ -215,7 +232,13 @@ async function environment(args) {
   const [action, id] = positional(args);
   if (['list', 'get', 'create', 'update', 'delete'].includes(action)) return crud('environment', args);
   if (action === 'setup') { if (!id) throw new CliError('environment setup 需要环境 ID'); return request('POST', `/terminal-environments/${id}/setup-sessions`, args, { body: await objectPayload(args) }); }
-  if (action === 'publish') { if (!id) throw new CliError('environment publish 需要 Setup Session ID'); return request('POST', `/environment-setup-sessions/${id}/publish`, args, { body: {} }); }
+  if (action === 'publish') {
+    if (!id) throw new CliError('environment publish 需要 Setup Session ID');
+    const description = option(args, '--description');
+    return request('POST', `/environment-setup-sessions/${id}/publish`, args, {
+      body: await objectPayload(args, description === undefined ? {} : { description }),
+    });
+  }
   if (action === 'stop') { if (!id) throw new CliError('environment stop 需要 Setup Session ID'); return request('DELETE', `/environment-setup-sessions/${id}`, args); }
   if (action === 'version-delete') {
     const versionId = option(args, '--version');
@@ -225,6 +248,21 @@ async function environment(args) {
   throw new CliError('environment 支持 list|get|create|update|delete|setup|publish|stop|version-delete');
 }
 
+async function credential(args) {
+  const [action, id] = positional(args);
+  if (action === 'list') return request('GET', '/website-credentials', args);
+  if (action === 'create') return request('POST', '/website-credentials', args);
+  if (action === 'delete-many') {
+    const ids = optionValues(args, '--id');
+    if (!ids.length) throw new CliError('credential delete-many 至少需要一个 --id');
+    return request('DELETE', '/website-credentials', args, { body: { ids } });
+  }
+  if (!id) throw new CliError(`credential ${action || ''} 需要认证 ID`);
+  if (action === 'update') return request('PUT', `/website-credentials/${id}`, args);
+  if (action === 'delete') return request('DELETE', `/website-credentials/${id}`, args);
+  throw new CliError('credential 支持 list|create|update|delete|delete-many');
+}
+
 async function flow(args) {
   const [action, id] = positional(args);
   if (['list', 'get', 'create', 'update', 'delete'].includes(action)) return crud('flow', args);
@@ -245,6 +283,30 @@ async function run(args) {
     return request('POST', `/flows/${flowId}/runs`, args, { body });
   }
   if (!id) throw new CliError(`run ${action || ''} 需要 FlowRun ID`);
+  if (action === 'workspace-delete') {
+    const attemptId = option(args, '--attempt');
+    const paths = optionValues(args, '--path');
+    if (!attemptId || !paths.length) {
+      throw new CliError('run workspace-delete 需要 FlowRun ID、--attempt 和至少一个 --path');
+    }
+    const bindingId = option(args, '--binding');
+    const workDirectoryId = option(args, '--work-directory');
+    return request('DELETE', `/flow-runs/${id}/node-attempts/${attemptId}/agent-sessions/workspace/entries`, args, {
+      body: { paths },
+      query: [
+        ...(bindingId ? [['binding_id', bindingId]] : []),
+        ...(workDirectoryId ? [['work_directory_id', workDirectoryId]] : []),
+      ],
+    });
+  }
+  if (action === 'work-directory-delete') {
+    const attemptId = option(args, '--attempt');
+    const workDirectoryId = option(args, '--work-directory');
+    if (!attemptId || !workDirectoryId) {
+      throw new CliError('run work-directory-delete 需要 FlowRun ID、--attempt 和 --work-directory');
+    }
+    return request('DELETE', `/flow-runs/${id}/node-attempts/${attemptId}/agent-sessions/work-directories/${workDirectoryId}`, args);
+  }
   if (action === 'get') return request('GET', `/flow-runs/${id}`, args);
   if (action === 'delete') return request('DELETE', `/flow-runs/${id}`, args);
   if (action === 'runtime') return request('GET', `/flow-runs/${id}/runtime`, args);
@@ -252,7 +314,7 @@ async function run(args) {
   if (action === 'cancel') return request('POST', `/flow-runs/${id}/cancel`, args, { body: {} });
   if (action === 'complete') return request('POST', `/flow-runs/${id}/complete`, args, { body: {} });
   if (action === 'events') return request('GET', `/flow-runs/${id}/events`, args);
-  throw new CliError('run 支持 list|get|start|delete|runtime|replace|cancel|complete|events');
+  throw new CliError('run 支持 list|get|start|delete|runtime|replace|cancel|complete|events|workspace-delete|work-directory-delete');
 }
 
 async function model(args) {
@@ -283,13 +345,34 @@ async function agent(args) {
   if (action === 'workspace') return request('GET', base, args);
   if (action === 'runtime') return request('GET', `${base}/runtime`, args);
   if (action === 'conversations') return request('GET', `${base}/conversations`, args);
+  if (action === 'work-directories') return request('GET', `${base}/work-directories`, args);
+  if (action === 'work-directory-create') {
+    return request('POST', `${base}/work-directories`, args);
+  }
+  if (action === 'work-directory-delete') {
+    if (!binding) throw new CliError('agent work-directory-delete 需要工作目录 ID');
+    return request('DELETE', `${base}/work-directories/${binding}`, args);
+  }
+  if (action === 'file-delete') {
+    const paths = optionValues(args, '--path');
+    if (!paths.length) throw new CliError('agent file-delete 至少需要一个 --path <runtime-path>');
+    const bindingId = option(args, '--binding');
+    const workDirectoryId = option(args, '--work-directory');
+    return request('DELETE', `${base}/workspace/entries`, args, {
+      body: { paths },
+      query: [
+        ...(bindingId ? [['binding_id', bindingId]] : []),
+        ...(workDirectoryId ? [['work_directory_id', workDirectoryId]] : []),
+      ],
+    });
+  }
   if (action === 'create') return request('POST', `${base}/conversations`, args);
   if (!binding) throw new CliError(`agent ${action || ''} 需要会话 binding ID`);
   if (action === 'conversation') return request('GET', `${base}/conversations/${binding}`, args);
   if (action === 'send') return request('POST', `${base}/conversations/${binding}/messages`, args);
   if (action === 'interrupt') return request('POST', `${base}/conversations/${binding}/interrupt`, args, { body: {} });
   if (action === 'resume') return request('POST', `${base}/conversations/${binding}/resume`, args, { body: {} });
-  throw new CliError('agent 支持 default|workspace|runtime|conversations|conversation|create|send|interrupt|resume');
+  throw new CliError('agent 支持 default|workspace|runtime|conversations|conversation|create|send|interrupt|resume|work-directories|work-directory-create|work-directory-delete|file-delete');
 }
 
 async function upload(args) {
@@ -362,9 +445,11 @@ async function main(argv) {
   else if (command === 'api') { const [method, path] = positional(args); if (!method || !path) throw new CliError('api 用法：api <method> <PATH>'); result = request(method.toUpperCase(), path, args, { raw: flag(args, '--raw') }); }
   else if (command === 'upload') result = upload(args);
   else if (command === 'ws') result = websocket(args);
-  else if (['node', 'node-directory'].includes(command)) result = crud(command, args);
+  else if (command === 'node') result = crud(command, args);
+  else if (command === 'node-directory') result = nodeDirectory(args);
   else if (command === 'capability') result = capability(args);
   else if (command === 'environment') result = environment(args);
+  else if (command === 'credential') result = credential(args);
   else if (command === 'flow') result = flow(args);
   else if (command === 'run') result = run(args);
   else if (command === 'model') result = model(args);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flowweave-ai/cli",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "FlowWeave 平台命令行客户端",
   "type": "module",
   "bin": {