bailian-cli 1.0.0-beta.0 → 1.0.0

package/skill/reference/app.md

@@ -0,0 +1,99 @@
+# `bl app` commands
+
+> Auto-generated from `packages/cli/src/commands/catalog.ts`. Do not edit by hand.
+> Regenerate: `pnpm --filter bailian-cli run generate:reference` (runs automatically on `build`).
+
+Index: [index.md](index.md)
+
+## Commands in this group
+
+| Command | Description |
+| --- | --- |
+| `bl app call` | Call a Bailian application (agent or workflow) |
+| `bl app list` | List Bailian applications |
+
+## Command details
+
+### `bl app call`
+
+| Field | Value |
+| --- | --- |
+| **Name** | `app call` |
+| **Description** | Call a Bailian application (agent or workflow) |
+| **Usage** | `bl app call --app-id <id> --prompt <text> [flags]` |
+
+#### Options
+
+| Flag | Type | Required | Description |
+| --- | --- | --- | --- |
+| `--app-id <id>` | string | yes | Application ID (required) |
+| `--prompt <text>` | string | yes | Input prompt text |
+| `--image <url>` | array | no | Image URL(s) to pass to the app (repeatable) |
+| `--file-id <id>` | array | no | Pre-uploaded file ID(s) (repeatable) |
+| `--session-id <id>` | string | no | Session ID for multi-turn conversation |
+| `--stream` | boolean | no | Stream response (default: on in TTY) |
+| `--pipeline-ids <ids>` | string | no | Knowledge base pipeline IDs (comma-separated) |
+| `--memory-id <id>` | string | no | Memory ID for long-term memory |
+| `--biz-params <json>` | string | no | Business parameters JSON (workflow variables) |
+| `--has-thoughts` | boolean | no | Show agent thinking process |
+
+#### Examples
+
+```bash
+bl app call --app-id abc123 --prompt "你好"
+```
+
+```bash
+bl app call --app-id abc123 --prompt "描述这张图片" --image https://example.com/photo.jpg
+```
+
+```bash
+bl app call --app-id abc123 --prompt "分析图片" --image img1.jpg --image img2.jpg
+```
+
+```bash
+bl app call --app-id abc123 --prompt "继续" --session-id sess_xxx --stream
+```
+
+```bash
+bl app call --app-id abc123 --prompt "搜索资料" --pipeline-ids pipe1,pipe2
+```
+
+```bash
+bl app call --app-id abc123 --prompt "开始" --biz-params '{"key":"value"}'
+```
+
+### `bl app list`
+
+| Field | Value |
+| --- | --- |
+| **Name** | `app list` |
+| **Description** | List Bailian applications |
+| **Usage** | `bl app list [flags]` |
+
+#### Options
+
+| Flag | Type | Required | Description |
+| --- | --- | --- | --- |
+| `--name <name>` | string | no | Filter by app name (keyword search) |
+| `--page <n>` | number | no | Page number (default: 1) |
+| `--page-size <n>` | number | no | Results per page (default: 30) |
+| `--region <region>` | string | no | API region (default: cn-beijing) |
+
+#### Examples
+
+```bash
+bl app list
+```
+
+```bash
+bl app list --name 客服
+```
+
+```bash
+bl app list --page 2 --page-size 10
+```
+
+```bash
+bl app list --output json
+```

package/skill/reference/auth.md

@@ -0,0 +1,96 @@
+# `bl auth` commands
+
+> Auto-generated from `packages/cli/src/commands/catalog.ts`. Do not edit by hand.
+> Regenerate: `pnpm --filter bailian-cli run generate:reference` (runs automatically on `build`).
+
+Index: [index.md](index.md)
+
+## Commands in this group
+
+| Command | Description |
+| --- | --- |
+| `bl auth login` | Authenticate with API key |
+| `bl auth logout` | Clear stored credentials |
+| `bl auth status` | Show current authentication state |
+
+## Command details
+
+### `bl auth login`
+
+| Field | Value |
+| --- | --- |
+| **Name** | `auth login` |
+| **Description** | Authenticate with API key |
+| **Usage** | `bl auth login --api-key <key> \| bl auth login --console` |
+
+#### Options
+
+| Flag | Type | Required | Description |
+| --- | --- | --- | --- |
+| `--api-key <key>` | string | no | DashScope API key to store |
+| `--console` | boolean | no | Sign in via browser; opens the console login URL in your default browser |
+
+#### Examples
+
+```bash
+bl auth login --api-key sk-xxxxx
+```
+
+```bash
+bl auth login --console
+```
+
+### `bl auth logout`
+
+| Field | Value |
+| --- | --- |
+| **Name** | `auth logout` |
+| **Description** | Clear stored credentials |
+| **Usage** | `bl auth logout [--console] [--yes] [--dry-run]` |
+
+#### Options
+
+| Flag | Type | Required | Description |
+| --- | --- | --- | --- |
+| `--console` | boolean | no | Only clear the console access_token, keep api_key intact |
+| `--yes` | boolean | no | Skip confirmation prompt |
+
+#### Examples
+
+```bash
+bl auth logout
+```
+
+```bash
+bl auth logout --console
+```
+
+```bash
+bl auth logout --dry-run
+```
+
+```bash
+bl auth logout --yes
+```
+
+### `bl auth status`
+
+| Field | Value |
+| --- | --- |
+| **Name** | `auth status` |
+| **Description** | Show current authentication state |
+| **Usage** | `bl auth status` |
+
+#### Options
+
+_No command-specific options._
+
+#### Examples
+
+```bash
+bl auth status
+```
+
+```bash
+bl auth status --output json
+```

package/skill/reference/config.md

@@ -0,0 +1,91 @@
+# `bl config` commands
+
+> Auto-generated from `packages/cli/src/commands/catalog.ts`. Do not edit by hand.
+> Regenerate: `pnpm --filter bailian-cli run generate:reference` (runs automatically on `build`).
+
+Index: [index.md](index.md)
+
+## Commands in this group
+
+| Command | Description |
+| --- | --- |
+| `bl config export-schema` | Export all (or one) CLI command(s) as Anthropic/OpenAI-compatible JSON tool schemas |
+| `bl config set` | Set a config value |
+| `bl config show` | Display current configuration |
+
+## Command details
+
+### `bl config export-schema`
+
+| Field | Value |
+| --- | --- |
+| **Name** | `config export-schema` |
+| **Description** | Export all (or one) CLI command(s) as Anthropic/OpenAI-compatible JSON tool schemas |
+| **Usage** | `bl config export-schema [--command "<name>"]` |
+
+#### Options
+
+| Flag | Type | Required | Description |
+| --- | --- | --- | --- |
+| `--command <name>` | string | no | Export schema for a specific command only (e.g. "image generate") |
+
+#### Examples
+
+```bash
+bl config export-schema
+```
+
+```bash
+bl config export-schema --command "video generate"
+```
+
+### `bl config set`
+
+| Field | Value |
+| --- | --- |
+| **Name** | `config set` |
+| **Description** | Set a config value |
+| **Usage** | `bl config set --key <key> --value <value>` |
+
+#### Options
+
+| Flag | Type | Required | Description |
+| --- | --- | --- | --- |
+| `--key <key>` | string | no | Config key (region, base_url, output, output_dir, timeout, api_key, access_token, default_*_model, access_key_id, access_key_secret, workspace_id) |
+| `--value <value>` | string | no | Value to set |
+
+#### Examples
+
+```bash
+bl config set --key output --value json
+```
+
+```bash
+bl config set --key timeout --value 600
+```
+
+```bash
+bl config set --key base_url --value https://dashscope.aliyuncs.com
+```
+
+### `bl config show`
+
+| Field | Value |
+| --- | --- |
+| **Name** | `config show` |
+| **Description** | Display current configuration |
+| **Usage** | `bl config show` |
+
+#### Options
+
+_No command-specific options._
+
+#### Examples
+
+```bash
+bl config show
+```
+
+```bash
+bl config show --output json
+```

package/skill/reference/console.md

@@ -0,0 +1,40 @@
+# `bl console` commands
+
+> Auto-generated from `packages/cli/src/commands/catalog.ts`. Do not edit by hand.
+> Regenerate: `pnpm --filter bailian-cli run generate:reference` (runs automatically on `build`).
+
+Index: [index.md](index.md)
+
+## Commands in this group
+
+| Command | Description |
+| --- | --- |
+| `bl console call` | Call a Bailian console API via the CLI gateway |
+
+## Command details
+
+### `bl console call`
+
+| Field | Value |
+| --- | --- |
+| **Name** | `console call` |
+| **Description** | Call a Bailian console API via the CLI gateway |
+| **Usage** | `bl console call --api <api> --data <json> [flags]` |
+
+#### Options
+
+| Flag | Type | Required | Description |
+| --- | --- | --- | --- |
+| `--api <api>` | string | yes | API name (e.g. zeldaEasy.broadscope-bailian.memory-library.getLibraries) |
+| `--data <json>` | string | yes | Request data as JSON string |
+| `--region <region>` | string | no | API region (default: cn-beijing) |
+
+#### Examples
+
+```bash
+bl console call --api zeldaEasy.broadscope-bailian.freeTrial.queryFreeTierQuota --data '{"queryFreeTierQuotaRequest":{"models":["qwen3-max"]}}'
+```
+
+```bash
+bl console call --api some.api.name --data '{"key":"value"}' --region cn-beijing
+```

package/skill/reference/file.md

@@ -0,0 +1,48 @@
+# `bl file` commands
+
+> Auto-generated from `packages/cli/src/commands/catalog.ts`. Do not edit by hand.
+> Regenerate: `pnpm --filter bailian-cli run generate:reference` (runs automatically on `build`).
+
+Index: [index.md](index.md)
+
+## Commands in this group
+
+| Command | Description |
+| --- | --- |
+| `bl file upload` | Upload a local file to DashScope temporary storage (48h) |
+
+## Command details
+
+### `bl file upload`
+
+| Field | Value |
+| --- | --- |
+| **Name** | `file upload` |
+| **Description** | Upload a local file to DashScope temporary storage (48h) |
+| **Usage** | `bl file upload --file <path> --model <model>` |
+| **API docs** | [/developer-reference/get-temporary-file-url](https://help.aliyun.com/zh/model-studio/developer-reference/get-temporary-file-url) |
+
+#### Options
+
+| Flag | Type | Required | Description |
+| --- | --- | --- | --- |
+| `--file <path>` | string | yes | Local file to upload (image, video, audio) |
+| `--model <model>` | string | yes | Target model name (file is bound to this model) |
+
+#### Examples
+
+```bash
+bl file upload --file photo.jpg --model qwen-vl-max
+```
+
+```bash
+bl file upload --file video.mp4 --model wan2.1-t2v-plus
+```
+
+```bash
+bl file upload --file audio.wav --model qwen3-asr-flash
+```
+
+```bash
+bl file upload --file cat.png --model qwen-image-2.0
+```

package/skill/reference/image.md

@@ -0,0 +1,116 @@
+# `bl image` commands
+
+> Auto-generated from `packages/cli/src/commands/catalog.ts`. Do not edit by hand.
+> Regenerate: `pnpm --filter bailian-cli run generate:reference` (runs automatically on `build`).
+
+Index: [index.md](index.md)
+
+## Commands in this group
+
+| Command | Description |
+| --- | --- |
+| `bl image edit` | Edit an existing image with text instructions (Qwen-Image) |
+| `bl image generate` | Generate images (Qwen-Image / wan2.x) |
+
+## Command details
+
+### `bl image edit`
+
+| Field | Value |
+| --- | --- |
+| **Name** | `image edit` |
+| **Description** | Edit an existing image with text instructions (Qwen-Image) |
+| **Usage** | `bl image edit --image <url> --prompt <text> [flags]` |
+| **API docs** | [/developer-reference/qwen-image-edit-api](https://help.aliyun.com/zh/model-studio/developer-reference/qwen-image-edit-api) |
+
+#### Options
+
+| Flag | Type | Required | Description |
+| --- | --- | --- | --- |
+| `--image <url>` | array | yes | Source image URL or local file path (repeatable for multi-image merge) |
+| `--prompt <text>` | string | yes | Edit instruction text |
+| `--model <model>` | string | no | Model ID (default: qwen-image-2.0) |
+| `--size <W*H>` | string | no | Output image size: ratio (3:4, 16:9) or pixels (2048*2048) |
+| `--n <count>` | number | no | Number of images (default: 1, max: 6) |
+| `--seed <n>` | number | no | Random seed for reproducible results |
+| `--negative-prompt <text>` | string | no | Negative prompt to exclude unwanted content |
+| `--prompt-extend` | boolean | no | Enable prompt smart rewrite (default: true) |
+| `--no-prompt-extend` | boolean | no | Disable prompt extend |
+| `--watermark` | boolean | no | Add watermark to output images |
+| `--out-dir <dir>` | string | no | Download images to directory |
+| `--out-prefix <prefix>` | string | no | Filename prefix (default: edited) |
+
+#### Examples
+
+```bash
+bl image edit --image ./photo.png --prompt "把背景换成海滩"
+```
+
+```bash
+bl image edit --image https://example.com/logo.png --prompt "Change color to blue" --n 3
+```
+
+```bash
+bl image edit --image ./a.png --image ./b.png --prompt "把两张图合并成一张拼图"
+```
+
+```bash
+bl image edit --image https://example.com/photo.png --prompt "Remove the person" --model qwen-image-2.0-pro
+```
+
+### `bl image generate`
+
+| Field | Value |
+| --- | --- |
+| **Name** | `image generate` |
+| **Description** | Generate images (Qwen-Image / wan2.x) |
+| **Usage** | `bl image generate --prompt <text> [flags]` |
+| **API docs** | [/best-practice/wanx/text-to-image](https://help.aliyun.com/zh/model-studio/best-practice/wanx/text-to-image) |
+
+#### Options
+
+| Flag | Type | Required | Description |
+| --- | --- | --- | --- |
+| `--prompt <text>` | string | yes | Image description |
+| `--model <model>` | string | no | Model ID (default: qwen-image-2.0) |
+| `--size <W*H>` | string | no | Image size: ratio (3:4, 16:9, 1:1) or pixels (2048*2048) |
+| `--n <count>` | number | no | Number of images per request (default: 1, max: 6) |
+| `--seed <n>` | number | no | Random seed for reproducible generation |
+| `--negative-prompt <text>` | string | no | Negative prompt to exclude unwanted content |
+| `--prompt-extend` | boolean | no | Automatically extend prompt for better results (default: true for qwen-image) |
+| `--no-prompt-extend` | boolean | no | Disable prompt extend |
+| `--watermark` | boolean | no | Add watermark to generated images |
+| `--no-wait` | boolean | no | Return task ID immediately without waiting (async models only) |
+| `--out-dir <dir>` | string | no | Download images to directory |
+| `--out-prefix <prefix>` | string | no | Filename prefix (default: image) |
+| `--poll-interval <seconds>` | number | no | Polling interval when waiting (default: 3) |
+
+#### Examples
+
+```bash
+bl image generate --prompt "一只穿太空服的猫在火星上"
+```
+
+```bash
+bl image generate --prompt "Logo design" --n 3 --out-dir ./generated/
+```
+
+```bash
+bl image generate --prompt "Mountain landscape" --size 2688*1536
+```
+
+```bash
+bl image generate --prompt "A castle" --seed 42 --no-prompt-extend
+```
+
+```bash
+bl image generate --prompt "sunset" --model wan2.6-t2i --no-wait --quiet
+```
+
+```bash
+bl image generate --prompt "Pro quality" --model qwen-image-2.0-pro
+```
+
+```bash
+bl image generate --prompt "Product shots" --n 2 --concurrent 3  # 6 images in parallel
+```

package/skill/reference/index.md

@@ -0,0 +1,95 @@
+# bailian-cli (`bl`) command reference
+
+> Auto-generated from `packages/cli/src/commands/catalog.ts`. Do not edit by hand.
+> Regenerate: `pnpm --filter bailian-cli run generate:reference` (runs automatically on `build`).
+
+Command **details** are in sibling `<group>.md` files in this directory.
+Use this index for the full quick index and global flags.
+
+## Quick index
+
+| Command | Description | Detail |
+| --- | --- | --- |
+| `bl app call` | Call a Bailian application (agent or workflow) | [app.md](app.md) |
+| `bl app list` | List Bailian applications | [app.md](app.md) |
+| `bl auth login` | Authenticate with API key | [auth.md](auth.md) |
+| `bl auth logout` | Clear stored credentials | [auth.md](auth.md) |
+| `bl auth status` | Show current authentication state | [auth.md](auth.md) |
+| `bl config export-schema` | Export all (or one) CLI command(s) as Anthropic/OpenAI-compatible JSON tool schemas | [config.md](config.md) |
+| `bl config set` | Set a config value | [config.md](config.md) |
+| `bl config show` | Display current configuration | [config.md](config.md) |
+| `bl console call` | Call a Bailian console API via the CLI gateway | [console.md](console.md) |
+| `bl file upload` | Upload a local file to DashScope temporary storage (48h) | [file.md](file.md) |
+| `bl image edit` | Edit an existing image with text instructions (Qwen-Image) | [image.md](image.md) |
+| `bl image generate` | Generate images (Qwen-Image / wan2.x) | [image.md](image.md) |
+| `bl knowledge retrieve` | Retrieve from a Bailian knowledge base (requires AK/SK) | [knowledge.md](knowledge.md) |
+| `bl memory add` | Add memory from messages or custom content | [memory.md](memory.md) |
+| `bl memory delete` | Delete a memory node | [memory.md](memory.md) |
+| `bl memory list` | List memory nodes for a user | [memory.md](memory.md) |
+| `bl memory profile create` | Create a user profile schema for memory profiling | [memory.md](memory.md) |
+| `bl memory profile get` | Get user profile by schema ID and user ID | [memory.md](memory.md) |
+| `bl memory search` | Search memory nodes by query or messages | [memory.md](memory.md) |
+| `bl memory update` | Update a memory node content | [memory.md](memory.md) |
+| `bl model list` | List available foundation models | [model.md](model.md) |
+| `bl omni` | Multimodal chat with text + audio output (Qwen-Omni) | [omni.md](omni.md) |
+| `bl search web` | Search the web using DashScope MCP WebSearch service | [search.md](search.md) |
+| `bl speech recognize` | Recognize speech from audio files (FunAudio-ASR) | [speech.md](speech.md) |
+| `bl speech synthesize` | Synthesize speech from text (CosyVoice TTS) | [speech.md](speech.md) |
+| `bl text chat` | Send a chat completion (OpenAI compatible, DashScope) | [text.md](text.md) |
+| `bl update` | Update bl to the latest version | [update.md](update.md) |
+| `bl usage free` | Query free-tier quota for a model | [usage.md](usage.md) |
+| `bl video download` | Download a completed video by task ID | [video.md](video.md) |
+| `bl video edit` | Edit a video with happyhorse-1.0-video-edit (style transfer, object replacement, etc.) | [video.md](video.md) |
+| `bl video generate` | Generate a video from text or image (happyhorse-1.0-t2v / happyhorse-1.0-i2v / wan2.6-t2v) | [video.md](video.md) |
+| `bl video ref` | Reference-to-video generation (happyhorse-1.0-r2v / wan2.6-r2v): multi-subject, multi-shot with voice | [video.md](video.md) |
+| `bl video task get` | Query async task status | [video.md](video.md) |
+| `bl vision describe` | Describe an image or video using Qwen-VL | [vision.md](vision.md) |
+
+## By group
+
+| Group | Commands | Reference |
+| --- | --- | --- |
+| `app` | `call`, `list` | [app.md](app.md) |
+| `auth` | `login`, `logout`, `status` | [auth.md](auth.md) |
+| `config` | `export-schema`, `set`, `show` | [config.md](config.md) |
+| `console` | `call` | [console.md](console.md) |
+| `file` | `upload` | [file.md](file.md) |
+| `image` | `edit`, `generate` | [image.md](image.md) |
+| `knowledge` | `retrieve` | [knowledge.md](knowledge.md) |
+| `memory` | `add`, `delete`, `list`, `profile create`, `profile get`, `search`, `update` | [memory.md](memory.md) |
+| `model` | `list` | [model.md](model.md) |
+| `omni` | `(root)` | [omni.md](omni.md) |
+| `search` | `web` | [search.md](search.md) |
+| `speech` | `recognize`, `synthesize` | [speech.md](speech.md) |
+| `text` | `chat` | [text.md](text.md) |
+| `update` | `(root)` | [update.md](update.md) |
+| `usage` | `free` | [usage.md](usage.md) |
+| `video` | `download`, `edit`, `generate`, `ref`, `task get` | [video.md](video.md) |
+| `vision` | `describe` | [vision.md](vision.md) |
+
+## Global flags
+
+Available on every command (in addition to command-specific options):
+
+| Flag | Type | Required | Description |
+| --- | --- | --- | --- |
+| `--api-key <key>` | string | no | API key |
+| `--region <region>` | string | no | API region: cn (default), us, intl |
+| `--base-url <url>` | string | no | API base URL |
+| `--output <format>` | string | no | Output format: text, json, yaml |
+| `--timeout <seconds>` | number | no | Request timeout |
+| `--quiet` | boolean | no | Suppress non-essential output |
+| `--verbose` | boolean | no | Print HTTP request/response details |
+| `--no-color` | boolean | no | Disable ANSI colors |
+| `--dry-run` | boolean | no | Dry run mode |
+| `--non-interactive` | boolean | no | Disable interactive prompts |
+| `--concurrent <n>` | number | no | Run N parallel requests (default: 1) |
+| `--help` | boolean | no | Show help |
+| `--version` | boolean | no | Print version |
+
+
+## Notes
+
+- Console commands (`app list`, `model list`, `usage free`, `console call`) require `bl auth login --console`.
+- Most API commands use `DASHSCOPE_API_KEY` or `bl auth login --api-key`.
+- Default output: **text** in TTY; **json** when piped. Console list commands default to **yaml** unless `--output` is set.

package/skill/reference/knowledge.md

@@ -0,0 +1,45 @@
+# `bl knowledge` commands
+
+> Auto-generated from `packages/cli/src/commands/catalog.ts`. Do not edit by hand.
+> Regenerate: `pnpm --filter bailian-cli run generate:reference` (runs automatically on `build`).
+
+Index: [index.md](index.md)
+
+## Commands in this group
+
+| Command | Description |
+| --- | --- |
+| `bl knowledge retrieve` | Retrieve from a Bailian knowledge base (requires AK/SK) |
+
+## Command details
+
+### `bl knowledge retrieve`
+
+| Field | Value |
+| --- | --- |
+| **Name** | `knowledge retrieve` |
+| **Description** | Retrieve from a Bailian knowledge base (requires AK/SK) |
+| **Usage** | `bl knowledge retrieve --index-id <id> --query <text> [flags]` |
+
+#### Options
+
+| Flag | Type | Required | Description |
+| --- | --- | --- | --- |
+| `--index-id <id>` | string | yes | Knowledge base index ID (required) |
+| `--query <text>` | string | yes | Search query (required) |
+| `--workspace-id <id>` | string | no | Bailian workspace ID (or env BAILIAN_WORKSPACE_ID) |
+| `--top-k <n>` | number | no | Number of results (default: 10) |
+| `--rerank` | boolean | no | Enable rerank |
+| `--rerank-top-n <n>` | number | no | Rerank top N results |
+| `--access-key-id <key>` | string | no | Alibaba Cloud Access Key ID (or env) |
+| `--access-key-secret <key>` | string | no | Alibaba Cloud Access Key Secret (or env) |
+
+#### Examples
+
+```bash
+bl knowledge retrieve --index-id idx_xxx --query "如何使用阿里云百炼" --workspace-id ws_xxx
+```
+
+```bash
+bl knowledge retrieve --index-id idx_xxx --query "API限流" --top-k 5 --rerank
+```