From fc25506601456ec2b350e4edf853e0e3a5b6f25b Mon Sep 17 00:00:00 2001 From: "lisheng.lisheng" Date: Fri, 13 Nov 2026 12:01:39 +0800 Subject: [PATCH 1/2] feat(flow-agent): add flow-agent command group, deprecate app call/list Register bl flow-agent (13 commands) as the canonical application group; keep only app call/list as deprecated wrappers pointing at flow-agent. Product-layer deprecation (description prefix + note + stderr warning), no commandAliases. Migrate e2e to flow-agent, add product-level deprecation tests, sync skill reference/routing/READMEs (cli copies byte-identical), amend 2.9.0 CHANGELOG. --- CHANGELOG.md | 14 +- CHANGELOG.zh.md | 14 +- README.md | 2 +- packages/cli/README.md | 2 +- packages/cli/src/commands.ts | 30 +- packages/cli/src/deprecated.ts | 39 ++ .../e2e/flow-agent-deprecation.e2e.test.ts | 87 +++ .../cli/tests/e2e/registry.smoke.e2e.test.ts | 8 +- .../tests/e2e/app-control.e2e.test.ts | 235 +++++--- packages/commands/tests/e2e/topic-routes.ts | 28 +- skills/bailian-cli/SKILL.md | 32 +- skills/bailian-cli/reference/app.md | 479 +-------------- skills/bailian-cli/reference/flow-agent.md | 550 ++++++++++++++++++ skills/bailian-cli/reference/index.md | 253 ++++---- skills/bailian-gen/SKILL.md | 2 +- skills/bailian-managed-agent/SKILL.md | 4 +- skills/bailian-protocol/SKILL.md | 2 +- skills/bailian-protocol/assets/setup.md | 2 +- tools/generate-reference.ts | 2 + 19 files changed, 1063 insertions(+), 722 deletions(-) create mode 100644 packages/cli/src/deprecated.ts create mode 100644 packages/cli/tests/e2e/flow-agent-deprecation.e2e.test.ts create mode 100644 skills/bailian-cli/reference/flow-agent.md diff --git a/CHANGELOG.md b/CHANGELOG.md index 0756fdee..807d53e9 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -6,20 +6,24 @@ The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and [中文版](CHANGELOG.zh.md) · [README](README.md) · [Contributing](CONTRIBUTING.md) -## [2.9.0] - 2026-11-12 +## [2.9.0] - 2026-11-13 ### Added -- **App control-plane commands**: Manage Bailian applications from the CLI via the console gateway. - - `bl app create` / `get` / `update` / `publish` / `delete` / `copy` / `versions` for agents (app-control 2.0) and workflows; `delete` is high-risk and requires `--yes`. - - `bl app workflow get` / `save` / `publish` / `export` for workflow canvases; `save` replaces the whole draft with optimistic-lock versioning, `publish` normalizes triggers like the console editor. +- **Flow-agent command group**: New `bl flow-agent` group for managing Bailian applications via the console gateway. + - `bl flow-agent create` / `get` / `update` / `publish` / `delete` / `copy` / `versions` for agents (app-control 2.0) and workflows; `delete` is high-risk and requires `--yes`. + - `bl flow-agent workflow get` / `save` / `publish` / `export` for workflow canvases; `save` replaces the whole draft with optimistic-lock versioning, `publish` normalizes triggers like the console editor. - Agent config updates read the current draft and merge `--model` / `--instructions` / `--config-json` / `--config-file`. -- **App list filtering**: `bl app list --type workflow` lists workflows using the console exclusion filter. + - `bl flow-agent list --type workflow` lists workflows using the console exclusion filter. ### Changed - **Omni default model**: `bl omni` now defaults to `qwen3.8-omni-flash` (was `qwen3.5-omni-plus`). +### Deprecated + +- **App group**: `bl app call` / `bl app list` are deprecated in favor of `bl flow-agent call` / `bl flow-agent list` and will be removed in a future release. The application control-plane commands now live only under `bl flow-agent`. + ### Fixed - **Free-tier model operations**: Tighten confirmation gating and error handling; recovery stays behind the confirmation gate. diff --git a/CHANGELOG.zh.md b/CHANGELOG.zh.md index 08c6629f..a753c22b 100644 --- a/CHANGELOG.zh.md +++ b/CHANGELOG.zh.md @@ -6,20 +6,24 @@ [English](CHANGELOG.md) · [README](README.zh.md) · [参与贡献](CONTRIBUTING.zh.md) -## [2.9.0] - 2026-11-12 +## [2.9.0] - 2026-11-13 ### 新增 -- **应用控制面命令**:通过控制台网关在命令行管理百炼应用。 - - `bl app create` / `get` / `update` / `publish` / `delete` / `copy` / `versions`:管理智能体(app-control 2.0)与工作流;`delete` 为高风险操作,需 `--yes`。 - - `bl app workflow get` / `save` / `publish` / `export`:管理工作流画布;`save` 整幅替换草稿并带乐观锁版本,`publish` 按控制台编辑器逻辑规范化触发器。 +- **flow-agent 命令组**:新增 `bl flow-agent` 组,通过控制台网关管理百炼应用。 + - `bl flow-agent create` / `get` / `update` / `publish` / `delete` / `copy` / `versions`:管理智能体(app-control 2.0)与工作流;`delete` 为高风险操作,需 `--yes`。 + - `bl flow-agent workflow get` / `save` / `publish` / `export`:管理工作流画布;`save` 整幅替换草稿并带乐观锁版本,`publish` 按控制台编辑器逻辑规范化触发器。 - 智能体配置更新先读取当前草稿,再合并 `--model` / `--instructions` / `--config-json` / `--config-file`。 -- **应用列表筛选**:`bl app list --type workflow` 按控制台排除法列出工作流。 + - `bl flow-agent list --type workflow` 按控制台排除法列出工作流。 ### 变更 - **Omni 默认模型**:`bl omni` 默认模型改为 `qwen3.8-omni-flash`(原 `qwen3.5-omni-plus`)。 +### 已弃用 + +- **app 组**:`bl app call` / `bl app list` 已废弃,请改用 `bl flow-agent call` / `bl flow-agent list`,将在未来版本移除。应用控制面命令现仅位于 `bl flow-agent` 下。 + ### 修复 - **免费额度模型操作**:收紧确认闸门与错误处理;恢复操作保持在确认闸门之后。 diff --git a/README.md b/README.md index 74935b78..f6f7beaa 100644 --- a/README.md +++ b/README.md @@ -192,7 +192,7 @@ Synchronous Batch Chat is non-streaming; explicit realtime/international/Token P ### Console Login (OAuth, Recommended) -Required for console capability commands (model list, app list, MCP list, workspace, usage queries, rate-limit increases, direct console calls). It can create an ordinary API key when needed. Token Plan and other subscription plans cannot use `--console`; use the API Key login below. +Required for console capability commands (model list, flow-agent list, MCP list, workspace, usage queries, rate-limit increases, direct console calls). It can create an ordinary API key when needed. Token Plan and other subscription plans cannot use `--console`; use the API Key login below. ```bash bl auth login --console diff --git a/packages/cli/README.md b/packages/cli/README.md index 74935b78..f6f7beaa 100644 --- a/packages/cli/README.md +++ b/packages/cli/README.md @@ -192,7 +192,7 @@ Synchronous Batch Chat is non-streaming; explicit realtime/international/Token P ### Console Login (OAuth, Recommended) -Required for console capability commands (model list, app list, MCP list, workspace, usage queries, rate-limit increases, direct console calls). It can create an ordinary API key when needed. Token Plan and other subscription plans cannot use `--console`; use the API Key login below. +Required for console capability commands (model list, flow-agent list, MCP list, workspace, usage queries, rate-limit increases, direct console calls). It can create an ordinary API key when needed. Token Plan and other subscription plans cannot use `--console`; use the API Key login below. ```bash bl auth login --console diff --git a/packages/cli/src/commands.ts b/packages/cli/src/commands.ts index 4873802f..717f45a8 100644 --- a/packages/cli/src/commands.ts +++ b/packages/cli/src/commands.ts @@ -1,4 +1,5 @@ import type { AnyCommand } from "bailian-cli-core"; +import { deprecatedCommand } from "./deprecated.ts"; import { authLogin, authStatus, @@ -387,19 +388,22 @@ export const commands: Record = { "config ui": configUi, "config agent": configAgent, update, - "app call": appCall, - "app list": appList, - "app create": appCreate, - "app get": appGet, - "app update": appUpdate, - "app publish": appPublish, - "app delete": appDelete, - "app copy": appCopy, - "app versions": appVersions, - "app workflow get": appWorkflowGet, - "app workflow save": appWorkflowSave, - "app workflow publish": appWorkflowPublish, - "app workflow export": appWorkflowExport, + // Deprecated app group: only call/list remain, pointing at the flow-agent group. + "app call": deprecatedCommand(appCall, "flow-agent call"), + "app list": deprecatedCommand(appList, "flow-agent list"), + "flow-agent call": appCall, + "flow-agent list": appList, + "flow-agent create": appCreate, + "flow-agent get": appGet, + "flow-agent update": appUpdate, + "flow-agent publish": appPublish, + "flow-agent delete": appDelete, + "flow-agent copy": appCopy, + "flow-agent versions": appVersions, + "flow-agent workflow get": appWorkflowGet, + "flow-agent workflow save": appWorkflowSave, + "flow-agent workflow publish": appWorkflowPublish, + "flow-agent workflow export": appWorkflowExport, "memory add": memoryAdd, "memory search": memorySearch, "memory list": memoryList, diff --git a/packages/cli/src/deprecated.ts b/packages/cli/src/deprecated.ts new file mode 100644 index 00000000..43059e39 --- /dev/null +++ b/packages/cli/src/deprecated.ts @@ -0,0 +1,39 @@ +import type { AnyCommand, LocalizedText } from "bailian-cli-core"; + +/** + * Wrap a command as a deprecated alias of its replacement product path. + * + * The wrapper keeps the original auth/risk/flags/prepare/validate intact (via + * spread) and only adds user-facing deprecation signals: a `[Deprecated]` + * description prefix, a leading note pointing at the replacement, and a stderr + * warning emitted on invocation. `--help` is rendered by the runtime before + * `run`, so it shows the note without emitting the warning. + * + * This lives in the product layer: the command library stays path-agnostic and + * the runtime gains no deprecation concept. + */ +export function deprecatedCommand(command: AnyCommand, replacementPath: string): AnyCommand { + const note: LocalizedText = { + "en-US": `Deprecated: use \`bl ${replacementPath}\` instead. This command will be removed in a future release.`, + "zh-CN": `已废弃:请改用 \`bl ${replacementPath}\`。该命令将在未来版本移除。`, + }; + const prefix = (text: LocalizedText): LocalizedText => + typeof text === "string" + ? `[Deprecated] ${text}` + : { + "en-US": `[Deprecated] ${text["en-US"]}`, + "zh-CN": `[已废弃] ${text["zh-CN"]}`, + }; + return { + ...command, + description: prefix(command.description), + notes: [note, ...(command.notes ?? [])], + async run(ctx) { + ctx.output.info({ + "en-US": `Warning: this command is deprecated; use \`bl ${replacementPath}\` instead.`, + "zh-CN": `警告:该命令已废弃,请改用 \`bl ${replacementPath}\`。`, + }); + return command.run(ctx); + }, + }; +} diff --git a/packages/cli/tests/e2e/flow-agent-deprecation.e2e.test.ts b/packages/cli/tests/e2e/flow-agent-deprecation.e2e.test.ts new file mode 100644 index 00000000..86b9fb71 --- /dev/null +++ b/packages/cli/tests/e2e/flow-agent-deprecation.e2e.test.ts @@ -0,0 +1,87 @@ +import { mkdtempSync, rmSync } from "fs"; +import { tmpdir } from "os"; +import { join } from "path"; +import { afterAll, describe, expect, test } from "vite-plus/test"; +import { captureRegistryHelp } from "e2e/registry-smoke"; +import { CommandRegistry } from "bailian-cli-runtime"; +import { commands } from "../../src/commands.ts"; +import { parseStdoutJson, runCli } from "./helpers.ts"; + +// Product-level: the real bl command map carries the deprecation wrappers +// (packages/cli/src/commands.ts), unlike the commands-library harness. +const registry = new CommandRegistry(commands, "bl"); +const isolatedConfigDir = mkdtempSync(join(tmpdir(), "bl-flow-agent-deprecation-")); + +afterAll(() => rmSync(isolatedConfigDir, { recursive: true, force: true })); + +function runCliIsolated(args: string[]) { + return runCli(args, { + BAILIAN_CONFIG_DIR: isolatedConfigDir, + DASHSCOPE_QUIET: "0", + DO_NOT_TRACK: "1", + NO_UPDATE_NOTIFIER: "1", + }); +} + +describe("e2e: flow-agent group + app deprecation", () => { + test("flow-agent registers all 13 commands; app keeps only call/list", () => { + const flowAgentPaths = Object.keys(commands) + .filter((path) => path.startsWith("flow-agent ")) + .sort(); + expect(flowAgentPaths).toEqual([ + "flow-agent call", + "flow-agent copy", + "flow-agent create", + "flow-agent delete", + "flow-agent get", + "flow-agent list", + "flow-agent publish", + "flow-agent update", + "flow-agent versions", + "flow-agent workflow export", + "flow-agent workflow get", + "flow-agent workflow publish", + "flow-agent workflow save", + ]); + const appPaths = Object.keys(commands) + .filter((path) => path.startsWith("app ")) + .sort(); + expect(appPaths).toEqual(["app call", "app list"]); + }); + + test("app call help is deprecated and points to flow-agent call", () => { + const help = captureRegistryHelp(registry, ["app", "call"]); + expect(help).toContain("[Deprecated]"); + expect(help).toContain("flow-agent call"); + }); + + test("app list help is deprecated and points to flow-agent list", () => { + const help = captureRegistryHelp(registry, ["app", "list"]); + expect(help).toContain("[Deprecated]"); + expect(help).toContain("flow-agent list"); + }); + + test("flow-agent list help is not deprecated", () => { + const help = captureRegistryHelp(registry, ["flow-agent", "list"]); + expect(help).not.toContain("[Deprecated]"); + }); + + test("removed app control-plane path is rejected (exit 2)", async () => { + const result = await runCliIsolated(["app", "create", "--name", "x", "--output", "json"]); + expect(result.exitCode, result.stderr).toBe(2); + }); + + test("app list --dry-run warns on stderr in text mode", async () => { + const result = await runCliIsolated(["app", "list", "--dry-run", "--output", "text"]); + expect(result.exitCode, result.stderr).toBe(0); + expect(result.stderr).toMatch(/deprecated/i); + expect(result.stderr).toContain("flow-agent list"); + }); + + test("app list --dry-run keeps stdout JSON clean in json mode", async () => { + const result = await runCliIsolated(["app", "list", "--dry-run", "--output", "json"]); + expect(result.exitCode, result.stderr).toBe(0); + const data = parseStdoutJson<{ api: string }>(result.stdout); + expect(data.api).toBe("zeldaEasy.broadscope-bailian.app-control.list"); + }); +}); diff --git a/packages/cli/tests/e2e/registry.smoke.e2e.test.ts b/packages/cli/tests/e2e/registry.smoke.e2e.test.ts index aa297ac0..f875bed7 100644 --- a/packages/cli/tests/e2e/registry.smoke.e2e.test.ts +++ b/packages/cli/tests/e2e/registry.smoke.e2e.test.ts @@ -62,8 +62,8 @@ describe("e2e: bl registry smoke", () => { expect(exitCode, stderr).toBe(0); expect(stderr).toMatch(/\bbl\b/i); expect(stderr).not.toMatch(/COMMAND\s+AUTH\s+DESCRIPTION/); - expect(stderr).toMatch(/app call\s+\[API Key\]\s+Call a Bailian application/); - expect(stderr).toMatch(/app list\s+\[Console\]\s+List Bailian applications/); + expect(stderr).toMatch(/app call\s+\[API Key\]\s+\[Deprecated\] Call a Bailian application/); + expect(stderr).toMatch(/app list\s+\[Console\]\s+\[Deprecated\] List Bailian applications/); expect(stderr).toMatch(/token-plan create-key\s+\[AK\/SK\]\s+Create a Token Plan API key/); expect(stderr).toMatch(/config show\s+\[No Auth\]\s+Display current configuration/); expect(stderr).toMatch(/--base-url/); @@ -76,8 +76,8 @@ describe("e2e: bl registry smoke", () => { test("分组帮助按叶子命令展示不同鉴权域", async () => { const { stderr, exitCode } = await runCliSmoke(["app", "--help"]); expect(exitCode, stderr).toBe(0); - expect(stderr).toMatch(/app call\s+\[API Key\]\s+Call a Bailian application/); - expect(stderr).toMatch(/app list\s+\[Console\]\s+List Bailian applications/); + expect(stderr).toMatch(/app call\s+\[API Key\]\s+\[Deprecated\] Call a Bailian application/); + expect(stderr).toMatch(/app list\s+\[Console\]\s+\[Deprecated\] List Bailian applications/); }); test.each([ diff --git a/packages/commands/tests/e2e/app-control.e2e.test.ts b/packages/commands/tests/e2e/app-control.e2e.test.ts index f3f16180..30d5545a 100644 --- a/packages/commands/tests/e2e/app-control.e2e.test.ts +++ b/packages/commands/tests/e2e/app-control.e2e.test.ts @@ -11,7 +11,7 @@ import { runCommandInProcess, runConsoleCommandE2e, } from "./helpers.ts"; -import { APP_CONTROL_ROUTES } from "./topic-routes.ts"; +import { APP_CONTROL_ROUTES, FLOW_AGENT_ROUTES } from "./topic-routes.ts"; import { APP_CONTROL_CREATE_API, APP_CONTROL_DELETE_API, @@ -85,7 +85,7 @@ function writeConfig(configDir: string, body: Record): void { // Offline contracts: help, validation, static dry-run (zero requests), risk gate // --------------------------------------------------------------------------- -describe("e2e: app control offline contracts", () => { +describe("e2e: flow-agent offline contracts", () => { let isolated: ReturnType; beforeEach(() => { @@ -105,31 +105,31 @@ describe("e2e: app control offline contracts", () => { }); function offline(args: string[]) { - return runCommandInProcess(APP_CONTROL_ROUTES, args, { + return runCommandInProcess(FLOW_AGENT_ROUTES, args, { ...isolated.env, ...offlineEnvironment, }); } const leaves = [ - { path: "app create", flags: ["--name", "--type", "--config-json", "--config-file"] }, - { path: "app get", flags: ["--app-id", "--type", "--scope", "--agent-version"] }, - { path: "app update", flags: ["--app-id", "--name", "--model", "--instructions"] }, - { path: "app publish", flags: ["--app-id", "--description"] }, - { path: "app delete", flags: ["--app-id", "--yes"] }, - { path: "app copy", flags: ["--app-id"] }, - { path: "app versions", flags: ["--app-id", "--type"] }, - { path: "app workflow get", flags: ["--app-id", "--flow-version", "--output-file"] }, + { path: "flow-agent create", flags: ["--name", "--type", "--config-json", "--config-file"] }, + { path: "flow-agent get", flags: ["--app-id", "--type", "--scope", "--agent-version"] }, + { path: "flow-agent update", flags: ["--app-id", "--name", "--model", "--instructions"] }, + { path: "flow-agent publish", flags: ["--app-id", "--description"] }, + { path: "flow-agent delete", flags: ["--app-id", "--yes"] }, + { path: "flow-agent copy", flags: ["--app-id"] }, + { path: "flow-agent versions", flags: ["--app-id", "--type"] }, + { path: "flow-agent workflow get", flags: ["--app-id", "--flow-version", "--output-file"] }, { - path: "app workflow save", + path: "flow-agent workflow save", flags: ["--app-id", "--config-json", "--config-file", "--flow-version"], }, - { path: "app workflow publish", flags: ["--app-id", "--description", "--trigger-list"] }, - { path: "app workflow export", flags: ["--app-id", "--flow-version", "--output-file"] }, + { path: "flow-agent workflow publish", flags: ["--app-id", "--description", "--trigger-list"] }, + { path: "flow-agent workflow export", flags: ["--app-id", "--flow-version", "--output-file"] }, ]; test.each(leaves)("$path help exposes Console scope flags", async (leaf) => { - const result = await runCommandHelp(APP_CONTROL_ROUTES, [...leaf.path.split(" "), "--help"]); + const result = await runCommandHelp(FLOW_AGENT_ROUTES, [...leaf.path.split(" "), "--help"]); expect(result.exitCode, result.stderr).toBe(0); expect(result.stderr).toContain(`bl ${leaf.path}`); for (const flag of [ @@ -144,17 +144,17 @@ describe("e2e: app control offline contracts", () => { }); const missingRequired = [ - { path: "app create", args: [] as string[] }, - { path: "app get", args: [] }, - { path: "app update", args: [] }, - { path: "app publish", args: [] }, - { path: "app delete", args: [] }, - { path: "app copy", args: [] }, - { path: "app versions", args: [] }, - { path: "app workflow get", args: [] }, - { path: "app workflow save", args: [] }, - { path: "app workflow publish", args: [] }, - { path: "app workflow export", args: [] }, + { path: "flow-agent create", args: [] as string[] }, + { path: "flow-agent get", args: [] }, + { path: "flow-agent update", args: [] }, + { path: "flow-agent publish", args: [] }, + { path: "flow-agent delete", args: [] }, + { path: "flow-agent copy", args: [] }, + { path: "flow-agent versions", args: [] }, + { path: "flow-agent workflow get", args: [] }, + { path: "flow-agent workflow save", args: [] }, + { path: "flow-agent workflow publish", args: [] }, + { path: "flow-agent workflow export", args: [] }, ]; test.each(missingRequired)("$path without required flags exits 2", async (scenario) => { @@ -167,9 +167,9 @@ describe("e2e: app control offline contracts", () => { expect(result.exitCode, result.stderr).toBe(2); }); - test("app create rejects invalid --config-json JSON", async () => { + test("flow-agent create rejects invalid --config-json JSON", async () => { const result = await offline([ - "app", + "flow-agent", "create", "--name", "x", @@ -183,9 +183,9 @@ describe("e2e: app control offline contracts", () => { expect(JSON.parse(result.stderr).error.message).toMatch(/valid JSON/i); }); - test("app create rejects --config-json together with --config-file", async () => { + test("flow-agent create rejects --config-json together with --config-file", async () => { const result = await offline([ - "app", + "flow-agent", "create", "--name", "x", @@ -201,9 +201,9 @@ describe("e2e: app control offline contracts", () => { expect(JSON.parse(result.stderr).error.message).toMatch(/mutually exclusive/i); }); - test("app create workflow rejects --model", async () => { + test("flow-agent create workflow rejects --model", async () => { const result = await offline([ - "app", + "flow-agent", "create", "--name", "x", @@ -219,9 +219,9 @@ describe("e2e: app control offline contracts", () => { expect(JSON.parse(result.stderr).error.message).toMatch(/workflow save/i); }); - test("app update requires at least one changed field", async () => { + test("flow-agent update requires at least one changed field", async () => { const result = await offline([ - "app", + "flow-agent", "update", "--app-id", "abc", @@ -233,9 +233,9 @@ describe("e2e: app control offline contracts", () => { expect(JSON.parse(result.stderr).error.message).toMatch(/at least one/i); }); - test("app get workflow rejects --agent-version", async () => { + test("flow-agent get workflow rejects --agent-version", async () => { const result = await offline([ - "app", + "flow-agent", "get", "--app-id", "abc", @@ -250,9 +250,9 @@ describe("e2e: app control offline contracts", () => { expect(result.exitCode, result.stderr).toBe(2); }); - test("app workflow save requires --config-json or --config-file", async () => { + test("flow-agent workflow save requires --config-json or --config-file", async () => { const result = await offline([ - "app", + "flow-agent", "workflow", "save", "--app-id", @@ -268,47 +268,47 @@ describe("e2e: app control offline contracts", () => { const staticDryRuns = [ { name: "create agent", - args: ["app", "create", "--name", "Demo"], + args: ["flow-agent", "create", "--name", "Demo"], api: APP_CONTROL_CREATE_API, }, { name: "create workflow", - args: ["app", "create", "--name", "Flow", "--type", "workflow"], + args: ["flow-agent", "create", "--name", "Flow", "--type", "workflow"], api: APP_DATA_CREATE_DRAFT_API, }, { name: "get agent", - args: ["app", "get", "--app-id", "abc"], + args: ["flow-agent", "get", "--app-id", "abc"], api: APP_CONTROL_DETAIL_API, }, { name: "publish agent", - args: ["app", "publish", "--app-id", "abc"], + args: ["flow-agent", "publish", "--app-id", "abc"], api: "zeldaEasy.broadscope-bailian.app-control.publish", }, { name: "delete agent", - args: ["app", "delete", "--app-id", "abc"], + args: ["flow-agent", "delete", "--app-id", "abc"], api: APP_CONTROL_DELETE_API, }, { name: "copy agent", - args: ["app", "copy", "--app-id", "abc"], + args: ["flow-agent", "copy", "--app-id", "abc"], api: "zeldaEasy.broadscope-bailian.app-control.copy", }, { name: "versions agent", - args: ["app", "versions", "--app-id", "abc"], + args: ["flow-agent", "versions", "--app-id", "abc"], api: "zeldaEasy.broadscope-bailian.app-control.getAgentVersionList", }, { name: "workflow get", - args: ["app", "workflow", "get", "--app-id", "abc"], + args: ["flow-agent", "workflow", "get", "--app-id", "abc"], api: FLOW_GET_CONFIG_API, }, { name: "workflow export", - args: ["app", "workflow", "export", "--app-id", "abc"], + args: ["flow-agent", "workflow", "export", "--app-id", "abc"], api: "zeldaEasy.broadscope-bailian.app-orchestra-flow.generateDSLSchema", }, ]; @@ -324,9 +324,9 @@ describe("e2e: app control offline contracts", () => { }, ); - test("app list --type workflow uses exclusion filter", async () => { + test("flow-agent list --type workflow uses exclusion filter", async () => { const result = await offline([ - "app", + "flow-agent", "list", "--type", "workflow", @@ -343,16 +343,16 @@ describe("e2e: app control offline contracts", () => { expect(data.data.reqDTO.type).toBeUndefined(); }); - test("app list default keeps agent filter", async () => { - const result = await offline(["app", "list", "--dry-run", "--output", "json"]); + test("flow-agent list default keeps agent filter", async () => { + const result = await offline(["flow-agent", "list", "--dry-run", "--output", "json"]); expect(result.exitCode, result.stderr).toBe(0); const data = parseStdoutJson<{ data: { reqDTO: Record } }>(result.stdout); expect(data.data.reqDTO.type).toBe(5); expect(data.data.reqDTO.notInTypes).toEqual([10]); }); - test("app delete without --yes requires confirmation (exit 7)", async () => { - const result = await offline(["app", "delete", "--app-id", "abc", "--output", "json"]); + test("flow-agent delete without --yes requires confirmation (exit 7)", async () => { + const result = await offline(["flow-agent", "delete", "--app-id", "abc", "--output", "json"]); expect(result.exitCode, result.stderr).toBe(7); const error = JSON.parse(result.stderr).error; expect(error.type).toBe("requires_confirmation"); @@ -363,7 +363,7 @@ describe("e2e: app control offline contracts", () => { // Mocked console: request payloads, read-modify-write planning, response unwrap // --------------------------------------------------------------------------- -describe("e2e: app control mocked console", () => { +describe("e2e: flow-agent mocked console", () => { let isolated: ReturnType; beforeEach(() => { @@ -380,16 +380,16 @@ describe("e2e: app control mocked console", () => { }); function run(args: string[]) { - return runCommandInProcess(APP_CONTROL_ROUTES, args, { + return runCommandInProcess(FLOW_AGENT_ROUTES, args, { ...isolated.env, ...offlineEnvironment, }); } - test("app create agent sends default config and extracts the app code", async () => { + test("flow-agent create agent sends default config and extracts the app code", async () => { const requests = mockConsole({ [APP_CONTROL_CREATE_API]: { result: "app-new-123" } }); const result = await run([ - "app", + "flow-agent", "create", "--name", "Demo", @@ -411,7 +411,7 @@ describe("e2e: app control mocked console", () => { expect(data.app_code).toBe("app-new-123"); }); - test("app update agent dry-run reads the draft and previews merged config (no write)", async () => { + test("flow-agent update agent dry-run reads the draft and previews merged config (no write)", async () => { const requests = mockConsole({ [APP_CONTROL_DETAIL_API]: { code: "abc", @@ -420,7 +420,7 @@ describe("e2e: app control mocked console", () => { }, }); const result = await run([ - "app", + "flow-agent", "update", "--app-id", "abc", @@ -445,13 +445,13 @@ describe("e2e: app control mocked console", () => { expect(config.dialog_round).toBe(3); }); - test("app update agent merges current config and writes once", async () => { + test("flow-agent update agent merges current config and writes once", async () => { const requests = mockConsole({ [APP_CONTROL_DETAIL_API]: { code: "abc", config: { model: "auto", dialog_round: 5 } }, [APP_CONTROL_UPDATE_API]: { result: true }, }); const result = await run([ - "app", + "flow-agent", "update", "--app-id", "abc", @@ -472,13 +472,13 @@ describe("e2e: app control mocked console", () => { expect(config.model).toBe("auto"); }); - test("app update workflow reads the DTO and writes metadata back", async () => { + test("flow-agent update workflow reads the DTO and writes metadata back", async () => { const requests = mockConsole({ [APP_DATA_GET_API]: { code: "abc", name: "Old", appDescription: "old desc", type: 7 }, [APP_DATA_UPDATE_DRAFT_API]: { result: true }, }); const result = await run([ - "app", + "flow-agent", "update", "--app-id", "abc", @@ -500,12 +500,12 @@ describe("e2e: app control mocked console", () => { expect(reqDTO.type).toBe(7); }); - test("app workflow save dry-run resolves version with a read only", async () => { + test("flow-agent workflow save dry-run resolves version with a read only", async () => { const requests = mockConsole({ [FLOW_GET_CONFIG_API]: { config: '{"nodes":[]}', version: "7" }, }); const result = await run([ - "app", + "flow-agent", "workflow", "save", "--app-id", @@ -524,13 +524,13 @@ describe("e2e: app control mocked console", () => { expect(data.data.config).toBe('{"nodes":[1]}'); }); - test("app workflow save writes the canvas with the resolved version", async () => { + test("flow-agent workflow save writes the canvas with the resolved version", async () => { const requests = mockConsole({ [FLOW_GET_CONFIG_API]: { config: '{"nodes":[]}', version: "7" }, [FLOW_SAVE_API]: { result: true }, }); const result = await run([ - "app", + "flow-agent", "workflow", "save", "--app-id", @@ -546,7 +546,7 @@ describe("e2e: app control mocked console", () => { expect(requests[1]!.Data.appCode).toBe("abc"); }); - test("app workflow publish normalizes triggers from the draft", async () => { + test("flow-agent workflow publish normalizes triggers from the draft", async () => { const draftTriggers = [ { flowName: "keep", uiConfig: '{"type":"webhook"}', parameters: [] }, { flowName: "drop", uiConfig: '{"type":"none"}', parameters: [] }, @@ -560,7 +560,7 @@ describe("e2e: app control mocked console", () => { [FLOW_PUBLISH_API]: { result: true }, }); const result = await run([ - "app", + "flow-agent", "workflow", "publish", "--app-id", @@ -581,9 +581,17 @@ describe("e2e: app control mocked console", () => { expect(triggerList[0]!.uiConfig).toBeUndefined(); }); - test("app delete --yes enters run and calls the delete API", async () => { + test("flow-agent delete --yes enters run and calls the delete API", async () => { const requests = mockConsole({ [APP_CONTROL_DELETE_API]: { result: true } }); - const result = await run(["app", "delete", "--app-id", "abc", "--yes", "--output", "json"]); + const result = await run([ + "flow-agent", + "delete", + "--app-id", + "abc", + "--yes", + "--output", + "json", + ]); expect(result.exitCode, result.stderr).toBe(0); expect(requests.map((request) => request.Api)).toEqual([APP_CONTROL_DELETE_API]); expect((requests[0]!.Data.reqDTO as Record).code).toBe("abc"); @@ -594,11 +602,11 @@ describe("e2e: app control mocked console", () => { // Representative subprocess coverage (shell / stdio / exit-code contract) // --------------------------------------------------------------------------- -describe("e2e: app control subprocess", () => { - test("app create --dry-run previews via a real subprocess", async () => { +describe("e2e: flow-agent subprocess", () => { + test("flow-agent create --dry-run previews via a real subprocess", async () => { const result = await runCommandE2e( - APP_CONTROL_ROUTES, - ["app", "create", "--name", "Demo", "--dry-run", "--output", "json"], + FLOW_AGENT_ROUTES, + ["flow-agent", "create", "--name", "Demo", "--dry-run", "--output", "json"], { ...offlineEnvironment, BAILIAN_E2E: "0" }, ); expect(result.exitCode, result.stderr).toBe(0); @@ -606,10 +614,10 @@ describe("e2e: app control subprocess", () => { expect(data.api).toBe(APP_CONTROL_CREATE_API); }); - test("app delete confirmation gate via a real subprocess (exit 7)", async () => { + test("flow-agent delete confirmation gate via a real subprocess (exit 7)", async () => { const result = await runCommandE2e( - APP_CONTROL_ROUTES, - ["app", "delete", "--app-id", "abc", "--output", "json"], + FLOW_AGENT_ROUTES, + ["flow-agent", "delete", "--app-id", "abc", "--output", "json"], { ...offlineEnvironment, BAILIAN_E2E: "0" }, ); expect(result.exitCode, result.stderr).toBe(7); @@ -617,14 +625,77 @@ describe("e2e: app control subprocess", () => { }); }); +// --------------------------------------------------------------------------- +// app call/list library contracts. The deprecation wrapper lives in the product +// map (packages/cli/src/commands.ts) and is asserted in packages/cli tests; the +// commands harness loads raw library exports, so no deprecation marking here. +// --------------------------------------------------------------------------- + +describe("e2e: app call/list library contracts", () => { + let isolated: ReturnType; + + beforeEach(() => { + isolated = buildIsolatedCliEnv({ overrides: offlineEnvironment }); + writeConfig(isolated.env.BAILIAN_CONFIG_DIR!, { language: "en-US", telemetry: false }); + vi.spyOn(httpTransport, "fetch").mockRejectedValue(new Error("Unexpected Console HTTP")); + vi.spyOn(globalThis, "fetch").mockRejectedValue(new Error("Unexpected offline HTTP")); + }); + afterEach(() => { + try { + expect(httpTransport.fetch).not.toHaveBeenCalled(); + expect(globalThis.fetch).not.toHaveBeenCalled(); + } finally { + vi.restoreAllMocks(); + isolated.dispose(); + } + }); + + function offline(args: string[]) { + return runCommandInProcess(APP_CONTROL_ROUTES, args, { + ...isolated.env, + ...offlineEnvironment, + }); + } + + test("app call --help renders", async () => { + const result = await runCommandHelp(APP_CONTROL_ROUTES, ["app", "call", "--help"]); + expect(result.exitCode, result.stderr).toBe(0); + expect(result.stderr).toContain("bl app call"); + }); + + test("app list --help renders", async () => { + const result = await runCommandHelp(APP_CONTROL_ROUTES, ["app", "list", "--help"]); + expect(result.exitCode, result.stderr).toBe(0); + expect(result.stderr).toContain("bl app list"); + }); + + test("app list --dry-run keeps stdout JSON clean (warning suppressed in json mode)", async () => { + const result = await offline(["app", "list", "--dry-run", "--output", "json"]); + expect(result.exitCode, result.stderr).toBe(0); + const data = parseStdoutJson<{ api: string }>(result.stdout); + expect(data.api).toBe(APP_CONTROL_LIST_API); + }); + + test("removed app control-plane path is rejected (exit 2)", async () => { + const result = await offline(["app", "create", "--name", "x", "--output", "json"]); + expect(result.exitCode, result.stderr).toBe(2); + }); + + test("flow-agent list --help is not deprecated", async () => { + const result = await runCommandHelp(FLOW_AGENT_ROUTES, ["flow-agent", "list", "--help"]); + expect(result.exitCode, result.stderr).toBe(0); + expect(result.stderr).not.toContain("[Deprecated]"); + }); +}); + // --------------------------------------------------------------------------- // Live integration (gated; requires a real console session) // --------------------------------------------------------------------------- -describe.skipIf(!isConsoleE2EReady())("e2e: app control live (Console)", () => { - test("app list returns a structured page", async () => { - const result = await runConsoleCommandE2e(APP_CONTROL_ROUTES, [ - "app", +describe.skipIf(!isConsoleE2EReady())("e2e: flow-agent live (Console)", () => { + test("flow-agent list returns a structured page", async () => { + const result = await runConsoleCommandE2e(FLOW_AGENT_ROUTES, [ + "flow-agent", "list", "--page-size", "5", diff --git a/packages/commands/tests/e2e/topic-routes.ts b/packages/commands/tests/e2e/topic-routes.ts index 9adce6f3..94bc55fc 100644 --- a/packages/commands/tests/e2e/topic-routes.ts +++ b/packages/commands/tests/e2e/topic-routes.ts @@ -180,18 +180,24 @@ export const CONSOLE_READ_ROUTES: E2eRouteExports = { }; export const APP_CONTROL_ROUTES: E2eRouteExports = { + "app call": "appCall", "app list": "appList", - "app create": "appCreate", - "app get": "appGet", - "app update": "appUpdate", - "app publish": "appPublish", - "app delete": "appDelete", - "app copy": "appCopy", - "app versions": "appVersions", - "app workflow get": "appWorkflowGet", - "app workflow save": "appWorkflowSave", - "app workflow publish": "appWorkflowPublish", - "app workflow export": "appWorkflowExport", +}; + +export const FLOW_AGENT_ROUTES: E2eRouteExports = { + "flow-agent call": "appCall", + "flow-agent list": "appList", + "flow-agent create": "appCreate", + "flow-agent get": "appGet", + "flow-agent update": "appUpdate", + "flow-agent publish": "appPublish", + "flow-agent delete": "appDelete", + "flow-agent copy": "appCopy", + "flow-agent versions": "appVersions", + "flow-agent workflow get": "appWorkflowGet", + "flow-agent workflow save": "appWorkflowSave", + "flow-agent workflow publish": "appWorkflowPublish", + "flow-agent workflow export": "appWorkflowExport", }; export const ADVISOR_ROUTES: E2eRouteExports = { diff --git a/skills/bailian-cli/SKILL.md b/skills/bailian-cli/SKILL.md index d640aad3..5604e25a 100644 --- a/skills/bailian-cli/SKILL.md +++ b/skills/bailian-cli/SKILL.md @@ -6,7 +6,7 @@ metadata: bins: ["bl"] description: >- 阿里云百炼 / Aliyun Bailian / DashScope 资源管理与 `bl` CLI hub: - 应用调用与管理(bl app:调用/创建/更新/发布/删除/复制/版本、工作流画布)、决策模型推理(bl decision)、模型目录/模型列表、用量/额度/配额、免费额度、 + 应用调用与管理(bl flow-agent:调用/创建/更新/发布/删除/复制/版本、工作流画布;旧 bl app call/list 已废弃)、决策模型推理(bl decision)、模型目录/模型列表、用量/额度/配额、免费额度、 工作空间、MCP 市场、pipeline、文件上传、ParseX 文档/音视频解析与字段抽取、Batch 批量推理与 CSV 转换、同步 Batch Chat、console API、登录鉴权与配置、 Agent skill 安装/列表/更新/卸载(bl skill add|list|update|remove,百炼 skill registry)。 用户点名百炼 / DashScope / `bl`,或继续既有 `bl` 工作流时直接使用。 @@ -73,10 +73,10 @@ Use this table only after the decision table in [`bailian-protocol`](../bailian- | 百炼单次同步 Batch Chat | `bl text chat --batch` | 等待单次响应,不创建任务 ID;messages-file 是同一请求的对话上下文,边界见 `reference/text.md` | | Typed decision model inference | `bl decision` | Workspace endpoint; returns `choice` / `noul` / `score` values and probabilities, not generated text | | Explicit ParseX parsing / structured field extraction | `bl parsex parse submit` / `result`; `bl parsex extract submit` / `result` | Workspace + API key; submit returns biz_id, result --follow waits. HTTP(S) source URLs; extraction can reuse a parsed document. See `reference/parsex.md`. | -| Bailian agent / workflow | `bl app call` | Needs `--app-id` | -| Find app by name | `bl app list` then `bl app call` | Console auth; `--type workflow` lists workflows | -| Create / update / publish / delete / copy an app | `bl app create` / `update` / `publish` / `delete` / `copy` / `get` / `versions` | Console auth; agent config via `--model`/`--instructions`/`--config-json`; `delete` needs `--yes`; see [`reference/app.md`](reference/app.md) | -| Workflow canvas read / save / publish / export | `bl app workflow get` / `save` / `publish` / `export` | Console auth; `save` replaces the whole draft canvas; see [`reference/app.md`](reference/app.md) | +| Bailian agent / workflow | `bl flow-agent call` | Needs `--app-id` | +| Find app by name | `bl flow-agent list` then `bl flow-agent call` | Console auth; `--type workflow` lists workflows | +| Create / update / publish / delete / copy an app | `bl flow-agent create` / `update` / `publish` / `delete` / `copy` / `get` / `versions` | Console auth; agent config via `--model`/`--instructions`/`--config-json`; `delete` needs `--yes`; see [`reference/flow-agent.md`](reference/flow-agent.md) | +| Workflow canvas read / save / publish / export | `bl flow-agent workflow get` / `save` / `publish` / `export` | Console auth; `save` replaces the whole draft canvas; see [`reference/flow-agent.md`](reference/flow-agent.md) | | Personal memory / Bailian memory resources | → skill `bailian-memory` | User-enabled personal memory; explicit resource operations use `bl memory --help` as fallback. | | Personal documents / Bailian knowledge workflows | Read skill `bailian-knowledge` | If missing: `bl knowledge --help` or `bl skill init` | | Resolve a Console file key / error-report URL | `bl file url` | Console auth; use the returned business file key, not a file ID or upload URI. Resolves only; no download or fixed expiry. Existing URLs need no resolution. | @@ -115,14 +115,14 @@ Flags, usage, and examples: see hub [`reference/`](reference/index.md) or `bl --state "Is this requesting a refund?" --questions '{"refund":{"type":"noul"}}' -bl app list --output json -bl app call --app-id --prompt "Hello" -bl app create --name "My agent" --model qwen3-max +bl flow-agent list --output json +bl flow-agent call --app-id --prompt "Hello" +bl flow-agent create --name "My agent" --model qwen3-max bl usage stats bl model list --model qwen ``` -More examples per command: see `reference/.md` (e.g. [`reference/text.md`](reference/text.md), [`reference/app.md`](reference/app.md)). +More examples per command: see `reference/.md` (e.g. [`reference/text.md`](reference/text.md), [`reference/flow-agent.md`](reference/flow-agent.md)). --- @@ -130,16 +130,18 @@ More examples per command: see `reference/.md` (e.g. [`reference/text.md` ### Find and call an app -1. `bl app list --name --output json` +1. `bl flow-agent list --name --output json` 2. Pick `code` (app ID); handle `user_prompt_params` via `--biz-params '{"key":"value"}'` -3. `bl app call --app-id --prompt "..."` +3. `bl flow-agent call --app-id --prompt "..."` ### Create and configure an app -1. `bl app create --name [--type workflow] --output json` → returns `app_code` -2. Agent: `bl app update --app-id --model --instructions "..."` (reads the draft, merges, writes) -3. `bl app publish --app-id ` to release; `bl app get --app-id ` to inspect -4. Workflow canvas: `bl app workflow get --app-id --output-file canvas.json` → edit → `bl app workflow save --app-id --config-file canvas.json` → `bl app workflow publish --app-id ` +1. `bl flow-agent create --name [--type workflow] --output json` → returns `app_code` +2. Agent: `bl flow-agent update --app-id --model --instructions "..."` (reads the draft, merges, writes) +3. `bl flow-agent publish --app-id ` to release; `bl flow-agent get --app-id ` to inspect +4. Workflow canvas: `bl flow-agent workflow get --app-id --output-file canvas.json` → edit → `bl flow-agent workflow save --app-id --config-file canvas.json` → `bl flow-agent workflow publish --app-id ` + +> `bl app call` / `bl app list` are deprecated aliases of `bl flow-agent call` / `bl flow-agent list`; the rest of the app group moved to `flow-agent`. ### Batch 文件工作流 diff --git a/skills/bailian-cli/reference/app.md b/skills/bailian-cli/reference/app.md index 063f1414..36f70ebe 100644 --- a/skills/bailian-cli/reference/app.md +++ b/skills/bailian-cli/reference/app.md @@ -7,32 +7,21 @@ Index: [index.md](index.md) ## Commands in this group -| Command | Authentication | Description | -| ------------------------- | -------------- | ---------------------------------------------------------------- | -| `bl app call` | API Key | Call a Bailian application (agent or workflow) | -| `bl app copy` | Console | Copy a Bailian application (agent or workflow) | -| `bl app create` | Console | Create a Bailian application (agent or workflow) | -| `bl app delete` | Console | Delete a Bailian application (agent or workflow) | -| `bl app get` | Console | Get Bailian application details (agent or workflow) | -| `bl app list` | Console | List Bailian applications | -| `bl app publish` | Console | Publish a Bailian agent application | -| `bl app update` | Console | Update a Bailian application (agent config or workflow metadata) | -| `bl app versions` | Console | List published versions of a Bailian application | -| `bl app workflow export` | Console | Export a workflow as a DSL schema (download URL) | -| `bl app workflow get` | Console | Get a workflow canvas (draft or a published version) | -| `bl app workflow publish` | Console | Publish a workflow (publishes the current draft canvas) | -| `bl app workflow save` | Console | Save a workflow canvas (replaces the current draft) | +| Command | Authentication | Description | +| ------------- | -------------- | ----------------------------------------------------------- | +| `bl app call` | API Key | [Deprecated] Call a Bailian application (agent or workflow) | +| `bl app list` | Console | [Deprecated] List Bailian applications | ## Command details ### `bl app call` -| Field | Value | -| ------------------ | --------------------------------------------------- | -| **Name** | `app call` | -| **Description** | Call a Bailian application (agent or workflow) | -| **Authentication** | API Key | -| **Usage** | `bl app call --app-id --prompt [flags]` | +| Field | Value | +| ------------------ | ----------------------------------------------------------- | +| **Name** | `app call` | +| **Description** | [Deprecated] Call a Bailian application (agent or workflow) | +| **Authentication** | API Key | +| **Usage** | `bl app call --app-id --prompt [flags]` | #### Flags @@ -51,6 +40,10 @@ Index: [index.md](index.md) | `--api-key ` | string | no | API key | | `--base-url ` | string | no | API base URL | +#### Notes + +- Deprecated: use `bl flow-agent call` instead. This command will be removed in a future release. + #### Examples ```bash @@ -77,170 +70,14 @@ bl app call --app-id abc123 --prompt "Search for materials" --pipeline-ids pipe1 bl app call --app-id abc123 --prompt "Start" --biz-params '{"key":"value"}' ``` -### `bl app copy` - -| Field | Value | -| ------------------ | ---------------------------------------------- | -| **Name** | `app copy` | -| **Description** | Copy a Bailian application (agent or workflow) | -| **Authentication** | Console | -| **Usage** | `bl app copy --app-id [flags]` | - -#### Flags - -| Flag | Type | Required | Description | -| ------------------------------ | ------ | -------- | -------------------------------------------------------- | -| `--app-id ` | string | yes | Application ID (app code, required) | -| `--console-region ` | string | no | Console gateway region (e.g. cn-beijing, ap-southeast-1) | -| `--console-site ` | string | no | Console site: domestic, international | -| `--console-switch-agent ` | number | no | Switch agent UID for delegated access | -| `--workspace-id ` | string | no | Workspace ID (env: BAILIAN_WORKSPACE_ID) | - -#### Examples - -```bash -bl app copy --app-id abc123 -``` - -### `bl app create` - -| Field | Value | -| ------------------ | ------------------------------------------------ | -| **Name** | `app create` | -| **Description** | Create a Bailian application (agent or workflow) | -| **Authentication** | Console | -| **Usage** | `bl app create --name [flags]` | - -#### Flags - -| Flag | Type | Required | Description | -| ------------------------------ | ------ | -------- | ------------------------------------------------------------------ | -| `--name ` | string | yes | Application name (required) | -| `--type ` | string | no | Application type: agent (default), workflow | -| `--description ` | string | no | Application description | -| `--icon ` | string | no | Application icon key | -| `--model ` | string | no | Agent model ID (default: auto; agent only) | -| `--config-json ` | string | no | Config JSON string (mutually exclusive with --config-file) | -| `--config-file ` | string | no | Path to a config JSON file (mutually exclusive with --config-json) | -| `--console-region ` | string | no | Console gateway region (e.g. cn-beijing, ap-southeast-1) | -| `--console-site ` | string | no | Console site: domestic, international | -| `--console-switch-agent ` | number | no | Switch agent UID for delegated access | -| `--workspace-id ` | string | no | Workspace ID (env: BAILIAN_WORKSPACE_ID) | - -#### Notes - -- Agent creation uses the app-control 2.0 API with a default config (model auto, dialog_round 3). --config-json/--config-file shallow-merges over the default config; --model overrides config.model. -- Workflow creation creates an empty draft canvas; edit it with `app workflow save` and publish with `app workflow publish`. - -#### Examples - -```bash -bl app create --name "Customer service" -``` - -```bash -bl app create --name "Customer service" --model qwen3-max --description "After-sales bot" -``` - -```bash -bl app create --name "Order flow" --type workflow -``` - -```bash -bl app create --name "My agent" --config-file ./agent-config.json -``` - -### `bl app delete` - -| Field | Value | -| ------------------ | ----------------------------------------------------------------------------------------------------- | -| **Name** | `app delete` | -| **Description** | Delete a Bailian application (agent or workflow) | -| **Authentication** | Console | -| **Usage** | `bl app delete --app-id [flags]` | -| **Risk** | `high` | -| **Risk message** | This permanently deletes the application and its configuration. Confirm the app ID before proceeding. | - -> **Agent safety:** Never add `--yes` automatically. On `type="requires_confirmation"`, stop and ask for explicit user confirmation of the same action and scope. - -#### Flags - -| Flag | Type | Required | Description | -| ------------------------------ | ------ | -------- | -------------------------------------------------------- | -| `--app-id ` | string | yes | Application ID (app code, required) | -| `--yes` | switch | no | Confirm this high-risk operation | -| `--console-region ` | string | no | Console gateway region (e.g. cn-beijing, ap-southeast-1) | -| `--console-site ` | string | no | Console site: domestic, international | -| `--console-switch-agent ` | number | no | Switch agent UID for delegated access | -| `--workspace-id ` | string | no | Workspace ID (env: BAILIAN_WORKSPACE_ID) | - -#### Notes - -- Deletion is irreversible. Run `app list` or `app get` first to confirm the app ID. - -#### Examples - -```bash -bl app delete --app-id abc123 -``` - -```bash -# Only after explicit user confirmation: -bl app delete --app-id abc123 --yes -``` - -### `bl app get` - -| Field | Value | -| ------------------ | --------------------------------------------------- | -| **Name** | `app get` | -| **Description** | Get Bailian application details (agent or workflow) | -| **Authentication** | Console | -| **Usage** | `bl app get --app-id [flags]` | - -#### Flags - -| Flag | Type | Required | Description | -| ------------------------------ | ------ | -------- | --------------------------------------------------------------------- | -| `--app-id ` | string | yes | Application ID (app code, required) | -| `--type ` | string | no | Application type: agent (default), workflow | -| `--scope ` | string | no | Data scope: draft (default), publish | -| `--agent-version ` | number | no | Agent version number (agent only; implies published scope by default) | -| `--console-region ` | string | no | Console gateway region (e.g. cn-beijing, ap-southeast-1) | -| `--console-site ` | string | no | Console site: domestic, international | -| `--console-switch-agent ` | number | no | Switch agent UID for delegated access | -| `--workspace-id ` | string | no | Workspace ID (env: BAILIAN_WORKSPACE_ID) | - -#### Notes - -- Agent details come from app-control 2.0; workflow details from app-data. For the workflow canvas config use `app workflow get`. - -#### Examples - -```bash -bl app get --app-id abc123 -``` - -```bash -bl app get --app-id abc123 --scope publish -``` - -```bash -bl app get --app-id abc123 --agent-version 3 -``` - -```bash -bl app get --app-id abc123 --type workflow -``` - ### `bl app list` -| Field | Value | -| ------------------ | ------------------------- | -| **Name** | `app list` | -| **Description** | List Bailian applications | -| **Authentication** | Console | -| **Usage** | `bl app list [flags]` | +| Field | Value | +| ------------------ | -------------------------------------- | +| **Name** | `app list` | +| **Description** | [Deprecated] List Bailian applications | +| **Authentication** | Console | +| **Usage** | `bl app list [flags]` | #### Flags @@ -255,6 +92,10 @@ bl app get --app-id abc123 --type workflow | `--console-switch-agent ` | number | no | Switch agent UID for delegated access | | `--workspace-id ` | string | no | Workspace ID (env: BAILIAN_WORKSPACE_ID) | +#### Notes + +- Deprecated: use `bl flow-agent list` instead. This command will be removed in a future release. + #### Examples ```bash @@ -276,275 +117,3 @@ bl app list --type workflow ```bash bl app list --output json ``` - -### `bl app publish` - -| Field | Value | -| ------------------ | -------------------------------------- | -| **Name** | `app publish` | -| **Description** | Publish a Bailian agent application | -| **Authentication** | Console | -| **Usage** | `bl app publish --app-id [flags]` | - -#### Flags - -| Flag | Type | Required | Description | -| ------------------------------ | ------ | -------- | -------------------------------------------------------- | -| `--app-id ` | string | yes | Application ID (app code, required) | -| `--description ` | string | no | Version description | -| `--console-region ` | string | no | Console gateway region (e.g. cn-beijing, ap-southeast-1) | -| `--console-site ` | string | no | Console site: domestic, international | -| `--console-switch-agent ` | number | no | Switch agent UID for delegated access | -| `--workspace-id ` | string | no | Workspace ID (env: BAILIAN_WORKSPACE_ID) | - -#### Notes - -- Publishes the current agent draft via app-control 2.0. To publish a workflow, use `app workflow publish`. - -#### Examples - -```bash -bl app publish --app-id abc123 -``` - -```bash -bl app publish --app-id abc123 --description "Release v2" -``` - -### `bl app update` - -| Field | Value | -| ------------------ | ---------------------------------------------------------------- | -| **Name** | `app update` | -| **Description** | Update a Bailian application (agent config or workflow metadata) | -| **Authentication** | Console | -| **Usage** | `bl app update --app-id [flags]` | - -#### Flags - -| Flag | Type | Required | Description | -| ------------------------------ | ------ | -------- | ------------------------------------------------------------------ | -| `--app-id ` | string | yes | Application ID (app code, required) | -| `--type ` | string | no | Application type: agent (default), workflow | -| `--name ` | string | no | New application name | -| `--description ` | string | no | New application description | -| `--icon ` | string | no | New application icon key | -| `--model ` | string | no | Agent model ID (agent only; sets config.model) | -| `--instructions ` | string | no | Agent instructions (agent only; sets config.instruction) | -| `--config-json ` | string | no | Config JSON string (mutually exclusive with --config-file) | -| `--config-file ` | string | no | Path to a config JSON file (mutually exclusive with --config-json) | -| `--console-region ` | string | no | Console gateway region (e.g. cn-beijing, ap-southeast-1) | -| `--console-site ` | string | no | Console site: domestic, international | -| `--console-switch-agent ` | number | no | Switch agent UID for delegated access | -| `--workspace-id ` | string | no | Workspace ID (env: BAILIAN_WORKSPACE_ID) | - -#### Notes - -- Reads the current draft first, then merges: current config -> --config-json/--config-file (shallow) -> --model/--instructions. Only changed fields are sent. Requires a console token even for --dry-run (read-only planning). -- Agent updates use app-control 2.0. Workflow updates only change metadata (name/description/icon); edit the canvas with `app workflow save`. - -#### Examples - -```bash -bl app update --app-id abc123 --name "New name" -``` - -```bash -bl app update --app-id abc123 --model qwen3-max -``` - -```bash -bl app update --app-id abc123 --instructions "You are a helpful assistant" -``` - -```bash -bl app update --app-id abc123 --config-file ./agent-config.json -``` - -```bash -bl app update --app-id abc123 --type workflow --name "New flow name" -``` - -### `bl app versions` - -| Field | Value | -| ------------------ | ------------------------------------------------ | -| **Name** | `app versions` | -| **Description** | List published versions of a Bailian application | -| **Authentication** | Console | -| **Usage** | `bl app versions --app-id [flags]` | - -#### Flags - -| Flag | Type | Required | Description | -| ------------------------------ | ------ | -------- | -------------------------------------------------------- | -| `--app-id ` | string | yes | Application ID (app code, required) | -| `--type ` | string | no | Application type: agent (default), workflow | -| `--console-region ` | string | no | Console gateway region (e.g. cn-beijing, ap-southeast-1) | -| `--console-site ` | string | no | Console site: domestic, international | -| `--console-switch-agent ` | number | no | Switch agent UID for delegated access | -| `--workspace-id ` | string | no | Workspace ID (env: BAILIAN_WORKSPACE_ID) | - -#### Examples - -```bash -bl app versions --app-id abc123 -``` - -```bash -bl app versions --app-id abc123 --type workflow -``` - -### `bl app workflow export` - -| Field | Value | -| ------------------ | ------------------------------------------------ | -| **Name** | `app workflow export` | -| **Description** | Export a workflow as a DSL schema (download URL) | -| **Authentication** | Console | -| **Usage** | `bl app workflow export --app-id [flags]` | - -#### Flags - -| Flag | Type | Required | Description | -| ------------------------------ | ------ | -------- | --------------------------------------------------------- | -| `--app-id ` | string | yes | Application ID (app code, required) | -| `--flow-version ` | string | no | Published version to export (default: current draft) | -| `--output-file ` | string | no | Download the DSL to this file instead of printing the URL | -| `--console-region ` | string | no | Console gateway region (e.g. cn-beijing, ap-southeast-1) | -| `--console-site ` | string | no | Console site: domestic, international | -| `--console-switch-agent ` | number | no | Switch agent UID for delegated access | -| `--workspace-id ` | string | no | Workspace ID (env: BAILIAN_WORKSPACE_ID) | - -#### Examples - -```bash -bl app workflow export --app-id abc123 -``` - -```bash -bl app workflow export --app-id abc123 --flow-version 3 -``` - -```bash -bl app workflow export --app-id abc123 --output-file ./flow.dsl -``` - -### `bl app workflow get` - -| Field | Value | -| ------------------ | ---------------------------------------------------- | -| **Name** | `app workflow get` | -| **Description** | Get a workflow canvas (draft or a published version) | -| **Authentication** | Console | -| **Usage** | `bl app workflow get --app-id [flags]` | - -#### Flags - -| Flag | Type | Required | Description | -| ------------------------------ | ------ | -------- | -------------------------------------------------------- | -| `--app-id ` | string | yes | Application ID (app code, required) | -| `--flow-version ` | string | no | Published version to read (default: current draft) | -| `--scope ` | string | no | Data scope: draft (default), publish | -| `--output-file ` | string | no | Write the canvas config JSON to this file (overwrites) | -| `--console-region ` | string | no | Console gateway region (e.g. cn-beijing, ap-southeast-1) | -| `--console-site ` | string | no | Console site: domestic, international | -| `--console-switch-agent ` | number | no | Switch agent UID for delegated access | -| `--workspace-id ` | string | no | Workspace ID (env: BAILIAN_WORKSPACE_ID) | - -#### Notes - -- Without --flow-version, reads the current draft canvas (config + version). With --flow-version, reads a published version (scope defaults to publish). The canvas config is a JSON string; --output-file writes it parsed and pretty-printed. - -#### Examples - -```bash -bl app workflow get --app-id abc123 -``` - -```bash -bl app workflow get --app-id abc123 --flow-version 3 -``` - -```bash -bl app workflow get --app-id abc123 --output-file ./canvas.json -``` - -### `bl app workflow publish` - -| Field | Value | -| ------------------ | ------------------------------------------------------- | -| **Name** | `app workflow publish` | -| **Description** | Publish a workflow (publishes the current draft canvas) | -| **Authentication** | Console | -| **Usage** | `bl app workflow publish --app-id [flags]` | - -#### Flags - -| Flag | Type | Required | Description | -| ------------------------------ | ------ | -------- | -------------------------------------------------------------- | -| `--app-id ` | string | yes | Application ID (app code, required) | -| `--description ` | string | no | Version description | -| `--trigger-list ` | string | no | Trigger list JSON array (default: read from the current draft) | -| `--console-region ` | string | no | Console gateway region (e.g. cn-beijing, ap-southeast-1) | -| `--console-site ` | string | no | Console site: domestic, international | -| `--console-switch-agent ` | number | no | Switch agent UID for delegated access | -| `--workspace-id ` | string | no | Workspace ID (env: BAILIAN_WORKSPACE_ID) | - -#### Notes - -- Reads the current draft canvas and version, then publishes. Triggers are taken from the draft (applicationConfigDTO.triggerList, falling back to the Start node) unless --trigger-list is given; 'none' triggers are dropped. Requires a console token even for --dry-run (read-only planning). - -#### Examples - -```bash -bl app workflow publish --app-id abc123 -``` - -```bash -bl app workflow publish --app-id abc123 --description "Release v2" -``` - -```bash -bl app workflow publish --app-id abc123 --trigger-list '[]' -``` - -### `bl app workflow save` - -| Field | Value | -| ------------------ | ------------------------------------------------------------------------------------------- | -| **Name** | `app workflow save` | -| **Description** | Save a workflow canvas (replaces the current draft) | -| **Authentication** | Console | -| **Usage** | `bl app workflow save --app-id (--config-json \| --config-file ) [flags]` | - -#### Flags - -| Flag | Type | Required | Description | -| ------------------------------ | ------ | -------- | --------------------------------------------------------------------------- | -| `--app-id ` | string | yes | Application ID (app code, required) | -| `--config-json ` | string | no | Config JSON string (mutually exclusive with --config-file) | -| `--config-file ` | string | no | Path to a config JSON file (mutually exclusive with --config-json) | -| `--flow-version ` | string | no | Expected current version for optimistic locking (default: read from server) | -| `--console-region ` | string | no | Console gateway region (e.g. cn-beijing, ap-southeast-1) | -| `--console-site ` | string | no | Console site: domestic, international | -| `--console-switch-agent ` | number | no | Switch agent UID for delegated access | -| `--workspace-id ` | string | no | Workspace ID (env: BAILIAN_WORKSPACE_ID) | - -#### Notes - -- The canvas config is a whole-document replacement of the draft. Export it first with `app workflow get --output-file`, edit, then save. Without --flow-version the current version is read from the server (requires a console token, also for --dry-run). - -#### Examples - -```bash -bl app workflow save --app-id abc123 --config-file ./canvas.json -``` - -```bash -bl app workflow save --app-id abc123 --config-json '{"nodes":[],"edges":[]}' -``` - -```bash -bl app workflow save --app-id abc123 --config-file ./canvas.json --flow-version 5 -``` diff --git a/skills/bailian-cli/reference/flow-agent.md b/skills/bailian-cli/reference/flow-agent.md new file mode 100644 index 00000000..dfac0ad9 --- /dev/null +++ b/skills/bailian-cli/reference/flow-agent.md @@ -0,0 +1,550 @@ +# `bl flow-agent` commands + +> Auto-generated from `packages/cli/src/commands.ts`. Do not edit by hand. +> Regenerate: `pnpm --filter bailian-cli run generate:reference`. + +Index: [index.md](index.md) + +## Commands in this group + +| Command | Authentication | Description | +| -------------------------------- | -------------- | ---------------------------------------------------------------- | +| `bl flow-agent call` | API Key | Call a Bailian application (agent or workflow) | +| `bl flow-agent copy` | Console | Copy a Bailian application (agent or workflow) | +| `bl flow-agent create` | Console | Create a Bailian application (agent or workflow) | +| `bl flow-agent delete` | Console | Delete a Bailian application (agent or workflow) | +| `bl flow-agent get` | Console | Get Bailian application details (agent or workflow) | +| `bl flow-agent list` | Console | List Bailian applications | +| `bl flow-agent publish` | Console | Publish a Bailian agent application | +| `bl flow-agent update` | Console | Update a Bailian application (agent config or workflow metadata) | +| `bl flow-agent versions` | Console | List published versions of a Bailian application | +| `bl flow-agent workflow export` | Console | Export a workflow as a DSL schema (download URL) | +| `bl flow-agent workflow get` | Console | Get a workflow canvas (draft or a published version) | +| `bl flow-agent workflow publish` | Console | Publish a workflow (publishes the current draft canvas) | +| `bl flow-agent workflow save` | Console | Save a workflow canvas (replaces the current draft) | + +## Command details + +### `bl flow-agent call` + +| Field | Value | +| ------------------ | ---------------------------------------------------------- | +| **Name** | `flow-agent call` | +| **Description** | Call a Bailian application (agent or workflow) | +| **Authentication** | API Key | +| **Usage** | `bl flow-agent call --app-id --prompt [flags]` | + +#### Flags + +| Flag | Type | Required | Description | +| ---------------------- | ------ | -------- | --------------------------------------------- | +| `--app-id ` | string | yes | Application ID (required) | +| `--prompt ` | string | yes | Input prompt text | +| `--image ` | array | no | Image URL(s) to pass to the app (repeatable) | +| `--file-id ` | array | no | Pre-uploaded file ID(s) (repeatable) | +| `--session-id ` | string | no | Session ID for multi-turn conversation | +| `--stream` | switch | no | Stream response (default: on in TTY) | +| `--pipeline-ids ` | string | no | Knowledge base pipeline IDs (comma-separated) | +| `--memory-id ` | string | no | Memory ID for long-term memory | +| `--biz-params ` | string | no | Business parameters JSON (workflow variables) | +| `--has-thoughts` | switch | no | Show agent thinking process | +| `--api-key ` | string | no | API key | +| `--base-url ` | string | no | API base URL | + +#### Examples + +```bash +bl flow-agent call --app-id abc123 --prompt "Hello" +``` + +```bash +bl flow-agent call --app-id abc123 --prompt "Describe this image" --image https://example.com/photo.jpg +``` + +```bash +bl flow-agent call --app-id abc123 --prompt "Analyze the image" --image img1.jpg --image img2.jpg +``` + +```bash +bl flow-agent call --app-id abc123 --prompt "Continue" --session-id sess_xxx --stream +``` + +```bash +bl flow-agent call --app-id abc123 --prompt "Search for materials" --pipeline-ids pipe1,pipe2 +``` + +```bash +bl flow-agent call --app-id abc123 --prompt "Start" --biz-params '{"key":"value"}' +``` + +### `bl flow-agent copy` + +| Field | Value | +| ------------------ | ---------------------------------------------- | +| **Name** | `flow-agent copy` | +| **Description** | Copy a Bailian application (agent or workflow) | +| **Authentication** | Console | +| **Usage** | `bl flow-agent copy --app-id [flags]` | + +#### Flags + +| Flag | Type | Required | Description | +| ------------------------------ | ------ | -------- | -------------------------------------------------------- | +| `--app-id ` | string | yes | Application ID (app code, required) | +| `--console-region ` | string | no | Console gateway region (e.g. cn-beijing, ap-southeast-1) | +| `--console-site ` | string | no | Console site: domestic, international | +| `--console-switch-agent ` | number | no | Switch agent UID for delegated access | +| `--workspace-id ` | string | no | Workspace ID (env: BAILIAN_WORKSPACE_ID) | + +#### Examples + +```bash +bl flow-agent copy --app-id abc123 +``` + +### `bl flow-agent create` + +| Field | Value | +| ------------------ | ------------------------------------------------ | +| **Name** | `flow-agent create` | +| **Description** | Create a Bailian application (agent or workflow) | +| **Authentication** | Console | +| **Usage** | `bl flow-agent create --name [flags]` | + +#### Flags + +| Flag | Type | Required | Description | +| ------------------------------ | ------ | -------- | ------------------------------------------------------------------ | +| `--name ` | string | yes | Application name (required) | +| `--type ` | string | no | Application type: agent (default), workflow | +| `--description ` | string | no | Application description | +| `--icon ` | string | no | Application icon key | +| `--model ` | string | no | Agent model ID (default: auto; agent only) | +| `--config-json ` | string | no | Config JSON string (mutually exclusive with --config-file) | +| `--config-file ` | string | no | Path to a config JSON file (mutually exclusive with --config-json) | +| `--console-region ` | string | no | Console gateway region (e.g. cn-beijing, ap-southeast-1) | +| `--console-site ` | string | no | Console site: domestic, international | +| `--console-switch-agent ` | number | no | Switch agent UID for delegated access | +| `--workspace-id ` | string | no | Workspace ID (env: BAILIAN_WORKSPACE_ID) | + +#### Notes + +- Agent creation uses the app-control 2.0 API with a default config (model auto, dialog_round 3). --config-json/--config-file shallow-merges over the default config; --model overrides config.model. +- Workflow creation creates an empty draft canvas; edit it with `app workflow save` and publish with `app workflow publish`. + +#### Examples + +```bash +bl flow-agent create --name "Customer service" +``` + +```bash +bl flow-agent create --name "Customer service" --model qwen3-max --description "After-sales bot" +``` + +```bash +bl flow-agent create --name "Order flow" --type workflow +``` + +```bash +bl flow-agent create --name "My agent" --config-file ./agent-config.json +``` + +### `bl flow-agent delete` + +| Field | Value | +| ------------------ | ----------------------------------------------------------------------------------------------------- | +| **Name** | `flow-agent delete` | +| **Description** | Delete a Bailian application (agent or workflow) | +| **Authentication** | Console | +| **Usage** | `bl flow-agent delete --app-id [flags]` | +| **Risk** | `high` | +| **Risk message** | This permanently deletes the application and its configuration. Confirm the app ID before proceeding. | + +> **Agent safety:** Never add `--yes` automatically. On `type="requires_confirmation"`, stop and ask for explicit user confirmation of the same action and scope. + +#### Flags + +| Flag | Type | Required | Description | +| ------------------------------ | ------ | -------- | -------------------------------------------------------- | +| `--app-id ` | string | yes | Application ID (app code, required) | +| `--yes` | switch | no | Confirm this high-risk operation | +| `--console-region ` | string | no | Console gateway region (e.g. cn-beijing, ap-southeast-1) | +| `--console-site ` | string | no | Console site: domestic, international | +| `--console-switch-agent ` | number | no | Switch agent UID for delegated access | +| `--workspace-id ` | string | no | Workspace ID (env: BAILIAN_WORKSPACE_ID) | + +#### Notes + +- Deletion is irreversible. Run `app list` or `app get` first to confirm the app ID. + +#### Examples + +```bash +bl flow-agent delete --app-id abc123 +``` + +```bash +# Only after explicit user confirmation: +bl flow-agent delete --app-id abc123 --yes +``` + +### `bl flow-agent get` + +| Field | Value | +| ------------------ | --------------------------------------------------- | +| **Name** | `flow-agent get` | +| **Description** | Get Bailian application details (agent or workflow) | +| **Authentication** | Console | +| **Usage** | `bl flow-agent get --app-id [flags]` | + +#### Flags + +| Flag | Type | Required | Description | +| ------------------------------ | ------ | -------- | --------------------------------------------------------------------- | +| `--app-id ` | string | yes | Application ID (app code, required) | +| `--type ` | string | no | Application type: agent (default), workflow | +| `--scope ` | string | no | Data scope: draft (default), publish | +| `--agent-version ` | number | no | Agent version number (agent only; implies published scope by default) | +| `--console-region ` | string | no | Console gateway region (e.g. cn-beijing, ap-southeast-1) | +| `--console-site ` | string | no | Console site: domestic, international | +| `--console-switch-agent ` | number | no | Switch agent UID for delegated access | +| `--workspace-id ` | string | no | Workspace ID (env: BAILIAN_WORKSPACE_ID) | + +#### Notes + +- Agent details come from app-control 2.0; workflow details from app-data. For the workflow canvas config use `app workflow get`. + +#### Examples + +```bash +bl flow-agent get --app-id abc123 +``` + +```bash +bl flow-agent get --app-id abc123 --scope publish +``` + +```bash +bl flow-agent get --app-id abc123 --agent-version 3 +``` + +```bash +bl flow-agent get --app-id abc123 --type workflow +``` + +### `bl flow-agent list` + +| Field | Value | +| ------------------ | ---------------------------- | +| **Name** | `flow-agent list` | +| **Description** | List Bailian applications | +| **Authentication** | Console | +| **Usage** | `bl flow-agent list [flags]` | + +#### Flags + +| Flag | Type | Required | Description | +| ------------------------------ | ------ | -------- | -------------------------------------------------------- | +| `--name ` | string | no | Filter by app name (keyword search) | +| `--page ` | number | no | Page number (default: 1) | +| `--page-size ` | number | no | Results per page (default: 30) | +| `--type ` | string | no | Application type: agent (default), workflow | +| `--console-region ` | string | no | Console gateway region (e.g. cn-beijing, ap-southeast-1) | +| `--console-site ` | string | no | Console site: domestic, international | +| `--console-switch-agent ` | number | no | Switch agent UID for delegated access | +| `--workspace-id ` | string | no | Workspace ID (env: BAILIAN_WORKSPACE_ID) | + +#### Examples + +```bash +bl flow-agent list +``` + +```bash +bl flow-agent list --name customer service +``` + +```bash +bl flow-agent list --page 2 --page-size 10 +``` + +```bash +bl flow-agent list --type workflow +``` + +```bash +bl flow-agent list --output json +``` + +### `bl flow-agent publish` + +| Field | Value | +| ------------------ | --------------------------------------------- | +| **Name** | `flow-agent publish` | +| **Description** | Publish a Bailian agent application | +| **Authentication** | Console | +| **Usage** | `bl flow-agent publish --app-id [flags]` | + +#### Flags + +| Flag | Type | Required | Description | +| ------------------------------ | ------ | -------- | -------------------------------------------------------- | +| `--app-id ` | string | yes | Application ID (app code, required) | +| `--description ` | string | no | Version description | +| `--console-region ` | string | no | Console gateway region (e.g. cn-beijing, ap-southeast-1) | +| `--console-site ` | string | no | Console site: domestic, international | +| `--console-switch-agent ` | number | no | Switch agent UID for delegated access | +| `--workspace-id ` | string | no | Workspace ID (env: BAILIAN_WORKSPACE_ID) | + +#### Notes + +- Publishes the current agent draft via app-control 2.0. To publish a workflow, use `app workflow publish`. + +#### Examples + +```bash +bl flow-agent publish --app-id abc123 +``` + +```bash +bl flow-agent publish --app-id abc123 --description "Release v2" +``` + +### `bl flow-agent update` + +| Field | Value | +| ------------------ | ---------------------------------------------------------------- | +| **Name** | `flow-agent update` | +| **Description** | Update a Bailian application (agent config or workflow metadata) | +| **Authentication** | Console | +| **Usage** | `bl flow-agent update --app-id [flags]` | + +#### Flags + +| Flag | Type | Required | Description | +| ------------------------------ | ------ | -------- | ------------------------------------------------------------------ | +| `--app-id ` | string | yes | Application ID (app code, required) | +| `--type ` | string | no | Application type: agent (default), workflow | +| `--name ` | string | no | New application name | +| `--description ` | string | no | New application description | +| `--icon ` | string | no | New application icon key | +| `--model ` | string | no | Agent model ID (agent only; sets config.model) | +| `--instructions ` | string | no | Agent instructions (agent only; sets config.instruction) | +| `--config-json ` | string | no | Config JSON string (mutually exclusive with --config-file) | +| `--config-file ` | string | no | Path to a config JSON file (mutually exclusive with --config-json) | +| `--console-region ` | string | no | Console gateway region (e.g. cn-beijing, ap-southeast-1) | +| `--console-site ` | string | no | Console site: domestic, international | +| `--console-switch-agent ` | number | no | Switch agent UID for delegated access | +| `--workspace-id ` | string | no | Workspace ID (env: BAILIAN_WORKSPACE_ID) | + +#### Notes + +- Reads the current draft first, then merges: current config -> --config-json/--config-file (shallow) -> --model/--instructions. Only changed fields are sent. Requires a console token even for --dry-run (read-only planning). +- Agent updates use app-control 2.0. Workflow updates only change metadata (name/description/icon); edit the canvas with `app workflow save`. + +#### Examples + +```bash +bl flow-agent update --app-id abc123 --name "New name" +``` + +```bash +bl flow-agent update --app-id abc123 --model qwen3-max +``` + +```bash +bl flow-agent update --app-id abc123 --instructions "You are a helpful assistant" +``` + +```bash +bl flow-agent update --app-id abc123 --config-file ./agent-config.json +``` + +```bash +bl flow-agent update --app-id abc123 --type workflow --name "New flow name" +``` + +### `bl flow-agent versions` + +| Field | Value | +| ------------------ | ------------------------------------------------ | +| **Name** | `flow-agent versions` | +| **Description** | List published versions of a Bailian application | +| **Authentication** | Console | +| **Usage** | `bl flow-agent versions --app-id [flags]` | + +#### Flags + +| Flag | Type | Required | Description | +| ------------------------------ | ------ | -------- | -------------------------------------------------------- | +| `--app-id ` | string | yes | Application ID (app code, required) | +| `--type ` | string | no | Application type: agent (default), workflow | +| `--console-region ` | string | no | Console gateway region (e.g. cn-beijing, ap-southeast-1) | +| `--console-site ` | string | no | Console site: domestic, international | +| `--console-switch-agent ` | number | no | Switch agent UID for delegated access | +| `--workspace-id ` | string | no | Workspace ID (env: BAILIAN_WORKSPACE_ID) | + +#### Examples + +```bash +bl flow-agent versions --app-id abc123 +``` + +```bash +bl flow-agent versions --app-id abc123 --type workflow +``` + +### `bl flow-agent workflow export` + +| Field | Value | +| ------------------ | ----------------------------------------------------- | +| **Name** | `flow-agent workflow export` | +| **Description** | Export a workflow as a DSL schema (download URL) | +| **Authentication** | Console | +| **Usage** | `bl flow-agent workflow export --app-id [flags]` | + +#### Flags + +| Flag | Type | Required | Description | +| ------------------------------ | ------ | -------- | --------------------------------------------------------- | +| `--app-id ` | string | yes | Application ID (app code, required) | +| `--flow-version ` | string | no | Published version to export (default: current draft) | +| `--output-file ` | string | no | Download the DSL to this file instead of printing the URL | +| `--console-region ` | string | no | Console gateway region (e.g. cn-beijing, ap-southeast-1) | +| `--console-site ` | string | no | Console site: domestic, international | +| `--console-switch-agent ` | number | no | Switch agent UID for delegated access | +| `--workspace-id ` | string | no | Workspace ID (env: BAILIAN_WORKSPACE_ID) | + +#### Examples + +```bash +bl flow-agent workflow export --app-id abc123 +``` + +```bash +bl flow-agent workflow export --app-id abc123 --flow-version 3 +``` + +```bash +bl flow-agent workflow export --app-id abc123 --output-file ./flow.dsl +``` + +### `bl flow-agent workflow get` + +| Field | Value | +| ------------------ | ---------------------------------------------------- | +| **Name** | `flow-agent workflow get` | +| **Description** | Get a workflow canvas (draft or a published version) | +| **Authentication** | Console | +| **Usage** | `bl flow-agent workflow get --app-id [flags]` | + +#### Flags + +| Flag | Type | Required | Description | +| ------------------------------ | ------ | -------- | -------------------------------------------------------- | +| `--app-id ` | string | yes | Application ID (app code, required) | +| `--flow-version ` | string | no | Published version to read (default: current draft) | +| `--scope ` | string | no | Data scope: draft (default), publish | +| `--output-file ` | string | no | Write the canvas config JSON to this file (overwrites) | +| `--console-region ` | string | no | Console gateway region (e.g. cn-beijing, ap-southeast-1) | +| `--console-site ` | string | no | Console site: domestic, international | +| `--console-switch-agent ` | number | no | Switch agent UID for delegated access | +| `--workspace-id ` | string | no | Workspace ID (env: BAILIAN_WORKSPACE_ID) | + +#### Notes + +- Without --flow-version, reads the current draft canvas (config + version). With --flow-version, reads a published version (scope defaults to publish). The canvas config is a JSON string; --output-file writes it parsed and pretty-printed. + +#### Examples + +```bash +bl flow-agent workflow get --app-id abc123 +``` + +```bash +bl flow-agent workflow get --app-id abc123 --flow-version 3 +``` + +```bash +bl flow-agent workflow get --app-id abc123 --output-file ./canvas.json +``` + +### `bl flow-agent workflow publish` + +| Field | Value | +| ------------------ | ------------------------------------------------------- | +| **Name** | `flow-agent workflow publish` | +| **Description** | Publish a workflow (publishes the current draft canvas) | +| **Authentication** | Console | +| **Usage** | `bl flow-agent workflow publish --app-id [flags]` | + +#### Flags + +| Flag | Type | Required | Description | +| ------------------------------ | ------ | -------- | -------------------------------------------------------------- | +| `--app-id ` | string | yes | Application ID (app code, required) | +| `--description ` | string | no | Version description | +| `--trigger-list ` | string | no | Trigger list JSON array (default: read from the current draft) | +| `--console-region ` | string | no | Console gateway region (e.g. cn-beijing, ap-southeast-1) | +| `--console-site ` | string | no | Console site: domestic, international | +| `--console-switch-agent ` | number | no | Switch agent UID for delegated access | +| `--workspace-id ` | string | no | Workspace ID (env: BAILIAN_WORKSPACE_ID) | + +#### Notes + +- Reads the current draft canvas and version, then publishes. Triggers are taken from the draft (applicationConfigDTO.triggerList, falling back to the Start node) unless --trigger-list is given; 'none' triggers are dropped. Requires a console token even for --dry-run (read-only planning). + +#### Examples + +```bash +bl flow-agent workflow publish --app-id abc123 +``` + +```bash +bl flow-agent workflow publish --app-id abc123 --description "Release v2" +``` + +```bash +bl flow-agent workflow publish --app-id abc123 --trigger-list '[]' +``` + +### `bl flow-agent workflow save` + +| Field | Value | +| ------------------ | -------------------------------------------------------------------------------------------------- | +| **Name** | `flow-agent workflow save` | +| **Description** | Save a workflow canvas (replaces the current draft) | +| **Authentication** | Console | +| **Usage** | `bl flow-agent workflow save --app-id (--config-json \| --config-file ) [flags]` | + +#### Flags + +| Flag | Type | Required | Description | +| ------------------------------ | ------ | -------- | --------------------------------------------------------------------------- | +| `--app-id ` | string | yes | Application ID (app code, required) | +| `--config-json ` | string | no | Config JSON string (mutually exclusive with --config-file) | +| `--config-file ` | string | no | Path to a config JSON file (mutually exclusive with --config-json) | +| `--flow-version ` | string | no | Expected current version for optimistic locking (default: read from server) | +| `--console-region ` | string | no | Console gateway region (e.g. cn-beijing, ap-southeast-1) | +| `--console-site ` | string | no | Console site: domestic, international | +| `--console-switch-agent ` | number | no | Switch agent UID for delegated access | +| `--workspace-id ` | string | no | Workspace ID (env: BAILIAN_WORKSPACE_ID) | + +#### Notes + +- The canvas config is a whole-document replacement of the draft. Export it first with `app workflow get --output-file`, edit, then save. Without --flow-version the current version is read from the server (requires a console token, also for --dry-run). + +#### Examples + +```bash +bl flow-agent workflow save --app-id abc123 --config-file ./canvas.json +``` + +```bash +bl flow-agent workflow save --app-id abc123 --config-json '{"nodes":[],"edges":[]}' +``` + +```bash +bl flow-agent workflow save --app-id abc123 --config-file ./canvas.json --flow-version 5 +``` diff --git a/skills/bailian-cli/reference/index.md b/skills/bailian-cli/reference/index.md index 4d15fad2..9fc03f1e 100644 --- a/skills/bailian-cli/reference/index.md +++ b/skills/bailian-cli/reference/index.md @@ -9,130 +9,132 @@ Use this index for the skill-scoped quick index and global flags. ## Quick index -| Command | Authentication | Description | Detail | -| ------------------------------- | -------------- | ------------------------------------------------------------------------------------------------------------------ | ------------------------------ | -| `bl advisor recommend` | API Key | Recommend the best models for your use case (intent → routing → recall → score → rank, with agent clarification) | [advisor.md](advisor.md) | -| `bl agents security alerts` | API Key | List Agent security alerts | [agents.md](agents.md) | -| `bl agents security overview` | API Key | Show the Agent security protection overview (last 24 hours) | [agents.md](agents.md) | -| `bl alert create` | Console | Create a model alert rule from an alert template | [alert.md](alert.md) | -| `bl alert delete` | Console | Delete model alert rules | [alert.md](alert.md) | -| `bl alert disable` | Console | Disable a model alert rule (keeps the rule, stops notifications) | [alert.md](alert.md) | -| `bl alert enable` | Console | Enable a model alert rule | [alert.md](alert.md) | -| `bl alert history` | Console | List model alert history (firing and recovered events) | [alert.md](alert.md) | -| `bl alert list` | Console | List model alert rules | [alert.md](alert.md) | -| `bl alert metrics` | Console | List metrics that alert rules can be created on, with supported aggregations | [alert.md](alert.md) | -| `bl alert template create` | Console | Create a custom alert template (or copy an official one with --from) | [alert.md](alert.md) | -| `bl alert template delete` | Console | Delete custom alert templates (official templates cannot be deleted) | [alert.md](alert.md) | -| `bl alert template list` | Console | List alert templates (official and custom); pass --template-id for details | [alert.md](alert.md) | -| `bl alert template update` | Console | Update a custom alert template (full replacement of conditions) | [alert.md](alert.md) | -| `bl alert update` | Console | Update a model alert rule (full replacement; same fields as create) | [alert.md](alert.md) | -| `bl app call` | API Key | Call a Bailian application (agent or workflow) | [app.md](app.md) | -| `bl app copy` | Console | Copy a Bailian application (agent or workflow) | [app.md](app.md) | -| `bl app create` | Console | Create a Bailian application (agent or workflow) | [app.md](app.md) | -| `bl app delete` | Console | Delete a Bailian application (agent or workflow) | [app.md](app.md) | -| `bl app get` | Console | Get Bailian application details (agent or workflow) | [app.md](app.md) | -| `bl app list` | Console | List Bailian applications | [app.md](app.md) | -| `bl app publish` | Console | Publish a Bailian agent application | [app.md](app.md) | -| `bl app update` | Console | Update a Bailian application (agent config or workflow metadata) | [app.md](app.md) | -| `bl app versions` | Console | List published versions of a Bailian application | [app.md](app.md) | -| `bl app workflow export` | Console | Export a workflow as a DSL schema (download URL) | [app.md](app.md) | -| `bl app workflow get` | Console | Get a workflow canvas (draft or a published version) | [app.md](app.md) | -| `bl app workflow publish` | Console | Publish a workflow (publishes the current draft canvas) | [app.md](app.md) | -| `bl app workflow save` | Console | Save a workflow canvas (replaces the current draft) | [app.md](app.md) | -| `bl auth generate-access-token` | No Auth | Generate a CLI access token using OpenAPI AK/SK | [auth.md](auth.md) | -| `bl auth login` | No Auth | Authenticate with API key, console browser login, or OpenAPI AK/SK (credentials can coexist) | [auth.md](auth.md) | -| `bl auth logout` | No Auth | Clear stored credentials; full logout also clears the model Base URL | [auth.md](auth.md) | -| `bl auth status` | No Auth | Show current authentication state | [auth.md](auth.md) | -| `bl batch cancel` | API Key | Request cancellation of a Batch task | [batch.md](batch.md) | -| `bl batch convert` | No Auth | Build Batch JSONL from CSV locally | [batch.md](batch.md) | -| `bl batch create` | API Key | Upload or reference input and create an asynchronous Batch task | [batch.md](batch.md) | -| `bl batch download` | API Key | Download original Batch results/errors, optionally export CSV | [batch.md](batch.md) | -| `bl batch get` | API Key | Get Batch task details, optionally following progress | [batch.md](batch.md) | -| `bl batch list` | API Key | List one page of Batch tasks | [batch.md](batch.md) | -| `bl cmodel base-models` | Console | List base models that can be imported as custom models | [cmodel.md](cmodel.md) | -| `bl cmodel delete` | API Key | Delete a custom model and its Bailian-side import record | [cmodel.md](cmodel.md) | -| `bl cmodel get` | API Key | Get details of a custom model (import job) | [cmodel.md](cmodel.md) | -| `bl cmodel import` | API Key | Import a custom model from OSS (creates an import job) | [cmodel.md](cmodel.md) | -| `bl cmodel list` | API Key | List custom models (import jobs) | [cmodel.md](cmodel.md) | -| `bl cmodel watch` | API Key | Probe a custom model's import status (default: single non-blocking fetch). Pass --follow to poll until terminal. | [cmodel.md](cmodel.md) | -| `bl config agent` | No Auth | Configure a coding agent to use DashScope API | [config.md](config.md) | -| `bl config list` | No Auth | List config profiles and show the active profile | [config.md](config.md) | -| `bl config set` | No Auth | Set a config value | [config.md](config.md) | -| `bl config show` | No Auth | Display current configuration | [config.md](config.md) | -| `bl config ui` | No Auth | Open a local web UI to manage config profiles | [config.md](config.md) | -| `bl config use` | No Auth | Set the active config profile | [config.md](config.md) | -| `bl console call` | Console | Call a Bailian console API via the CLI gateway | [console.md](console.md) | -| `bl decision` | API Key | Run the decision model: typed choice / noul / score answers with probabilities | [decision.md](decision.md) | -| `bl file upload` | API Key | Upload a local file to DashScope temporary storage (48h) | [file.md](file.md) | -| `bl file url` | Console | Resolve a Console business file key to a file URL | [file.md](file.md) | -| `bl log audit count` | Console | Count model audit logs in a time range (useful before exporting) | [log.md](log.md) | -| `bl log audit disable` | Console | Disable audit log delivery for all models in the workspace | [log.md](log.md) | -| `bl log audit enable` | Console | Enable audit log delivery to SLS (SLR authorization → SLS instance → log switch) | [log.md](log.md) | -| `bl log audit get` | Console | Show a single audit log entry with its raw origin record | [log.md](log.md) | -| `bl log audit list` | Console | Query model audit logs (call metadata; request/response content is not recorded) | [log.md](log.md) | -| `bl log inference count` | Console | Count model inference logs in a time range (useful before exporting) | [log.md](log.md) | -| `bl log inference disable` | Console | Disable inference log delivery for all models in the workspace | [log.md](log.md) | -| `bl log inference enable` | Console | Enable inference log delivery to SLS (SLR authorization → SLS instance → log switch) | [log.md](log.md) | -| `bl log inference get` | Console | Show a single inference log entry with full request/response content | [log.md](log.md) | -| `bl log inference list` | Console | Query model inference logs (requires inference log delivery; use `log inference get` for request/response content) | [log.md](log.md) | -| `bl log status` | Console | Show model log delivery status (SLS authorization, audit / inference service and switches) | [log.md](log.md) | -| `bl log trace get` | Console | Show a single call trace with its span tree | [log.md](log.md) | -| `bl log trace list` | Console | List call traces for a model or app | [log.md](log.md) | -| `bl log trace stats` | Console | Show per-resource trace statistics (calls, tokens, latency) | [log.md](log.md) | -| `bl mcp call` | API Key | Call a tool on an MCP server (tools/call) | [mcp.md](mcp.md) | -| `bl mcp connect` | API Key | Register a Bailian MCP server in an Agent's native configuration | [mcp.md](mcp.md) | -| `bl mcp disconnect` | No Auth | Remove an unchanged MCP registration previously managed by bailian-cli | [mcp.md](mcp.md) | -| `bl mcp list` | Console | List MCP servers activated under your Bailian account | [mcp.md](mcp.md) | -| `bl mcp tools` | API Key | List tools exposed by an MCP server (tools/list) | [mcp.md](mcp.md) | -| `bl model code` | No Auth | Print a ready-to-run SDK sample for calling a model | [model.md](model.md) | -| `bl model list` | No Auth | Browse model families or show detailed model info in the Bailian model marketplace | [model.md](model.md) | -| `bl model search` | No Auth | Search the model catalog by keyword, ranked by relevance | [model.md](model.md) | -| `bl monitor delivery disable` | Console | Disable monitor delivery for all models in the workspace | [monitor.md](monitor.md) | -| `bl monitor delivery enable` | Console | Activate monitoring delivery: CMS SLR authorization, CMS service, and the dedicated Prometheus instance | [monitor.md](monitor.md) | -| `bl monitor delivery status` | Console | Show monitoring delivery (Prometheus instance) status | [monitor.md](monitor.md) | -| `bl monitor errors` | Console | Show failure breakdown by HTTP status code and error code | [monitor.md](monitor.md) | -| `bl monitor metrics` | Console | Query time-series monitor metrics (RPM/TPM, latency percentiles, token usage) | [monitor.md](monitor.md) | -| `bl monitor models` | Console | List per-model / per-API-key call statistics with server-side sort and paging | [monitor.md](monitor.md) | -| `bl monitor overview` | Console | Show aggregated model call statistics (calls, failures, latency, token usage) | [monitor.md](monitor.md) | -| `bl parsex extract result` | API Key | Query ParseX extraction status, fields and citations | [parsex.md](parsex.md) | -| `bl parsex extract submit` | API Key | Submit ParseX structured field extraction | [parsex.md](parsex.md) | -| `bl parsex parse result` | API Key | Query ParseX parsing status, results or a result slice | [parsex.md](parsex.md) | -| `bl parsex parse submit` | API Key | Submit a ParseX document or media parsing task | [parsex.md](parsex.md) | -| `bl permission grant` | API Key | Grant model permissions (inference / finetune / deploy) | [permission.md](permission.md) | -| `bl permission list` | API Key | List model permissions (inference / fine-tune / deploy) in the workspace | [permission.md](permission.md) | -| `bl permission revoke` | API Key | Revoke model permissions (inference / finetune / deploy) | [permission.md](permission.md) | -| `bl pipeline run` | No Auth | Run a pipeline workflow definition | [pipeline.md](pipeline.md) | -| `bl pipeline validate` | No Auth | Validate a pipeline definition without executing | [pipeline.md](pipeline.md) | -| `bl plugin install` | No Auth | Install or upgrade an allowlisted Command Pack | [plugin.md](plugin.md) | -| `bl plugin link` | No Auth | Link an allowlisted local Command Pack for development | [plugin.md](plugin.md) | -| `bl plugin list` | No Auth | List installed Command Packs and their load status | [plugin.md](plugin.md) | -| `bl plugin remove` | No Auth | Remove an installed Command Pack | [plugin.md](plugin.md) | -| `bl quota check` | Console | Check current usage against rate limits | [quota.md](quota.md) | -| `bl quota delete` | API Key | Clear all custom rate limits (QPM/TPM) for a model | [quota.md](quota.md) | -| `bl quota history` | Console | View quota change history | [quota.md](quota.md) | -| `bl quota list` | API Key | View model rate limits (QPM/TPM, account and workspace level) | [quota.md](quota.md) | -| `bl quota update` | API Key | Update model rate limits (QPM/TPM) | [quota.md](quota.md) | -| `bl search web` | API Key | Search the web via a chat model with built-in web search (default) or the DashScope MCP WebSearch service | [search.md](search.md) | -| `bl skill add` | No Auth | Install skills from the Bailian skill registry into local agents | [skill.md](skill.md) | -| `bl skill init` | No Auth | Install all bailian-* skills (one-shot bootstrap for new environments) | [skill.md](skill.md) | -| `bl skill list` | No Auth | List registry skills and diff against local installs | [skill.md](skill.md) | -| `bl skill remove` | No Auth | Remove locally installed skills (registry is untouched) | [skill.md](skill.md) | -| `bl skill update` | No Auth | Update installed skills to the latest registry versions | [skill.md](skill.md) | -| `bl text chat` | API Key | Send a text model request (OpenAI compatible, DashScope) | [text.md](text.md) | -| `bl token-plan add-member` | AK/SK | Add a member to a Token Plan organization | [token-plan.md](token-plan.md) | -| `bl token-plan assign-seats` | AK/SK | Batch assign Token Plan seats to members | [token-plan.md](token-plan.md) | -| `bl token-plan create-key` | AK/SK | Create a Token Plan API key for a seat | [token-plan.md](token-plan.md) | -| `bl token-plan harness-quota` | Console | Show Token Plan harness entitlement quota usage | [token-plan.md](token-plan.md) | -| `bl token-plan list-seats` | AK/SK | List Token Plan subscription seat details | [token-plan.md](token-plan.md) | -| `bl update` | No Auth | Update the CLI to the latest or a specified version | [update.md](update.md) | -| `bl usage coding-plan` | Console | Show Coding Plan quota usage | [usage.md](usage.md) | -| `bl usage free` | Console | Query free-tier quota for models (all models if --model is omitted) | [usage.md](usage.md) | -| `bl usage freetier` | Console | Enable or disable auto-stop for free-tier models. Enables by default; use --off to disable | [usage.md](usage.md) | -| `bl usage stats` | Console | Query model usage statistics | [usage.md](usage.md) | -| `bl usage summary` | Console | Show a unified usage summary: free-tier quota and recent usage overview | [usage.md](usage.md) | -| `bl usage token-plan` | Console | Show Token Plan quota usage | [usage.md](usage.md) | -| `bl workspace init` | No Auth | Initialize Bailian workspace and activate postpaid services | [workspace.md](workspace.md) | -| `bl workspace list` | Console | List all workspaces | [workspace.md](workspace.md) | +| Command | Authentication | Description | Detail | +| -------------------------------- | -------------- | ------------------------------------------------------------------------------------------------------------------ | ------------------------------ | +| `bl advisor recommend` | API Key | Recommend the best models for your use case (intent → routing → recall → score → rank, with agent clarification) | [advisor.md](advisor.md) | +| `bl agents security alerts` | API Key | List Agent security alerts | [agents.md](agents.md) | +| `bl agents security overview` | API Key | Show the Agent security protection overview (last 24 hours) | [agents.md](agents.md) | +| `bl alert create` | Console | Create a model alert rule from an alert template | [alert.md](alert.md) | +| `bl alert delete` | Console | Delete model alert rules | [alert.md](alert.md) | +| `bl alert disable` | Console | Disable a model alert rule (keeps the rule, stops notifications) | [alert.md](alert.md) | +| `bl alert enable` | Console | Enable a model alert rule | [alert.md](alert.md) | +| `bl alert history` | Console | List model alert history (firing and recovered events) | [alert.md](alert.md) | +| `bl alert list` | Console | List model alert rules | [alert.md](alert.md) | +| `bl alert metrics` | Console | List metrics that alert rules can be created on, with supported aggregations | [alert.md](alert.md) | +| `bl alert template create` | Console | Create a custom alert template (or copy an official one with --from) | [alert.md](alert.md) | +| `bl alert template delete` | Console | Delete custom alert templates (official templates cannot be deleted) | [alert.md](alert.md) | +| `bl alert template list` | Console | List alert templates (official and custom); pass --template-id for details | [alert.md](alert.md) | +| `bl alert template update` | Console | Update a custom alert template (full replacement of conditions) | [alert.md](alert.md) | +| `bl alert update` | Console | Update a model alert rule (full replacement; same fields as create) | [alert.md](alert.md) | +| `bl app call` | API Key | [Deprecated] Call a Bailian application (agent or workflow) | [app.md](app.md) | +| `bl app list` | Console | [Deprecated] List Bailian applications | [app.md](app.md) | +| `bl auth generate-access-token` | No Auth | Generate a CLI access token using OpenAPI AK/SK | [auth.md](auth.md) | +| `bl auth login` | No Auth | Authenticate with API key, console browser login, or OpenAPI AK/SK (credentials can coexist) | [auth.md](auth.md) | +| `bl auth logout` | No Auth | Clear stored credentials; full logout also clears the model Base URL | [auth.md](auth.md) | +| `bl auth status` | No Auth | Show current authentication state | [auth.md](auth.md) | +| `bl batch cancel` | API Key | Request cancellation of a Batch task | [batch.md](batch.md) | +| `bl batch convert` | No Auth | Build Batch JSONL from CSV locally | [batch.md](batch.md) | +| `bl batch create` | API Key | Upload or reference input and create an asynchronous Batch task | [batch.md](batch.md) | +| `bl batch download` | API Key | Download original Batch results/errors, optionally export CSV | [batch.md](batch.md) | +| `bl batch get` | API Key | Get Batch task details, optionally following progress | [batch.md](batch.md) | +| `bl batch list` | API Key | List one page of Batch tasks | [batch.md](batch.md) | +| `bl cmodel base-models` | Console | List base models that can be imported as custom models | [cmodel.md](cmodel.md) | +| `bl cmodel delete` | API Key | Delete a custom model and its Bailian-side import record | [cmodel.md](cmodel.md) | +| `bl cmodel get` | API Key | Get details of a custom model (import job) | [cmodel.md](cmodel.md) | +| `bl cmodel import` | API Key | Import a custom model from OSS (creates an import job) | [cmodel.md](cmodel.md) | +| `bl cmodel list` | API Key | List custom models (import jobs) | [cmodel.md](cmodel.md) | +| `bl cmodel watch` | API Key | Probe a custom model's import status (default: single non-blocking fetch). Pass --follow to poll until terminal. | [cmodel.md](cmodel.md) | +| `bl config agent` | No Auth | Configure a coding agent to use DashScope API | [config.md](config.md) | +| `bl config list` | No Auth | List config profiles and show the active profile | [config.md](config.md) | +| `bl config set` | No Auth | Set a config value | [config.md](config.md) | +| `bl config show` | No Auth | Display current configuration | [config.md](config.md) | +| `bl config ui` | No Auth | Open a local web UI to manage config profiles | [config.md](config.md) | +| `bl config use` | No Auth | Set the active config profile | [config.md](config.md) | +| `bl console call` | Console | Call a Bailian console API via the CLI gateway | [console.md](console.md) | +| `bl decision` | API Key | Run the decision model: typed choice / noul / score answers with probabilities | [decision.md](decision.md) | +| `bl file upload` | API Key | Upload a local file to DashScope temporary storage (48h) | [file.md](file.md) | +| `bl file url` | Console | Resolve a Console business file key to a file URL | [file.md](file.md) | +| `bl flow-agent call` | API Key | Call a Bailian application (agent or workflow) | [flow-agent.md](flow-agent.md) | +| `bl flow-agent copy` | Console | Copy a Bailian application (agent or workflow) | [flow-agent.md](flow-agent.md) | +| `bl flow-agent create` | Console | Create a Bailian application (agent or workflow) | [flow-agent.md](flow-agent.md) | +| `bl flow-agent delete` | Console | Delete a Bailian application (agent or workflow) | [flow-agent.md](flow-agent.md) | +| `bl flow-agent get` | Console | Get Bailian application details (agent or workflow) | [flow-agent.md](flow-agent.md) | +| `bl flow-agent list` | Console | List Bailian applications | [flow-agent.md](flow-agent.md) | +| `bl flow-agent publish` | Console | Publish a Bailian agent application | [flow-agent.md](flow-agent.md) | +| `bl flow-agent update` | Console | Update a Bailian application (agent config or workflow metadata) | [flow-agent.md](flow-agent.md) | +| `bl flow-agent versions` | Console | List published versions of a Bailian application | [flow-agent.md](flow-agent.md) | +| `bl flow-agent workflow export` | Console | Export a workflow as a DSL schema (download URL) | [flow-agent.md](flow-agent.md) | +| `bl flow-agent workflow get` | Console | Get a workflow canvas (draft or a published version) | [flow-agent.md](flow-agent.md) | +| `bl flow-agent workflow publish` | Console | Publish a workflow (publishes the current draft canvas) | [flow-agent.md](flow-agent.md) | +| `bl flow-agent workflow save` | Console | Save a workflow canvas (replaces the current draft) | [flow-agent.md](flow-agent.md) | +| `bl log audit count` | Console | Count model audit logs in a time range (useful before exporting) | [log.md](log.md) | +| `bl log audit disable` | Console | Disable audit log delivery for all models in the workspace | [log.md](log.md) | +| `bl log audit enable` | Console | Enable audit log delivery to SLS (SLR authorization → SLS instance → log switch) | [log.md](log.md) | +| `bl log audit get` | Console | Show a single audit log entry with its raw origin record | [log.md](log.md) | +| `bl log audit list` | Console | Query model audit logs (call metadata; request/response content is not recorded) | [log.md](log.md) | +| `bl log inference count` | Console | Count model inference logs in a time range (useful before exporting) | [log.md](log.md) | +| `bl log inference disable` | Console | Disable inference log delivery for all models in the workspace | [log.md](log.md) | +| `bl log inference enable` | Console | Enable inference log delivery to SLS (SLR authorization → SLS instance → log switch) | [log.md](log.md) | +| `bl log inference get` | Console | Show a single inference log entry with full request/response content | [log.md](log.md) | +| `bl log inference list` | Console | Query model inference logs (requires inference log delivery; use `log inference get` for request/response content) | [log.md](log.md) | +| `bl log status` | Console | Show model log delivery status (SLS authorization, audit / inference service and switches) | [log.md](log.md) | +| `bl log trace get` | Console | Show a single call trace with its span tree | [log.md](log.md) | +| `bl log trace list` | Console | List call traces for a model or app | [log.md](log.md) | +| `bl log trace stats` | Console | Show per-resource trace statistics (calls, tokens, latency) | [log.md](log.md) | +| `bl mcp call` | API Key | Call a tool on an MCP server (tools/call) | [mcp.md](mcp.md) | +| `bl mcp connect` | API Key | Register a Bailian MCP server in an Agent's native configuration | [mcp.md](mcp.md) | +| `bl mcp disconnect` | No Auth | Remove an unchanged MCP registration previously managed by bailian-cli | [mcp.md](mcp.md) | +| `bl mcp list` | Console | List MCP servers activated under your Bailian account | [mcp.md](mcp.md) | +| `bl mcp tools` | API Key | List tools exposed by an MCP server (tools/list) | [mcp.md](mcp.md) | +| `bl model code` | No Auth | Print a ready-to-run SDK sample for calling a model | [model.md](model.md) | +| `bl model list` | No Auth | Browse model families or show detailed model info in the Bailian model marketplace | [model.md](model.md) | +| `bl model search` | No Auth | Search the model catalog by keyword, ranked by relevance | [model.md](model.md) | +| `bl monitor delivery disable` | Console | Disable monitor delivery for all models in the workspace | [monitor.md](monitor.md) | +| `bl monitor delivery enable` | Console | Activate monitoring delivery: CMS SLR authorization, CMS service, and the dedicated Prometheus instance | [monitor.md](monitor.md) | +| `bl monitor delivery status` | Console | Show monitoring delivery (Prometheus instance) status | [monitor.md](monitor.md) | +| `bl monitor errors` | Console | Show failure breakdown by HTTP status code and error code | [monitor.md](monitor.md) | +| `bl monitor metrics` | Console | Query time-series monitor metrics (RPM/TPM, latency percentiles, token usage) | [monitor.md](monitor.md) | +| `bl monitor models` | Console | List per-model / per-API-key call statistics with server-side sort and paging | [monitor.md](monitor.md) | +| `bl monitor overview` | Console | Show aggregated model call statistics (calls, failures, latency, token usage) | [monitor.md](monitor.md) | +| `bl parsex extract result` | API Key | Query ParseX extraction status, fields and citations | [parsex.md](parsex.md) | +| `bl parsex extract submit` | API Key | Submit ParseX structured field extraction | [parsex.md](parsex.md) | +| `bl parsex parse result` | API Key | Query ParseX parsing status, results or a result slice | [parsex.md](parsex.md) | +| `bl parsex parse submit` | API Key | Submit a ParseX document or media parsing task | [parsex.md](parsex.md) | +| `bl permission grant` | API Key | Grant model permissions (inference / finetune / deploy) | [permission.md](permission.md) | +| `bl permission list` | API Key | List model permissions (inference / fine-tune / deploy) in the workspace | [permission.md](permission.md) | +| `bl permission revoke` | API Key | Revoke model permissions (inference / finetune / deploy) | [permission.md](permission.md) | +| `bl pipeline run` | No Auth | Run a pipeline workflow definition | [pipeline.md](pipeline.md) | +| `bl pipeline validate` | No Auth | Validate a pipeline definition without executing | [pipeline.md](pipeline.md) | +| `bl plugin install` | No Auth | Install or upgrade an allowlisted Command Pack | [plugin.md](plugin.md) | +| `bl plugin link` | No Auth | Link an allowlisted local Command Pack for development | [plugin.md](plugin.md) | +| `bl plugin list` | No Auth | List installed Command Packs and their load status | [plugin.md](plugin.md) | +| `bl plugin remove` | No Auth | Remove an installed Command Pack | [plugin.md](plugin.md) | +| `bl quota check` | Console | Check current usage against rate limits | [quota.md](quota.md) | +| `bl quota delete` | API Key | Clear all custom rate limits (QPM/TPM) for a model | [quota.md](quota.md) | +| `bl quota history` | Console | View quota change history | [quota.md](quota.md) | +| `bl quota list` | API Key | View model rate limits (QPM/TPM, account and workspace level) | [quota.md](quota.md) | +| `bl quota update` | API Key | Update model rate limits (QPM/TPM) | [quota.md](quota.md) | +| `bl search web` | API Key | Search the web via a chat model with built-in web search (default) or the DashScope MCP WebSearch service | [search.md](search.md) | +| `bl skill add` | No Auth | Install skills from the Bailian skill registry into local agents | [skill.md](skill.md) | +| `bl skill init` | No Auth | Install all bailian-* skills (one-shot bootstrap for new environments) | [skill.md](skill.md) | +| `bl skill list` | No Auth | List registry skills and diff against local installs | [skill.md](skill.md) | +| `bl skill remove` | No Auth | Remove locally installed skills (registry is untouched) | [skill.md](skill.md) | +| `bl skill update` | No Auth | Update installed skills to the latest registry versions | [skill.md](skill.md) | +| `bl text chat` | API Key | Send a text model request (OpenAI compatible, DashScope) | [text.md](text.md) | +| `bl token-plan add-member` | AK/SK | Add a member to a Token Plan organization | [token-plan.md](token-plan.md) | +| `bl token-plan assign-seats` | AK/SK | Batch assign Token Plan seats to members | [token-plan.md](token-plan.md) | +| `bl token-plan create-key` | AK/SK | Create a Token Plan API key for a seat | [token-plan.md](token-plan.md) | +| `bl token-plan harness-quota` | Console | Show Token Plan harness entitlement quota usage | [token-plan.md](token-plan.md) | +| `bl token-plan list-seats` | AK/SK | List Token Plan subscription seat details | [token-plan.md](token-plan.md) | +| `bl update` | No Auth | Update the CLI to the latest or a specified version | [update.md](update.md) | +| `bl usage coding-plan` | Console | Show Coding Plan quota usage | [usage.md](usage.md) | +| `bl usage free` | Console | Query free-tier quota for models (all models if --model is omitted) | [usage.md](usage.md) | +| `bl usage freetier` | Console | Enable or disable auto-stop for free-tier models. Enables by default; use --off to disable | [usage.md](usage.md) | +| `bl usage stats` | Console | Query model usage statistics | [usage.md](usage.md) | +| `bl usage summary` | Console | Show a unified usage summary: free-tier quota and recent usage overview | [usage.md](usage.md) | +| `bl usage token-plan` | Console | Show Token Plan quota usage | [usage.md](usage.md) | +| `bl workspace init` | No Auth | Initialize Bailian workspace and activate postpaid services | [workspace.md](workspace.md) | +| `bl workspace list` | Console | List all workspaces | [workspace.md](workspace.md) | ## By group @@ -141,7 +143,7 @@ Use this index for the skill-scoped quick index and global flags. | `advisor` | `recommend` | [advisor.md](advisor.md) | | `agents` | `security alerts`, `security overview` | [agents.md](agents.md) | | `alert` | `create`, `delete`, `disable`, `enable`, `history`, `list`, `metrics`, `template create`, `template delete`, `template list`, `template update`, `update` | [alert.md](alert.md) | -| `app` | `call`, `copy`, `create`, `delete`, `get`, `list`, `publish`, `update`, `versions`, `workflow export`, `workflow get`, `workflow publish`, `workflow save` | [app.md](app.md) | +| `app` | `call`, `list` | [app.md](app.md) | | `auth` | `generate-access-token`, `login`, `logout`, `status` | [auth.md](auth.md) | | `batch` | `cancel`, `convert`, `create`, `download`, `get`, `list` | [batch.md](batch.md) | | `cmodel` | `base-models`, `delete`, `get`, `import`, `list`, `watch` | [cmodel.md](cmodel.md) | @@ -149,6 +151,7 @@ Use this index for the skill-scoped quick index and global flags. | `console` | `call` | [console.md](console.md) | | `decision` | `(root)` | [decision.md](decision.md) | | `file` | `upload`, `url` | [file.md](file.md) | +| `flow-agent` | `call`, `copy`, `create`, `delete`, `get`, `list`, `publish`, `update`, `versions`, `workflow export`, `workflow get`, `workflow publish`, `workflow save` | [flow-agent.md](flow-agent.md) | | `log` | `audit count`, `audit disable`, `audit enable`, `audit get`, `audit list`, `inference count`, `inference disable`, `inference enable`, `inference get`, `inference list`, `status`, `trace get`, `trace list`, `trace stats` | [log.md](log.md) | | `mcp` | `call`, `connect`, `disconnect`, `list`, `tools` | [mcp.md](mcp.md) | | `model` | `code`, `list`, `search` | [model.md](model.md) | diff --git a/skills/bailian-gen/SKILL.md b/skills/bailian-gen/SKILL.md index 4de343ce..25245601 100644 --- a/skills/bailian-gen/SKILL.md +++ b/skills/bailian-gen/SKILL.md @@ -118,7 +118,7 @@ If one or more `bl` commands actually ran, proactively add a one-line summary in 软 hand-off(按 skill **名**;已安装则 Read,否则 `--help` / 提示 `bl skill init`): - Generation failed and it is not a usage/auth/content-filter issue → follow the issue-reporting flow in `bailian-protocol` ([`../bailian-protocol/SKILL.md`](../bailian-protocol/SKILL.md#cli-errors-report-an-issue)) and ask once whether to report. -- Managing Bailian apps / knowledge bases / usage → skill `bailian-cli` (fallback: `bl app\|knowledge\|usage --help`). +- Managing Bailian apps / knowledge bases / usage → skill `bailian-cli` (fallback: `bl flow-agent\|knowledge\|usage --help`). - Train a dedicated model on user data → skill `bailian-finetune` (fallback: `bl dataset\|finetune\|deploy --help`). ## references diff --git a/skills/bailian-managed-agent/SKILL.md b/skills/bailian-managed-agent/SKILL.md index cc9ba960..83b0937a 100644 --- a/skills/bailian-managed-agent/SKILL.md +++ b/skills/bailian-managed-agent/SKILL.md @@ -11,7 +11,7 @@ description: >- `bl managed-agent`。Agent/Environment/Skill/Vault/Deployment/Memory Store 仍以 agents.yaml 为唯一事实源做 IaC;Webhook 使用无需项目文件的工作空间 API;公开 API 能力按资源透出 list/get/search/versions/download、数据面和运行时动作命令。apply / destroy 与破坏性 API 命令受统一高风险确认闸门保护; 务必先展示预览再让用户确认,禁止自动添加 `--yes`。 - 反触发:调用已上线的百炼应用/智能体走 bailian-app-call 或 `bl app`;宿主 agent 自身的记忆、技能、 + 反触发:调用已上线的百炼应用/智能体走 bailian-app-call 或 `bl flow-agent`;宿主 agent 自身的记忆、技能、 子代理不走本 skill;生图生视频走 bailian-gen。 官方安装:`bl skill init`(与共享协议 bailian-protocol 同装)。 --- @@ -241,7 +241,7 @@ Flags, usage, and examples: see [`reference/`](reference/index.md) or `bl > = { // bailian-memory — personal memory and explicit Memory resource operations memory: "bailian-memory", knowledge: "bailian-knowledge", + // bailian-cli (hub) — application / flow-agent control plane + "flow-agent": "bailian-cli", // everything else → bailian-cli (hub) }; From e13be6e70a0ed2f734e101d1d9d578978635868a Mon Sep 17 00:00:00 2001 From: "lisheng.lisheng" Date: Fri, 13 Nov 2026 12:59:00 +0800 Subject: [PATCH 2/2] chore(release): prepare 2.10.0 Bump seven packages 2.9.0 -> 2.10.0; add 2.10.0 CHANGELOG (flow-agent command group, app call/list deprecated) and restore the published 2.9.0 entry; sync SKILL metadata. --- CHANGELOG.md | 20 +++++++++++++++----- CHANGELOG.zh.md | 20 +++++++++++++++----- packages/bailian-kb-dsh/package.json | 2 +- packages/bailian-memo-dsh/package.json | 2 +- packages/cli/package.json | 2 +- packages/commands/package.json | 2 +- packages/core/package.json | 2 +- packages/kscli/package.json | 2 +- packages/runtime/package.json | 2 +- skills/bailian-cli/SKILL.md | 2 +- skills/bailian-finetune/SKILL.md | 2 +- skills/bailian-gen/SKILL.md | 2 +- skills/bailian-knowledge/SKILL.md | 2 +- skills/bailian-managed-agent/SKILL.md | 2 +- skills/bailian-memory/SKILL.md | 2 +- skills/bailian-protocol/SKILL.md | 2 +- skills/bailian-sandbox/SKILL.md | 2 +- skills/bailian-web-search/SKILL.md | 2 +- 18 files changed, 46 insertions(+), 26 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 807d53e9..be65e183 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -6,7 +6,7 @@ The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and [中文版](CHANGELOG.zh.md) · [README](README.md) · [Contributing](CONTRIBUTING.md) -## [2.9.0] - 2026-11-13 +## [2.10.0] - 2026-11-13 ### Added @@ -16,13 +16,23 @@ The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and - Agent config updates read the current draft and merge `--model` / `--instructions` / `--config-json` / `--config-file`. - `bl flow-agent list --type workflow` lists workflows using the console exclusion filter. -### Changed +### Deprecated -- **Omni default model**: `bl omni` now defaults to `qwen3.8-omni-flash` (was `qwen3.5-omni-plus`). +- **App group**: `bl app call` / `bl app list` are deprecated in favor of `bl flow-agent call` / `bl flow-agent list` and will be removed in a future release. The application control-plane commands introduced in 2.9.0 now live only under `bl flow-agent`. -### Deprecated +## [2.9.0] - 2026-11-12 + +### Added -- **App group**: `bl app call` / `bl app list` are deprecated in favor of `bl flow-agent call` / `bl flow-agent list` and will be removed in a future release. The application control-plane commands now live only under `bl flow-agent`. +- **App control-plane commands**: Manage Bailian applications from the CLI via the console gateway. + - `bl app create` / `get` / `update` / `publish` / `delete` / `copy` / `versions` for agents (app-control 2.0) and workflows; `delete` is high-risk and requires `--yes`. + - `bl app workflow get` / `save` / `publish` / `export` for workflow canvases; `save` replaces the whole draft with optimistic-lock versioning, `publish` normalizes triggers like the console editor. + - Agent config updates read the current draft and merge `--model` / `--instructions` / `--config-json` / `--config-file`. +- **App list filtering**: `bl app list --type workflow` lists workflows using the console exclusion filter. + +### Changed + +- **Omni default model**: `bl omni` now defaults to `qwen3.8-omni-flash` (was `qwen3.5-omni-plus`). ### Fixed diff --git a/CHANGELOG.zh.md b/CHANGELOG.zh.md index a753c22b..d355ba11 100644 --- a/CHANGELOG.zh.md +++ b/CHANGELOG.zh.md @@ -6,7 +6,7 @@ [English](CHANGELOG.md) · [README](README.zh.md) · [参与贡献](CONTRIBUTING.zh.md) -## [2.9.0] - 2026-11-13 +## [2.10.0] - 2026-11-13 ### 新增 @@ -16,13 +16,23 @@ - 智能体配置更新先读取当前草稿,再合并 `--model` / `--instructions` / `--config-json` / `--config-file`。 - `bl flow-agent list --type workflow` 按控制台排除法列出工作流。 -### 变更 +### 已弃用 -- **Omni 默认模型**:`bl omni` 默认模型改为 `qwen3.8-omni-flash`(原 `qwen3.5-omni-plus`)。 +- **app 组**:`bl app call` / `bl app list` 已废弃,请改用 `bl flow-agent call` / `bl flow-agent list`,将在未来版本移除。2.9.0 引入的应用控制面命令现仅位于 `bl flow-agent` 下。 -### 已弃用 +## [2.9.0] - 2026-11-12 + +### 新增 -- **app 组**:`bl app call` / `bl app list` 已废弃,请改用 `bl flow-agent call` / `bl flow-agent list`,将在未来版本移除。应用控制面命令现仅位于 `bl flow-agent` 下。 +- **应用控制面命令**:通过控制台网关在命令行管理百炼应用。 + - `bl app create` / `get` / `update` / `publish` / `delete` / `copy` / `versions`:管理智能体(app-control 2.0)与工作流;`delete` 为高风险操作,需 `--yes`。 + - `bl app workflow get` / `save` / `publish` / `export`:管理工作流画布;`save` 整幅替换草稿并带乐观锁版本,`publish` 按控制台编辑器逻辑规范化触发器。 + - 智能体配置更新先读取当前草稿,再合并 `--model` / `--instructions` / `--config-json` / `--config-file`。 +- **应用列表筛选**:`bl app list --type workflow` 按控制台排除法列出工作流。 + +### 变更 + +- **Omni 默认模型**:`bl omni` 默认模型改为 `qwen3.8-omni-flash`(原 `qwen3.5-omni-plus`)。 ### 修复 diff --git a/packages/bailian-kb-dsh/package.json b/packages/bailian-kb-dsh/package.json index c18e0fb9..f330e860 100644 --- a/packages/bailian-kb-dsh/package.json +++ b/packages/bailian-kb-dsh/package.json @@ -1,6 +1,6 @@ { "name": "bailian-kb-dsh", - "version": "2.9.0", + "version": "2.10.0", "description": "Bailian knowledge-base tools for DeepSeek Harness: kb_search and kb_chat over the DashScope RAG API, plus the bl CLI management skill.", "keywords": [ "alibaba-cloud", diff --git a/packages/bailian-memo-dsh/package.json b/packages/bailian-memo-dsh/package.json index 8366c86d..5aa5783f 100644 --- a/packages/bailian-memo-dsh/package.json +++ b/packages/bailian-memo-dsh/package.json @@ -1,6 +1,6 @@ { "name": "bailian-memo-dsh", - "version": "2.9.0", + "version": "2.10.0", "description": "Bailian personal memory for DeepSeek Harness: automatic recall, silent curation, and user-controlled remember/forget.", "keywords": [ "alibaba-cloud", diff --git a/packages/cli/package.json b/packages/cli/package.json index df95718f..04a0dd6e 100644 --- a/packages/cli/package.json +++ b/packages/cli/package.json @@ -1,6 +1,6 @@ { "name": "bailian-cli", - "version": "2.9.0", + "version": "2.10.0", "description": "CLI for Aliyun Model Studio (DashScope) AI Platform.", "keywords": [ "agent", diff --git a/packages/commands/package.json b/packages/commands/package.json index 1e33ab3d..dafdb2aa 100644 --- a/packages/commands/package.json +++ b/packages/commands/package.json @@ -1,6 +1,6 @@ { "name": "bailian-cli-commands", - "version": "2.9.0", + "version": "2.10.0", "description": "Command library for bailian-cli products (knowledge, memory, media, …). See https://www.npmjs.com/package/bailian-cli for usage.", "homepage": "https://bailian.console.aliyun.com/cli", "bugs": { diff --git a/packages/core/package.json b/packages/core/package.json index 6ff4b57e..de1aad0a 100644 --- a/packages/core/package.json +++ b/packages/core/package.json @@ -1,6 +1,6 @@ { "name": "bailian-cli-core", - "version": "2.9.0", + "version": "2.10.0", "description": "Core SDK for bailian-cli. See https://www.npmjs.com/package/bailian-cli for usage.", "homepage": "https://bailian.console.aliyun.com/cli", "bugs": { diff --git a/packages/kscli/package.json b/packages/kscli/package.json index 46acf87a..d6f5dbf1 100644 --- a/packages/kscli/package.json +++ b/packages/kscli/package.json @@ -1,6 +1,6 @@ { "name": "knowledge-studio-cli", - "version": "2.9.0", + "version": "2.10.0", "description": "Lightweight RAG CLI for Aliyun Model Studio — focused on knowledge-base retrieval.", "keywords": [ "alibaba-cloud", diff --git a/packages/runtime/package.json b/packages/runtime/package.json index 2ffea374..6e509160 100644 --- a/packages/runtime/package.json +++ b/packages/runtime/package.json @@ -1,6 +1,6 @@ { "name": "bailian-cli-runtime", - "version": "2.9.0", + "version": "2.10.0", "description": "Runtime framework for bailian-cli (createCli, registry, args, output, pipeline). See https://www.npmjs.com/package/bailian-cli for usage.", "homepage": "https://bailian.console.aliyun.com/cli", "bugs": { diff --git a/skills/bailian-cli/SKILL.md b/skills/bailian-cli/SKILL.md index 5604e25a..f86d5abf 100644 --- a/skills/bailian-cli/SKILL.md +++ b/skills/bailian-cli/SKILL.md @@ -1,7 +1,7 @@ --- name: bailian-cli metadata: - version: "2.9.0" + version: "2.10.0" requires: bins: ["bl"] description: >- diff --git a/skills/bailian-finetune/SKILL.md b/skills/bailian-finetune/SKILL.md index 4ac1a15b..263d2533 100644 --- a/skills/bailian-finetune/SKILL.md +++ b/skills/bailian-finetune/SKILL.md @@ -1,7 +1,7 @@ --- name: bailian-finetune metadata: - version: "2.9.0" + version: "2.10.0" requires: bins: ["bl"] description: >- diff --git a/skills/bailian-gen/SKILL.md b/skills/bailian-gen/SKILL.md index 25245601..26c5e20b 100644 --- a/skills/bailian-gen/SKILL.md +++ b/skills/bailian-gen/SKILL.md @@ -1,7 +1,7 @@ --- name: bailian-gen metadata: - version: "2.9.0" + version: "2.10.0" requires: bins: ["bl"] description: >- diff --git a/skills/bailian-knowledge/SKILL.md b/skills/bailian-knowledge/SKILL.md index ef7d4086..9f81d90a 100644 --- a/skills/bailian-knowledge/SKILL.md +++ b/skills/bailian-knowledge/SKILL.md @@ -1,7 +1,7 @@ --- name: bailian-knowledge metadata: - version: "2.9.0" + version: "2.10.0" requires: bins: ["bl"] description: >- diff --git a/skills/bailian-managed-agent/SKILL.md b/skills/bailian-managed-agent/SKILL.md index 83b0937a..771dd715 100644 --- a/skills/bailian-managed-agent/SKILL.md +++ b/skills/bailian-managed-agent/SKILL.md @@ -1,7 +1,7 @@ --- name: bailian-managed-agent metadata: - version: "2.9.0" + version: "2.10.0" requires: bins: ["bl"] description: >- diff --git a/skills/bailian-memory/SKILL.md b/skills/bailian-memory/SKILL.md index 8edba5d2..fe906f0c 100644 --- a/skills/bailian-memory/SKILL.md +++ b/skills/bailian-memory/SKILL.md @@ -1,7 +1,7 @@ --- name: bailian-memory metadata: - version: "2.9.0" + version: "2.10.0" requires: bins: ["bl"] description: >- diff --git a/skills/bailian-protocol/SKILL.md b/skills/bailian-protocol/SKILL.md index c62da942..9198fe59 100644 --- a/skills/bailian-protocol/SKILL.md +++ b/skills/bailian-protocol/SKILL.md @@ -1,7 +1,7 @@ --- name: bailian-protocol metadata: - version: "2.9.0" + version: "2.10.0" requires: bins: ["bl"] description: >- diff --git a/skills/bailian-sandbox/SKILL.md b/skills/bailian-sandbox/SKILL.md index ce52ddf6..5e0624e2 100644 --- a/skills/bailian-sandbox/SKILL.md +++ b/skills/bailian-sandbox/SKILL.md @@ -1,7 +1,7 @@ --- name: bailian-sandbox metadata: - version: "2.9.0" + version: "2.10.0" requires: bins: ["bl"] description: >- diff --git a/skills/bailian-web-search/SKILL.md b/skills/bailian-web-search/SKILL.md index f17e18ad..50c35916 100644 --- a/skills/bailian-web-search/SKILL.md +++ b/skills/bailian-web-search/SKILL.md @@ -1,7 +1,7 @@ --- name: bailian-web-search metadata: - version: "2.9.0" + version: "2.10.0" requires: bins: ["bl"] description: >-