bailian-cli-core 1.1.3 → 1.2.0

package/dist/index.d.mts

@@ -731,24 +731,22 @@ interface McpToolResult {
   }>;
   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 baseUrl;
+  private url;
   private sessionId;
   private nextId;
   private config;
   private authToken;
-  constructor(config: Config, baseUrl: string);
-  /**
-   * Initialize the MCP session. Must be called before any other method.
-   */
+  constructor(config: Config, url: string);
+  /** Initialize the MCP session. Must be called before any other method. */
   initialize(): Promise<void>;
-  /**
-   * List available tools from the MCP server.
-   */
   listTools(): Promise<McpTool[]>;
-  /**
-   * Call a tool on the MCP server.
-   */
   callTool(name: string, args: Record<string, unknown>): Promise<McpToolResult>;
   private rpc;
   private notify;
@@ -783,6 +781,21 @@ declare function callConsoleGateway(config: Config, token: string | undefined, {
   region
 }: ConsoleGatewayRequest): Promise<unknown>;
 //#endregion
+//#region src/console/models.d.ts
+interface ModelListParams {
+  pageNo?: number;
+  pageSize?: number;
+  name?: string;
+  providers?: string[];
+  capabilities?: string[];
+  region?: string;
+}
+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;
@@ -944,6 +957,18 @@ declare function isCI(): boolean;
  */
 declare function stripUndefined<T extends Record<string, unknown>>(obj: T): T;
 //#endregion
+//#region src/utils/boolean-flag.d.ts
+/** Parse true/false from CLI flags (e.g. `--watermark <bool>`). */
+declare function parseBooleanValue(value: unknown, label?: string): boolean;
+declare function parseOptionalBooleanValue(value: unknown, label?: string): boolean | undefined;
+/**
+ * Resolve a tri-state boolean CLI flag (`--name <bool>`).
+ * Returns `defaultWhenUnset` when the flag is omitted.
+ */
+declare function resolveBooleanFlag(flagValue: unknown, defaultWhenUnset: boolean | undefined, label?: string): boolean | undefined;
+/** Resolve `--watermark` flag; default true when unset. */
+declare function resolveWatermark(flagValue: unknown): boolean;
+//#endregion
 //#region src/telemetry/event.d.ts
 interface TrackingEvent {
   command: string;
@@ -993,4 +1018,191 @@ declare function remoteSink(event: TrackingEvent): Promise<void>;
 //#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, 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 };
+//#region src/advisor/types.d.ts
+type Modality = "Text" | "Image" | "Video" | "Audio";
+type Complexity = "single" | "pipeline";
+type Budget = "low" | "medium" | "high";
+type ContextNeed = "standard" | "large" | "extra-large";
+type QualityPreference = "flagship" | "balanced" | "cost-optimized";
+type Capability = "TG" | "Reasoning" | "VU" | "IG" | "VG" | "TTS" | "ASR" | "Realtime-ASR" | "Realtime-Text-to-Speech" | "Realtime-Audio-Translate" | "Realtime-Omni" | "Multimodal-Omni" | "ME" | "TR" | "3D-generation";
+type Feature = "function-calling" | "web-search" | "structured-outputs" | "prefix-completion";
+type ModelCategory = "Flagship" | "Cost-optimized";
+type PreferenceMode = "unconstrained" | "scoped" | "comparison" | "alternative";
+interface ModelPreference {
+  mode: PreferenceMode;
+  targets?: string[];
+  excludes?: string[];
+}
+declare const Modalities: {
+  readonly Text: "Text";
+  readonly Image: "Image";
+  readonly Video: "Video";
+  readonly Audio: "Audio";
+};
+declare const Complexities: {
+  readonly Single: "single";
+  readonly Pipeline: "pipeline";
+};
+declare const Budgets: {
+  readonly Low: "low";
+  readonly Medium: "medium";
+  readonly High: "high";
+};
+declare const ContextNeeds: {
+  readonly Standard: "standard";
+  readonly Large: "large";
+  readonly ExtraLarge: "extra-large";
+};
+declare const QualityPreferences: {
+  readonly Flagship: "flagship";
+  readonly Balanced: "balanced";
+  readonly CostOptimized: "cost-optimized";
+};
+declare const Capabilities: {
+  readonly TG: "TG";
+  readonly Reasoning: "Reasoning";
+  readonly VU: "VU";
+  readonly IG: "IG";
+  readonly VG: "VG";
+  readonly TTS: "TTS";
+  readonly ASR: "ASR";
+  readonly RealtimeASR: "Realtime-ASR";
+  readonly RealtimeTTS: "Realtime-Text-to-Speech";
+  readonly RealtimeAudioTranslate: "Realtime-Audio-Translate";
+  readonly RealtimeOmni: "Realtime-Omni";
+  readonly MultimodalOmni: "Multimodal-Omni";
+  readonly ME: "ME";
+  readonly TR: "TR";
+  readonly ThreeDGeneration: "3D-generation";
+};
+declare const Features: {
+  readonly FunctionCalling: "function-calling";
+  readonly WebSearch: "web-search";
+  readonly StructuredOutputs: "structured-outputs";
+  readonly PrefixCompletion: "prefix-completion";
+};
+declare const ModelCategories: {
+  readonly Flagship: "Flagship";
+  readonly CostOptimized: "Cost-optimized";
+};
+interface IntentSegment {
+  step: string;
+  inputModality: Modality[];
+  outputModality: Modality[];
+  requiredCapabilities: Capability[];
+}
+interface IntentProfile {
+  complexity: Complexity;
+  segments?: IntentSegment[];
+  taskSummary: string;
+  scenarioHints: string[];
+  inputModality: Modality[];
+  outputModality: Modality[];
+  requiredCapabilities: Capability[];
+  requiredFeatures: Feature[];
+  budget: Budget;
+  contextNeed: ContextNeed;
+  qualityPreference: QualityPreference;
+  confidence: number;
+  modelPreference?: ModelPreference;
+}
+interface ModelPrice {
+  type: string;
+  unit: string;
+  price: string;
+}
+interface QpmLimit {
+  count_limit: number;
+  count_limit_period: number;
+  usage_limit: number;
+  usage_limit_field: string;
+  usage_limit_period: number;
+}
+interface ModelProfile {
+  model: string;
+  name: string;
+  description: string;
+  provider: string;
+  capabilities: string[];
+  features: string[];
+  contextWindow?: number;
+  maxOutputTokens?: number;
+  docUrl?: string;
+  inferenceMetadata?: {
+    request_modality?: Modality[];
+    response_modality?: Modality[];
+  };
+  shortDescription?: string;
+  category?: ModelCategory;
+  collectionTag?: string;
+  maxInputTokens?: number;
+  prices?: ModelPrice[];
+  qpmInfo?: Record<string, QpmLimit>;
+  versionTag?: string;
+  openSource?: boolean;
+  family?: string;
+  familyName?: string;
+}
+interface RecommendedModel {
+  model: string;
+  name: string;
+  reason: string;
+  highlights: string[];
+  category?: ModelCategory;
+  contextWindow?: number;
+  maxOutputTokens?: number;
+  docUrl?: string;
+}
+interface PipelineStep {
+  step: string;
+  recommendations: RecommendedModel[];
+  warnings?: string[];
+}
+interface SingleResult {
+  type: "single";
+  recommendations: RecommendedModel[];
+}
+interface PipelineResult {
+  type: "pipeline";
+  summary: string;
+  steps: PipelineStep[];
+}
+type RecommendResult = SingleResult | PipelineResult;
+//#endregion
+//#region src/advisor/cache.d.ts
+interface GetModelsOptions {
+  onPrepareStart?: () => void;
+}
+declare function getModels(config: Config, options?: GetModelsOptions): Promise<ModelProfile[]>;
+//#endregion
+//#region src/advisor/intent.d.ts
+declare function analyzeIntent(config: Config, input: string): Promise<IntentProfile>;
+//#endregion
+//#region src/advisor/recall.d.ts
+interface ScoredCandidate {
+  model: ModelProfile;
+  score: 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[]>;
+//#endregion
+//#region src/advisor/recommend.d.ts
+interface RecommendOptions {
+  onThinking?: (text: string) => void;
+  onContentStart?: () => void;
+  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>;
+//#endregion
+//#region src/advisor/sources/types.d.ts
+interface ModelSource {
+  name: string;
+  available(): boolean;
+  load(): Promise<ModelProfile[]>;
+}
+//#endregion
+export { AkSignConfig, type ApiErrorBody, AppCompletionRequest, AppCompletionResponse, AppStreamChunk, AuthMethod, BAILIAN_HOST, BailianError, Budget, Budgets, CHANNEL, CONSOLE_GATEWAY_NO_TOKEN_MESSAGE, Capabilities, Capability, ChatChoice, ChatMessage, ChatMessageContent, ChatRequest, ChatResponse, ChatTool, Command, CommandSpec, Complexities, Complexity, Config, ConfigFile, ConsoleGatewayRequest, ContextNeed, ContextNeeds, DOCS_HOSTS, DashScopeASRRequest, DashScopeASRTaskResult, DashScopeAsyncResponse, DashScopeImageRequest, DashScopeImageSyncResponse, DashScopeTTSRequest, DashScopeTTSResponse, DashScopeTTSStreamChunk, DashScopeTaskResponse, DashScopeVideoEditRequest, DashScopeVideoRefRequest, DashScopeVideoRequest, ExitCode, Feature, Features, GLOBAL_OPTIONS, GetModelsOptions, GlobalFlags, IntentProfile, IntentSegment, KnowledgeRetrieveRequest, KnowledgeRetrieveResponse, McpClient, McpTool, McpToolResult, MemoryAddRequest, MemoryAddResponse, MemoryMessage, MemoryNode, MemoryNodeListResponse, MemoryNodeUpdateRequest, MemorySearchRequest, MemorySearchResponse, Modalities, Modality, ModelCategories, ModelCategory, ModelListParams, ModelListResult, ModelPreference, ModelPrice, ModelProfile, ModelSource, OptionDef, OutputFormat, PipelineResult, PipelineStep, PreferenceMode, ProfileAttribute, ProfileSchemaCreateRequest, ProfileSchemaCreateResponse, QpmLimit, QualityPreference, QualityPreferences, REGIONS, RecommendOptions, RecommendResult, RecommendedModel, Region, RequestOpts, ResolvedCredential, SOURCE_CONFIG, ScoredCandidate, ServerSentEvent, SingleResult, StreamChoice, StreamChunk, TAGS, TrackingEvent, UserProfileResponse, analyzeIntent, appCompletionEndpoint, bailianMcpUrl, buildDocLink, callConsoleGateway, chatEndpoint, clearApiKey, createTrackingEvent, defineCommand, detectOutputFormat, ensureConfigDir, fetchModelList, flushTelemetry, formatErrorJson, formatJson, formatOutput, formatText, generateFilename, generateToolSchema, getConfigDir, getConfigPath, getCredentialsPath, getModels, imageEndpoint, imageSyncEndpoint, isCI, isInteractive, isLocalFile, isSemanticAvailable, loadApiKeyFromConfig, loadConfig, localSink, mapApiError, maskToken, mcpWebSearchEndpoint, memoryAddEndpoint, memoryListEndpoint, memoryNodeEndpoint, memorySearchEndpoint, parseBooleanValue, parseConfigFile, parseOptionalBooleanValue, parseSSE, profileSchemaEndpoint, rankModels, readConfigFile, recallCandidates, recallSemantic, remoteSink, request, requestJson, resolveBooleanFlag, resolveConsoleGatewayCredential, resolveCredential, resolveFileUrl, resolveOutputDir, resolveWatermark, saveApiKeyToConfig, signRequest, speechRecognizeEndpoint, speechSynthesizeEndpoint, stripUndefined, taskEndpoint, trackCommandExecution, trackingHeaders, uploadFile, userProfileEndpoint, videoGenerateEndpoint, writeConfigFile };