feat(managed-agent): hide capabilities command from public CLI

This commit is contained in:
chenanran555
2026-09-02 15:33:50 +08:00
parent 9d19558645
commit 176961dc56
8 changed files with 4 additions and 117 deletions
-2
View File
@@ -152,7 +152,6 @@ import {
managedAgentSessionSend,
managedAgentSessionEvents,
managedAgentSkillList,
managedAgentCapabilities,
managedAgentAgentCreate,
managedAgentEnvironmentCreate,
managedAgentSkillCreate,
@@ -357,7 +356,6 @@ export const commands: Record<string, AnyCommand> = {
"managed-agent session send": managedAgentSessionSend,
"managed-agent session events": managedAgentSessionEvents,
"managed-agent skill-list": managedAgentSkillList,
"managed-agent capabilities": managedAgentCapabilities,
"managed-agent agent create": managedAgentAgentCreate,
"managed-agent agent list": managedAgentAgentList,
"managed-agent agent get": managedAgentAgentGet,
@@ -1,49 +0,0 @@
import { getManagedAgentProviderCapabilities } from "@openagentpack/sdk";
import { defineCommand, detectOutputFormat } from "bailian-cli-core";
import { emitBare, emitResult, formatTable } from "bailian-cli-runtime";
const FLAGS = {
provider: {
type: "string",
valueHint: "<name>",
description: {
"en-US": "Provider to inspect (default: bailian)",
"zh-CN": "要检查的 Provider(默认:bailian)",
},
},
} as const;
export default defineCommand({
description: {
"en-US": "Show operation-level Managed Agents API capabilities",
"zh-CN": "显示 Managed Agents API 的操作级能力",
},
auth: "none",
usageArgs: "[--provider <name>]",
flags: FLAGS,
exampleArgs: ["", "--provider bailian --output json"],
notes: [
{
"en-US":
"Capabilities distinguish public Managed Agents APIs from client-side compositions and unsupported resources.",
"zh-CN": "Capabilities 会区分公开 Managed Agents API、客户端组合能力和不支持的资源。",
},
],
async run(ctx) {
const format = detectOutputFormat(ctx.settings.output);
const capabilities = getManagedAgentProviderCapabilities(ctx.flags.provider ?? "bailian");
if (format === "json") {
emitResult(capabilities, format);
return;
}
const rows = Object.entries(capabilities.operations).map(([operation, capability]) => [
operation,
capability.supported ? "yes" : "no",
capability.auth ?? "-",
capability.reason ?? "-",
]);
for (const line of formatTable(["OPERATION", "SUPPORTED", "AUTH", "REASON"], rows)) {
emitBare(line);
}
},
});
-1
View File
@@ -149,7 +149,6 @@ export { default as managedAgentSessionRun } from "./commands/managed-agent/sess
export { default as managedAgentSessionSend } from "./commands/managed-agent/session-send.ts";
export { default as managedAgentSessionEvents } from "./commands/managed-agent/session-events.ts";
export { default as managedAgentSkillList } from "./commands/managed-agent/skill-list.ts";
export { default as managedAgentCapabilities } from "./commands/managed-agent/capabilities.ts";
export { default as managedAgentAgentCreate } from "./commands/managed-agent/agent/create.ts";
export { default as managedAgentEnvironmentCreate } from "./commands/managed-agent/environment/create.ts";
export { default as managedAgentSkillCreate } from "./commands/managed-agent/skill/create.ts";
@@ -1166,34 +1166,6 @@ vaults:
});
describe("e2e: managed-agent(--dry-run 短路,不联网不写盘)", () => {
test("capabilities 明确区分 Session Event 与独立 Thread API", async () => {
const { stdout, stderr, exitCode } = await runCommandE2e(MANAGED_AGENT_ROUTES, [
"managed-agent",
"capabilities",
"--output",
"json",
]);
expect(exitCode, stderr).toBe(0);
const data = parseStdoutJson<{
operations?: Record<string, { supported?: boolean; auth?: string; reason?: string }>;
}>(stdout);
for (const operation of [
"agent.create",
"environment.create",
"skill.create",
"vault.create",
"vault.credential.create",
"deployment.create",
]) {
expect(data.operations?.[operation]).toEqual(
expect.objectContaining({ supported: true, auth: "api_key" }),
);
}
expect(data.operations?.["session.event.list"]?.supported).toBe(true);
expect(data.operations?.["session_thread.list"]?.supported).toBe(false);
expect(data.operations?.["session_thread.list"]?.reason).toMatch(/no independent Thread/i);
});
test.each([
["session archive", ["session", "archive", "--session-id", "sess_e2e"]],
["session update", ["session", "update", "--session-id", "sess_e2e", "--title", "new"]],
@@ -199,7 +199,6 @@ export const MANAGED_AGENT_ROUTES: E2eRouteExports = {
"managed-agent session list": "managedAgentSessionList",
"managed-agent session events": "managedAgentSessionEvents",
"managed-agent skill-list": "managedAgentSkillList",
"managed-agent capabilities": "managedAgentCapabilities",
"managed-agent agent create": "managedAgentAgentCreate",
"managed-agent agent list": "managedAgentAgentList",
"managed-agent agent get": "managedAgentAgentGet",
+1 -2
View File
@@ -127,7 +127,6 @@ Managed Agents 的子线程通过 Event 中的 `session_thread_id` 暴露;公
| Intent | Command family |
| -------------------------------------- | ------------------------------------------------------------------------------------------------------- |
| Check exact API support/auth/reason | `bl managed-agent capabilities` |
| Discover agents and versions | `agent list`, `agent get`, `agent search`, `agent versions` |
| Discover environments | `environment list`, `environment get`, `environment search` |
| Discover skills and download a version | `skill list`, `skill get`, `skill search`, `skill versions`, `skill download` |
@@ -143,7 +142,7 @@ Managed Agents 的子线程通过 Event 中的 `session_thread_id` 暴露;公
- 客户端搜索默认最多扫描 10 页;需要扩大范围时显式传 `--page-limit`。Deployment 搜索直接映射服务端 `keyword`。
- 下载必须给出 `--output-file`;默认不覆盖已有文件,只有用户确认后才可加 `--force`。
- `session export` 只导出诊断元数据,不含 File 正文,并会脱敏凭证类字段。
- 公开 Managed Agents API 没有模型 Catalog,也没有 MCP OAuth Login;以 `capabilities` 返回的 unsupported 原因为准。
- 公开 Managed Agents API 没有模型 Catalog,也没有 MCP OAuth Login;CLI 不注册对应命令。
## Local state management
@@ -17,7 +17,6 @@ Use this index for the skill-scoped quick index and global flags.
| `bl managed-agent agent search` | API Key | Search Managed Agents | [managed-agent.md](managed-agent.md) |
| `bl managed-agent agent versions` | API Key | List Managed Agent versions | [managed-agent.md](managed-agent.md) |
| `bl managed-agent apply` | API Key | Apply planned changes to create/update/delete agent resources | [managed-agent.md](managed-agent.md) |
| `bl managed-agent capabilities` | No Auth | Show operation-level Managed Agents API capabilities | [managed-agent.md](managed-agent.md) |
| `bl managed-agent deployment create` | API Key | Declare and create one Managed Agent Deployment through a scoped YAML apply | [managed-agent.md](managed-agent.md) |
| `bl managed-agent deployment get` | API Key | Get a Managed Agent deployment | [managed-agent.md](managed-agent.md) |
| `bl managed-agent deployment list` | API Key | List Managed Agent deployments | [managed-agent.md](managed-agent.md) |
@@ -75,9 +74,9 @@ Use this index for the skill-scoped quick index and global flags.
## By group
| Group | Commands | Reference |
| --------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------ |
| `managed-agent` | `agent create`, `agent get`, `agent list`, `agent search`, `agent versions`, `apply`, `capabilities`, `deployment create`, `deployment get`, `deployment list`, `deployment pause`, `deployment run`, `deployment runs get`, `deployment runs list`, `deployment search`, `deployment unpause`, `destroy`, `environment create`, `environment get`, `environment list`, `environment search`, `file delete`, `file download`, `file get`, `file list`, `file search`, `file upload`, `init`, `plan`, `session archive`, `session create`, `session debug`, `session delete`, `session event list`, `session event send`, `session event stream`, `session events`, `session export`, `session get`, `session list`, `session run`, `session search`, `session send`, `session update`, `skill create`, `skill download`, `skill get`, `skill list`, `skill search`, `skill versions`, `skill-list`, `state import`, `state list`, `state rm`, `state show`, `validate`, `vault create`, `vault credential create`, `vault get`, `vault list`, `vault search` | [managed-agent.md](managed-agent.md) |
| Group | Commands | Reference |
| --------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------ |
| `managed-agent` | `agent create`, `agent get`, `agent list`, `agent search`, `agent versions`, `apply`, `deployment create`, `deployment get`, `deployment list`, `deployment pause`, `deployment run`, `deployment runs get`, `deployment runs list`, `deployment search`, `deployment unpause`, `destroy`, `environment create`, `environment get`, `environment list`, `environment search`, `file delete`, `file download`, `file get`, `file list`, `file search`, `file upload`, `init`, `plan`, `session archive`, `session create`, `session debug`, `session delete`, `session event list`, `session event send`, `session event stream`, `session events`, `session export`, `session get`, `session list`, `session run`, `session search`, `session send`, `session update`, `skill create`, `skill download`, `skill get`, `skill list`, `skill search`, `skill versions`, `skill-list`, `state import`, `state list`, `state rm`, `state show`, `validate`, `vault create`, `vault credential create`, `vault get`, `vault list`, `vault search` | [managed-agent.md](managed-agent.md) |
## Global flags
@@ -15,7 +15,6 @@ Index: [index.md](index.md)
| `bl managed-agent agent search` | API Key | Search Managed Agents |
| `bl managed-agent agent versions` | API Key | List Managed Agent versions |
| `bl managed-agent apply` | API Key | Apply planned changes to create/update/delete agent resources |
| `bl managed-agent capabilities` | No Auth | Show operation-level Managed Agents API capabilities |
| `bl managed-agent deployment create` | API Key | Declare and create one Managed Agent Deployment through a scoped YAML apply |
| `bl managed-agent deployment get` | API Key | Get a Managed Agent deployment |
| `bl managed-agent deployment list` | API Key | List Managed Agent deployments |
@@ -324,35 +323,6 @@ bl managed-agent apply --yes
bl managed-agent apply --provider bailian --yes
```
### `bl managed-agent capabilities`
| Field | Value |
| ------------------ | ---------------------------------------------------- |
| **Name** | `managed-agent capabilities` |
| **Description** | Show operation-level Managed Agents API capabilities |
| **Authentication** | No Auth |
| **Usage** | `bl managed-agent capabilities [--provider <name>]` |
#### Flags
| Flag | Type | Required | Description |
| ------------------- | ------ | -------- | -------------------------------------- |
| `--provider <name>` | string | no | Provider to inspect (default: bailian) |
#### Notes
- Capabilities distinguish public Managed Agents APIs from client-side compositions and unsupported resources.
#### Examples
```bash
bl managed-agent capabilities
```
```bash
bl managed-agent capabilities --provider bailian --output json
```
### `bl managed-agent deployment create`
| Field | Value |