feat(agent): rename cli command to managed-agent

Author: chenanran555

docs/agents/auth-change.md

@@ -55,7 +55,7 @@ defineCommand({ auth }) → runtime/authStage → ctx.client → command.run(ctx
 
 ### 例外:agent 命令的 SDK 凭证桥接
 
-`bl agent *` 命令声明 `auth: "none"`,凭证由 `@openagentpack/sdk` 自主从 env 解析(agents.yaml 的 `${DASHSCOPE_API_KEY}` / `${BAILIAN_WORKSPACE_ID}` 插值)。为让 bl 登录态复用,`packages/commands/src/commands/agent/_engine/credentials.ts` 的 `bridgeBailianCredentials()` 会**直接 `readConfigFile()`**,把 config 的 `api_key` / `workspace_id` 作为最低优先级兜底填入对应 env,仅填空值,不覆盖已有。这是唯一允许命令层直接读 config 的场景(SDK 只认 env,不走 `ctx.client`);优先级链:`~/.agents/config.json` > shell env > `.env` > `~/.bailian/config.json`。
+`bl managed-agent *` 命令声明 `auth: "none"`,凭证由 `@openagentpack/sdk` 自主从 env 解析(agents.yaml 的 `${DASHSCOPE_API_KEY}` / `${BAILIAN_WORKSPACE_ID}` 插值)。为让 bl 登录态复用,`packages/commands/src/commands/managed-agent/_engine/credentials.ts` 的 `bridgeBailianCredentials()` 会**直接 `readConfigFile()`**,把 config 的 `api_key` / `workspace_id` 作为最低优先级兜底填入对应 env,仅填空值,不覆盖已有。这是唯一允许命令层直接读 config 的场景(SDK 只认 env,不走 `ctx.client`);优先级链:`~/.agents/config.json` > shell env > `.env` > `~/.bailian/config.json`。
 
 ## 必查清单
 

packages/cli/agents.yaml

@@ -0,0 +1,27 @@
+version: "1"
+
+providers:
+  bailian:
+    # bl auth login --api-key <key> sets DASHSCOPE_API_KEY; --agentstudio-base-url <url> sets BAILIAN_BASE_URL
+    api_key: ${DASHSCOPE_API_KEY}
+    base_url: ${BAILIAN_BASE_URL}
+
+defaults:
+  provider: bailian
+
+environments:
+  dev:
+    config:
+      type: cloud
+      networking:
+        type: unrestricted
+
+agents:
+  assistant:
+    description: "General-purpose assistant"
+    model: qwen3.7-max
+    instructions: |
+      You are a helpful assistant.
+    environment: dev
+    tools:
+      builtin: [bash, read, glob, grep]

packages/cli/src/commands.ts

@@ -89,22 +89,22 @@ import {
   pluginLink,
   pluginList,
   pluginRemove,
-  agentInit,
-  agentValidate,
-  agentPlan,
-  agentApply,
-  agentDestroy,
-  agentStateList,
-  agentStateShow,
-  agentStateRm,
-  agentStateImport,
-  agentSessionCreate,
-  agentSessionList,
-  agentSessionGet,
-  agentSessionDelete,
-  agentSessionRun,
-  agentSessionSend,
-  agentSessionEvents,
+  managedAgentInit,
+  managedAgentValidate,
+  managedAgentPlan,
+  managedAgentApply,
+  managedAgentDestroy,
+  managedAgentStateList,
+  managedAgentStateShow,
+  managedAgentStateRm,
+  managedAgentStateImport,
+  managedAgentSessionCreate,
+  managedAgentSessionList,
+  managedAgentSessionGet,
+  managedAgentSessionDelete,
+  managedAgentSessionRun,
+  managedAgentSessionSend,
+  managedAgentSessionEvents,
 } from "bailian-cli-commands";
 
 // Full bailian-cli product: every command, exposed under the `bl` binary.
@@ -202,20 +202,20 @@ export const commands: Record<string, AnyCommand> = {
   "plugin link": pluginLink,
   "plugin list": pluginList,
   "plugin remove": pluginRemove,
-  "agent init": agentInit,
-  "agent validate": agentValidate,
-  "agent plan": agentPlan,
-  "agent apply": agentApply,
-  "agent destroy": agentDestroy,
-  "agent state list": agentStateList,
-  "agent state show": agentStateShow,
-  "agent state rm": agentStateRm,
-  "agent state import": agentStateImport,
-  "agent session create": agentSessionCreate,
-  "agent session list": agentSessionList,
-  "agent session get": agentSessionGet,
-  "agent session delete": agentSessionDelete,
-  "agent session run": agentSessionRun,
-  "agent session send": agentSessionSend,
-  "agent session events": agentSessionEvents,
+  "managed-agent init": managedAgentInit,
+  "managed-agent validate": managedAgentValidate,
+  "managed-agent plan": managedAgentPlan,
+  "managed-agent apply": managedAgentApply,
+  "managed-agent destroy": managedAgentDestroy,
+  "managed-agent state list": managedAgentStateList,
+  "managed-agent state show": managedAgentStateShow,
+  "managed-agent state rm": managedAgentStateRm,
+  "managed-agent state import": managedAgentStateImport,
+  "managed-agent session create": managedAgentSessionCreate,
+  "managed-agent session list": managedAgentSessionList,
+  "managed-agent session get": managedAgentSessionGet,
+  "managed-agent session delete": managedAgentSessionDelete,
+  "managed-agent session run": managedAgentSessionRun,
+  "managed-agent session send": managedAgentSessionSend,
+  "managed-agent session events": managedAgentSessionEvents,
 };

packages/commands/src/commands/auth/login.ts

@@ -21,7 +21,11 @@ export default defineCommand({
   usageArgs:
     "--api-key <key> | --console | --open-api --access-key-id <id> --access-key-secret <secret>",
   flags: {
-    apiKey: { type: "string", valueHint: "<key>", description: "Model API key to store" },
+    apiKey: {
+      type: "string",
+      valueHint: "<key>",
+      description: "Model API key to store",
+    },
     baseUrl: {
       type: "string",
       valueHint: "<url>",
@@ -31,7 +35,7 @@ export default defineCommand({
       type: "string",
       valueHint: "<url>",
       description:
-        "Bailian AgentStudio base URL for `bl agent` commands (sets BAILIAN_BASE_URL; used with --api-key)",
+        "Bailian AgentStudio base URL for `bl managed-agent` commands (sets BAILIAN_BASE_URL; used with --api-key)",
     },
     console: {
       type: "switch",

…/commands/agent/_engine/address-utils.ts …s/managed-agent/_engine/address-utils.tspackages/commands/src/commands/agent/_engine/address-utils.ts renamed to packages/commands/src/commands/managed-agent/_engine/address-utils.ts packages/commands/src/commands/agent/_engine/address-utils.ts renamed to packages/commands/src/commands/managed-agent/_engine/address-utils.ts

@@ -20,7 +20,7 @@ export const CREDENTIALS_NOTE = [
  * the bailian provider. bl persists `api_key` / `agentstudio_base_url` in
  * `~/.bailian/config.json` (via `bl auth login`); mirror them onto
  * `DASHSCOPE_API_KEY` / `BAILIAN_BASE_URL` so users don't have to re-declare the
- * same credentials for `bl agent *`. `workspace_id` is still bridged for configs
+ * same credentials for `bl managed-agent *`. `workspace_id` is still bridged for configs
  * that predate the base_url flow (the SDK accepts either).
  *
  * Lowest priority: only fills a var that is still unset, so anything already in