bailian-cli-runtime 1.28.0 → 2.0.1

package/dist/index.d.mts

@@ -1,5 +1,4 @@
 import { AnyCommand, ApiKeyCredential, AuthStore, Client, Command, CommandPackManager, ConfigStore, FlagDef, FlagsDef, Identity, ImageSizeProfile, Language, LocalizedText, OutputFormat, ParsedFlags, ResolutionSources, Settings, UsageError } from "bailian-cli-core";
-
 //#region src/command-packs/types.d.ts
 interface CommandPackDefinition {
   commandPrefixes: readonly string[];
@@ -36,7 +35,7 @@ interface Cli {
  * its own commands + identity. `run` resolves argv into a {@link Resolution},
  * then dispatches it.
  */
-declare function createCli(commands: Record<string, AnyCommand>, opts: CliOptions): Cli;
+export declare function createCli(commands: Record<string, AnyCommand>, opts: CliOptions): Cli;
 //#endregion
 //#region src/i18n.d.ts
 /** Per-CLI localized text selector. */
@@ -65,7 +64,7 @@ type LocateResult = {
   kind: "unknown";
   error: UsageError;
 };
-declare class CommandRegistry {
+export declare class CommandRegistry {
   private root;
   /** Binary name shown in usage/help/error strings (e.g. "bl", "rag"). */
   private readonly cliName;
@@ -129,7 +128,7 @@ type Resolution = {
  * `parsePath` scan for the command path + flag region, one `registry.locate`
  * for the routing decision. Never throws. Trivially unit-testable.
  */
-declare function resolve(argv: string[], registry: CommandRegistry): Resolution;
+export declare function resolve(argv: string[], registry: CommandRegistry): Resolution;
 //#endregion
 //#region src/middleware.d.ts
 /**
@@ -165,7 +164,7 @@ interface RunContext {
 /** Koa-style onion middleware: do work, call `next()`, do work after it returns. */
 type Middleware = (ctx: RunContext, next: () => Promise<void>) => Promise<void>;
 /** Fold a middleware list into a single runnable function. */
-declare function compose(stack: Middleware[]): (ctx: RunContext) => Promise<void>;
+export declare function compose(stack: Middleware[]): (ctx: RunContext) => Promise<void>;
 //#endregion
 //#region src/args.d.ts
 interface ParsePathResult {
@@ -182,22 +181,22 @@ interface ParsePathResult {
  * oclif-style). There are no positionals, so nothing bare can legitimately
  * follow a flag — and no flags precede the path, so this needs no schema.
  */
-declare function parsePath(argv: string[]): ParsePathResult;
+export declare function parsePath(argv: string[]): ParsePathResult;
 /**
  * Second pass — parse the flag region into typed values, driven entirely by the
  * keyed FlagsDef (key = camelCase flag name). Pure: returns typed flags or
  * throws UsageError — never prints/exits. The error boundary decides rendering.
  */
-declare function parseFlags<F extends FlagsDef>(rest: string[], defs: F): ParsedFlags<F>;
+export declare function parseFlags<F extends FlagsDef>(rest: string[], defs: F): ParsedFlags<F>;
 //#endregion
 //#region src/proxy.d.ts
-declare function setupProxyFromEnv(): void;
+export declare function setupProxyFromEnv(): void;
 //#endregion
 //#region src/error-handler.d.ts
-declare function handleError(err: unknown, cliName: string): never;
+export declare function handleError(err: unknown, cliName: string): never;
 //#endregion
 //#region src/version.d.ts
-declare const CLI_VERSION: string;
+export declare const CLI_VERSION: string;
 //#endregion
 //#region src/urls.d.ts
 /**
@@ -208,22 +207,28 @@ declare const CLI_VERSION: string;
  * if/when overseas console support is added.
  */
 /** Root entry — generic console landing, region picker. */
-declare const BAILIAN_CONSOLE_ROOT = "https://bailian.console.aliyun.com";
+export declare const BAILIAN_CONSOLE_ROOT = "https://bailian.console.aliyun.com";
 /** Region-pinned console base. Add a region map if/when overseas is supported. */
-declare const BAILIAN_CONSOLE = "https://bailian.console.aliyun.com/cn-beijing";
+export declare const BAILIAN_CONSOLE = "https://bailian.console.aliyun.com/cn-beijing";
 /** Direct deep link to API key management page. */
-declare const API_KEY_PAGE = "https://bailian.console.aliyun.com/cn-beijing/?tab=app#/api-key";
+export declare const API_KEY_PAGE = "https://bailian.console.aliyun.com/cn-beijing/?tab=app#/api-key";
 /** Direct deep link to the Token Plan subscription overview and API key entry. */
-declare const TOKEN_PLAN_PAGE = "https://bailian.console.aliyun.com/cn-beijing?tab=plan#/efm/subscription/overview";
+export declare const TOKEN_PLAN_PAGE = "https://bailian.console.aliyun.com/cn-beijing?tab=plan#/efm/subscription/overview";
 /** MCP marketplace detail page for a server code (e.g. WebSearch, market-cmapi00073529). */
-declare function mcpMarketplaceDetailPage(serverCode: string): string;
+export declare function mcpMarketplaceDetailPage(serverCode: string): string;
 /**
  * MCP marketplace detail for the built-in WebSearch server.
  * Users must activate (or re-activate for Streamable HTTP) before `search web` works.
  */
-declare const MCP_WEBSEARCH_PAGE: string;
+export declare const MCP_WEBSEARCH_PAGE: string;
 /** Voice TTS experience center — browse system and custom voices. */
-declare const VOICE_TTS_PAGE = "https://help.aliyun.com/zh/model-studio/cosyvoice-voice-list";
+export declare const VOICE_TTS_PAGE = "https://help.aliyun.com/zh/model-studio/cosyvoice-voice-list";
+/**
+ * Aliyun billing console refund (unsubscribe) page for one prepaid instance.
+ * Unsubscribing a prepaid PTU capacity instance is a billing action that has
+ * no API; users complete it here with the account that placed the order.
+ */
+export declare function refundConsolePage(instanceId: string): string;
 //#endregion
 //#region src/output/output.d.ts
 /**
@@ -231,12 +236,12 @@ declare const VOICE_TTS_PAGE = "https://help.aliyun.com/zh/model-studio/cosyvoic
  *   stdout → result (text by default; JSON with --output json)
  *   stderr → human info (progress, logs, tips) — handled elsewhere
  */
-declare function emitResult(data: unknown, format: OutputFormat): void;
+export declare function emitResult(data: unknown, format: OutputFormat): void;
 /**
  * Emit a bare value (file path, plain text) to stdout.
  * Used in --quiet mode or when the result is a single scalar.
  */
-declare function emitBare(value: string): void;
+export declare function emitBare(value: string): void;
 /**
  * Surface a server request id for text-mode output. Written to stderr (the
  * diagnostic channel) so it never corrupts the primary stdout result, mirroring
@@ -244,7 +249,7 @@ declare function emitBare(value: string): void;
  * absent (e.g. dry-run) or in --quiet mode (which owes callers a bare scalar).
  * JSON output surfaces request_id inside the payload instead of calling this.
  */
-declare function emitRequestId(requestId: string | undefined, quiet: boolean): void;
+export declare function emitRequestId(requestId: string | undefined, quiet: boolean): void;
 //#endregion
 //#region src/output/table.d.ts
 /**
@@ -254,9 +259,7 @@ declare function emitRequestId(requestId: string | undefined, quiet: boolean): v
  * outputs space-padded columns so the table is human-readable.
  */
 /** Produce aligned text lines from headers + rows (all string[]). */
-declare function formatTable(headers: string[], rows: string[][], {
-  gap
-}?: {
+export declare function formatTable(headers: string[], rows: string[][], { gap }?: {
   gap?: number;
 }): string[];
 //#endregion
@@ -293,12 +296,12 @@ interface GaugeCell {
  * transparent track, and a light-blue label after the bar. `percent` is 0-100;
  * null renders an empty gauge with a neutral label.
  */
-declare function renderGauge(percent: number | null, label: string, width?: number, out?: NodeJS.WriteStream): GaugeCell;
+export declare function renderGauge(percent: number | null, label: string, width?: number, out?: NodeJS.WriteStream): GaugeCell;
 /**
  * Render a bordered table as an array of lines. The header row is drawn as a
  * solid highlight bar that extends to the full table width.
  */
-declare function renderBoxTable(options: BoxTableOptions): string[];
+export declare function renderBoxTable(options: BoxTableOptions): string[];
 //#endregion
 //#region src/output/progress.d.ts
 interface Spinner {
@@ -306,23 +309,23 @@ interface Spinner {
   update(text: string): void;
   stop(finalText?: string): void;
 }
-declare function createSpinner(label: string): Spinner;
+export declare function createSpinner(label: string): Spinner;
 interface ProgressBar {
   update(current: number): void;
   finish(): void;
 }
-declare function createProgressBar(total: number, label?: string): ProgressBar;
+export declare function createProgressBar(total: number, label?: string): ProgressBar;
 //#endregion
 //#region src/output/banner.d.ts
-declare function printWelcomeBanner(cliName: string, translator?: Translator): void;
-declare function printQuickStart(tasks: readonly string[], language?: Language): void;
+export declare function printWelcomeBanner(cliName: string, translator?: Translator): void;
+export declare function printQuickStart(tasks: readonly string[], language?: Language): void;
 //#endregion
 //#region src/output/status-bar.d.ts
-declare function maybeShowStatusBar(settings: Settings, token: string, resolved: ApiKeyCredential): void;
+export declare function maybeShowStatusBar(settings: Settings, token: string, resolved: ApiKeyCredential): void;
 //#endregion
 //#region src/output/cjk-width.d.ts
-declare function displayWidth(text: string): number;
-declare function padEnd(text: string, targetWidth: number): string;
+export declare function displayWidth(text: string): number;
+export declare function padEnd(text: string, targetWidth: number): string;
 //#endregion
 //#region src/output/color.d.ts
 type TextStyle = (text: string) => string;
@@ -343,9 +346,9 @@ interface AnsiStyles {
   keyPink: TextStyle;
   reset: string;
 }
-declare function isTerminal(out: NodeJS.WriteStream): boolean;
-declare function supportsColor(out: NodeJS.WriteStream): boolean;
-declare function ansi(out: NodeJS.WriteStream): AnsiStyles;
+export declare function isTerminal(out: NodeJS.WriteStream): boolean;
+export declare function supportsColor(out: NodeJS.WriteStream): boolean;
+export declare function ansi(out: NodeJS.WriteStream): AnsiStyles;
 //#endregion
 //#region src/utils/polling.d.ts
 interface PollOptions {
@@ -358,19 +361,19 @@ interface PollOptions {
   getStatus?: (data: unknown) => string;
   getErrorMessage?: (data: unknown) => string | undefined;
 }
-declare function poll<T>(client: Client, settings: Settings, opts: PollOptions): Promise<T>;
+export declare function poll<T>(client: Client, settings: Settings, opts: PollOptions): Promise<T>;
 //#endregion
 //#region src/utils/download.d.ts
-declare function downloadFile(url: string, destPath: string, opts?: {
+export declare function downloadFile(url: string, destPath: string, opts?: {
   quiet?: boolean;
 }): Promise<{
   size: number;
 }>;
-declare function formatBytes(bytes: number): string;
+export declare function formatBytes(bytes: number): string;
 //#endregion
 //#region src/utils/concurrent.d.ts
 /** Resolve concurrency from parsed command flags(`--concurrent`,defaults to 1). */
-declare function getConcurrency(flags: {
+export declare function getConcurrency(flags: {
   concurrent?: number;
 }): number;
 /**
@@ -383,7 +386,7 @@ declare function getConcurrency(flags: {
  * @param task     Async factory to execute
  * @param label    Optional label for status output (e.g. "requests", "tasks")
  */
-declare function runConcurrent<T>(n: number, settings: Settings, task: (index: number) => Promise<T>, label?: string): Promise<T[]>;
+export declare function runConcurrent<T>(n: number, settings: Settings, task: (index: number) => Promise<T>, label?: string): Promise<T[]>;
 /**
  * Parallel download helper — downloads multiple URLs concurrently.
  *
@@ -392,7 +395,7 @@ declare function runConcurrent<T>(n: number, settings: Settings, task: (index: n
  * @param opts   Options passed to download function
  * @returns Array of saved file paths in order
  */
-declare function downloadParallel(items: Array<{
+export declare function downloadParallel(items: Array<{
   url: string;
   destPath: string;
 }>, downloadFn: (url: string, destPath: string, opts?: {
@@ -403,19 +406,19 @@ declare function downloadParallel(items: Array<{
 //#endregion
 //#region src/utils/image-size.d.ts
 /** Resolve `--size` with an explicit model size profile. */
-declare function resolveImageSize(input: string, sizeProfile: ImageSizeProfile): string;
-declare function resolveImageSize(input: string | undefined, sizeProfile: ImageSizeProfile): string | undefined;
+export declare function resolveImageSize(input: string, sizeProfile: ImageSizeProfile): string;
+export declare function resolveImageSize(input: string | undefined, sizeProfile: ImageSizeProfile): string | undefined;
 /** @deprecated Prefer `ImageSizeProfile`; boolean maps sync→qwen-image-2.0 / async→qwen-image-fixed. */
-declare function resolveImageSize(input: string, useSync: boolean): string;
-declare function resolveImageSize(input: string | undefined, useSync: boolean): string | undefined;
+export declare function resolveImageSize(input: string, useSync: boolean): string;
+export declare function resolveImageSize(input: string | undefined, useSync: boolean): string | undefined;
 //#endregion
 //#region src/utils/update-checker.d.ts
-declare const NPM_REGISTRY = "https://registry.npmjs.org";
+export declare const NPM_REGISTRY = "https://registry.npmjs.org";
 /** Default npm package; products override per-call via the `npmPackage` argument. */
-declare const NPM_PACKAGE = "bailian-cli";
-declare function fetchLatestVersion(timeoutMs?: number, npmPackage?: string): Promise<string | null>;
-declare function getPendingUpdateNotification(): string | null;
-declare function checkForUpdate(currentVersion: string, npmPackage?: string, clientName?: string): Promise<void>;
+export declare const NPM_PACKAGE = "bailian-cli";
+export declare function fetchLatestVersion(timeoutMs?: number, npmPackage?: string): Promise<string | null>;
+export declare function getPendingUpdateNotification(): string | null;
+export declare function checkForUpdate(currentVersion: string, npmPackage?: string, clientName?: string): Promise<void>;
 //#endregion
 //#region src/utils/binary-update.d.ts
 interface ChannelManifest {
@@ -428,17 +431,17 @@ interface ChannelManifest {
   }>;
 }
 /** Product share root: versions/, current, and (on Windows) bin/. */
-declare function getBinaryShareRoot(): string;
+export declare function getBinaryShareRoot(): string;
 /** PATH directory that should expose `bl` / `bailian`. */
-declare function getBinaryBinRoot(): string;
-declare function getBinaryVersionsDir(): string;
-declare function getBinaryCurrentPath(): string;
-declare function fetchBinaryChannelVersion(channel?: string, timeoutMs?: number): Promise<string | null>;
-declare function fetchBinaryChannelManifest(channel?: string, timeoutMs?: number): Promise<ChannelManifest | null>;
+export declare function getBinaryBinRoot(): string;
+export declare function getBinaryVersionsDir(): string;
+export declare function getBinaryCurrentPath(): string;
+export declare function fetchBinaryChannelVersion(channel?: string, timeoutMs?: number): Promise<string | null>;
+export declare function fetchBinaryChannelManifest(channel?: string, timeoutMs?: number): Promise<ChannelManifest | null>;
 /** Strip a leading `v` from release-style tags (`v1.2.3` → `1.2.3`). */
-declare function normalizeBinaryVersion(raw: string): string;
+export declare function normalizeBinaryVersion(raw: string): string;
 /** True if `raw` is a usable `--to` target after trim (optional `v` prefix). */
-declare function isValidUpdateTargetVersion(raw: string): boolean;
+export declare function isValidUpdateTargetVersion(raw: string): boolean;
 interface BinaryDownloadSpec {
   zipName: string;
   innerName: string;
@@ -451,26 +454,26 @@ interface BinaryDownloadSpec {
  * manifest `url` / `file`. Checksum prefers per-version SHA256SUMS, then the
  * latest rolling manifest only when it points at the same version.
  */
-declare function resolveBinaryDownloadSpec(targetVersion: string): Promise<BinaryDownloadSpec>;
+export declare function resolveBinaryDownloadSpec(targetVersion: string): Promise<BinaryDownloadSpec>;
 /** Resolve which version directory `current` points at, if any. */
-declare function readCurrentVersionDir(): Promise<string | null>;
+export declare function readCurrentVersionDir(): Promise<string | null>;
 /**
  * Point `shareRoot/current` at `versions/<version>/`.
  * Unix: directory symlink. Windows: directory junction.
  * Retargets in place so PATH entries that go through `current` keep working.
  */
-declare function switchCurrentToVersion(version: string): Promise<string>;
+export declare function switchCurrentToVersion(version: string): Promise<string>;
 /**
  * Ensure PATH bin entries resolve through `current` (Codex-style).
  * - Unix: `~/.local/bin/{bl,bailian}` → `current/bl`
  * - Windows: `shareRoot/bin` is a junction → `current` (contains bl.exe + bailian.exe)
  */
-declare function ensureBinaryPathEntries(version: string): Promise<void>;
+export declare function ensureBinaryPathEntries(version: string): Promise<void>;
 /**
  * Keep only the listed version directory names under `versions/`.
  * Always preserves directories that are still the live `current` target.
  */
-declare function pruneBinaryVersions(keepVersions: string[]): Promise<void>;
+export declare function pruneBinaryVersions(keepVersions: string[]): Promise<void>;
 /**
  * Download and install a newer standalone binary using Codex-style layout:
  * `versions/<ver>/` + retarget `current` + path entries through `current`.
@@ -479,26 +482,26 @@ declare function pruneBinaryVersions(keepVersions: string[]): Promise<void>;
  * Does not overwrite a running executable image: old version files stay locked
  * by the current process; the next invocation follows the updated pointer.
  */
-declare function performBinaryUpdate(targetVersion: string): Promise<string>;
+export declare function performBinaryUpdate(targetVersion: string): Promise<string>;
 //#endregion
 //#region src/utils/flag-descriptions.d.ts
 /** Shared --foo <bool> help text; keep wording consistent with actual CLI/request behavior. */
-declare const BOOL_FLAG_WATERMARK: {
+export declare const BOOL_FLAG_WATERMARK: {
   "en-US": string;
   "zh-CN": string;
 };
 /** CLI sends prompt_extend=true when flag omitted (qwen-image edit, etc.). */
-declare const BOOL_FLAG_PROMPT_EXTEND_CLI_TRUE: {
+export declare const BOOL_FLAG_PROMPT_EXTEND_CLI_TRUE: {
   "en-US": string;
   "zh-CN": string;
 };
 /** Sync qwen-image defaults on; async models omit the field unless flag is set. */
-declare const BOOL_FLAG_PROMPT_EXTEND_IMAGE_GENERATE: {
+export declare const BOOL_FLAG_PROMPT_EXTEND_IMAGE_GENERATE: {
   "en-US": string;
   "zh-CN": string;
 };
 /** CLI omits prompt_extend in the request when flag is unset (video commands). */
-declare const BOOL_FLAG_PROMPT_EXTEND_API_DEFAULT: {
+export declare const BOOL_FLAG_PROMPT_EXTEND_API_DEFAULT: {
   "en-US": string;
   "zh-CN": string;
 };
@@ -790,18 +793,18 @@ declare class StepDispatcher {
 }
 //#endregion
 //#region src/pipeline/init.d.ts
-declare function initPipelineSteps(dispatcher?: StepDispatcher): StepDispatcher;
+export declare function initPipelineSteps(dispatcher?: StepDispatcher): StepDispatcher;
 //#endregion
 //#region src/pipeline/validation.d.ts
-declare function collectPipelineIssues(pipeline: PipelineDefinition, dispatcher?: StepDispatcher): string[];
+export declare function collectPipelineIssues(pipeline: PipelineDefinition, dispatcher?: StepDispatcher): string[];
 /**
  * Collect non-blocking hints about potentially invalid $from paths.
  * These do not prevent execution but help workflow authors catch typos.
  */
-declare function collectPipelineHints(pipeline: PipelineDefinition, dispatcher?: StepDispatcher): string[];
+export declare function collectPipelineHints(pipeline: PipelineDefinition, dispatcher?: StepDispatcher): string[];
 //#endregion
 //#region src/pipeline/executor.d.ts
-declare function executePipeline(pipeline: PipelineDefinition, runtimeInput?: Record<string, unknown>, options?: ExecutePipelineOptions): Promise<PipelineExecutionReport>;
-declare function streamPipelineEvents(pipeline: PipelineDefinition, runtimeInput?: Record<string, unknown>, options?: Pick<ExecutePipelineOptions, "concurrency" | "basePath" | "dryRun" | "signal" | "timeoutSeconds" | "blRequestTimeoutSeconds" | "stepDispatcher">): AsyncGenerator<PipelineLifecycleEvent>;
+export declare function executePipeline(pipeline: PipelineDefinition, runtimeInput?: Record<string, unknown>, options?: ExecutePipelineOptions): Promise<PipelineExecutionReport>;
+export declare function streamPipelineEvents(pipeline: PipelineDefinition, runtimeInput?: Record<string, unknown>, options?: Pick<ExecutePipelineOptions, "concurrency" | "basePath" | "dryRun" | "signal" | "timeoutSeconds" | "blRequestTimeoutSeconds" | "stepDispatcher">): AsyncGenerator<PipelineLifecycleEvent>;
 //#endregion
-export { API_KEY_PAGE, type AnsiStyles, BAILIAN_CONSOLE, BAILIAN_CONSOLE_ROOT, BOOL_FLAG_PROMPT_EXTEND_API_DEFAULT, BOOL_FLAG_PROMPT_EXTEND_CLI_TRUE, BOOL_FLAG_PROMPT_EXTEND_IMAGE_GENERATE, BOOL_FLAG_WATERMARK, type BarColumn, type BoxTableOptions, CLI_VERSION, type Cli, type CliOptions, type Command, type CommandPackCredentialAccess, type CommandPackDefinition, type CommandPackPolicy, CommandRegistry, type FlagDef, type GaugeCell, type LocateResult, MCP_WEBSEARCH_PAGE, type Middleware, NPM_PACKAGE, NPM_REGISTRY, type ParsePathResult, type PipelineDefinition, type PipelineLifecycleEvent, type Resolution, type RunContext, TOKEN_PLAN_PAGE, type TextStyle, VOICE_TTS_PAGE, ansi, checkForUpdate, collectPipelineHints, collectPipelineIssues, compose, createCli, createProgressBar, createSpinner, displayWidth, downloadFile, downloadParallel, emitBare, emitRequestId, emitResult, ensureBinaryPathEntries, executePipeline, fetchBinaryChannelManifest, fetchBinaryChannelVersion, fetchLatestVersion, formatBytes, formatTable, getBinaryBinRoot, getBinaryCurrentPath, getBinaryShareRoot, getBinaryVersionsDir, getConcurrency, getPendingUpdateNotification, handleError, initPipelineSteps, isTerminal, isValidUpdateTargetVersion, maybeShowStatusBar, mcpMarketplaceDetailPage, normalizeBinaryVersion, padEnd, parseFlags, parsePath, performBinaryUpdate, poll, printQuickStart, printWelcomeBanner, pruneBinaryVersions, readCurrentVersionDir, renderBoxTable, renderGauge, resolve, resolveBinaryDownloadSpec, resolveImageSize, runConcurrent, setupProxyFromEnv, streamPipelineEvents, supportsColor, switchCurrentToVersion };
+export type { AnsiStyles, BarColumn, BoxTableOptions, Cli, CliOptions, Command, CommandPackCredentialAccess, CommandPackDefinition, CommandPackPolicy, FlagDef, GaugeCell, LocateResult, Middleware, ParsePathResult, PipelineDefinition, PipelineLifecycleEvent, Resolution, RunContext, TextStyle };