@amaster.ai/runtime-cli 1.1.13 → 1.1.14-beta.1

package/README.md

@@ -9,7 +9,7 @@ CLI for Amaster SDK - Multi-app support for OpenClaw. Manage multiple Amaster ap
 - **Structured Output**: `json`, `pretty`, `table`, `ndjson`, and `csv`
 - **Entity Management**: CRUD, options lookup, and bulk operations on entities
 - **BPM**: Manage Camunda processes, tasks, and instances
-- **Workflow**: Run workflows
+- **Workflow**: Discover, inspect, and run workflows
 - **S3 Storage**: Upload files, download objects, and inspect metadata
 - **OpenClaw Integration**: Initialize app-specific skills and MCP servers
 
@@ -86,6 +86,10 @@ amaster logout --app myapp
 ### 4. Use SDK Features
 
 ```bash
+# Discover runnable workflows and inspect required inputs
+amaster workflow list --app myapp --format pretty
+amaster workflow get <workflow-app-id> --app myapp --format pretty
+
 # Run an anonymous workflow when the app exposes it publicly
 amaster workflow run text-sentiment-analysis --app myapp \
   --input '{"input_text":"I love this product. It is fast and easy to use."}'
@@ -173,6 +177,15 @@ amaster entity bulk-delete default products --app myapp --ids 1,2,3
 
 # Bulk delete by JSON array
 amaster entity bulk-delete default products --app myapp --ids '[1,2,3]'
+
+# Discover runtime datasources and models
+amaster model datasources --app myapp
+
+# Fetch CREATE TABLE statements for one datasource
+amaster model table-schema source-123 --app myapp
+
+# Limit schema output to selected tables
+amaster model table-schema source-123 --app myapp --tables products,categories
 ```
 
 For `amaster entity list`, explicit options such as `--page`, `--page-size`, `--fields`, `--relations`, and `--order-by` override the same keys inside `--query`. If you omit `--page` and `--page-size`, the CLI does not inject pagination defaults and forwards only the parameters you provided.
@@ -271,6 +284,17 @@ amaster entity bulk-delete <namespace> <entity> [options]
   --ids <ids>                         # Comma-separated IDs, JSON array, or @file
 ```
 
+### Model Discovery
+
+```bash
+amaster model datasources [options]
+  --app <app-code>                    # App code (uses default if not specified)
+
+amaster model table-schema <source-id> [options]
+  --app <app-code>                    # App code (uses default if not specified)
+  --tables <tables>                   # Comma-separated table names, JSON array, or @file
+```
+
 #### Entity Parameter Examples
 
 ```bash
@@ -340,6 +364,15 @@ amaster entity bulk-update default products --app myapp \
 
 # bulk-delete --ids
 amaster entity bulk-delete default products --app myapp --ids 1,2,3
+
+# model datasources
+amaster model datasources --app bleulig7o
+
+# model table-schema
+amaster model table-schema source-ae0rbo4tg9a8 --app bleulig7o
+
+# model table-schema --tables
+amaster model table-schema source-ae0rbo4tg9a8 --app bleulig7o --tables products,categories
 ```
 
 ### BPM (Business Process Management)
@@ -610,6 +643,15 @@ amaster bpm modify-instance proc-123 --app myapp \
 ### Workflow
 
 ```bash
+amaster workflow list [options]          # List workflow apps and runnable names
+  --app <app-code>                    # App code (uses default if not specified)
+  --page <n>                          # Page number
+  --limit <n>                         # Page size
+  --mode <mode>                       # workflow | chat | completion | agent-chat
+
+amaster workflow get <id> [options]     # Get workflow details and input variables by workflow app ID
+  --app <app-code>                    # App code (uses default if not specified)
+
 amaster workflow run <name> [options]    # Run a workflow
   --app <app-code>                    # App code (uses default if not specified)
   -i, --input <json>                  # Workflow inputs object as JSON or @file
@@ -620,6 +662,8 @@ amaster workflow run <name> [options]    # Run a workflow
   --trace-id <traceId>                # Workflow trace ID
 ```
 
+Use `workflow list` to discover workflow app IDs and `runnable_name`. Use the `id` with `workflow get`, and use the `runnable_name` or the `name` returned by `workflow get` with `workflow run`.
+
 ### S3 Storage
 
 ```bash