From 176961dc56a5fd48e8bf68dbae36cc1ecd3704f0 Mon Sep 17 00:00:00 2001 From: chenanran555 Date: Wed, 2 Sep 2026 15:33:50 +0800 Subject: [PATCH] feat(managed-agent): hide capabilities command from public CLI --- packages/cli/src/commands.ts | 2 - .../commands/managed-agent/capabilities.ts | 49 ------------------- packages/commands/src/index.ts | 1 - .../tests/e2e/managed-agent.e2e.test.ts | 28 ----------- packages/commands/tests/e2e/topic-routes.ts | 1 - skills/bailian-managed-agent/SKILL.md | 3 +- .../bailian-managed-agent/reference/index.md | 7 ++- .../reference/managed-agent.md | 30 ------------ 8 files changed, 4 insertions(+), 117 deletions(-) delete mode 100644 packages/commands/src/commands/managed-agent/capabilities.ts diff --git a/packages/cli/src/commands.ts b/packages/cli/src/commands.ts index 40978fe..309b5d6 100644 --- a/packages/cli/src/commands.ts +++ b/packages/cli/src/commands.ts @@ -152,7 +152,6 @@ import { managedAgentSessionSend, managedAgentSessionEvents, managedAgentSkillList, - managedAgentCapabilities, managedAgentAgentCreate, managedAgentEnvironmentCreate, managedAgentSkillCreate, @@ -357,7 +356,6 @@ export const commands: Record = { "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, diff --git a/packages/commands/src/commands/managed-agent/capabilities.ts b/packages/commands/src/commands/managed-agent/capabilities.ts deleted file mode 100644 index 77e3167..0000000 --- a/packages/commands/src/commands/managed-agent/capabilities.ts +++ /dev/null @@ -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: "", - 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 ]", - 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); - } - }, -}); diff --git a/packages/commands/src/index.ts b/packages/commands/src/index.ts index ccdebf5..0eb21c4 100644 --- a/packages/commands/src/index.ts +++ b/packages/commands/src/index.ts @@ -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"; diff --git a/packages/commands/tests/e2e/managed-agent.e2e.test.ts b/packages/commands/tests/e2e/managed-agent.e2e.test.ts index 022f7b5..6b925b3 100644 --- a/packages/commands/tests/e2e/managed-agent.e2e.test.ts +++ b/packages/commands/tests/e2e/managed-agent.e2e.test.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; - }>(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"]], diff --git a/packages/commands/tests/e2e/topic-routes.ts b/packages/commands/tests/e2e/topic-routes.ts index 89ac236..18e6279 100644 --- a/packages/commands/tests/e2e/topic-routes.ts +++ b/packages/commands/tests/e2e/topic-routes.ts @@ -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", diff --git a/skills/bailian-managed-agent/SKILL.md b/skills/bailian-managed-agent/SKILL.md index 76eefeb..81441d9 100644 --- a/skills/bailian-managed-agent/SKILL.md +++ b/skills/bailian-managed-agent/SKILL.md @@ -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 diff --git a/skills/bailian-managed-agent/reference/index.md b/skills/bailian-managed-agent/reference/index.md index d019fdf..6d2d373 100644 --- a/skills/bailian-managed-agent/reference/index.md +++ b/skills/bailian-managed-agent/reference/index.md @@ -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 diff --git a/skills/bailian-managed-agent/reference/managed-agent.md b/skills/bailian-managed-agent/reference/managed-agent.md index aca615d..7a9d53c 100644 --- a/skills/bailian-managed-agent/reference/managed-agent.md +++ b/skills/bailian-managed-agent/reference/managed-agent.md @@ -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 ]` | - -#### Flags - -| Flag | Type | Required | Description | -| ------------------- | ------ | -------- | -------------------------------------- | -| `--provider ` | 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 |