@flowweave-ai/cli 0.2.0 → 0.3.0

package/README.md

@@ -21,7 +21,9 @@ flowweave health --ready
 
 读取 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 凭据。
 
-周期任务使用 `schedule list/create/pause/resume/trigger/delete`。创建请求必须使用在线 `FlowRunScheduleWrite` schema；暂停或恢复前从 `schedule list` 读取当前 `row_version`，再传入 `--expected-row-version`。手动触发会新增一次 occurrence，不会改写既有运行；删除已有执行记录的调度会被平台拒绝。
+周期任务使用 `schedule list/templates/occurrences/create/pause/resume/trigger/delete`。先用 `schedule templates` 读取可作为冻结母版的已就绪连续运行记录；创建请求必须使用在线 `FlowRunScheduleWrite` schema：只提交任务名称、母版 `source_flow_run_id` 和五段 `cron_expression`，节点、环境、输入和启动提示词均来自该记录的冻结母版。`schedule occurrences <schedule-id> --page 1 --page-size 10` 按需读取该调度的执行历史及其 FlowRun/NodeRun，而不预加载所有记录。暂停或恢复前从 `schedule list` 读取当前 `row_version`，再传入 `--expected-row-version`。手动触发会新增一次 occurrence，不会改写既有运行；删除生成的 FlowRun 不会删除调度，而有生成记录的调度删除会被平台拒绝。
+
+能力命令还支持受治理的 OpenHands Plugin Marketplace：`capability marketplace` 读取服务端固定到完整 commit 的公开目录；使用返回的 `source`、`commit`、`repo_path` 与插件名称调用 `capability marketplace-resolve --data-file ./marketplace-plugin.json`，随后读取 `capability plugin-resolution <resolution-id>`，并以当前 `state_version` 调用 `capability plugin-publish <resolution-id> --data '{"expected_state_version": 1}'`。自定义受信任 Marketplace 可先用 `capability marketplace-preview --data-file ./marketplace.json` 审阅目录。Agent Definition 只能以 UTF-8 `.md`/`.markdown` 的 OpenHands YAML frontmatter + Markdown 正文通过 `capability validate|import --type AGENT_DEFINITION --file <file>` 导入；Hook 已下线，新的 `--type HOOK` 导入会被明确拒绝。
 
 `api`、`upload`、`ws` 是完整契约入口：任意当前或未来的 REST、multipart、WebSocket 原子接口均可直接调用，不需要等待 CLI 发布。三者都会使用当前 `auth login` 会话；不得用 `--header` 手工传 Cookie。写操作支持 `--dry-run`，并可使用 `-H 'Idempotency-Key: …'` 传入一次性幂等键。对于没有快捷命令的新接口，先运行 `flowweave openapi --paths`，再通过通用命令调用。
 

package/bin/flowweave.mjs

@@ -32,12 +32,12 @@ function usage() {
 页面域原子操作：
   node <list|get|create|update|delete> [ID] [--data JSON|--data-file FILE]
   node-directory <list|create|delete|delete-many> [ID] [--id ID ...]
-  capability <list|validate|commit|import> ...
+  capability <list|validate|commit|import|marketplace|marketplace-preview|marketplace-resolve|plugin-resolution|plugin-publish> ...
   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|pause|resume|cancel|complete|events|node|node-copy|node-delete|workspace-delete|work-directory-delete> ...
-  schedule <list|create|pause|resume|trigger|delete> ...
+  schedule <list|templates|occurrences|create|pause|resume|trigger|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> ...
 
@@ -334,6 +334,26 @@ async function nodeDirectory(args) {
 async function capability(args) {
   const [action, id] = positional(args);
   if (action === 'list') return request('GET', '/capabilities', args);
+  if (action === 'marketplace') {
+    if (id) throw new CliError('capability marketplace 不接受 ID');
+    return request('GET', '/plugin-marketplace-catalogs/openhands', args);
+  }
+  if (action === 'marketplace-preview') {
+    if (id) throw new CliError('capability marketplace-preview 不接受 ID');
+    return request('POST', '/plugin-marketplace-catalogs/preview', args);
+  }
+  if (action === 'marketplace-resolve') {
+    if (id) throw new CliError('capability marketplace-resolve 不接受 ID');
+    return request('POST', '/plugin-source-resolutions/marketplace', args);
+  }
+  if (action === 'plugin-resolution') {
+    if (!id) throw new CliError('capability plugin-resolution 需要 resolution ID');
+    return request('GET', `/plugin-source-resolutions/${id}`, args);
+  }
+  if (action === 'plugin-publish') {
+    if (!id) throw new CliError('capability plugin-publish 需要 resolution ID');
+    return request('POST', `/plugin-source-resolutions/${id}/publish`, args);
+  }
   if (action === 'validate' || action === 'import') {
     const type = option(args, '--type');
     const source = option(args, '--file');
@@ -350,7 +370,7 @@ async function capability(args) {
     if (!token) throw new CliError('capability commit 需要 --import-token');
     return request('POST', '/capability-imports', args, { body: { import_token: token } });
   }
-  throw new CliError('capability 支持 list|validate|commit|import');
+  throw new CliError('capability 支持 list|validate|commit|import|marketplace|marketplace-preview|marketplace-resolve|plugin-resolution|plugin-publish');
 }
 
 async function environment(args) {
@@ -463,11 +483,31 @@ async function schedule(args) {
     if (id) throw new CliError('schedule list 不接受 ID');
     return request('GET', '/flow-run-schedules', args);
   }
+  if (action === 'templates') {
+    if (id) throw new CliError('schedule templates 不接受 ID');
+    return request('GET', '/flow-run-schedule-templates', args);
+  }
   if (action === 'create') {
     if (id) throw new CliError('schedule create 不接受 ID');
     return request('POST', '/flow-run-schedules', args);
   }
   if (!id) throw new CliError(`schedule ${action || ''} 需要调度 ID`);
+  if (action === 'occurrences') {
+    const page = option(args, '--page');
+    const pageSize = option(args, '--page-size');
+    const query = [];
+    if (page !== undefined) {
+      const value = Number(page);
+      if (!Number.isSafeInteger(value) || value < 1) throw new CliError('schedule occurrences 的 --page 必须为正整数');
+      query.push(['page', String(value)]);
+    }
+    if (pageSize !== undefined) {
+      const value = Number(pageSize);
+      if (!Number.isSafeInteger(value) || value < 1 || value > 100) throw new CliError('schedule occurrences 的 --page-size 必须为 1 到 100 的整数');
+      query.push(['page_size', String(value)]);
+    }
+    return request('GET', `/flow-run-schedules/${id}/occurrences`, args, { query });
+  }
   if (action === 'pause' || action === 'resume') {
     const expected = Number(option(args, '--expected-row-version'));
     if (!Number.isSafeInteger(expected) || expected < 1) {
@@ -479,7 +519,7 @@ async function schedule(args) {
   }
   if (action === 'trigger') return request('POST', `/flow-run-schedules/${id}/trigger`, args, { body: {} });
   if (action === 'delete') return request('DELETE', `/flow-run-schedules/${id}`, args);
-  throw new CliError('schedule 支持 list|create|pause|resume|trigger|delete');
+  throw new CliError('schedule 支持 list|templates|occurrences|create|pause|resume|trigger|delete');
 }
 
 async function model(args) {

package/package.json

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