@flowweave-ai/cli 0.1.2 → 0.1.4

package/README.md

@@ -14,7 +14,11 @@ flowweave health --ready
 
 常用命令示例：
 
-`flowweave node-directory delete <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`。
+`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>`。
+
+读取 FlowRun 中的记录使用 `flowweave run node <run-id> --node <node-run-id>`；只有用户明确要求时才能执行 `node-copy` 或 `node-delete`。暂停或恢复 Runtime 前，必须先读取 `run runtime`，将返回的 `generation` 与 session `row_version` 写入 `expected_generation`、`expected_session_row_version` 后传给 `run pause` 或 `run resume`。供应商上游余额/用量使用 `flowweave model usage <provider-id>`，它可能依赖该供应商的有效 API 凭据。
 
 `api`、`upload`、`ws` 是完整契约入口：任意当前或未来的 REST、multipart、WebSocket 原子接口均可直接调用，不需要等待 CLI 发布。`ws` 使用 Node 原生 WebSocket；当前公开 FlowWeave WebSocket 接口无需自定义请求头。写操作支持 `--dry-run`，并可使用 `-H 'Idempotency-Key: …'` 传入一次性幂等键。对于没有快捷命令的新接口，先运行 `flowweave openapi --paths`，再通过通用命令调用。
 

package/bin/flowweave.mjs

@@ -26,13 +26,13 @@ function usage() {
 
 页面域原子操作：
   node <list|get|create|update|delete> [ID] [--data JSON|--data-file FILE]
-  node-directory <list|create|delete> [ID] [--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> ...
-  model <list|create|update|delete|discover|test|oauth-start|oauth-poll|oauth-status|oauth-revoke> ...
+  run <list|get|start|delete|runtime|replace|pause|resume|cancel|complete|events|node|node-copy|node-delete|workspace-delete|work-directory-delete> ...
+  model <list|create|update|delete|discover|usage|test|oauth-start|oauth-poll|oauth-status|oauth-revoke> ...
   agent <default|workspace|runtime|conversations|conversation|create|send|interrupt|resume|work-directories|work-directory-create|work-directory-delete|file-delete> ...
 
 所有写入操作都可加 --dry-run 仅查看最终请求。运行 flowweave <命令> --help 查看该命令说明。`;
@@ -198,7 +198,12 @@ async function nodeDirectory(args) {
     if (!id) throw new CliError('node-directory delete 必须提供目录 ID');
     return request('DELETE', `/node-directories/${id}`, args);
   }
-  throw new CliError('node-directory 支持 list|create|delete');
+  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) {
@@ -278,14 +283,53 @@ async function run(args) {
     return request('POST', `/flows/${flowId}/runs`, args, { body });
   }
   if (!id) throw new CliError(`run ${action || ''} 需要 FlowRun ID`);
+  if (action === 'node' || action === 'node-copy' || action === 'node-delete') {
+    const nodeRunId = option(args, '--node');
+    if (!nodeRunId) throw new CliError(`run ${action} 需要 --node <node-run-id>`);
+    const path = `/flow-runs/${id}/nodes/${nodeRunId}`;
+    if (action === 'node') return request('GET', path, args);
+    if (action === 'node-copy') return request('POST', `${path}/copy`, args, { body: await objectPayload(args) });
+    return request('DELETE', path, args);
+  }
+  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);
   if (action === 'replace') return request('POST', `/flow-runs/${id}/runtime/replacements`, args);
+  if (action === 'pause' || action === 'resume') {
+    const body = await objectPayload(args);
+    if (!Number.isInteger(body.expected_generation) || !Number.isInteger(body.expected_session_row_version)) {
+      throw new CliError(`run ${action} 需要 --data 或 --data-file，且必须包含整数 expected_generation 和 expected_session_row_version`);
+    }
+    return request('POST', `/flow-runs/${id}/runtime/${action}`, args, { body });
+  }
   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|pause|resume|cancel|complete|events|node|node-copy|node-delete|workspace-delete|work-directory-delete');
 }
 
 async function model(args) {
@@ -298,6 +342,7 @@ async function model(args) {
       : request('POST', '/model-providers/discover-models', args);
   }
   if (!id) throw new CliError(`model ${action || ''} 需要模型供应商 ID`);
+  if (action === 'usage') return request('GET', `/model-providers/${id}/usage`, args);
   if (action === 'update') return request('PUT', `/model-providers/${id}`, args);
   if (action === 'delete') return request('DELETE', `/model-providers/${id}`, args);
   if (action === 'test') return request('POST', `/model-providers/${id}/test`, args);
@@ -305,7 +350,7 @@ async function model(args) {
   if (action === 'oauth-poll') return request('POST', `/model-providers/${id}/oauth/device/poll`, args, { body: await objectPayload(args) });
   if (action === 'oauth-status') return request('GET', `/model-providers/${id}/oauth/status`, args);
   if (action === 'oauth-revoke') return request('DELETE', `/model-providers/${id}/oauth`, args);
-  throw new CliError('model 支持 list|create|update|delete|discover|test|oauth-start|oauth-poll|oauth-status|oauth-revoke');
+  throw new CliError('model 支持 list|create|update|delete|discover|usage|test|oauth-start|oauth-poll|oauth-status|oauth-revoke');
 }
 
 async function agent(args) {
@@ -325,13 +370,13 @@ async function agent(args) {
     return request('DELETE', `${base}/work-directories/${binding}`, args);
   }
   if (action === 'file-delete') {
-    const path = option(args, '--path');
-    if (!path) throw new CliError('agent file-delete 需要 --path <runtime-path>');
+    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/file`, args, {
+    return request('DELETE', `${base}/workspace/entries`, args, {
+      body: { paths },
       query: [
-        ['path', path],
         ...(bindingId ? [['binding_id', bindingId]] : []),
         ...(workDirectoryId ? [['work_directory_id', workDirectoryId]] : []),
       ],

package/package.json

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