@thinkingai/ae-cli 6.0.38 → 6.0.39

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (193) hide show
  1. package/README.md +25 -3
  2. package/README.zh.md +25 -3
  3. package/dist/{auth-56Z45UVR.js → auth-GDV3H5I4.js} +18 -8
  4. package/dist/{auth-ENM3FE6L.js → auth-NN55553T.js} +3 -3
  5. package/dist/{capability-2H6PAOA3.js → capability-TPORIKRQ.js} +19 -15
  6. package/dist/{capability-YPOQX6PL.js → capability-VQNC5CF7.js} +19 -15
  7. package/dist/chunk-4NN5IWVN.js +26 -0
  8. package/dist/{chunk-DB4Q3ANU.js → chunk-6A2FUCIS.js} +3 -3
  9. package/dist/{chunk-PVBYJWC2.js → chunk-7KQWSBSL.js} +4 -4
  10. package/dist/{chunk-24BAVOX3.js → chunk-AXDXJTPC.js} +3 -1
  11. package/dist/{chunk-CPVTECJ3.js → chunk-DT6Y3TD7.js} +5 -5
  12. package/dist/{chunk-EGEIXA2Z.js → chunk-DWO43OIB.js} +0 -248
  13. package/dist/{chunk-V6FR6WTW.js → chunk-GJJA4CQZ.js} +34 -2
  14. package/dist/{chunk-RGXCNC4N.js → chunk-GS2P7LFD.js} +50 -17
  15. package/dist/{chunk-LYVNONC4.js → chunk-JHENBQ5B.js} +35 -0
  16. package/dist/{chunk-3P3562ZX.js → chunk-MVDZ7DBQ.js} +5 -5
  17. package/dist/{chunk-LCXU3AAT.js → chunk-NBPKWKRA.js} +2 -2
  18. package/dist/{chunk-HQ2A7ITL.js → chunk-RBNKI5ZW.js} +50 -17
  19. package/dist/{chunk-LHVM35J4.js → chunk-TS6BUGUY.js} +4 -4
  20. package/dist/chunk-TUKQZTMI.js +250 -0
  21. package/dist/{chunk-J7MZHDHQ.js → chunk-VKD5WQKN.js} +5 -5
  22. package/dist/{chunk-3KI3RRXX.js → chunk-VTXHDCBW.js} +3 -3
  23. package/dist/{chunk-KTYR3U6D.js → chunk-YTG6Q75E.js} +10 -6
  24. package/dist/{chunk-IR4ZLVPW.js → chunk-YV52FB5G.js} +25 -3
  25. package/dist/{chunk-E7UXXHO3.js → chunk-Z3OXWCIA.js} +3 -3
  26. package/dist/{cli-token-4SBMXAUK.js → cli-token-GL5MS5FK.js} +4 -4
  27. package/dist/{client-PP5FETMW.js → client-DAIPF7XN.js} +4 -4
  28. package/dist/{community-report-client-KK2QBANO.js → community-report-client-M2RW4MXD.js} +2 -2
  29. package/dist/config-4VZNLBKF.js +489 -0
  30. package/dist/index.js +96 -37
  31. package/dist/memory-RWJW4XFO.js +892 -0
  32. package/dist/memory-VO2ZJCRT.js +892 -0
  33. package/dist/{metadata-JIQ77HFY.js → metadata-YGTHR2XJ.js} +8 -8
  34. package/dist/{metadata-AN3YFZEV.js → metadata-ZRN2GHPN.js} +8 -8
  35. package/dist/{model-JASQVOFD.js → model-CLUIK3K5.js} +7 -5
  36. package/dist/{raw-XJCAT3HX.js → raw-52B4UKO4.js} +8 -7
  37. package/dist/sync-3REDHGY6.js +10259 -0
  38. package/dist/{te-agent-JHUG6DVV.js → te-agent-XNPELAKX.js} +580 -84
  39. package/dist/{te-analysis-ITKTO6JS.js → te-analysis-GJI5FZUL.js} +1152 -13
  40. package/dist/{te-analysis-RAC67YYD.js → te-analysis-N2BRDJZ5.js} +1152 -13
  41. package/dist/{te-community-QOYIYEJI.js → te-community-SQXKE5OO.js} +7 -7
  42. package/dist/{te-community-UFKI6ONP.js → te-community-TYSNU3NQ.js} +7 -7
  43. package/dist/{te-dataops-PZQ5NQLY.js → te-dataops-5TM7WZDI.js} +370 -189
  44. package/dist/{te-dataops-XTWVTJCA.js → te-dataops-OWIADNSM.js} +370 -189
  45. package/dist/{te-engage-NLZUPSBK.js → te-engage-F7V55KVW.js} +333 -105
  46. package/dist/{te-engage-E7F4HTXU.js → te-engage-FMYAYCNV.js} +333 -105
  47. package/dist/{te-kb-E7NSCBRB.js → te-kb-VRMEY3D4.js} +6 -6
  48. package/dist/{te-meta-GBDTMPEL.js → te-meta-53BVXPFI.js} +7 -7
  49. package/dist/{te-meta-ZTLTSHXC.js → te-meta-TOCBPBXI.js} +7 -7
  50. package/dist/{te-system-AH7DMCAQ.js → te-system-XGS5EQIQ.js} +4 -4
  51. package/dist/{te-team-BQ3SKSZV.js → te-team-BZRDV2CM.js} +7 -7
  52. package/dist/{update-DKG6UXEM.js → update-HEDXGOJH.js} +8 -6
  53. package/package.json +4 -1
  54. package/skills/ae-agent/SKILL.md +178 -16
  55. package/skills/ae-agent/references/add-skill.md +22 -10
  56. package/skills/ae-agent/references/edit-skill.md +24 -14
  57. package/skills/ae-agent/references/find-archived-conversations.md +82 -0
  58. package/skills/ae-agent/references/restore-conversation.md +54 -0
  59. package/skills/ae-agent/references/upload-skill.md +24 -14
  60. package/skills/ae-analysis/SKILL.md +1 -1
  61. package/skills/ae-analysis/references/command_index.md +104 -42
  62. package/skills/ae-analysis/references/entity_id_import_options.md +1 -1
  63. package/skills/ae-analysis/references/project_access_detail_get.md +3 -3
  64. package/skills/ae-analysis/references/project_data_power_delete.md +3 -3
  65. package/skills/ae-analysis/references/project_data_power_get.md +3 -3
  66. package/skills/ae-analysis/references/project_data_power_list.md +3 -3
  67. package/skills/ae-analysis/references/project_data_power_upsert.md +3 -3
  68. package/skills/ae-analysis/references/project_entity_create.md +3 -3
  69. package/skills/ae-analysis/references/project_entity_delete.md +3 -3
  70. package/skills/ae-analysis/references/project_entity_event_list.md +3 -3
  71. package/skills/ae-analysis/references/project_entity_get.md +3 -3
  72. package/skills/ae-analysis/references/project_entity_list.md +3 -3
  73. package/skills/ae-analysis/references/project_entity_update.md +3 -3
  74. package/skills/ae-analysis/references/project_function_list.md +3 -3
  75. package/skills/ae-analysis/references/project_info_create.md +25 -0
  76. package/skills/ae-analysis/references/project_info_delete.md +24 -0
  77. package/skills/ae-analysis/references/project_info_get.md +3 -3
  78. package/skills/ae-analysis/references/project_info_list.md +3 -3
  79. package/skills/ae-analysis/references/project_info_update.md +3 -3
  80. package/skills/ae-analysis/references/project_mark_time_create.md +3 -3
  81. package/skills/ae-analysis/references/project_mark_time_delete.md +3 -3
  82. package/skills/ae-analysis/references/project_mark_time_list.md +3 -3
  83. package/skills/ae-analysis/references/project_mark_time_update.md +3 -3
  84. package/skills/ae-analysis/references/project_member_add.md +3 -3
  85. package/skills/ae-analysis/references/project_member_batch_update.md +3 -3
  86. package/skills/ae-analysis/references/project_member_candidate_list.md +3 -3
  87. package/skills/ae-analysis/references/project_member_handover_export.md +3 -3
  88. package/skills/ae-analysis/references/project_member_handover_run.md +3 -3
  89. package/skills/ae-analysis/references/project_member_import.md +3 -3
  90. package/skills/ae-analysis/references/project_member_list.md +3 -3
  91. package/skills/ae-analysis/references/project_member_receiver_list.md +3 -3
  92. package/skills/ae-analysis/references/project_member_remove.md +3 -3
  93. package/skills/ae-analysis/references/project_member_update.md +3 -3
  94. package/skills/ae-analysis/references/project_owner_update.md +3 -3
  95. package/skills/ae-analysis/references/project_permission_binding_list.md +3 -3
  96. package/skills/ae-analysis/references/project_receive_status_update.md +3 -3
  97. package/skills/ae-analysis/references/project_role_delete.md +3 -3
  98. package/skills/ae-analysis/references/project_role_function_list.md +3 -3
  99. package/skills/ae-analysis/references/project_role_get.md +3 -3
  100. package/skills/ae-analysis/references/project_role_list.md +3 -3
  101. package/skills/ae-analysis/references/project_role_upsert.md +3 -3
  102. package/skills/ae-analysis/references/project_role_user_list.md +3 -3
  103. package/skills/ae-analysis/references/project_space_list.md +1 -1
  104. package/skills/ae-analysis/references/project_timezone_get.md +3 -3
  105. package/skills/ae-analysis/references/project_timezone_overview.md +3 -3
  106. package/skills/ae-analysis/references/project_timezone_update.md +3 -3
  107. package/skills/ae-analysis/references/project_user_id_items_update.md +3 -3
  108. package/skills/ae-analysis/references/system_admin_function_list.md +22 -0
  109. package/skills/ae-analysis/references/system_admin_function_update.md +26 -0
  110. package/skills/ae-analysis/references/system_admin_list.md +21 -0
  111. package/skills/ae-analysis/references/system_admin_remove.md +25 -0
  112. package/skills/ae-analysis/references/system_admin_upsert.md +25 -0
  113. package/skills/ae-analysis/references/system_function_list.md +21 -0
  114. package/skills/ae-analysis/references/system_member_add.md +25 -0
  115. package/skills/ae-analysis/references/system_member_candidate_list.md +22 -0
  116. package/skills/ae-analysis/references/system_member_delete.md +25 -0
  117. package/skills/ae-analysis/references/system_member_list.md +24 -0
  118. package/skills/ae-analysis/references/system_member_mfa_unbind.md +25 -0
  119. package/skills/ae-analysis/references/system_member_password_reset.md +32 -0
  120. package/skills/ae-analysis/references/system_member_project_batch_update.md +27 -0
  121. package/skills/ae-analysis/references/system_member_status_update.md +26 -0
  122. package/skills/ae-analysis/references/system_member_update.md +23 -0
  123. package/skills/ae-analysis/references/system_mfa_get.md +21 -0
  124. package/skills/ae-analysis/references/system_mfa_update.md +25 -0
  125. package/skills/ae-analysis/references/system_node_monitor_list.md +24 -0
  126. package/skills/ae-analysis/references/system_oauth2_update.md +22 -0
  127. package/skills/ae-analysis/references/system_ops_alert_contact_delete.md +25 -0
  128. package/skills/ae-analysis/references/system_ops_alert_contact_list.md +23 -0
  129. package/skills/ae-analysis/references/system_ops_alert_contact_test.md +29 -0
  130. package/skills/ae-analysis/references/system_ops_alert_contact_upsert.md +39 -0
  131. package/skills/ae-analysis/references/system_preference_get.md +21 -0
  132. package/skills/ae-analysis/references/system_preference_update.md +22 -0
  133. package/skills/ae-analysis/references/system_project_usage_list.md +28 -0
  134. package/skills/ae-analysis/references/system_query_alert_rule_list.md +21 -0
  135. package/skills/ae-analysis/references/system_query_alert_rule_update.md +26 -0
  136. package/skills/ae-analysis/references/system_query_monitor_overview.md +26 -0
  137. package/skills/ae-analysis/references/system_query_task_cancel.md +25 -0
  138. package/skills/ae-analysis/references/system_query_task_export.md +49 -0
  139. package/skills/ae-analysis/references/system_query_task_get.md +23 -0
  140. package/skills/ae-analysis/references/system_query_task_list.md +35 -0
  141. package/skills/ae-analysis/references/system_query_task_options.md +27 -0
  142. package/skills/ae-analysis/references/system_receiver_address_delete.md +26 -0
  143. package/skills/ae-analysis/references/system_receiver_address_overview.md +21 -0
  144. package/skills/ae-analysis/references/system_receiver_address_project_list.md +21 -0
  145. package/skills/ae-analysis/references/system_receiver_address_promote.md +24 -0
  146. package/skills/ae-analysis/references/system_receiver_address_upsert.md +27 -0
  147. package/skills/ae-analysis/references/system_receiver_detection_get.md +22 -0
  148. package/skills/ae-analysis/references/system_receiver_detection_run.md +22 -0
  149. package/skills/ae-analysis/references/system_receiver_detection_update.md +25 -0
  150. package/skills/ae-analysis/references/system_role_delete.md +26 -0
  151. package/skills/ae-analysis/references/system_role_function_list.md +22 -0
  152. package/skills/ae-analysis/references/system_role_get.md +22 -0
  153. package/skills/ae-analysis/references/system_role_list.md +24 -0
  154. package/skills/ae-analysis/references/system_role_upsert.md +27 -0
  155. package/skills/ae-analysis/references/system_role_user_list.md +22 -0
  156. package/skills/ae-analysis/references/system_seat_list.md +25 -0
  157. package/skills/ae-analysis/references/system_seat_update.md +26 -0
  158. package/skills/ae-analysis/references/system_smtp_delete.md +24 -0
  159. package/skills/ae-analysis/references/system_smtp_get.md +21 -0
  160. package/skills/ae-analysis/references/system_smtp_test.md +22 -0
  161. package/skills/ae-analysis/references/system_smtp_upsert.md +31 -0
  162. package/skills/ae-analysis/references/system_third_party_login_disable.md +25 -0
  163. package/skills/ae-analysis/references/system_third_party_login_list.md +21 -0
  164. package/skills/ae-analysis/references/system_third_party_login_upsert.md +33 -0
  165. package/skills/ae-analysis/references/system_usage_overview.md +21 -0
  166. package/skills/ae-analysis/references/system_usage_trend_export.md +44 -0
  167. package/skills/ae-analysis/references/system_usage_trend_query.md +28 -0
  168. package/skills/ae-dataops/SKILL.md +1 -1
  169. package/skills/ae-dataops/references/dataops-flow-create.md +51 -16
  170. package/skills/ae-engage/SKILL.md +56 -26
  171. package/skills/ae-engage/references/activity-activity.md +3 -0
  172. package/skills/ae-engage/references/activity-approval.md +12 -4
  173. package/skills/ae-engage/references/activity-task.md +21 -6
  174. package/skills/ae-engage/references/activity-topic.md +31 -13
  175. package/skills/ae-engage/references/add-channel.md +170 -41
  176. package/skills/ae-engage/references/build-task-save-guide.md +40 -27
  177. package/skills/ae-engage/references/channel-update-config.md +3 -2
  178. package/skills/ae-engage/references/common-metric.md +48 -120
  179. package/skills/ae-engage/references/flow-detail.md +13 -0
  180. package/skills/ae-engage/references/preset-event.md +12 -32
  181. package/skills/ae-engage/references/save-flow.md +127 -64
  182. package/skills/ae-engage/references/save-task.md +197 -59
  183. package/skills/ae-engage/references/scene-config-metric.md +3 -0
  184. package/skills/ae-engage/references/scene-preset-metric.md +8 -37
  185. package/skills/ae-engage/references/scene-strategy-audience.md +51 -643
  186. package/skills/ae-engage/references/scene-strategy.md +6 -6
  187. package/skills/ae-engage/references/task-detail.md +10 -0
  188. package/skills/ae-engage/references/task-submit-approval.md +45 -0
  189. package/skills/ae-engage/references/validate-flow-node-config.md +1 -1
  190. package/skills/ae-generate-tracking-code/SKILL.md +2 -2
  191. package/skills/ae-metadata/SKILL.md +1 -1
  192. package/dist/config-BSSALXEN.js +0 -128
  193. package/dist/sync-QFP4XFN3.js +0 -485
@@ -0,0 +1,25 @@
1
+ # system seat list
2
+
3
+ Use when the user needs to list company seat assignments.
4
+
5
+ Do not use it outside the system seat operation or with fields absent from the inspected capability schema.
6
+
7
+ Command:
8
+
9
+ ```bash
10
+ ae-cli system seat list --company-id <company-id>
11
+ ```
12
+
13
+ Capability id: `system.seat.list`.
14
+
15
+ The response uses `ok`, `data`, and `meta`. Treat empty `data` as success when `ok=true`; preserve `request_id` and `invocation_id` when present.
16
+
17
+ ## Parameters
18
+
19
+ | Parameter | Required | Description |
20
+ |---|---|---|
21
+ | `--company-id` | Yes | Company ID. |
22
+ | `--query` | No | Optional keyword filter. |
23
+ | `--limit` | No | Page size. Default and maximum depend on the capability schema. |
24
+ | `--offset` | No | Zero-based result offset. |
25
+ | `--seat-type` | No | Optional seat type. |
@@ -0,0 +1,26 @@
1
+ # system seat update
2
+
3
+ Use when the user needs to assign management/view BI seats or remove seats from an explicit member set.
4
+
5
+ Do not use it without first reading current seat assignments and company quota with `ae-cli system seat list`.
6
+
7
+ Command:
8
+
9
+ ```bash
10
+ ae-cli system seat update --dry-run --company-id <company_id> --seat-type <manage_or_view_or_empty> --open-ids '["ou_xxx"]'
11
+ ae-cli system seat update --company-id <company_id> --seat-type <manage_or_view_or_empty> --open-ids '["ou_xxx"]' --yes
12
+ ```
13
+
14
+ Capability id: `system.seat.update`.
15
+
16
+ `seat-type=empty` removes seats. Run `--dry-run` first and verify additions, removals, unchanged members, and license quota impact. Wait for explicit user confirmation before rerunning the unchanged command with global `--yes`.
17
+
18
+ The response uses `ok`, `data`, and `meta`. A quota conflict is not proof of a partial update; inspect the returned transactional result.
19
+
20
+ ## Parameters
21
+
22
+ | Parameter | Required | Description |
23
+ |---|---|---|
24
+ | `--company-id` | Yes | Company ID. |
25
+ | `--seat-type` | Yes | `manage`, `view`, or `empty`; `empty` removes seats. |
26
+ | `--open-ids` | Yes | Non-empty company member open-ID JSON array. |
@@ -0,0 +1,24 @@
1
+ # system smtp delete
2
+
3
+ Use when the user needs to delete company SMTP configuration.
4
+
5
+ Do not use it outside the system smtp operation or with fields absent from the inspected capability schema.
6
+
7
+ Command:
8
+
9
+ ```bash
10
+ ae-cli system smtp delete --dry-run --company-id <company-id>
11
+ ae-cli system smtp delete --company-id <company-id> --yes
12
+ ```
13
+
14
+ Capability id: `system.smtp.delete`.
15
+
16
+ Run `--dry-run` first, summarize the affected target and impact, then wait for explicit user confirmation before rerunning the unchanged command with global `--yes`.
17
+
18
+ The response uses `ok`, `data`, and `meta`. Treat empty `data` as success when `ok=true`; preserve `request_id` and `invocation_id` when present.
19
+
20
+ ## Parameters
21
+
22
+ | Parameter | Required | Description |
23
+ |---|---|---|
24
+ | `--company-id` | Yes | Company ID. |
@@ -0,0 +1,21 @@
1
+ # system smtp get
2
+
3
+ Use when the user needs to get sanitized company SMTP configuration.
4
+
5
+ Do not use it outside the system smtp operation or with fields absent from the inspected capability schema.
6
+
7
+ Command:
8
+
9
+ ```bash
10
+ ae-cli system smtp get --company-id <company-id>
11
+ ```
12
+
13
+ Capability id: `system.smtp.get`.
14
+
15
+ The response uses `ok`, `data`, and `meta`. Treat empty `data` as success when `ok=true`; preserve `request_id` and `invocation_id` when present.
16
+
17
+ ## Parameters
18
+
19
+ | Parameter | Required | Description |
20
+ |---|---|---|
21
+ | `--company-id` | Yes | Company ID. |
@@ -0,0 +1,22 @@
1
+ # system smtp test
2
+
3
+ Use when the user needs to send one SMTP test using the saved configuration.
4
+
5
+ Do not use it outside the system smtp operation or with fields absent from the inspected capability schema.
6
+
7
+ Command:
8
+
9
+ ```bash
10
+ ae-cli system smtp test --company-id <company-id> --receiver <receiver>
11
+ ```
12
+
13
+ Capability id: `system.smtp.test`.
14
+
15
+ The response uses `ok`, `data`, and `meta`. Treat empty `data` as success when `ok=true`; preserve `request_id` and `invocation_id` when present.
16
+
17
+ ## Parameters
18
+
19
+ | Parameter | Required | Description |
20
+ |---|---|---|
21
+ | `--company-id` | Yes | Company ID. |
22
+ | `--receiver` | Yes | Test email receiver. |
@@ -0,0 +1,31 @@
1
+ # system smtp upsert
2
+
3
+ Use when the user needs to create or update company SMTP configuration using a protected password source.
4
+
5
+ Do not use it outside the system smtp operation or with fields absent from the inspected capability schema.
6
+
7
+ Command:
8
+
9
+ ```bash
10
+ ae-cli system smtp upsert --company-id <company-id> --server-host <server-host> --server-port <server-port> --sender-address <sender-address> --sender-name <sender-name> --password-file <chmod_600_file>
11
+ ```
12
+
13
+ Capability id: `system.smtp.upsert`.
14
+
15
+ Sensitive values are accepted only through a permission-protected file or stdin. Never put a secret value in argv, examples, logs, validation output, dry-run output, or the response.
16
+
17
+ The response uses `ok`, `data`, and `meta`. Treat empty `data` as success when `ok=true`; preserve `request_id` and `invocation_id` when present.
18
+
19
+ ## Parameters
20
+
21
+ | Parameter | Required | Description |
22
+ |---|---|---|
23
+ | `--company-id` | Yes | Company ID. |
24
+ | `--server-host` | Yes | SMTP server host. |
25
+ | `--server-port` | Yes | SMTP server port. |
26
+ | `--has-encrypt` | No | Encryption mode: 0, 1, or 2. |
27
+ | `--sender-address` | Yes | Sender email address. |
28
+ | `--sender-name` | Yes | Sender display name. |
29
+ | `--subject-prefix` | No | Optional subject prefix. |
30
+ | `--password-file` | No | SMTP password. Read from a local permission-protected file; one of file/stdin is required. |
31
+ | `--password-stdin` | No | SMTP password. Read from stdin; one of file/stdin is required. |
@@ -0,0 +1,25 @@
1
+ # system third-party-login disable
2
+
3
+ Use when the user needs to disable a third-party login provider.
4
+
5
+ Do not use it outside the system third-party-login operation or with fields absent from the inspected capability schema.
6
+
7
+ Command:
8
+
9
+ ```bash
10
+ ae-cli system third-party-login disable --dry-run --company-id <company-id> --login-type <login-type>
11
+ ae-cli system third-party-login disable --company-id <company-id> --login-type <login-type> --yes
12
+ ```
13
+
14
+ Capability id: `system.third_party_login.disable`.
15
+
16
+ Run `--dry-run` first, summarize the affected target and impact, then wait for explicit user confirmation before rerunning the unchanged command with global `--yes`.
17
+
18
+ The response uses `ok`, `data`, and `meta`. Treat empty `data` as success when `ok=true`; preserve `request_id` and `invocation_id` when present.
19
+
20
+ ## Parameters
21
+
22
+ | Parameter | Required | Description |
23
+ |---|---|---|
24
+ | `--company-id` | Yes | Company ID. |
25
+ | `--login-type` | Yes | Third-party login type. |
@@ -0,0 +1,21 @@
1
+ # system third-party-login list
2
+
3
+ Use when the user needs to list sanitized third-party login configurations.
4
+
5
+ Do not use it outside the system third-party-login operation or with fields absent from the inspected capability schema.
6
+
7
+ Command:
8
+
9
+ ```bash
10
+ ae-cli system third-party-login list --company-id <company-id>
11
+ ```
12
+
13
+ Capability id: `system.third_party_login.list`.
14
+
15
+ The response uses `ok`, `data`, and `meta`. Treat empty `data` as success when `ok=true`; preserve `request_id` and `invocation_id` when present.
16
+
17
+ ## Parameters
18
+
19
+ | Parameter | Required | Description |
20
+ |---|---|---|
21
+ | `--company-id` | Yes | Company ID. |
@@ -0,0 +1,33 @@
1
+ # system third-party-login upsert
2
+
3
+ Use when the user needs to create or update a third-party login configuration using protected secret sources.
4
+
5
+ Do not use it outside the system third-party-login operation or with fields absent from the inspected capability schema.
6
+
7
+ Command:
8
+
9
+ ```bash
10
+ ae-cli system third-party-login upsert --company-id <company_id> --login-type feishu --app-id <app_id> --app-secret-file <chmod_600_file>
11
+ ae-cli system third-party-login upsert --company-id <company_id> --login-type dingtalk --app-id <app_id> --corp-id <corp_id> --agent-id <agent_id> --dd-scan-app-id <scan_app_id> --app-secret-file <chmod_600_file> --dd-scan-app-secret-file <chmod_600_file>
12
+ ```
13
+
14
+ Capability id: `system.third_party_login.upsert`.
15
+
16
+ Sensitive values are accepted only through a permission-protected file or stdin. Never put a secret value in argv, examples, logs, validation output, dry-run output, or the response.
17
+
18
+ The response uses `ok`, `data`, and `meta`. Treat empty `data` as success when `ok=true`; preserve `request_id` and `invocation_id` when present.
19
+
20
+ ## Parameters
21
+
22
+ | Parameter | Required | Description |
23
+ |---|---|---|
24
+ | `--company-id` | Yes | Company ID. |
25
+ | `--login-type` | Yes | Third-party login type. |
26
+ | `--app-id` | Yes | Provider application ID. |
27
+ | `--corp-id` | No | Provider corporation ID. |
28
+ | `--agent-id` | No | Provider agent ID. |
29
+ | `--dd-scan-app-id` | No | DingTalk scan-login application ID. |
30
+ | `--app-secret-file` | No | Provider application secret. Read from a local permission-protected file; one of file/stdin is required. |
31
+ | `--app-secret-stdin` | No | Provider application secret. Read from stdin; one of file/stdin is required. |
32
+ | `--dd-scan-app-secret-file` | No | DingTalk scan-login application secret. Read from a local permission-protected file; the value is never accepted directly on argv. |
33
+ | `--dd-scan-app-secret-stdin` | No | DingTalk scan-login application secret. Read from stdin; do not combine with --dd-scan-app-secret-file. |
@@ -0,0 +1,21 @@
1
+ # system usage overview
2
+
3
+ Use when the user needs to get the current company system-usage summary.
4
+
5
+ Do not use it outside the system usage operation or with fields absent from the inspected capability schema.
6
+
7
+ Command:
8
+
9
+ ```bash
10
+ ae-cli system usage overview --company-id <company-id>
11
+ ```
12
+
13
+ Capability id: `system.usage.overview`.
14
+
15
+ The response uses `ok`, `data`, and `meta`. Treat empty `data` as success when `ok=true`; preserve `request_id` and `invocation_id` when present.
16
+
17
+ ## Parameters
18
+
19
+ | Parameter | Required | Description |
20
+ |---|---|---|
21
+ | `--company-id` | Yes | Company ID. |
@@ -0,0 +1,44 @@
1
+ # system usage-trend export
2
+
3
+ Use when the user needs the complete usage-trend result as a cancellable gzip JSONL artifact.
4
+
5
+ Do not use it for a small inline result; use `ae-cli system usage-trend query` instead.
6
+
7
+ Command:
8
+
9
+ ```bash
10
+ ae-cli system usage-trend export --company-id <company_id> --metric <metric> --start-time <yyyy-MM-dd> --end-time <yyyy-MM-dd> --time-granularity <day_or_week_or_month>
11
+ ```
12
+
13
+ Capability id: `system.usage_trend.export`.
14
+
15
+ The submit response returns the `run_id` for this exact export. Preserve it and poll:
16
+
17
+ ```bash
18
+ ae-cli analysis run inspect --run-id <run_id>
19
+ ```
20
+
21
+ When the run succeeds, preserve its `artifact_id` and download the same run-scoped artifact:
22
+
23
+ ```bash
24
+ ae-cli analysis artifact download --run-id <run_id> --artifact-id <artifact_id> --output <output_path>
25
+ ```
26
+
27
+ The artifact format is fixed gzip-compressed JSONL (`.jsonl.gz`); this command intentionally has no `--artifact-format`. Cancel an unfinished export with `ae-cli analysis query cancel --run-id <run_id>`.
28
+
29
+ The response uses `ok`, `data`, and `meta`. Empty exported data is success when `ok=true`; preserve `request_id` and `invocation_id`.
30
+
31
+ ## Parameters
32
+
33
+ | Parameter | Required | Description |
34
+ |---|---|---|
35
+ | `--company-id` | Yes | Company ID. |
36
+ | `--metric` | Yes | One supported usage metric; `apollo_token` is not implemented. |
37
+ | `--start-time` | Yes | Inclusive start date in `yyyy-MM-dd`. |
38
+ | `--end-time` | Yes | Inclusive end date in `yyyy-MM-dd`. |
39
+ | `--time-granularity` | Yes | `day`, `week`, or `month`. |
40
+ | `--scope` | No | `company` or `project`; project scope requires `--project-ids`. |
41
+ | `--project-ids` | No | Project ID JSON array. |
42
+ | `--data-type` | No | `all`, `event`, or `user` for project-scoped total event volume. |
43
+ | `--request-id` | No | Caller-supplied `cli_<32 lowercase hex>` lifecycle ID; generated when omitted. |
44
+ | `--timeout-seconds` | No | Maximum runtime, `1..21600`; default `21600`. |
@@ -0,0 +1,28 @@
1
+ # system usage-trend query
2
+
3
+ Use when the user needs to query a bounded company or project usage trend.
4
+
5
+ Do not use it outside the system usage-trend operation or with fields absent from the inspected capability schema.
6
+
7
+ Command:
8
+
9
+ ```bash
10
+ ae-cli system usage-trend query --company-id <company-id> --start-time <start-time> --end-time <end-time> --metric <metric> --time-granularity <time-granularity>
11
+ ```
12
+
13
+ Capability id: `system.usage_trend.query`.
14
+
15
+ The response uses `ok`, `data`, and `meta`. Treat empty `data` as success when `ok=true`; preserve `request_id` and `invocation_id` when present.
16
+
17
+ ## Parameters
18
+
19
+ | Parameter | Required | Description |
20
+ |---|---|---|
21
+ | `--company-id` | Yes | Company ID. |
22
+ | `--start-time` | Yes | Inclusive ISO date/time lower bound. |
23
+ | `--end-time` | Yes | Inclusive ISO date/time upper bound. |
24
+ | `--metric` | Yes | Supported usage metric; apollo_token is not available. |
25
+ | `--time-granularity` | Yes | Aggregation granularity. |
26
+ | `--scope` | No | Aggregation scope. |
27
+ | `--project-ids` | No | Project ID JSON array; required for project scope. |
28
+ | `--data-type` | No | Optional event-volume data type. |
@@ -89,7 +89,7 @@ You must understand the following key concepts before use, otherwise errors are
89
89
  ### Flow Lifecycle
90
90
 
91
91
  ```
92
- Create DEV Flow → Create/Update DEV SQL Tasks → Configure Dependencies/Schedule → Preview Release → Release to PROD → PROD Manual Execution / Operations Troubleshooting
92
+ Create DEV Flow → Create/Update DEV SQL, Integration, or Workflow Instance Check Tasks → Configure Dependencies/Schedule → Preview Release → Release to PROD → PROD Manual Execution / Operations Troubleshooting
93
93
  ```
94
94
 
95
95
  ### CRON Format (6 fields)
@@ -41,7 +41,7 @@ ae-cli dataops_flow +create_sql_task --spaceCode "${spaceCode}" \
41
41
  # Create task with upstream dependency
42
42
  ae-cli dataops_flow +create_sql_task --spaceCode "${spaceCode}" \
43
43
  --flowCode ${flowCode} --taskName "Export Results" \
44
- --preTaskCode ${upstreamTaskCode} \
44
+ --preTasks "[${upstreamTaskCode},${anotherUpstreamTaskCode}]" \
45
45
  --sql "INSERT INTO ads_user SELECT * FROM dwd_user"
46
46
  ```
47
47
 
@@ -63,23 +63,40 @@ ae-cli dataops_flow +update_integration_task --spaceCode "${spaceCode}" \
63
63
 
64
64
  Use `dataops_integration +list_sync_solutions` or `+get_sync_detail` to find the `syncId` first. These commands expose workflow `OFFLINE_SYNC` tasks only; app sync tasks are not part of this flow.
65
65
 
66
- ### Step 4: Modify SQL Task Content
66
+ ### Step 4: Create or Modify Workflow Instance Check Task
67
+
68
+ `checkItems` is a flat JSON array. Every item contains only `flowCode`, `left`, `right`, and `checkTimeUnit` (`DAY`, `HOUR`, or `MINUTE`). One `AND` or `OR` relation applies to the entire array; nested groups are not supported. For the current workflow, `left` and `right` are at least `1`; for another workflow they may be `0`; `right` must not exceed `left`.
69
+
70
+ ```bash
71
+ ae-cli dataops_flow +create_workflow_instance_check_task --spaceCode "${spaceCode}" \
72
+ --flowCode ${flowCode} --taskName "Wait for upstream workflows" \
73
+ --checkItems '[{"flowCode":10037355068544,"left":1,"right":1,"checkTimeUnit":"DAY"},{"flowCode":10037355068545,"left":2,"right":0,"checkTimeUnit":"HOUR"}]' \
74
+ --relation OR
75
+
76
+ ae-cli dataops_flow +update_workflow_instance_check_task --spaceCode "${spaceCode}" \
77
+ --flowCode ${flowCode} --taskCode ${taskCode} \
78
+ --checkItems '[{"flowCode":10037355068544,"left":1,"right":1,"checkTimeUnit":"DAY"}]'
79
+ ```
80
+
81
+ Create defaults are `relation=AND`, `checkInterval=5`, `checkTime=3`, `failRetryTimes=3`, `failRetryInterval=5`, and `failRetryUnit=MINUTE`. On update, omitted check scalars, dependencies, and retry fields keep their current values.
82
+
83
+ ### Step 5: Modify SQL Task Content
67
84
 
68
85
  ```bash
69
- # Update SQL task content without changing owner, remark, dependencies, retry, or timeout
86
+ # Update SQL task content and keep dependencies and retry policy
70
87
  ae-cli dataops_flow +update_sql_task --spaceCode "${spaceCode}" \
71
88
  --flowCode ${flowCode} --taskCode ${taskCode} \
72
89
  --sql "SELECT * FROM dwd_user"
73
90
  ```
74
91
 
75
- ### Step 5: Add Task Dependencies (DAG connections)
92
+ ### Step 6: Add Task Dependencies (DAG connections)
76
93
 
77
94
  ```bash
78
95
  ae-cli dataops_flow +add_task_relation --spaceCode "${spaceCode}" \
79
96
  --flowCode ${flowCode} --preTaskCode ${upstreamTaskCode} --taskCode ${downstreamTaskCode}
80
97
  ```
81
98
 
82
- ### Step 6: Configure Schedule
99
+ ### Step 7: Configure Schedule
83
100
 
84
101
  ```bash
85
102
  # CRON expression for scheduled execution
@@ -93,7 +110,7 @@ ae-cli dataops_flow +save_schedule_config --spaceCode "${spaceCode}" \
93
110
  - `0 0 */4 * * ?` — Every 4 hours
94
111
  - `0 30 8 * * 1-5` — Weekdays at 8:30
95
112
 
96
- ### Step 7: Preview Release
113
+ ### Step 8: Preview Release
97
114
 
98
115
  ```bash
99
116
  # Preview pending DEV-to-PROD release changes before publishing
@@ -101,7 +118,7 @@ ae-cli dataops_flow +preview_release_flow --spaceCode "${spaceCode}" \
101
118
  --flowCode ${flowCode}
102
119
  ```
103
120
 
104
- ### Step 8: Release to Production and Verify
121
+ ### Step 9: Release to Production and Verify
105
122
 
106
123
  ```bash
107
124
  ae-cli dataops_flow +release_flow --spaceCode "${spaceCode}" \
@@ -130,10 +147,12 @@ ae-cli dataops_operations +get_task_instance_detail --spaceCode "${spaceCode}" \
130
147
  | Command | Purpose | Key Flags |
131
148
  |---------|---------|-----------|
132
149
  | `+create_flow` | Create DEV flow | `--spaceCode` `--flowName` `[--remark]` |
133
- | `+create_sql_task` | Create DEV Trino SQL task and save SQL | `--spaceCode` `--flowCode` `--taskName` `--sql` `[--preSql]` `[--postSql]` `[--preTaskCode]` `[--remark]` |
134
- | `+update_sql_task` | Update DEV Trino SQL task content | `--spaceCode` `--flowCode` `--taskCode` `--sql` `[--preSql]` `[--postSql]` |
135
- | `+create_integration_task` | Create DEV integration sync task from an existing sync solution | `--spaceCode` `--flowCode` `--taskName` `--syncId` `[--preTaskCode]` `[--remark]` |
136
- | `+update_integration_task` | Rebind DEV integration sync task to a sync solution | `--spaceCode` `--flowCode` `--taskCode` `--syncId` |
150
+ | `+create_sql_task` | Create DEV Trino SQL task and save SQL | `--spaceCode` `--flowCode` `--taskName` `--sql` `[--preSql]` `[--postSql]` `[--preTasks]` `[--failRetryTimes]` `[--failRetryInterval]` `[--failRetryUnit]` `[--remark]` |
151
+ | `+update_sql_task` | Update DEV Trino SQL task content | `--spaceCode` `--flowCode` `--taskCode` `--sql` `[--preSql]` `[--postSql]` `[--preTasks]` `[--failRetryTimes]` `[--failRetryInterval]` `[--failRetryUnit]` |
152
+ | `+create_integration_task` | Create DEV integration sync task from an existing sync solution | `--spaceCode` `--flowCode` `--taskName` `--syncId` `[--preTasks]` `[--failRetryTimes]` `[--failRetryInterval]` `[--failRetryUnit]` `[--remark]` |
153
+ | `+update_integration_task` | Rebind DEV integration sync task to a sync solution | `--spaceCode` `--flowCode` `--taskCode` `--syncId` `[--preTasks]` `[--failRetryTimes]` `[--failRetryInterval]` `[--failRetryUnit]` |
154
+ | `+create_workflow_instance_check_task` | Create DEV workflow instance check task | `--spaceCode` `--flowCode` `--taskName` `--checkItems` `[--relation]` `[--checkInterval]` `[--checkTime]` `[--preTasks]` `[retry flags]` `[--remark]` |
155
+ | `+update_workflow_instance_check_task` | Update DEV workflow instance check task | `--spaceCode` `--flowCode` `--taskCode` `--checkItems` `[--relation]` `[--checkInterval]` `[--checkTime]` `[--preTasks]` `[retry flags]` |
137
156
  | `+add_task_relation` | Add DEV dependency | `--spaceCode` `--flowCode` `--preTaskCode` `--taskCode` |
138
157
  | `+save_schedule_config` | Save DEV schedule config | `--spaceCode` `--flowCode` `--enabled` `[--cron]` |
139
158
  | `+get_task_params` | View DEV task parameter list | `--spaceCode` `--flowCode` `--taskCode` |
@@ -150,17 +169,33 @@ ae-cli dataops_operations +get_task_instance_detail --spaceCode "${spaceCode}" \
150
169
  - **Schedule config**: `+save_schedule_config` requires `--spaceCode`, `--flowCode`, and `--enabled`. `--cron` is required only when `--enabled true`; omit it when disabling scheduling. It returns `action/result/status`; `result` includes `enabled`, `flow`, `message`, and `cron` only when enabled.
151
170
  - **Release preview**: `+preview_release_flow` requires `--spaceCode` and `--flowCode`; it has no optional flags. It returns `flowCode`, `releaseStatus`, `message`, and `changes`. Each change may include `scheduleConfigChange` and `tasks`; task entries may include `changed`, `contentCompare`, and `targetTable`.
152
171
  - **Release**: `+release_flow` requires `--spaceCode` and `--flowCode`; it has no optional flags. It returns `action/result/status`; `result` includes `flowCode`, `releaseStatus`, `message`, optional `packageCode`, and optional `changes`. Each change may include `scheduleConfigChange` and `tasks`; task entries include `changed`.
153
- - **SQL task creation**: `+create_sql_task` requires `--spaceCode`, `--flowCode`, `--taskName`, and `--sql`; `--preSql`, `--postSql`, `--preTaskCode`, and `--remark` are optional. It returns `action/result/status`; `result` includes `flowCode`, `taskCode`, `taskName`, `taskType=TRINO_SQL`, and `sqlSaved=true`.
154
- - **SQL task update**: `+update_sql_task` requires `--spaceCode`, `--flowCode`, `--taskCode`, and `--sql`; `--preSql` and `--postSql` are optional and keep existing values when omitted. It returns `action/result/status`; `result` includes `sqlSaved`, `flowCode`, `taskCode`, `taskType=TRINO_SQL`, and `task`.
172
+ - **Task dependencies**: `--preTasks` is a JSON array of upstream task codes on SQL, integration, and workflow instance check create/update commands. Omit `--preTasks` on update to preserve existing dependencies; pass `--preTasks '[]'` to clear them; pass a non-empty array to replace them.
173
+ - **Retry policy**: The three task types accept `--failRetryTimes`, `--failRetryInterval`, and `--failRetryUnit`. Create defaults to `3`, `5`, and `MINUTE`. Update preserves every omitted retry field. `MINUTE` is the only supported unit.
174
+ - **SQL task creation**: `+create_sql_task` requires `--spaceCode`, `--flowCode`, `--taskName`, and `--sql`; SQL hooks, dependencies, retry policy, and remark are optional. It returns `action/result/status`; `result` includes `flowCode`, `taskCode`, `taskName`, `taskType=TRINO_SQL`, and `sqlSaved=true`.
175
+ - **SQL task update**: `+update_sql_task` requires `--spaceCode`, `--flowCode`, `--taskCode`, and `--sql`; omitted SQL hooks, dependencies, and retry fields keep existing values. It returns `action/result/status`; `result` includes `sqlSaved`, `flowCode`, `taskCode`, `taskType=TRINO_SQL`, and `task`.
155
176
  - **Task dependency**: `+add_task_relation` requires `--spaceCode`, `--flowCode`, `--preTaskCode`, and `--taskCode`. `preTaskCode` is upstream and `taskCode` is downstream. It returns `action/result/status`; `result` includes `status`, `flowCode`, `preTaskCode`, `taskCode`, and `message`.
156
177
  - **Task parameters**: `+get_task_params` requires `--spaceCode`, `--flowCode`, and `--taskCode`; it has no optional flags. It queries DEV and returns `data` as an array. Items include fields such as `paramKey`, `paramType`, `paramDataType`, `paramFrom`, and built-in flags like `isBd`.
157
- - **Integration task creation**: `+create_integration_task` requires `--spaceCode`, `--flowCode`, `--taskName`, and `--syncId`; `--preTaskCode` and `--remark` are optional. It returns `action/result/status`; `result` includes `syncTaskSaved`, `flowCode`, `taskCode`, `taskName`, `taskType=OFFLINE_SYNC`, `syncId`, and `nextAction`.
158
- - **SQL task dependencies**: Use optional `--preTaskCode` to create one upstream dependency with the task. Use `+add_task_relation` for additional DAG dependencies.
178
+ - **Integration task creation**: `+create_integration_task` requires `--spaceCode`, `--flowCode`, `--taskName`, and `--syncId`; dependencies, retry policy, and remark are optional. It returns `action/result/status`; `result` includes `syncTaskSaved`, `flowCode`, `taskCode`, `taskName`, `taskType=OFFLINE_SYNC`, `syncId`, and `nextAction`.
179
+ - **Workflow instance check tasks**: `checkItems` is required and replaces the complete check item list. Create defaults `relation/checkInterval/checkTime` to `AND/5/3`; update preserves omitted scalar values. This command creates `FLOW_CHECK`, not task-instance `TASK_CHECK`.
180
+
181
+ ## Transport Status
182
+
183
+ Transition status: transitional
184
+
185
+ Owning module: gaia-mcp workflow
186
+
187
+ Current transport: DataOps CLI REST
188
+
189
+ Gateway target: TBD after DataOps workflow Gateway schema review
190
+
191
+ Review after: 2026-10-27
192
+
193
+ Exit condition: Migrate or remove these one-to-one commands after equivalent Capability Gateway actions are available.
159
194
 
160
195
  ## Important Notes
161
196
 
162
197
  1. **Getting flowCode**: Use `+list_flows` (see `dataops-flow-monitor` Skill)
163
- 2. **Getting taskCode**: Returned by `+create_sql_task` / `+create_integration_task` or query via `+get_flow_overview`
198
+ 2. **Getting taskCode**: Returned by a task create command or query via `+get_flow_overview`
164
199
  3. **Release Impact**: Submits current DEV changes to PROD; released schedule/config applies to future PROD runs
165
200
  4. **SQL Validation**: Recommended to validate before saving TRINO_SQL tasks
166
201
  5. **Cannot create circular dependencies**