bailian-cli-core 1.6.1 → 1.7.0

package/dist/index.d.mts

@@ -38,6 +38,10 @@ declare class BailianError extends Error {
     };
   };
 }
+/** Invalid usage: unknown command, bad/unknown flag, missing required, failed validation. */
+declare class UsageError extends BailianError {
+  constructor(message: string, hint?: string);
+}
 //#endregion
 //#region src/errors/api.d.ts
 interface ApiErrorBody {
@@ -93,6 +97,14 @@ interface ChatTool {
     parameters: Record<string, unknown>;
   };
 }
+interface ChatResponseFormat {
+  type: "json_object" | "json_schema";
+  json_schema?: {
+    name: string;
+    schema?: Record<string, unknown>;
+    strict?: boolean;
+  };
+}
 interface ChatRequest {
   model: string;
   messages: ChatMessage[];
@@ -117,6 +129,7 @@ interface ChatRequest {
   stream_options?: {
     include_usage?: boolean;
   };
+  response_format?: ChatResponseFormat;
 }
 interface ChatChoice {
   index: number;
@@ -182,6 +195,47 @@ interface StreamChunk {
     total_tokens: number;
   };
 }
+/**
+ * Request body for `tongyi-intent-detect-v3` via the DashScope-native
+ * text-generation endpoint. Uses `{ model, input, parameters }` shape —
+ * NOT the OpenAI `{ model, messages }` shape.
+ */
+interface DashScopeIntentDetectRequest {
+  model: string;
+  input: {
+    messages: Array<{
+      role: "system" | "user" | "assistant";
+      content: string;
+    }>;
+  };
+  parameters?: {
+    result_format?: "message";
+    max_tokens?: number;
+    temperature?: number;
+  };
+}
+/**
+ * Response envelope from the DashScope-native text-generation endpoint with
+ * `result_format: "message"`. The model's output lives under `output.choices`,
+ * mirroring the OpenAI shape but nested one level deeper.
+ */
+interface DashScopeIntentDetectResponse {
+  output: {
+    choices?: Array<{
+      finish_reason: string;
+      message: {
+        role: string;
+        content: string;
+      };
+    }>;
+  };
+  usage?: {
+    total_tokens?: number;
+    input_tokens?: number;
+    output_tokens?: number;
+  };
+  request_id: string;
+}
 interface DashScopeImageRequest {
   model: string;
   input: {
@@ -412,38 +466,6 @@ interface UserProfileResponse {
     attributes: ProfileAttribute[];
   };
 }
-interface KnowledgeRetrieveRequest {
-  IndexId: string;
-  Query: string;
-  DenseSimilarityTopK?: number;
-  SparseSimilarityTopK?: number;
-  EnableReranking?: boolean;
-  EnableRewrite?: boolean;
-  RerankTopN?: number;
-  TopK?: number;
-  Rerank?: Array<{
-    ModelName?: string;
-    RerankMode?: string;
-    RerankInstruct?: string;
-  }>;
-  RerankTopN_legacy?: number;
-  SearchFilters?: Array<{
-    Key: string;
-    Value: string;
-    Operator: string;
-  }>;
-}
-interface KnowledgeRetrieveResponse {
-  Success: boolean;
-  RequestId: string;
-  Data: {
-    Nodes: Array<{
-      Text: string;
-      Score: number;
-      Metadata: Record<string, unknown>;
-    }>;
-  };
-}
 interface DashScopeKnowledgeRetrieveRequest {
   index_id: string;
   query: string;
@@ -666,11 +688,6 @@ interface DashScopeTaskResponse {
   request_id: string;
 }
 //#endregion
-//#region src/auth/credentials.d.ts
-declare function loadApiKeyFromConfig(): string | null;
-declare function saveApiKeyToConfig(apiKey: string): Promise<void>;
-declare function clearApiKey(): Promise<void>;
-//#endregion
 //#region src/config/schema.d.ts
 declare const REGIONS: {
   readonly cn: "https://dashscope.aliyuncs.com";
@@ -688,7 +705,17 @@ interface ConfigFile {
   api_key?: string;
   /** OAuth-style token from `bl auth login --console` callback; sent as `Authorization: Bearer …` */
   access_token?: string;
+  /** Alibaba Cloud OpenAPI AccessKey ID from `bl auth login --open-api`. */
+  access_key_id?: string;
+  /** Alibaba Cloud OpenAPI AccessKey secret from `bl auth login --open-api`. */
+  access_key_secret?: string;
   base_url?: string;
+  /**
+   * Dedicated base URL for the intent-detect model (tongyi-intent-detect-v3).
+   * Allows pointing the intent API at a different region/workspace than the
+   * main chat endpoint. Falls back to `base_url` when not set.
+   */
+  intent_detect_base_url?: string;
   output?: "text" | "json";
   output_dir?: string;
   timeout?: number;
@@ -697,8 +724,6 @@ interface ConfigFile {
   default_image_model?: string;
   default_speech_model?: string;
   default_omni_model?: string;
-  access_key_id?: string;
-  access_key_secret?: string;
   workspace_id?: string;
   console_site?: "domestic" | "international";
   console_region?: string;
@@ -706,22 +731,32 @@ interface ConfigFile {
   telemetry?: boolean;
 }
 declare function parseConfigFile(raw: unknown): ConfigFile;
-interface Config {
-  clientName?: string;
-  clientVersion?: string;
-  /** Product binary name (e.g. "bl", "rag"), injected by createCli for command-facing output. */
-  binName?: string;
-  /** npm package name for self-update (e.g. "bailian-cli", "bailian-cli-rag"), injected by createCli. */
-  npmPackage?: string;
-  apiKey?: string;
-  /** `DASHSCOPE_ACCESS_TOKEN` env (explicit override). */
-  accessTokenEnv?: string;
-  /** `access_token` in config file (console login). */
-  fileAccessToken?: string;
-  fileApiKey?: string;
+/** 静态产品身份,createCli 注入一次(bl/rag 各异,故注入而非模块常量)。 */
+interface Identity {
+  /** Product binary name, e.g. "bl", "rag". */
+  binName: string;
+  version: string;
+  /** npm package name for self-update, e.g. "bailian-cli". */
+  npmPackage: string;
+  /** User-Agent / telemetry client name. */
+  clientName: string;
+}
+/**
+ * 命令唯一会读的配置面(flag/env/file 解析后的有效值)。
+ * 不含身份(Identity)、不含秘密(credential);console 三元组为 dry-run 展示保留,
+ * 真实调用走 ConsoleCredential(同链解析,受控重叠)。
+ */
+interface Settings {
   configPath?: string;
-  baseUrl: string;
+  /** Dedicated base URL for intent-detect model; falls back to the model baseUrl at call site. */
+  intentDetectBaseUrl?: string;
   output: "text" | "json";
+  /**
+   * Whether `output` came from an explicit source (flag/env/file) rather than
+   * the default. Commands whose default format differs from the global default
+   * (e.g. `advisor recommend` defaults to json) branch on this.
+   */
+  outputExplicit: boolean;
   outputDir?: string;
   timeout: number;
   defaultTextModel?: string;
@@ -729,100 +764,93 @@ interface Config {
   defaultImageModel?: string;
   defaultSpeechModel?: string;
   defaultOmniModel?: string;
-  accessKeyId?: string;
-  accessKeySecret?: string;
   workspaceId?: string;
-  consoleSite?: "domestic" | "international";
   consoleRegion?: string;
+  consoleSite?: "domestic" | "international";
   consoleSwitchAgent?: number;
   verbose: boolean;
   quiet: boolean;
-  noColor: boolean;
-  yes: boolean;
   dryRun: boolean;
-  nonInteractive: boolean;
-  async: boolean;
   telemetry: boolean;
 }
 //#endregion
-//#region src/auth/types.d.ts
-type AuthMethod = "api-key" | "access-token";
-interface ResolvedCredential {
-  token: string;
-  method: AuthMethod;
-  source: string;
-}
-//#endregion
-//#region src/auth/resolver.d.ts
-declare function resolveCredential(config: Config): Promise<ResolvedCredential>;
+//#region src/config/store.d.ts
 /**
- * Credential for Bailian **console** CLI gateway only (`callConsoleGateway`).
- * DashScope API keys are not valid Bearer tokens for this gateway — use env/file
- * `access_token` even when `api_key` is also present in config.
+ * config 命令族的持久化能力面(lint 限定 commands/config/** 使用)。
+ * 读写都直达磁盘(非 dispatch 时的快照),与现有 config set/show 的行为一致。
  */
-/** Thrown when `callConsoleGateway` has no usable console session token. */
-declare const CONSOLE_GATEWAY_NO_TOKEN_MESSAGE = "No console access token found.";
-declare function resolveConsoleGatewayCredential(config: Config): Promise<ResolvedCredential>;
+interface ConfigStore {
+  read(): ConfigFile;
+  /** 合并写入;patch 里值为 undefined 的键会被删除。 */
+  write(patch: Partial<ConfigFile>): Promise<void>;
+  /** 删除指定键。 */
+  unset(keys: (keyof ConfigFile)[]): Promise<void>;
+  path: string;
+}
+declare function makeConfigStore(): ConfigStore;
 //#endregion
-//#region src/client/ak-sign.d.ts
-/**
- * Alibaba Cloud V3 Signature (ROA style) for Bailian Cloud API.
- *
- * Used by Knowledge Base Retrieve API which requires AK/SK authentication
- * instead of Bearer token.
- *
- * Reference: https://help.aliyun.com/document_detail/2712195.html
- */
-interface AkSignConfig {
+//#region src/auth/types.d.ts
+/** Where a resolved credential came from (shown by `bl auth status`). */
+type CredentialSource = "flag" | "env" | "config";
+/** Credential for the **model domain** (DashScope data plane). Always an API key. */
+interface ApiKeyCredential {
+  token: string;
+  /** Base URL to send this key's requests to. */
+  baseUrl: string;
+  source: CredentialSource;
+}
+/** Credential for the **console domain** (Bailian console gateway). An access token + region/site. */
+interface ConsoleCredential {
+  token: string;
+  region: string;
+  site: "domestic" | "international";
+  switchAgent?: number;
+  source: CredentialSource;
+}
+/** Credential for Alibaba Cloud OpenAPI calls signed with AK/SK. */
+interface OpenApiCredential {
   accessKeyId: string;
   accessKeySecret: string;
-  action: string;
-  version: string;
-  body: string;
-  host: string;
-  pathname: string;
-  method?: string;
+  source: CredentialSource;
+}
+/** Full auth snapshot for display (`bl auth status`) — what would resolve per domain. */
+interface AuthState {
+  apiKey?: ApiKeyCredential;
+  console?: ConsoleCredential;
+  openapi?: OpenApiCredential;
 }
-declare function signRequest(cfg: AkSignConfig): Record<string, string>;
-//#endregion
-//#region src/client/endpoints.d.ts
-declare function chatEndpoint(baseUrl: string): string;
-declare function imageEndpoint(baseUrl: string): string;
-declare function imageSyncEndpoint(baseUrl: string): string;
-declare function videoGenerateEndpoint(baseUrl: string): string;
-declare function taskEndpoint(baseUrl: string, taskId: string): string;
-declare function appCompletionEndpoint(baseUrl: string, appId: string): string;
-declare function memoryAddEndpoint(baseUrl: string): string;
-declare function memorySearchEndpoint(baseUrl: string): string;
-declare function memoryListEndpoint(baseUrl: string): string;
-declare function memoryNodeEndpoint(baseUrl: string, nodeId: string): string;
-declare function speechSynthesizeEndpoint(baseUrl: string): string;
-declare function speechRecognizeEndpoint(baseUrl: string): string;
-declare function profileSchemaEndpoint(baseUrl: string): string;
-declare function userProfileEndpoint(baseUrl: string, schemaId: string): string;
-declare function knowledgeRetrieveEndpoint(baseUrl: string): string;
-declare function knowledgeSearchEndpoint(workspaceId: string): string;
-declare function knowledgeChatEndpoint(workspaceId: string): string;
-declare function mcpWebSearchEndpoint(baseUrl: string): string;
 //#endregion
-//#region src/client/headers.d.ts
+//#region src/auth/store.d.ts
+/** 登录允许落盘的键:凭证本体 + 登录回调携带的连接/作用域字段。 */
+type AuthPersistPatch = Pick<ConfigFile, "api_key" | "access_token" | "access_key_id" | "access_key_secret" | "base_url" | "console_site" | "console_region" | "console_switch_agent" | "workspace_id">;
 /**
- * Shared HTTP request headers for all outgoing requests.
- *
- * Centralises the `x-dashscope-source-config` header so every fetch call
- * (both via the central http client and the bypass paths) uses the
- * same values from a single source of truth.
+ * auth 命令族的凭证能力面(lint 限定 commands/auth/** 使用)。
+ * 登录产生的全部落盘走 login,不放宽 configStore 的边界。
  */
-declare const CHANNEL = "bailian-cli";
-declare const TAGS: {
-  t1: string;
-  t2: string;
-};
-declare const SOURCE_CONFIG: string;
-/** Standard tracking headers required on every outbound request. */
-declare function trackingHeaders(): Record<string, string>;
+interface AuthStore {
+  /** 各域"将会解析出"的凭证快照(auth status 用)。 */
+  describe(): AuthState;
+  /** 磁盘上当前是否存有各域凭证(区别于 describe:只看 file,不含 flag/env 源)。 */
+  stored(): {
+    apiKey: boolean;
+    console: boolean;
+    openapi: boolean;
+  };
+  /** model 域 baseUrl 链(flag > env > file > 默认);验证 API key 等无凭证场景用。 */
+  resolveBaseUrl(): string;
+  /** 登录落盘:合并写入,undefined 键忽略。 */
+  login(patch: AuthPersistPatch): Promise<void>;
+  /** 清凭证:console/openapi 只删对应域;all 清全部登录凭证。返回是否有变更。 */
+  logout(scope: "console" | "openapi" | "all"): Promise<boolean>;
+}
+declare function makeAuthStore(sources: ResolutionSources): AuthStore;
 //#endregion
 //#region src/client/http.d.ts
+/** 传输层依赖:UA 用 identity,timeout/verbose 用 settings。凭证由调用方(Client)注头。 */
+interface HttpDeps {
+  identity: Identity;
+  settings: Settings;
+}
 interface RequestOpts {
   url: string;
   method?: string;
@@ -830,12 +858,29 @@ interface RequestOpts {
   headers?: Record<string, string>;
   timeout?: number;
   stream?: boolean;
-  noAuth?: boolean;
   async?: boolean;
   signal?: AbortSignal;
 }
-declare function request(config: Config, opts: RequestOpts): Promise<Response>;
-declare function requestJson<T>(config: Config, opts: RequestOpts): Promise<T>;
+declare function request(deps: HttpDeps, opts: RequestOpts): Promise<Response>;
+declare function requestJson<T>(deps: HttpDeps, opts: RequestOpts): Promise<T>;
+//#endregion
+//#region src/client/acs.d.ts
+type AcsQueryParams = Record<string, string | string[] | undefined>;
+interface AcsSignConfig {
+  accessKeyId: string;
+  accessKeySecret: string;
+  action: string;
+  version: string;
+  body: string;
+  host: string;
+  pathname: string;
+  method?: string;
+  /** ACS3 canonical query string (sorted, encoded, no leading `?`). */
+  queryString?: string;
+}
+/** Build ACS3 canonical query string from OpenAPI query parameters. */
+declare function buildAcsCanonicalQuery(params: AcsQueryParams): string;
+declare function signAcsRequest(cfg: AcsSignConfig): Record<string, string>;
 //#endregion
 //#region src/client/mcp.d.ts
 interface McpTool {
@@ -857,14 +902,14 @@ interface McpToolResult {
  * The path is `/api/v1/mcps/<serverCode>/mcp`; the `serverCode` is taken
  * verbatim from `bl mcp list` (e.g. `WebSearch`, `market-cmapi00073529`).
  */
-declare function bailianMcpUrl(baseUrl: string, serverCode: string): string;
+declare function bailianMcpPath(serverCode: string): string;
 declare class McpClient {
   private url;
   private sessionId;
   private nextId;
-  private config;
+  private deps;
   private authToken;
-  constructor(config: Config, url: string);
+  constructor(deps: HttpDeps, url: string, authToken?: string);
   /** Initialize the MCP session. Must be called before any other method. */
   initialize(): Promise<void>;
   listTools(): Promise<McpTool[]>;
@@ -874,6 +919,329 @@ declare class McpClient {
   private send;
 }
 //#endregion
+//#region src/client/client.d.ts
+/** Client 的结构化依赖:身份 + 有效配置 + 各域凭证(按命令的 auth 注入)。 */
+interface ClientDeps {
+  identity: Identity;
+  settings: Settings;
+  /** Model 域 base URL(凭证无关链解析,resolveModelBaseUrl;有 apiCred 时两者一致)。 */
+  baseUrl: string;
+  apiCred?: ApiKeyCredential;
+  consoleCred?: ConsoleCredential;
+  openApiCred?: OpenApiCredential;
+}
+/** Like {@link RequestOpts} but with a `path` (credential baseUrl prepended) or an absolute URL. */
+interface ClientRequestOpts extends Omit<RequestOpts, "url" | "noAuth"> {
+  path: string;
+}
+interface ClientOpenApiQueryOpts {
+  host: string;
+  path: string;
+  action: string;
+  version: string;
+  method: "GET" | "POST";
+  queryParams: AcsQueryParams;
+}
+interface OpenApiResponse {
+  Success?: boolean;
+  Code?: string;
+  Message?: string;
+}
+/**
+ * A command's network surface: call its methods to reach the API — the
+ * credential and base URL are already baked in, so commands never handle tokens
+ * or baseUrl. Model methods (`request`/`requestJson`/`mcp`) need an api key;
+ * `uploadFile` only needs one for local files, and passes URLs through without
+ * credentials. `console` needs a console token; calling one without its
+ * credential throws.
+ */
+declare class Client {
+  private readonly deps;
+  constructor(deps: ClientDeps);
+  private get http();
+  private requireApi;
+  private requireOpenApi;
+  /** Model-domain base URL. Readable without a key (e.g. dry-run preview); real requests still need one. */
+  get baseUrl(): string;
+  /** Full URL for a model-domain {@link path}; build request/display URLs only through this. */
+  url(path: string): string;
+  private toOpts;
+  request(opts: ClientRequestOpts): Promise<Response>;
+  requestJson<T>(opts: ClientRequestOpts): Promise<T>;
+  /** Resolve a file arg: upload a local path to OSS (returns oss:// URL), or pass a URL through. */
+  uploadFile(source: string, model: string, opts?: {
+    signal?: AbortSignal;
+  }): Promise<string>;
+  /** Open an MCP client. Accepts a path (prepended with the model baseUrl) or an absolute URL. */
+  mcp(pathOrUrl: string): McpClient;
+  console<T>(api: string, data: Record<string, unknown>): Promise<T>;
+  openApiQueryJson<T extends OpenApiResponse>(opts: ClientOpenApiQueryOpts): Promise<T>;
+}
+//#endregion
+//#region src/types/command.d.ts
+/** A presence flag: `--quiet`. No value; absent → false. */
+interface SwitchFlag {
+  type: "switch";
+  description: string;
+}
+/** A value flag: `--prompt <text>`, `--n <count>`, `--watermark true|false`. */
+interface ValueFlag {
+  type: "string" | "number" | "boolean" | "array";
+  description: string;
+  valueHint: string;
+  required?: boolean;
+  /**
+   * Restrict to a fixed set of values. The parser rejects anything else and the
+   * parsed type narrows to the union. Declare with `as const` so the literals
+   * survive inference: `choices: ["mp3", "wav"] as const`.
+   */
+  choices?: readonly string[];
+}
+type FlagDef = SwitchFlag | ValueFlag;
+type FlagsDef = Record<string, FlagDef>;
+type ParsedValue<F extends FlagDef> = F extends SwitchFlag ? boolean : F extends {
+  type: "number";
+} ? number : F extends {
+  type: "boolean";
+} ? boolean : F extends {
+  choices: readonly (infer C extends string)[];
+} ? F extends {
+  type: "array";
+} ? C[] : C : F extends {
+  type: "array";
+} ? string[] : string;
+/** Switches and `required` value flags are present; other value flags optional. */
+type IsRequired<F extends FlagDef> = F extends SwitchFlag ? true : F extends {
+  required: true;
+} ? true : false;
+/**
+ * Map a FlagsDef to the parsed flags object type. Required flags (switches +
+ * `required: true`) are required properties; optional value flags are `?`.
+ */
+type ParsedFlags<F extends FlagsDef> = { [K in keyof F as IsRequired<F[K]> extends true ? K : never]: ParsedValue<F[K]> } & { [K in keyof F as IsRequired<F[K]> extends true ? never : K]?: ParsedValue<F[K]> };
+type AuthRequirement = "apiKey" | "console" | "openapi" | "none";
+/** 所有命令都可用的全局 flag。 */
+declare const GLOBAL_FLAGS: {
+  output: {
+    type: "string";
+    valueHint: string;
+    description: string;
+  };
+  timeout: {
+    type: "number";
+    valueHint: string;
+    description: string;
+  };
+  quiet: {
+    type: "switch";
+    description: string;
+  };
+  verbose: {
+    type: "switch";
+    description: string;
+  };
+  dryRun: {
+    type: "switch";
+    description: string;
+  };
+  help: {
+    type: "switch";
+    description: string;
+  };
+  version: {
+    type: "switch";
+    description: string;
+  };
+};
+/** Command-scoped flag for commands that support parallel API calls. */
+declare const CONCURRENT_FLAG: {
+  concurrent: {
+    type: "number";
+    valueHint: string;
+    description: string;
+  };
+};
+/** Command-scoped flag for task-based commands that can return without polling. */
+declare const ASYNC_FLAG: {
+  async: {
+    type: "switch";
+    description: string;
+  };
+};
+/** Model 域凭证/连接 flag,`auth: "apiKey"` 命令可见。 */
+declare const MODEL_AUTH_FLAGS: {
+  apiKey: {
+    type: "string";
+    valueHint: string;
+    description: string;
+  };
+  baseUrl: {
+    type: "string";
+    valueHint: string;
+    description: string;
+  };
+};
+/** Console 域目标/作用域 flag,`auth: "console"` 命令可见。 */
+declare const CONSOLE_AUTH_FLAGS: {
+  consoleRegion: {
+    type: "string";
+    valueHint: string;
+    description: string;
+  };
+  consoleSite: {
+    type: "string";
+    valueHint: string;
+    description: string;
+  };
+  consoleSwitchAgent: {
+    type: "number";
+    valueHint: string;
+    description: string;
+  };
+  workspaceId: {
+    type: "string";
+    valueHint: string;
+    description: string;
+  };
+};
+/** Alibaba Cloud OpenAPI AK/SK credential flags, visible to `auth: "openapi"` commands. */
+declare const OPENAPI_AUTH_FLAGS: {
+  accessKeyId: {
+    type: "string";
+    valueHint: string;
+    description: string;
+  };
+  accessKeySecret: {
+    type: "string";
+    valueHint: string;
+    description: string;
+  };
+};
+/** sources 里可能出现的全部 flag(全局 + 凭证域)。 */
+type SourceFlags = ParsedFlags<typeof GLOBAL_FLAGS & typeof MODEL_AUTH_FLAGS & typeof CONSOLE_AUTH_FLAGS & typeof OPENAPI_AUTH_FLAGS>;
+/** 该命令可见的凭证域 flag 定义。 */
+declare function credentialFlagDefs(cmd: {
+  auth: AuthRequirement;
+}): FlagsDef;
+/**
+ * What a command's `run` receives: `client` for all network calls (its
+ * credential is already injected per the command's `auth`), `settings` for the
+ * resolved configuration surface, `identity` for product identity, and `flags`
+ * for parsed arguments. Never handle tokens or baseUrl.
+ */
+interface CommandContext<F extends FlagsDef = FlagsDef> {
+  /** 静态产品身份(binName/version/npmPackage/clientName)。 */
+  identity: Identity;
+  /** flag/env/file 解析后的有效配置面。 */
+  settings: Settings;
+  /** 只含本命令声明的 flag;全局 flag 经 settings 读。 */
+  flags: ParsedFlags<F>;
+  /** Network surface; the credential for the command's `auth` is pre-injected. */
+  client: Client;
+  /** 惰性访问器,lint 限定 commands/config/** 使用。 */
+  configStore(): ConfigStore;
+  /** 惰性访问器,lint 限定 commands/auth/** 使用。 */
+  authStore(): AuthStore;
+}
+/**
+ * A command. Generic over its flags `F` so `run`/`validate` receive precisely
+ * typed flags (`ParsedFlags<F>` = 命令自有 flag). Stored heterogeneously as
+ * {@link AnyCommand}; the precise typing lives at the `defineCommand` call site.
+ */
+interface Command<F extends FlagsDef = FlagsDef> {
+  description: string;
+  /** Credential this command requires. See {@link AuthRequirement}. */
+  auth: AuthRequirement;
+  /** Usage line arg portion, e.g. "--prompt <text> [flags]". Manually written. */
+  usageArgs?: string;
+  /** Example arg strings (without the `<bin> <path>` prefix). */
+  exampleArgs?: string[];
+  notes?: string[];
+  flags?: F;
+  /**
+   * Cross-flag validation, after parsing and before run. Return an error message
+   * → UsageError; undefined to pass. Single-flag `required` is enforced by the
+   * parser — use this for rules spanning flags or depending on a flag's *value*.
+   */
+  validate?: (flags: ParsedFlags<F>) => string | undefined;
+  run: (ctx: CommandContext<F>) => Promise<void>;
+}
+/** Type-erased command for heterogeneous storage (registry / context). */
+type AnyCommand = Command<any>;
+/** Identity wrapper whose only job is to infer `F` from `spec.flags`. */
+declare function defineCommand<F extends FlagsDef>(spec: Command<F>): Command<F>;
+//#endregion
+//#region src/config/loader.d.ts
+declare function readConfigFile(): ConfigFile;
+declare function writeConfigFile(data: Record<string, unknown>): Promise<void>;
+/**
+ * 解析的三个来源,dispatch 边界一次构建。flags 收 Partial:ParsedFlags 里 switch 是
+ * 必填 boolean,收 Partial 让 pipeline 等无 flag 场景传 {} 即可。
+ */
+interface ResolutionSources {
+  flags: Partial<SourceFlags>;
+  file: ConfigFile;
+  env: NodeJS.ProcessEnv;
+}
+declare function buildSources(flags: Partial<SourceFlags>): ResolutionSources;
+/**
+ * 纯解析 sources → Settings(命令唯一会读的配置面)。不含身份、baseUrl、鉴权。
+ * 各字段链序 flag > env > file > 默认;锁定表 tests/config-priority.test.ts。
+ */
+declare function buildSettings(s: ResolutionSources): Settings;
+//#endregion
+//#region src/auth/resolver.d.ts
+/** Model-domain baseUrl(flag > env > file > cn)——无需 key 也可解析;login 验证等用。 */
+declare function resolveModelBaseUrl(s: ResolutionSources): string;
+/**
+ * Model-domain credential from sources. Priority: `--api-key` flag >
+ * `DASHSCOPE_API_KEY` env > config.json `api_key`. baseUrl: flag > env > file > cn.
+ */
+declare function resolveApiKey(s: ResolutionSources): ApiKeyCredential;
+/** Console-domain credential from sources — access token + 连接目标(flag > file > 默认)。 */
+declare function resolveConsole(s: ResolutionSources): ConsoleCredential;
+/** Alibaba Cloud OpenAPI AK/SK credential. Priority: flags > env > config. */
+declare function resolveOpenApi(s: ResolutionSources): OpenApiCredential;
+/** Full auth snapshot from sources — what would resolve per domain (or undefined). */
+declare function describeAuthState(s: ResolutionSources): AuthState;
+//#endregion
+//#region src/client/endpoints.d.ts
+declare function chatPath(): string;
+declare function imagePath(): string;
+declare function imageSyncPath(): string;
+declare function videoGeneratePath(): string;
+declare function taskPath(taskId: string): string;
+declare function appCompletionPath(appId: string): string;
+declare function memoryAddPath(): string;
+declare function memorySearchPath(): string;
+declare function memoryListPath(): string;
+declare function memoryNodePath(nodeId: string): string;
+declare function speechSynthesizePath(): string;
+declare function speechRecognizePath(): string;
+declare function profileSchemaPath(): string;
+declare function userProfilePath(schemaId: string): string;
+declare function knowledgeRetrievePath(): string;
+declare function knowledgeSearchEndpoint(workspaceId: string): string;
+declare function knowledgeChatEndpoint(workspaceId: string): string;
+declare function mcpWebSearchPath(): string;
+//#endregion
+//#region src/client/headers.d.ts
+/**
+ * Shared HTTP request headers for all outgoing requests.
+ *
+ * Centralises the `x-dashscope-source-config` header so every fetch call
+ * (both via the central http client and the bypass paths) uses the
+ * same values from a single source of truth.
+ */
+declare const CHANNEL = "bailian-cli";
+declare const TAGS: {
+  t1: string;
+  t2: string;
+};
+declare const SOURCE_CONFIG: string;
+/** Standard tracking headers required on every outbound request. */
+declare function trackingHeaders(): Record<string, string>;
+//#endregion
 //#region src/client/stream.d.ts
 interface ServerSentEvent {
   event?: string;
@@ -884,8 +1252,11 @@ declare function parseSSE(response: Response): AsyncGenerator<ServerSentEvent>;
 //#endregion
 //#region src/console/gateway.d.ts
 type ConsoleSite = "domestic" | "international";
-/** Resolved console gateway settings (same defaults as {@link callConsoleGateway}). */
-declare function effectiveConsoleGatewayConfig(config: Config): {
+/**
+ * Resolved console gateway settings (same defaults as {@link callConsoleGateway}).
+ * 参数只需 settings 的 console 三元组;dry-run 展示分支直接传 settings。
+ */
+declare function effectiveConsoleGatewayConfig(config: Pick<Settings, "consoleRegion" | "consoleSite" | "consoleSwitchAgent">): {
   consoleRegion: string;
   consoleSite: ConsoleSite;
   consoleSwitchAgent?: number;
@@ -894,23 +1265,19 @@ interface ConsoleGatewayRequest {
   /** Console API name, e.g. zeldaEasy.broadscope-bailian.freeTrial.queryFreeTierQuota */
   api: string;
   data: Record<string, unknown>;
-  /** Console region (e.g. cn-beijing, ap-southeast-1). Falls back to config.consoleRegion, then "cn-beijing". */
-  region?: string;
-  /** Console site. Falls back to config.consoleSite, then "domestic". */
-  site?: ConsoleSite;
-  /** Switch-agent UID for delegated access. Falls back to config.consoleSwitchAgent. */
-  switchAgent?: number;
 }
 /**
  * Invoke a Bailian **console** OpenAPI via the CLI gateway (`/cli/api.json`).
- * `token` is the console `access_token` (from `bl auth login --console`); when
- * omitted the request is sent without an Authorization header, which works for
- * public console APIs that don't require a login session.
- *
- * Gateway URL and action are resolved from `region + site` via {@link REGION_GATEWAYS}.
- * Each parameter falls back to the corresponding config value, then to a hardcoded default.
+ * 目标(region/site/switchAgent)与 token 均由调用方解析后传入:Client.console 传
+ * ConsoleCredential;公共目录类 API(如 advisor 的模型目录)可不带 token 匿名调用。
  */
-declare function callConsoleGateway(config: Config, token: string | undefined, {
+interface ConsoleGatewayTarget {
+  region: string;
+  site: ConsoleSite;
+  switchAgent?: number;
+  token?: string;
+}
+declare function callConsoleGateway(target: ConsoleGatewayTarget, timeoutSec: number, {
   api,
   data
 }: ConsoleGatewayRequest): Promise<unknown>;
@@ -927,32 +1294,8 @@ interface ModelListResult {
   total: number;
   models: Record<string, unknown>[];
 }
-declare function fetchModelList(config: Config, token: string, params?: ModelListParams): Promise<ModelListResult>;
-//#endregion
-//#region src/types/flags.d.ts
-interface GlobalFlags {
-  apiKey?: string;
-  baseUrl?: string;
-  output?: string;
-  quiet: boolean;
-  verbose: boolean;
-  timeout?: number;
-  noColor: boolean;
-  yes: boolean;
-  dryRun: boolean;
-  help: boolean;
-  nonInteractive: boolean;
-  async: boolean;
-  consoleRegion?: string;
-  consoleSite?: string;
-  consoleSwitchAgent?: number;
-  [key: string]: unknown;
-}
-//#endregion
-//#region src/config/loader.d.ts
-declare function readConfigFile(): ConfigFile;
-declare function writeConfigFile(data: Record<string, unknown>): Promise<void>;
-declare function loadConfig(flags: GlobalFlags): Config;
+/** Page the console model-list API. `call` makes the gateway request (e.g. `client.console`). */
+declare function fetchModelList(call: (api: string, data: Record<string, unknown>) => Promise<unknown>, params?: ModelListParams): Promise<ModelListResult>;
 //#endregion
 //#region src/config/paths.d.ts
 declare function getConfigDir(): string;
@@ -1108,7 +1451,7 @@ interface DatasetUploadParams {
  * `Response`'s helper to avoid the buffer doubling. Fall back to readFileSync
  * for small files where streaming overhead isn't worth it.
  */
-declare function uploadDataset(config: Config, params: DatasetUploadParams): Promise<DatasetFile>;
+declare function uploadDataset(client: Client, params: DatasetUploadParams): Promise<DatasetFile>;
 interface DatasetListParams {
   pageNo?: number;
   pageSize?: number;
@@ -1116,11 +1459,11 @@ interface DatasetListParams {
   signal?: AbortSignal;
 }
 /** GET /api/v1/files */
-declare function listDatasets(config: Config, params?: DatasetListParams): Promise<DatasetListResponse>;
+declare function listDatasets(client: Client, params?: DatasetListParams): Promise<DatasetListResponse>;
 /** GET /api/v1/files/{file_id} */
-declare function getDataset(config: Config, fileId: string, signal?: AbortSignal): Promise<DatasetGetResponse>;
+declare function getDataset(client: Client, fileId: string, signal?: AbortSignal): Promise<DatasetGetResponse>;
 /** DELETE /api/v1/files/{file_id} */
-declare function deleteDataset(config: Config, fileId: string, signal?: AbortSignal): Promise<DatasetDeleteResponse>;
+declare function deleteDataset(client: Client, fileId: string, signal?: AbortSignal): Promise<DatasetDeleteResponse>;
 //#endregion
 //#region src/dataset/validate/types.d.ts
 /**
@@ -1433,7 +1776,7 @@ interface GetFineTuneResponse {
 //#endregion
 //#region src/finetune/api.d.ts
 /** POST /api/v1/fine-tunes */
-declare function createFineTune(config: Config, body: CreateFineTuneRequest, signal?: AbortSignal): Promise<CreateFineTuneResponse>;
+declare function createFineTune(client: Client, body: CreateFineTuneRequest, signal?: AbortSignal): Promise<CreateFineTuneResponse>;
 interface ListFineTunesParams {
   pageNo?: number;
   pageSize?: number;
@@ -1441,22 +1784,22 @@ interface ListFineTunesParams {
   signal?: AbortSignal;
 }
 /** GET /api/v1/fine-tunes */
-declare function listFineTunes(config: Config, params?: ListFineTunesParams): Promise<ListFineTunesResponse>;
+declare function listFineTunes(client: Client, params?: ListFineTunesParams): Promise<ListFineTunesResponse>;
 /** GET /api/v1/fine-tunes/{job_id} */
-declare function getFineTune(config: Config, jobId: string, signal?: AbortSignal): Promise<GetFineTuneResponse>;
+declare function getFineTune(client: Client, jobId: string, signal?: AbortSignal): Promise<GetFineTuneResponse>;
 /** POST /api/v1/fine-tunes/{job_id}/cancel */
-declare function cancelFineTune(config: Config, jobId: string, signal?: AbortSignal): Promise<CancelFineTuneResponse>;
+declare function cancelFineTune(client: Client, jobId: string, signal?: AbortSignal): Promise<CancelFineTuneResponse>;
 /** DELETE /api/v1/fine-tunes/{job_id} */
-declare function deleteFineTune(config: Config, jobId: string, signal?: AbortSignal): Promise<DeleteFineTuneResponse>;
+declare function deleteFineTune(client: Client, jobId: string, signal?: AbortSignal): Promise<DeleteFineTuneResponse>;
 interface GetFineTuneLogsParams {
   pageNo?: number;
   pageSize?: number;
   signal?: AbortSignal;
 }
 /** GET /api/v1/fine-tunes/{job_id}/logs */
-declare function getFineTuneLogs(config: Config, jobId: string, params?: GetFineTuneLogsParams): Promise<GetFineTuneLogsResponse>;
+declare function getFineTuneLogs(client: Client, jobId: string, params?: GetFineTuneLogsParams): Promise<GetFineTuneLogsResponse>;
 /** GET /api/v1/fine-tunes/{job_id}/checkpoints */
-declare function listCheckpoints(config: Config, jobId: string, signal?: AbortSignal): Promise<ListCheckpointsResponse>;
+declare function listCheckpoints(client: Client, jobId: string, signal?: AbortSignal): Promise<ListCheckpointsResponse>;
 /**
  * GET /api/v1/fine-tunes/{job_id}/export/{checkpoint}?model_name={name}
  *
@@ -1464,7 +1807,7 @@ declare function listCheckpoints(config: Config, jobId: string, signal?: AbortSi
  * `bl deploy create` can target it. The platform may auto-export the best
  * checkpoint on SUCCEEDED, but explicit export is the canonical path.
  */
-declare function exportCheckpoint(config: Config, jobId: string, checkpoint: string, modelName: string, signal?: AbortSignal): Promise<ExportCheckpointResponse>;
+declare function exportCheckpoint(client: Client, jobId: string, checkpoint: string, modelName: string, signal?: AbortSignal): Promise<ExportCheckpointResponse>;
 //#endregion
 //#region src/finetune/capability.d.ts
 /**
@@ -1562,7 +1905,7 @@ declare function listSupportedTrainingTypes(model: ModelCapability | undefined |
  * server's `name` filter is a substring match, so we additionally require an
  * exact `model` equality to avoid e.g. `qwen3-8b` matching `qwen3-8b-v2`).
  */
-declare function fetchModelCapability(config: Config, modelName: string): Promise<ModelCapability | null>;
+declare function fetchModelCapability(settings: Settings, modelName: string): Promise<ModelCapability | null>;
 //#endregion
 //#region src/finetune/preflight.d.ts
 /** Stable issue code for "too few training samples for the batch size". */
@@ -1843,7 +2186,7 @@ interface UpdateDeploymentResponse {
 //#endregion
 //#region src/deploy/api.d.ts
 /** POST /api/v1/deployments */
-declare function createDeployment(config: Config, body: CreateDeploymentRequest, signal?: AbortSignal): Promise<CreateDeploymentResponse>;
+declare function createDeployment(client: Client, body: CreateDeploymentRequest, signal?: AbortSignal): Promise<CreateDeploymentResponse>;
 interface ListDeploymentsParams {
   pageNo?: number;
   pageSize?: number;
@@ -1851,11 +2194,11 @@ interface ListDeploymentsParams {
   signal?: AbortSignal;
 }
 /** GET /api/v1/deployments */
-declare function listDeployments(config: Config, params?: ListDeploymentsParams): Promise<ListDeploymentsResponse>;
+declare function listDeployments(client: Client, params?: ListDeploymentsParams): Promise<ListDeploymentsResponse>;
 /** GET /api/v1/deployments/{deployed_model} */
-declare function getDeployment(config: Config, deployedModel: string, signal?: AbortSignal): Promise<GetDeploymentResponse>;
+declare function getDeployment(client: Client, deployedModel: string, signal?: AbortSignal): Promise<GetDeploymentResponse>;
 /** DELETE /api/v1/deployments/{deployed_model} */
-declare function deleteDeployment(config: Config, deployedModel: string, signal?: AbortSignal): Promise<DeleteDeploymentResponse>;
+declare function deleteDeployment(client: Client, deployedModel: string, signal?: AbortSignal): Promise<DeleteDeploymentResponse>;
 interface ListDeployableModelsParams {
   pageNo?: number;
   pageSize?: number;
@@ -1866,57 +2209,15 @@ interface ListDeployableModelsParams {
   signal?: AbortSignal;
 }
 /** GET /api/v1/deployments/models */
-declare function listDeployableModels(config: Config, params?: ListDeployableModelsParams): Promise<ListDeployableModelsResponse>;
+declare function listDeployableModels(client: Client, params?: ListDeployableModelsParams): Promise<ListDeployableModelsResponse>;
 /** PUT /api/v1/deployments/{deployed_model}/scale */
-declare function scaleDeployment(config: Config, deployedModel: string, body: ScaleDeploymentRequest, signal?: AbortSignal): Promise<ScaleDeploymentResponse>;
+declare function scaleDeployment(client: Client, deployedModel: string, body: ScaleDeploymentRequest, signal?: AbortSignal): Promise<ScaleDeploymentResponse>;
 /**
  * PUT /api/v1/deployments/{deployed_model}/update
  *
  * Update rate limits. At least one of `rpm_limit` / `tpm_limit` must be set.
  */
-declare function updateDeployment(config: Config, deployedModel: string, body: UpdateDeploymentRequest, signal?: AbortSignal): Promise<UpdateDeploymentResponse>;
-//#endregion
-//#region src/types/command.d.ts
-interface OptionDef {
-  flag: string;
-  description: string;
-  type?: "string" | "number" | "boolean" | "array";
-  required?: boolean;
-}
-interface Command {
-  description: string;
-  /**
-   * Argument portion of the usage line, WITHOUT the `<bin> <path>` prefix
-   * (e.g. "--index-id <id> --query <text> [flags]"). The runtime prepends the
-   * product binary name and the command's actual path when rendering help, so
-   * the same command renders correctly under any product (bl / rag / …).
-   */
-  usageArgs?: string;
-  options?: OptionDef[];
-  /**
-   * Example argument strings, each WITHOUT the `<bin> <path>` prefix
-   * (e.g. '--index-id idx_xxx --query "..."'). The runtime prepends
-   * `<bin> <path>` per product when rendering help.
-   */
-  exampleArgs?: string[];
-  skipDefaultApiKeySetup?: boolean;
-  notes?: string[];
-  execute: (config: Config, flags: GlobalFlags) => Promise<void>;
-}
-interface CommandSpec {
-  description: string;
-  /** See {@link Command.usageArgs} — argument portion only, no `<bin> <path>` prefix. */
-  usageArgs?: string;
-  options?: OptionDef[];
-  /** See {@link Command.exampleArgs} — argument strings only, no `<bin> <path>` prefix. */
-  exampleArgs?: string[];
-  skipDefaultApiKeySetup?: boolean;
-  notes?: string[];
-  run: (config: Config, flags: GlobalFlags) => Promise<void>;
-}
-declare function defineCommand(spec: CommandSpec): Command;
-/** Global flags shared by all commands — drives the parser's type resolution. */
-declare const GLOBAL_OPTIONS: OptionDef[];
+declare function updateDeployment(client: Client, deployedModel: string, body: UpdateDeploymentRequest, signal?: AbortSignal): Promise<UpdateDeploymentResponse>;
 //#endregion
 //#region src/utils/filename.d.ts
 declare function generateFilename(prefix: string, prompt: string): string;
@@ -1933,7 +2234,7 @@ declare function generateFilename(prefix: string, prompt: string): string;
  * Optionally appends a subdirectory (e.g. 'images', 'videos', 'speech').
  * Creates the directory if it doesn't exist.
  */
-declare function resolveOutputDir(config: Config, options?: {
+declare function resolveOutputDir(settings: Settings, options?: {
   flagDir?: string;
   subDir?: string;
 }): string;
@@ -1941,33 +2242,6 @@ declare function resolveOutputDir(config: Config, options?: {
 //#region src/utils/token.d.ts
 declare function maskToken(token: string): string;
 //#endregion
-//#region src/utils/env.d.ts
-/**
- * Environment detection utilities for bailian-cli.
- *
- * Used to determine whether the CLI is running in an interactive terminal
- * (human user) or in a non-interactive environment (CI, agent, pipe, etc.),
- * so commands can adjust their behavior accordingly.
- */
-/**
- * Detects whether the current environment is interactive.
- *
- * Returns false when:
- *  - stdout or stdin is not a TTY
- *  - The --non-interactive flag was explicitly set
- *  - The process is running in a known CI environment (CI env var present)
- *
- * Returns true when stdout and stdin are both TTYs and --non-interactive
- * was not passed.
- */
-declare function isInteractive(options?: {
-  nonInteractive?: boolean;
-}): boolean;
-/**
- * Detects whether the current process is running in a CI environment.
- */
-declare function isCI(): boolean;
-//#endregion
 //#region src/utils/object.d.ts
 /**
  * Generic object-cleaning utilities.
@@ -2007,7 +2281,7 @@ interface TrackingEvent {
   cliVersion: string;
   nodeVersion: string;
   os: string;
-  authMethod?: string;
+  authMethod?: AuthRequirement;
   params?: Record<string, unknown>;
 }
 declare function createTrackingEvent(opts: {
@@ -2020,7 +2294,7 @@ declare function createTrackingEvent(opts: {
     requestId?: string;
   };
   cliVersion: string;
-  authMethod?: string;
+  authMethod?: AuthRequirement;
   params?: Record<string, unknown>;
 }): TrackingEvent;
 //#endregion
@@ -2040,7 +2314,13 @@ declare function localSink(event: TrackingEvent): Promise<void>;
 declare function remoteSink(event: TrackingEvent): Promise<void>;
 //#endregion
 //#region src/telemetry/tracker.d.ts
-declare function trackCommandExecution(config: Config, commandPath: string[], flags: GlobalFlags, fn: () => Promise<void>): Promise<void>;
+/** 遥测只记录命令声明的鉴权域,不接触具体凭证能力。 */
+interface TrackingDeps {
+  identity: Identity;
+  settings: Settings;
+  authMethod?: AuthRequirement;
+}
+declare function trackCommandExecution(deps: TrackingDeps, commandPath: string[], flags: Record<string, unknown>, fn: () => Promise<void>): Promise<void>;
 //#endregion
 //#region src/advisor/types.d.ts
 type Modality = "Text" | "Image" | "Video" | "Audio";
@@ -2120,6 +2400,13 @@ interface IntentProfile {
   segments?: IntentSegment[];
   taskSummary: string;
   scenarioHints: string[];
+  /**
+   * LLM-refined, self-contained English description of the need, optimized for
+   * semantic matching against model descriptions. Used as the embedding query
+   * for soft-track recall. Empty when intent analysis degrades (recall then
+   * falls back to the raw user query).
+   */
+  semanticQuery: string;
   inputModality: Modality[];
   outputModality: Modality[];
   requiredCapabilities: Capability[];
@@ -2197,21 +2484,40 @@ type RecommendResult = SingleResult | PipelineResult;
 interface GetModelsOptions {
   onPrepareStart?: () => void;
 }
-declare function getModels(config: Config, options?: GetModelsOptions): Promise<ModelProfile[]>;
+declare function getModels(settings: Settings, options?: GetModelsOptions): Promise<ModelProfile[]>;
+//#endregion
+//#region src/advisor/constants/scoring.d.ts
+declare const SEMANTIC_TOP_K = 20;
 //#endregion
 //#region src/advisor/intent.d.ts
-declare function analyzeIntent(config: Config, input: string): Promise<IntentProfile>;
+/**
+ * Analyze the user's input to produce an IntentProfile.
+ *
+ * Two LLM calls run in parallel:
+ *   1. `tongyi-intent-detect-v3` (DashScope native) -- fast mode/targets/excludes/complexity
+ *   2. `qwen3.6-flash` -- rich field extraction (taskSummary, modalities, budget, etc.)
+ *
+ * detect-v3 takes priority for mode/targets/excludes/complexity;
+ * the extraction model fills everything else.
+ */
+declare function analyzeIntent(client: Client, input: string, opts?: {
+  intentDetectBaseUrl?: string;
+}): Promise<IntentProfile>;
 //#endregion
 //#region src/advisor/recall.d.ts
 interface ScoredCandidate {
   model: ModelProfile;
   score: number;
+  /** Normalized [0,1] preference-satisfaction score (capability/feature/context/quality). */
+  hardScore?: number;
+  /** Cosine similarity [0,1] between the semantic query and the model embedding. */
+  softScore?: number;
 }
 declare function recallCandidates(models: ModelProfile[], intent: IntentProfile): ScoredCandidate[];
 //#endregion
 //#region src/advisor/recall-semantic.d.ts
 declare function isSemanticAvailable(): boolean;
-declare function recallSemantic(config: Config, models: ModelProfile[], query: string, topK: number, intent?: IntentProfile): Promise<ScoredCandidate[]>;
+declare function recallSemantic(client: Client, models: ModelProfile[], query: string, topK: number, intent?: IntentProfile): Promise<ScoredCandidate[]>;
 //#endregion
 //#region src/advisor/recommend.d.ts
 interface RecommendOptions {
@@ -2220,7 +2526,7 @@ interface RecommendOptions {
   enableThinking?: boolean;
 }
 declare function buildDocLink(docUrl?: string): string | undefined;
-declare function rankModels(config: Config, candidates: ScoredCandidate[], intent: IntentProfile, userInput: string, top: number, options?: RecommendOptions): Promise<RecommendResult>;
+declare function rankModels(client: Client, candidates: ScoredCandidate[], intent: IntentProfile, userInput: string, top: number, options?: RecommendOptions): Promise<RecommendResult>;
 //#endregion
 //#region src/advisor/sources/types.d.ts
 interface ModelSource {
@@ -2229,4 +2535,4 @@ interface ModelSource {
   load(): Promise<ModelProfile[]>;
 }
 //#endregion
-export { AkSignConfig, type ApiErrorBody, AppCompletionRequest, AppCompletionResponse, AppStreamChunk, AuthMethod, BAILIAN_HOST, BailianError, BatchSizeGateInput, BatchSizeGateResult, Budget, Budgets, CHANNEL, CONSOLE_GATEWAY_NO_TOKEN_MESSAGE, CancelFineTuneResponse, Capabilities, Capability, ChatChoice, ChatMessage, ChatMessageContent, ChatRequest, ChatResponse, ChatTool, Command, CommandSpec, Complexities, Complexity, Config, ConfigFile, ConsoleGatewayRequest, ConsoleSite, ContextNeed, ContextNeeds, CreateDeploymentRequest, CreateDeploymentResponse, CreateFineTuneRequest, CreateFineTuneResponse, DEFAULT_TRAINING_TYPE, DOCS_HOSTS, DashScopeASRRequest, DashScopeASRTaskResult, DashScopeAsyncResponse, DashScopeImageRequest, DashScopeImageSyncResponse, DashScopeKnowledgeRetrieveRequest, DashScopeKnowledgeRetrieveResponse, DashScopeTTSRequest, DashScopeTTSResponse, DashScopeTTSStreamChunk, DashScopeTaskResponse, DashScopeVideoEditRequest, DashScopeVideoRefRequest, DashScopeVideoRequest, DatasetDeleteResponse, DatasetFile, DatasetGetResponse, DatasetListParams, DatasetListResponse, DatasetSchema, DatasetUploadParams, DatasetUploadResponse, DeleteDeploymentResponse, DeleteFineTuneResponse, DeployableModel, DeployableTemplate, Deployment, ExitCode, ExportCheckpointResponse, Feature, Features, FineTuneCheckpoint, FineTuneHyperParameters, FineTuneJob, FineTuneLogEntry, GLOBAL_OPTIONS, GetDeploymentResponse, GetFineTuneLogsParams, GetFineTuneLogsResponse, GetFineTuneResponse, GetModelsOptions, GlobalFlags, INSUFFICIENT_SAMPLES_CODE, IntentProfile, IntentSegment, KnowledgeChatContentPart, KnowledgeChatMessage, KnowledgeChatRequest, KnowledgeChatStreamChunk, KnowledgeRetrieveRequest, KnowledgeRetrieveResponse, KnowledgeSearchRequest, KnowledgeSearchResponse, ListCheckpointsResponse, ListDeployableModelsParams, ListDeployableModelsResponse, ListDeploymentsParams, ListDeploymentsResponse, ListFineTunesParams, ListFineTunesResponse, MAX_DATASET_BYTES, McpClient, McpTool, McpToolResult, MemoryAddRequest, MemoryAddResponse, MemoryMessage, MemoryNode, MemoryNodeListResponse, MemoryNodeUpdateRequest, MemorySearchRequest, MemorySearchResponse, Modalities, Modality, ModelCapability, ModelCategories, ModelCategory, ModelListParams, ModelListResult, ModelPreference, ModelPrice, ModelProfile, ModelSource, OptionDef, OutputFormat, PipelineResult, PipelineStep, PreferenceMode, ProfileAttribute, ProfileSchemaCreateRequest, ProfileSchemaCreateResponse, PtuCapacity, QpmLimit, QualityPreference, QualityPreferences, REGIONS, RecommendOptions, RecommendResult, RecommendedModel, Region, RequestOpts, ResolvedCredential, SOURCE_CONFIG, ScaleDeploymentRequest, ScaleDeploymentResponse, ScoredCandidate, ServerSentEvent, SingleResult, StreamChoice, StreamChunk, TAGS, TRAINING_TYPES_CLI, TRAINING_TYPE_MAP, TrackingEvent, TrainingTypeCli, UpdateDeploymentRequest, UpdateDeploymentResponse, UserProfileResponse, ValidateOpts, ValidationIssue, ValidationResult, ValidationSeverity, ValidationStats, ValidatorSpec, analyzeIntent, appCompletionEndpoint, bailianMcpUrl, buildDocLink, callConsoleGateway, cancelFineTune, chatEndpoint, clearApiKey, createDeployment, createFineTune, createTrackingEvent, defineCommand, deleteDataset, deleteDeployment, deleteFineTune, detectOutputFormat, effectiveConsoleGatewayConfig, ensureConfigDir, exportCheckpoint, fetchModelCapability, fetchModelList, flushTelemetry, formatErrorJson, formatIssue, formatJson, formatOutput, formatText, generateFilename, getConfigDir, getConfigPath, getCredentialsPath, getDataset, getDeployment, getFineTune, getFineTuneLogs, getModels, imageEndpoint, imageSyncEndpoint, isCI, isInteractive, isLocalFile, isSemanticAvailable, isTrainingTypeCli, knowledgeChatEndpoint, knowledgeRetrieveEndpoint, knowledgeSearchEndpoint, listCheckpoints, listDatasets, listDeployableModels, listDeployments, listFineTunes, listSupportedFormats, listSupportedTrainingTypes, loadApiKeyFromConfig, loadConfig, localSink, mapApiError, maskToken, mcpWebSearchEndpoint, memoryAddEndpoint, memoryListEndpoint, memoryNodeEndpoint, memorySearchEndpoint, modelSupportsTrainingType, parseBooleanValue, parseConfigFile, parseDatasetSchemaFlag, parseOptionalBooleanValue, parseSSE, pickValidator, preflightBatchSizeGate, profileSchemaEndpoint, rankModels, readConfigFile, recallCandidates, recallSemantic, registerValidator, remoteSink, request, requestJson, resolveBooleanFlag, resolveConsoleGatewayCredential, resolveCredential, resolveFileUrl, resolveOutputDir, resolveWatermark, saveApiKeyToConfig, scaleDeployment, signRequest, speechRecognizeEndpoint, speechSynthesizeEndpoint, stripUndefined, taskEndpoint, toServerTrainingType, trackCommandExecution, trackingHeaders, trainingTypeMethodVariant, updateDeployment, uploadDataset, uploadFile, userProfileEndpoint, validateDataset, videoGenerateEndpoint, writeConfigFile };
+export { ASYNC_FLAG, AcsQueryParams, AcsSignConfig, AnyCommand, type ApiErrorBody, ApiKeyCredential, AppCompletionRequest, AppCompletionResponse, AppStreamChunk, AuthPersistPatch, AuthRequirement, AuthState, AuthStore, BAILIAN_HOST, BailianError, BatchSizeGateInput, BatchSizeGateResult, Budget, Budgets, CHANNEL, CONCURRENT_FLAG, CONSOLE_AUTH_FLAGS, CancelFineTuneResponse, Capabilities, Capability, ChatChoice, ChatMessage, ChatMessageContent, ChatRequest, ChatResponse, ChatResponseFormat, ChatTool, Client, ClientOpenApiQueryOpts, ClientRequestOpts, Command, Complexities, Complexity, ConfigFile, ConfigStore, ConsoleCredential, ConsoleGatewayRequest, ConsoleSite, ContextNeed, ContextNeeds, CreateDeploymentRequest, CreateDeploymentResponse, CreateFineTuneRequest, CreateFineTuneResponse, CredentialSource, DEFAULT_TRAINING_TYPE, DOCS_HOSTS, DashScopeASRRequest, DashScopeASRTaskResult, DashScopeAsyncResponse, DashScopeImageRequest, DashScopeImageSyncResponse, DashScopeIntentDetectRequest, DashScopeIntentDetectResponse, DashScopeKnowledgeRetrieveRequest, DashScopeKnowledgeRetrieveResponse, DashScopeTTSRequest, DashScopeTTSResponse, DashScopeTTSStreamChunk, DashScopeTaskResponse, DashScopeVideoEditRequest, DashScopeVideoRefRequest, DashScopeVideoRequest, DatasetDeleteResponse, DatasetFile, DatasetGetResponse, DatasetListParams, DatasetListResponse, DatasetSchema, DatasetUploadParams, DatasetUploadResponse, DeleteDeploymentResponse, DeleteFineTuneResponse, DeployableModel, DeployableTemplate, Deployment, ExitCode, ExportCheckpointResponse, Feature, Features, FineTuneCheckpoint, FineTuneHyperParameters, FineTuneJob, FineTuneLogEntry, FlagDef, FlagsDef, GLOBAL_FLAGS, GetDeploymentResponse, GetFineTuneLogsParams, GetFineTuneLogsResponse, GetFineTuneResponse, GetModelsOptions, INSUFFICIENT_SAMPLES_CODE, Identity, IntentProfile, IntentSegment, KnowledgeChatContentPart, KnowledgeChatMessage, KnowledgeChatRequest, KnowledgeChatStreamChunk, KnowledgeSearchRequest, KnowledgeSearchResponse, ListCheckpointsResponse, ListDeployableModelsParams, ListDeployableModelsResponse, ListDeploymentsParams, ListDeploymentsResponse, ListFineTunesParams, ListFineTunesResponse, MAX_DATASET_BYTES, MODEL_AUTH_FLAGS, McpClient, McpTool, McpToolResult, MemoryAddRequest, MemoryAddResponse, MemoryMessage, MemoryNode, MemoryNodeListResponse, MemoryNodeUpdateRequest, MemorySearchRequest, MemorySearchResponse, Modalities, Modality, ModelCapability, ModelCategories, ModelCategory, ModelListParams, ModelListResult, ModelPreference, ModelPrice, ModelProfile, ModelSource, OPENAPI_AUTH_FLAGS, OpenApiCredential, OutputFormat, ParsedFlags, PipelineResult, PipelineStep, PreferenceMode, ProfileAttribute, ProfileSchemaCreateRequest, ProfileSchemaCreateResponse, PtuCapacity, QpmLimit, QualityPreference, QualityPreferences, REGIONS, RecommendOptions, RecommendResult, RecommendedModel, Region, RequestOpts, ResolutionSources, SEMANTIC_TOP_K, SOURCE_CONFIG, ScaleDeploymentRequest, ScaleDeploymentResponse, ScoredCandidate, ServerSentEvent, Settings, SingleResult, SourceFlags, StreamChoice, StreamChunk, TAGS, TRAINING_TYPES_CLI, TRAINING_TYPE_MAP, TrackingEvent, TrainingTypeCli, UpdateDeploymentRequest, UpdateDeploymentResponse, UsageError, UserProfileResponse, ValidateOpts, ValidationIssue, ValidationResult, ValidationSeverity, ValidationStats, ValidatorSpec, analyzeIntent, appCompletionPath, bailianMcpPath, buildAcsCanonicalQuery, buildDocLink, buildSettings, buildSources, callConsoleGateway, cancelFineTune, chatPath, createDeployment, createFineTune, createTrackingEvent, credentialFlagDefs, defineCommand, deleteDataset, deleteDeployment, deleteFineTune, describeAuthState, detectOutputFormat, effectiveConsoleGatewayConfig, ensureConfigDir, exportCheckpoint, fetchModelCapability, fetchModelList, flushTelemetry, formatErrorJson, formatIssue, formatJson, formatOutput, formatText, generateFilename, getConfigDir, getConfigPath, getCredentialsPath, getDataset, getDeployment, getFineTune, getFineTuneLogs, getModels, imagePath, imageSyncPath, isLocalFile, isSemanticAvailable, isTrainingTypeCli, knowledgeChatEndpoint, knowledgeRetrievePath, knowledgeSearchEndpoint, listCheckpoints, listDatasets, listDeployableModels, listDeployments, listFineTunes, listSupportedFormats, listSupportedTrainingTypes, localSink, makeAuthStore, makeConfigStore, mapApiError, maskToken, mcpWebSearchPath, memoryAddPath, memoryListPath, memoryNodePath, memorySearchPath, modelSupportsTrainingType, parseBooleanValue, parseConfigFile, parseDatasetSchemaFlag, parseOptionalBooleanValue, parseSSE, pickValidator, preflightBatchSizeGate, profileSchemaPath, rankModels, readConfigFile, recallCandidates, recallSemantic, registerValidator, remoteSink, request, requestJson, resolveApiKey, resolveBooleanFlag, resolveConsole, resolveFileUrl, resolveModelBaseUrl, resolveOpenApi, resolveOutputDir, resolveWatermark, scaleDeployment, signAcsRequest, speechRecognizePath, speechSynthesizePath, stripUndefined, taskPath, toServerTrainingType, trackCommandExecution, trackingHeaders, trainingTypeMethodVariant, updateDeployment, uploadDataset, uploadFile, userProfilePath, validateDataset, videoGeneratePath, writeConfigFile };