bailian-cli-core 0.0.0-beta-ca77c77-20260605

package/dist/index.d.mts

@@ -0,0 +1,994 @@
+//#region src/errors/codes.d.ts
+declare const ExitCode: {
+  readonly SUCCESS: 0;
+  readonly GENERAL: 1;
+  readonly USAGE: 2;
+  readonly AUTH: 3;
+  readonly QUOTA: 4;
+  readonly TIMEOUT: 5;
+  readonly NETWORK: 6;
+  readonly CONTENT_FILTER: 10;
+};
+type ExitCode = (typeof ExitCode)[keyof typeof ExitCode];
+//#endregion
+//#region src/errors/base.d.ts
+interface ApiErrorContext {
+  httpStatus?: number;
+  apiCode?: string;
+  requestId?: string;
+}
+interface BailianErrorOptions {
+  cause?: unknown;
+  api?: ApiErrorContext;
+}
+declare class BailianError extends Error {
+  readonly exitCode: ExitCode;
+  readonly hint?: string;
+  readonly api?: ApiErrorContext;
+  constructor(message: string, exitCode?: ExitCode, hint?: string, options?: BailianErrorOptions);
+  toJSON(): {
+    error: {
+      code: ExitCode;
+      message: string;
+      hint?: string | undefined;
+      http_status?: number | undefined;
+      api_code?: string | undefined;
+      request_id?: string | undefined;
+      cause?: Record<string, unknown> | undefined;
+    };
+  };
+}
+//#endregion
+//#region src/errors/api.d.ts
+interface ApiErrorBody {
+  error?: {
+    message?: string;
+    type?: string;
+    code?: number | string;
+  };
+  code?: string;
+  message?: string;
+  request_id?: string;
+}
+declare function mapApiError(status: number, body: ApiErrorBody, _url?: string): BailianError;
+//#endregion
+//#region src/types/api.d.ts
+interface ChatMessage {
+  role: "system" | "user" | "assistant";
+  content: string | ChatMessageContent[];
+}
+type ChatMessageContent = {
+  type: "text";
+  text: string;
+} | {
+  type: "image_url";
+  image_url: {
+    url: string;
+  };
+} | {
+  type: "input_audio";
+  input_audio: {
+    data: string;
+    format?: string;
+  };
+} | {
+  type: "audio_url";
+  audio_url: {
+    url: string;
+  };
+} | {
+  type: "video";
+  video: string[];
+} | {
+  type: "video_url";
+  video_url: {
+    url: string;
+  };
+};
+interface ChatTool {
+  type: "function";
+  function: {
+    name: string;
+    description?: string;
+    parameters: Record<string, unknown>;
+  };
+}
+interface ChatRequest {
+  model: string;
+  messages: ChatMessage[];
+  max_tokens?: number;
+  temperature?: number;
+  top_p?: number;
+  stream?: boolean;
+  tools?: ChatTool[];
+  tool_choice?: "auto" | "none" | {
+    type: "function";
+    function: {
+      name: string;
+    };
+  };
+  enable_thinking?: boolean;
+  thinking_budget?: number;
+  modalities?: string[];
+  audio?: {
+    voice: string;
+    format?: string;
+  };
+  stream_options?: {
+    include_usage?: boolean;
+  };
+}
+interface ChatChoice {
+  index: number;
+  message: {
+    role: "assistant";
+    content: string | null;
+    reasoning_content?: string | null;
+    tool_calls?: Array<{
+      id: string;
+      type: "function";
+      function: {
+        name: string;
+        arguments: string;
+      };
+    }>;
+  };
+  finish_reason: string;
+}
+interface ChatResponse {
+  id: string;
+  object: "chat.completion";
+  created: number;
+  model: string;
+  choices: ChatChoice[];
+  usage: {
+    prompt_tokens: number;
+    completion_tokens: number;
+    total_tokens: number;
+  };
+}
+interface StreamChoice {
+  index: number;
+  delta: {
+    role?: string;
+    content?: string | null;
+    reasoning_content?: string | null;
+    audio?: {
+      data?: string;
+      id?: string;
+      expires_at?: number;
+    };
+    tool_calls?: Array<{
+      index: number;
+      id?: string;
+      type?: "function";
+      function?: {
+        name?: string;
+        arguments?: string;
+      };
+    }>;
+  };
+  finish_reason: string | null;
+}
+interface StreamChunk {
+  id: string;
+  object: "chat.completion.chunk";
+  created: number;
+  model: string;
+  choices: StreamChoice[];
+  usage?: {
+    prompt_tokens: number;
+    completion_tokens: number;
+    total_tokens: number;
+  };
+}
+interface DashScopeImageRequest {
+  model: string;
+  input: {
+    messages: Array<{
+      role: "user";
+      content: Array<{
+        text?: string;
+        image?: string;
+      }>;
+    }>;
+  };
+  parameters?: {
+    size?: string;
+    n?: number;
+    seed?: number;
+    prompt_extend?: boolean;
+    watermark?: boolean;
+    negative_prompt?: string;
+  };
+}
+interface DashScopeImageSyncResponse {
+  output: {
+    choices: Array<{
+      finish_reason: string;
+      message: {
+        role: "assistant";
+        content: Array<{
+          image: string;
+          type: "image";
+        }>;
+      };
+    }>;
+    finished: boolean;
+  };
+  usage: {
+    image_count: number;
+  };
+  request_id: string;
+}
+interface DashScopeVideoRequest {
+  model: string;
+  input: {
+    prompt: string;
+    negative_prompt?: string;
+    img_url?: string;
+    media?: Array<{
+      type: "image" | "video" | "first_frame" | "last_frame" | "driving_audio" | "first_clip";
+      url: string;
+    }>;
+  };
+  parameters?: {
+    resolution?: string;
+    ratio?: string;
+    duration?: number;
+    prompt_extend?: boolean;
+    watermark?: boolean;
+    seed?: number;
+  };
+}
+interface DashScopeVideoRefRequest {
+  model: string;
+  input: {
+    prompt: string;
+    media: Array<{
+      type: "reference_image" | "reference_video";
+      url: string;
+      reference_voice?: string;
+    }>;
+  };
+  parameters?: {
+    resolution?: string;
+    ratio?: string;
+    duration?: number;
+    prompt_extend?: boolean;
+    watermark?: boolean;
+    seed?: number;
+  };
+}
+interface DashScopeVideoEditRequest {
+  model: string;
+  input: {
+    prompt?: string;
+    negative_prompt?: string;
+    media: Array<{
+      type: "video" | "reference_image";
+      url: string;
+    }>;
+  };
+  parameters?: {
+    resolution?: string;
+    ratio?: string;
+    duration?: number;
+    audio_setting?: "auto" | "origin";
+    prompt_extend?: boolean;
+    watermark?: boolean;
+    seed?: number;
+  };
+}
+interface AppCompletionRequest {
+  input: {
+    prompt?: string;
+    session_id?: string;
+    image_list?: string[];
+    file_ids?: string[];
+    biz_params?: Record<string, unknown>;
+  };
+  parameters?: {
+    has_thoughts?: boolean;
+    incremental_output?: boolean;
+    rag_options?: {
+      pipeline_ids?: string[];
+      knowledge_base_ids?: string[];
+    };
+    memory_id?: string;
+  };
+  debug?: Record<string, unknown>;
+}
+interface AppCompletionResponse {
+  output: {
+    text: string;
+    finish_reason: string;
+    session_id: string;
+    thoughts?: Array<{
+      thought: string;
+      action_type: string;
+      action_name: string;
+      action: string;
+      action_input_stream: string;
+      action_input: string;
+      response: string;
+      observation: string;
+    }>;
+    doc_references?: Array<{
+      index_id: string;
+      title: string;
+      doc_id: string;
+      doc_name: string;
+      text: string;
+      images?: string[];
+    }>;
+  };
+  usage: {
+    models: Array<{
+      model_id: string;
+      input_tokens: number;
+      output_tokens: number;
+    }>;
+  };
+  request_id: string;
+}
+interface AppStreamChunk {
+  output: {
+    text: string;
+    finish_reason: string;
+    session_id: string;
+    thoughts?: AppCompletionResponse["output"]["thoughts"];
+    doc_references?: AppCompletionResponse["output"]["doc_references"];
+  };
+  usage?: AppCompletionResponse["usage"];
+  request_id: string;
+}
+interface MemoryMessage {
+  role: "user" | "assistant";
+  content: string;
+}
+interface MemoryAddRequest {
+  user_id: string;
+  messages?: MemoryMessage[];
+  custom_content?: string;
+  profile_schema?: string;
+  memory_library_id?: string;
+}
+interface MemoryAddResponse {
+  request_id: string;
+  memory_ids?: string[];
+}
+interface MemorySearchRequest {
+  user_id: string;
+  messages?: MemoryMessage[];
+  query?: string;
+  top_k?: number;
+  memory_library_id?: string;
+}
+interface MemoryNode {
+  memory_node_id: string;
+  content: string;
+  user_id?: string;
+  meta_data?: Record<string, unknown>;
+  created_at?: string;
+  updated_at?: string;
+}
+interface MemorySearchResponse {
+  request_id: string;
+  memory_nodes: MemoryNode[];
+}
+interface MemoryNodeListResponse {
+  request_id: string;
+  memory_nodes: MemoryNode[];
+  total?: number;
+  page_num?: number;
+  page_size?: number;
+}
+interface MemoryNodeUpdateRequest {
+  user_id: string;
+  custom_content: string;
+  /** 非默认记忆库时必填（与控制台记忆库 ID 一致） */
+  memory_library_id?: string;
+}
+interface ProfileAttribute {
+  name: string;
+  description: string;
+  value?: string;
+}
+interface ProfileSchemaCreateRequest {
+  name: string;
+  description?: string;
+  attributes: ProfileAttribute[];
+}
+interface ProfileSchemaCreateResponse {
+  request_id: string;
+  profile_schema_id: string;
+}
+interface UserProfileResponse {
+  request_id: string;
+  profile: {
+    schema_id: string;
+    user_id: string;
+    attributes: ProfileAttribute[];
+  };
+}
+interface KnowledgeRetrieveRequest {
+  IndexId: string;
+  Query: string;
+  DenseSimilarityTopK?: number;
+  SparseSimilarityTopK?: number;
+  EnableReranking?: boolean;
+  EnableRewrite?: boolean;
+  RerankTopN?: number;
+  TopK?: number;
+  Rerank?: boolean;
+  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 DashScopeTTSRequest {
+  model: string;
+  input: {
+    text: string;
+    voice?: string;
+    format?: "mp3" | "pcm" | "wav" | "opus";
+    sample_rate?: number;
+    volume?: number;
+    rate?: number;
+    pitch?: number;
+    seed?: number;
+    language_hints?: string[];
+    instruction?: string;
+    enable_ssml?: boolean;
+  };
+}
+interface DashScopeTTSResponse {
+  output: {
+    audio: {
+      url: string;
+      expires_at?: string;
+    };
+    finish_reason?: string;
+  };
+  usage?: Record<string, unknown>;
+  request_id: string;
+}
+interface DashScopeTTSStreamChunk {
+  output: {
+    audio: {
+      data?: string;
+      url?: string;
+      expires_at?: string;
+    };
+    finish_reason?: string;
+  };
+  usage?: Record<string, unknown>;
+  request_id?: string;
+}
+interface DashScopeASRRequest {
+  model: string;
+  input: {
+    file_urls: string[];
+  };
+  parameters?: {
+    channel_id?: number[];
+    language_hints?: string[];
+    diarization_enabled?: boolean;
+    speaker_count?: number;
+    vocabulary_id?: string;
+  };
+}
+interface DashScopeASRTaskResult {
+  output: {
+    task_id: string;
+    task_status: "PENDING" | "RUNNING" | "SUCCEEDED" | "FAILED" | "UNKNOWN";
+    results?: Array<{
+      file_url?: string;
+      transcription_url?: string;
+      subtask_status?: string;
+      code?: string;
+      message?: string;
+    }>;
+    task_metrics?: {
+      TOTAL: number;
+      SUCCEEDED: number;
+      FAILED: number;
+    };
+  };
+  usage?: Record<string, unknown>;
+  request_id: string;
+}
+interface DashScopeAsyncResponse {
+  output: {
+    task_id: string;
+    task_status: string;
+  };
+  request_id: string;
+}
+interface DashScopeTaskResponse {
+  output: {
+    task_id: string;
+    task_status: "PENDING" | "RUNNING" | "SUCCEEDED" | "FAILED" | "UNKNOWN";
+    finished?: boolean;
+    task_metrics?: {
+      TOTAL?: number;
+      SUCCEEDED?: number;
+      FAILED?: number;
+    };
+    choices?: Array<{
+      finish_reason: string;
+      message: {
+        role: "assistant";
+        content: Array<{
+          image: string;
+          type: "image";
+        }>;
+      };
+    }>;
+    results?: Array<{
+      url: string;
+    }>;
+    video_url?: string;
+    submit_time?: string;
+    scheduled_time?: string;
+    end_time?: string;
+    code?: string;
+    message?: string;
+  };
+  usage?: Record<string, unknown>;
+  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";
+  readonly us: "https://dashscope-us.aliyuncs.com";
+  readonly intl: "https://dashscope-intl.aliyuncs.com";
+};
+declare const DOCS_HOSTS: {
+  readonly cn: "https://help.aliyun.com/zh/model-studio";
+  readonly us: "https://help.aliyun.com/zh/model-studio";
+  readonly intl: "https://help.aliyun.com/zh/model-studio";
+};
+declare const BAILIAN_HOST = "https://bailian.cn-beijing.aliyuncs.com";
+type Region = keyof typeof REGIONS;
+interface ConfigFile {
+  api_key?: string;
+  /** OAuth-style token from `bl auth login --console` callback; sent as `Authorization: Bearer …` */
+  access_token?: string;
+  region?: Region;
+  base_url?: string;
+  output?: "text" | "json";
+  output_dir?: string;
+  timeout?: number;
+  default_text_model?: string;
+  default_video_model?: string;
+  default_image_model?: string;
+  default_speech_model?: string;
+  default_omni_model?: string;
+  access_key_id?: string;
+  access_key_secret?: string;
+  workspace_id?: string;
+  console_gateway_url?: string;
+  telemetry?: boolean;
+}
+declare function parseConfigFile(raw: unknown): ConfigFile;
+interface Config {
+  clientName?: string;
+  clientVersion?: string;
+  apiKey?: string;
+  /** `DASHSCOPE_ACCESS_TOKEN` env (explicit override). */
+  accessTokenEnv?: string;
+  /** `access_token` in config file (console login). */
+  fileAccessToken?: string;
+  fileApiKey?: string;
+  fileRegion?: Region;
+  configPath?: string;
+  region: Region;
+  baseUrl: string;
+  output: "text" | "json";
+  outputDir?: string;
+  timeout: number;
+  defaultTextModel?: string;
+  defaultVideoModel?: string;
+  defaultImageModel?: string;
+  defaultSpeechModel?: string;
+  defaultOmniModel?: string;
+  accessKeyId?: string;
+  accessKeySecret?: string;
+  workspaceId?: string;
+  consoleGatewayUrl: string;
+  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>;
+/**
+ * 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.
+ */
+/** 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>;
+//#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 {
+  accessKeyId: string;
+  accessKeySecret: string;
+  action: string;
+  version: string;
+  body: string;
+  host: string;
+  pathname: string;
+  method?: string;
+}
+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 mcpWebSearchEndpoint(baseUrl: string): 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/http.d.ts
+interface RequestOpts {
+  url: string;
+  method?: string;
+  body?: unknown;
+  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>;
+//#endregion
+//#region src/client/mcp.d.ts
+interface McpTool {
+  name: string;
+  description?: string;
+  inputSchema?: Record<string, unknown>;
+}
+interface McpToolResult {
+  content: Array<{
+    type: string;
+    text?: string;
+    data?: string;
+    mimeType?: string;
+  }>;
+  isError?: boolean;
+}
+/**
+ * Compose the streamable-HTTP MCP endpoint for a Bailian MCP server.
+ * 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 class McpClient {
+  private url;
+  private sessionId;
+  private nextId;
+  private config;
+  private authToken;
+  constructor(config: Config, url: string);
+  /** Initialize the MCP session. Must be called before any other method. */
+  initialize(): Promise<void>;
+  listTools(): Promise<McpTool[]>;
+  callTool(name: string, args: Record<string, unknown>): Promise<McpToolResult>;
+  private rpc;
+  private notify;
+  private send;
+}
+//#endregion
+//#region src/client/stream.d.ts
+interface ServerSentEvent {
+  event?: string;
+  data: string;
+  id?: string;
+}
+declare function parseSSE(response: Response): AsyncGenerator<ServerSentEvent>;
+//#endregion
+//#region src/console/gateway.d.ts
+interface ConsoleGatewayRequest {
+  /** Console API name, e.g. zeldaEasy.broadscope-bailian.freeTrial.queryFreeTierQuota */
+  api: string;
+  data: Record<string, unknown>;
+  /** Console region (default: cn-beijing), distinct from DashScope `config.region`. */
+  region?: string;
+}
+/**
+ * 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.
+ */
+declare function callConsoleGateway(config: Config, token: string | undefined, {
+  api,
+  data,
+  region
+}: ConsoleGatewayRequest): Promise<unknown>;
+//#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;
+  [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;
+//#endregion
+//#region src/config/paths.d.ts
+declare function getConfigDir(): string;
+declare function getConfigPath(): string;
+declare function getCredentialsPath(): string;
+declare function ensureConfigDir(): Promise<void>;
+//#endregion
+//#region src/output/formatter.d.ts
+type OutputFormat = "text" | "json";
+declare function detectOutputFormat(flagValue?: string): OutputFormat;
+declare function formatOutput(data: unknown, format: OutputFormat): string;
+//#endregion
+//#region src/output/json.d.ts
+declare function formatJson(data: unknown): string;
+declare function formatErrorJson(code: number, message: string, hint?: string): string;
+//#endregion
+//#region src/output/text.d.ts
+declare function formatText(data: unknown): string;
+//#endregion
+//#region src/files/upload.d.ts
+interface UploadOptions {
+  apiKey: string;
+  model: string;
+  filePath: string;
+  signal?: AbortSignal;
+}
+/**
+ * Upload a local file to DashScope temporary storage and return the oss:// URL.
+ * The URL is valid for 48 hours.
+ */
+declare function uploadFile(opts: UploadOptions): Promise<string>;
+/**
+ * Check if a string looks like a local file path (not a URL).
+ */
+declare function isLocalFile(input: string): boolean;
+/**
+ * Resolve a file argument: if it's a local path, upload it and return the oss:// URL.
+ * If it's already a URL, return as-is.
+ */
+declare function resolveFileUrl(input: string, apiKey: string, model: string, opts?: {
+  signal?: AbortSignal;
+}): Promise<string>;
+//#endregion
+//#region src/types/command.d.ts
+interface OptionDef {
+  flag: string;
+  description: string;
+  type?: "string" | "number" | "boolean" | "array";
+  required?: boolean;
+}
+interface Command {
+  name: string;
+  description: string;
+  usage?: string;
+  options?: OptionDef[];
+  examples?: string[];
+  apiDocs?: string;
+  execute: (config: Config, flags: GlobalFlags) => Promise<void>;
+}
+interface CommandSpec {
+  name: string;
+  description: string;
+  usage?: string;
+  options?: OptionDef[];
+  examples?: string[];
+  apiDocs?: 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[];
+//#endregion
+//#region src/utils/filename.d.ts
+declare function generateFilename(prefix: string, prompt: string): string;
+//#endregion
+//#region src/utils/output-dir.d.ts
+/**
+ * Resolve the output directory for generated files.
+ *
+ * Priority:
+ * 1. User-specified dir (e.g. --out-dir flag)
+ * 2. Config file output_dir
+ * 3. Default: ~/bailian-output/
+ *
+ * Optionally appends a subdirectory (e.g. 'images', 'videos', 'speech').
+ * Creates the directory if it doesn't exist.
+ */
+declare function resolveOutputDir(config: Config, options?: {
+  flagDir?: string;
+  subDir?: string;
+}): string;
+//#endregion
+//#region src/utils/schema.d.ts
+declare function generateToolSchema(cmd: Command): Record<string, unknown>;
+//#endregion
+//#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.
+ */
+/**
+ * Remove all keys whose value is `undefined` from a plain object (in-place).
+ * Returns the same reference for chaining convenience.
+ *
+ * ```ts
+ * const params = { a: 1, b: undefined };
+ * stripUndefined(params); // { a: 1 }
+ * ```
+ */
+declare function stripUndefined<T extends Record<string, unknown>>(obj: T): T;
+//#endregion
+//#region src/telemetry/event.d.ts
+interface TrackingEvent {
+  command: string;
+  timestamp: string;
+  durationMs: number;
+  success: boolean;
+  errorMessage?: string;
+  httpStatus?: number;
+  requestId?: string;
+  cliVersion: string;
+  region: string;
+  nodeVersion: string;
+  os: string;
+  authMethod?: string;
+  params?: Record<string, unknown>;
+}
+declare function createTrackingEvent(opts: {
+  command: string;
+  durationMs: number;
+  success: boolean;
+  error?: {
+    message?: string;
+    httpStatus?: number;
+    requestId?: string;
+  };
+  cliVersion: string;
+  region: string;
+  authMethod?: string;
+  params?: Record<string, unknown>;
+}): TrackingEvent;
+//#endregion
+//#region src/telemetry/sink.d.ts
+/**
+ * 尽力等待所有在途的埋点发送完成（best-effort）。
+ *
+ * 1. 先调用 `_sendAll` 排空 tracker 内部的去抖队列，把还卡在 500ms 合并窗口里
+ *    的事件立刻推上网络。
+ * 2. 然后用硬超时 race 所有已追踪的 fetch promise。
+ *
+ * 埋点永远不应阻塞 CLI：调用方应传入较短的超时（例如 1000ms），并始终与超时
+ * race。错误与超时一律静默吞掉。
+ */
+declare function flushTelemetry(timeoutMs?: number): Promise<void>;
+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>;
+//#endregion
+export { AkSignConfig, type ApiErrorBody, AppCompletionRequest, AppCompletionResponse, AppStreamChunk, AuthMethod, BAILIAN_HOST, BailianError, CHANNEL, CONSOLE_GATEWAY_NO_TOKEN_MESSAGE, ChatChoice, ChatMessage, ChatMessageContent, ChatRequest, ChatResponse, ChatTool, Command, CommandSpec, Config, ConfigFile, ConsoleGatewayRequest, DOCS_HOSTS, DashScopeASRRequest, DashScopeASRTaskResult, DashScopeAsyncResponse, DashScopeImageRequest, DashScopeImageSyncResponse, DashScopeTTSRequest, DashScopeTTSResponse, DashScopeTTSStreamChunk, DashScopeTaskResponse, DashScopeVideoEditRequest, DashScopeVideoRefRequest, DashScopeVideoRequest, ExitCode, GLOBAL_OPTIONS, GlobalFlags, KnowledgeRetrieveRequest, KnowledgeRetrieveResponse, McpClient, McpTool, McpToolResult, MemoryAddRequest, MemoryAddResponse, MemoryMessage, MemoryNode, MemoryNodeListResponse, MemoryNodeUpdateRequest, MemorySearchRequest, MemorySearchResponse, OptionDef, OutputFormat, ProfileAttribute, ProfileSchemaCreateRequest, ProfileSchemaCreateResponse, REGIONS, Region, RequestOpts, ResolvedCredential, SOURCE_CONFIG, ServerSentEvent, StreamChoice, StreamChunk, TAGS, TrackingEvent, UserProfileResponse, appCompletionEndpoint, bailianMcpUrl, callConsoleGateway, chatEndpoint, clearApiKey, createTrackingEvent, defineCommand, detectOutputFormat, ensureConfigDir, flushTelemetry, formatErrorJson, formatJson, formatOutput, formatText, generateFilename, generateToolSchema, getConfigDir, getConfigPath, getCredentialsPath, imageEndpoint, imageSyncEndpoint, isCI, isInteractive, isLocalFile, loadApiKeyFromConfig, loadConfig, localSink, mapApiError, maskToken, mcpWebSearchEndpoint, memoryAddEndpoint, memoryListEndpoint, memoryNodeEndpoint, memorySearchEndpoint, parseConfigFile, parseSSE, profileSchemaEndpoint, readConfigFile, remoteSink, request, requestJson, resolveConsoleGatewayCredential, resolveCredential, resolveFileUrl, resolveOutputDir, saveApiKeyToConfig, signRequest, speechRecognizeEndpoint, speechSynthesizeEndpoint, stripUndefined, taskEndpoint, trackCommandExecution, trackingHeaders, uploadFile, userProfileEndpoint, videoGenerateEndpoint, writeConfigFile };