bailian-cli-core 2.2.1 → 2.3.0

package/README.md

@@ -7,7 +7,7 @@ Internal SDK for [`bailian-cli`](https://www.npmjs.com/package/bailian-cli).
 Not intended for direct use. For installation, usage, and documentation, see the CLI package:
 
 - npm: <https://www.npmjs.com/package/bailian-cli>
-- Homepage: <https://bailian.console.aliyun.com/cli?source_channel=cli_github&>
+- Homepage: <https://bailian.console.aliyun.com/cli?spm=a2ty07.github>
 
 ## License
 

package/README.zh.md

@@ -7,7 +7,7 @@
 不建议直接使用。安装、使用方式与文档请参考 CLI:
 
 - npm:<https://www.npmjs.com/package/bailian-cli>
-- 主页:<https://bailian.console.aliyun.com/cli?source_channel=cli_github&>
+- 主页:<https://bailian.console.aliyun.com/cli?spm=a2ty07.github>
 
 ## License
 

package/dist/index.d.mts

@@ -1875,6 +1875,7 @@ export declare function refreshAccessToken(opts: {
 //#region src/client/endpoints.d.ts
 export declare function chatPath(): string;
 export declare function responsesPath(): string;
+export declare function decisionPath(): string;
 /** Async image API used by wan2.6-t2i / wan2.6-image (T2I) and similar message-format models. */
 export declare function imagePath(): string;
 /** Sync multimodal API (qwen-image / wan2.7-image / z-image generate; also wan2.6-image edit). */
@@ -1900,7 +1901,7 @@ export declare function speechVocabularyPath(): string;
 export declare function profileSchemaPath(): string;
 export declare function userProfilePath(schemaId: string): string;
 export declare function knowledgeRetrievePath(): string;
-export declare function workspaceMaaSBaseUrl(workspaceId: string): string;
+export declare function workspaceMaaSBaseUrl(workspaceId: string, region?: string): string;
 export declare function knowledgeSearchEndpoint(workspaceId: string): string;
 export declare function knowledgeChatEndpoint(workspaceId: string): string;
 /** Per-workspace AgentStudio host (same shape as {@link ragEndpoint}'s host). */
@@ -2423,6 +2424,14 @@ export declare function getApiKeyLoginKind(apiKey: string): ApiKeyLoginKind;
  */
 export declare function normalizeModelBaseUrl(input: string): string;
 //#endregion
+//#region src/config/validation.d.ts
+declare const TIMEOUT_ERROR_MESSAGE: {
+  readonly "en-US": "Timeout must be a positive finite number.";
+  readonly "zh-CN": "请求超时必须是一个有限的正数。";
+};
+/** Shared timeout constraint for effective settings and CLI flag validation. */
+export declare function validateTimeout(timeout: unknown): typeof TIMEOUT_ERROR_MESSAGE | undefined;
+//#endregion
 //#region src/output/formatter.d.ts
 type OutputFormat = "text" | "json";
 export declare function detectOutputFormat(flagValue?: string): OutputFormat;
@@ -2442,6 +2451,7 @@ interface UploadOptions {
   filePath: string;
   identity: TrackingIdentity;
   signal?: AbortSignal;
+  timeout?: number;
 }
 /** Encode a local image as a Data URI. */
 export declare function imageFileToDataUri(filePath: string): string;
@@ -2463,6 +2473,7 @@ export declare function isLocalFile(input: string): boolean;
 export declare function resolveFileUrl(input: string, apiKey: string, model: string, opts: {
   identity: TrackingIdentity;
   signal?: AbortSignal;
+  timeout?: number;
 }): Promise<string>;
 //#endregion
 //#region src/dataset/types.d.ts
@@ -2619,9 +2630,11 @@ interface ValidateOpts {
    *                   Every record MUST carry `chosen` + `rejected`.
    *   - `"cpt"`    — `{text: "..."}` (continual pre-training). Raw text only,
    *                   no `messages[]`.
-   *   - `undefined` — auto-detect per record: a record with `chosen` or
-   *                   `rejected` is validated as DPO, one with `text` (and no
-   *                   `messages`) as CPT, otherwise as ChatML.
+   *   - `"decision"` — `{state:{content}, questions:{...}}`（决策模型训练数据）。
+   *   - `undefined` — auto-detect per record: a record with `state`/`questions`
+   *                   is validated as decision data, one with `chosen` or
+   *                   `rejected` as DPO, one with `text` (and no `messages`) as
+   *                   CPT, otherwise as ChatML.
    * `finetune create` sets this from `--training-type` (dpo* → "dpo",
    * cpt → "cpt") so a malformed dataset fails at validate time, not on the
    * platform ten minutes in.
@@ -2635,7 +2648,7 @@ interface ValidateOpts {
   model?: string;
 }
 /** The schemas a `.jsonl` record can be validated against. */
-type DatasetSchema = "chatml" | "dpo" | "cpt" | "tts" | "image" | "video";
+type DatasetSchema = "chatml" | "dpo" | "cpt" | "decision" | "tts" | "image" | "video";
 type ValidationSeverity = "error" | "warning";
 interface ValidationIssue {
   severity: ValidationSeverity;
@@ -2775,6 +2788,8 @@ export declare const MAX_DATASET_BYTES: number;
  * CPT requires at least 50M tokens; larger files are expected.
  */
 export declare const MAX_CPT_BYTES: number;
+/** 决策模型训练数据单文件上限，按平台文档为 300MB。 */
+export declare const MAX_DECISION_DATASET_BYTES: number;
 /**
  * Image / video ZIP size cap — 2 GB per the platform docs. Used by
  * `bl dataset upload` for media schemas and by the `sft-lora` training
@@ -2799,6 +2814,90 @@ export declare function parseDatasetSchemaFlag(value: string | undefined): Datas
  */
 export declare function formatIssue(issue: ValidationIssue): string;
 //#endregion
+//#region src/decision/questions.d.ts
+/**
+ * 决策模型（TypeSafe System One）问题定义与 state 的结构校验。
+ *
+ * 推理请求（`bl decision`）与训练数据校验（`decision` record schema）共用这里的
+ * 规则；训练侧在此之上再校验 `label` / `target`。规则以决策模型 API 文档为准：
+ * - state：非空字符串、对象或数组；
+ * - instructions：可选字符串；
+ * - choice.criteria：选项名 → 描述，1–255 项；
+ * - score.criteria：从低到高的等级描述数组，2–255 级；
+ * - noul.criteria：可选，只能包含 `true` / `false` 描述。
+ */
+export declare const DECISION_QUESTION_TYPES: readonly ["choice", "noul", "score"];
+export type DecisionQuestionType = (typeof DECISION_QUESTION_TYPES)[number];
+export declare const MAX_DECISION_CHOICE_OPTIONS = 255;
+export declare const MIN_DECISION_SCORE_LEVELS = 2;
+export declare const MAX_DECISION_SCORE_LEVELS = 255;
+export interface DecisionIssue {
+  code: string;
+  /** 双语文案：命令层用 `ctx.localize` 渲染，训练校验拼成 `英文 / 中文`。 */
+  message: {
+    readonly "en-US": string;
+    readonly "zh-CN": string;
+  };
+  path: string;
+}
+export declare function isDecisionObject(value: unknown): value is Record<string, unknown>;
+export declare function inspectDecisionState(state: unknown, path?: string): DecisionIssue[];
+/** 校验单个问题定义（不含训练专用的 label / target）。 */
+export declare function inspectDecisionQuestion(question: unknown, path: string): DecisionIssue[];
+/** 校验问题表本身是否为非空对象。 */
+export declare function inspectDecisionQuestionTable(questions: unknown, path?: string): DecisionIssue[];
+export declare function inspectDecisionQuestionId(questionId: string, path?: string): DecisionIssue[];
+/** 校验完整问题表：表结构、每个问题 ID 与问题定义。 */
+export declare function inspectDecisionQuestions(questions: unknown, path?: string): DecisionIssue[];
+//#endregion
+//#region src/decision/request.d.ts
+export declare const DEFAULT_DECISION_MODEL = "decision-model-preview";
+/** 决策模型开放的 workspace 域名地域。 */
+export declare const DECISION_REGIONS: readonly ["cn-beijing", "ap-southeast-1"];
+export type DecisionRegion = (typeof DECISION_REGIONS)[number];
+export declare const DEFAULT_DECISION_REGION: DecisionRegion;
+export type DecisionState = string | Record<string, unknown> | unknown[];
+export interface DecisionQuestion {
+  type: DecisionQuestionType;
+  instructions?: string;
+  criteria?: Record<string, string> | string[];
+  [key: string]: unknown;
+}
+export interface DecisionRequest {
+  model: string;
+  state: DecisionState;
+  questions: Record<string, DecisionQuestion>;
+}
+export interface DecisionAnswer {
+  type?: string;
+  choice?: string;
+  noul?: number;
+  score?: number;
+  confidence?: number;
+  probabilities?: Record<string, number>;
+  legend?: Record<string, string>;
+  [key: string]: unknown;
+}
+export interface DecisionResponse {
+  model?: string;
+  request_id?: string;
+  answers?: Record<string, DecisionAnswer>;
+  usage?: {
+    input_tokens?: number;
+    [key: string]: unknown;
+  };
+  latency_ms?: number;
+  [key: string]: unknown;
+}
+/**
+ * 兼容两种问题文件：裸问题表 `{ id: {...} }`，或外层包了一层的 `{ "questions": {...} }`
+ * （如示例包里的 workload.json / 训练样本）。当 `questions` 本身像一个问题定义
+ * （带字符串 `type`）时，视为 ID 恰好叫 "questions" 的裸问题表，不做解包。
+ */
+export declare function unwrapDecisionQuestions(parsed: unknown): unknown;
+/** 去掉每个问题上的训练字段（label / target），返回新对象，不修改入参。 */
+export declare function stripDecisionTrainingFields(questions: unknown): unknown;
+//#endregion
 //#region src/finetune/types.d.ts
 /**
  * Fine-tune job API types.
@@ -2993,6 +3092,126 @@ export interface GetFineTuneResponse {
   output?: FineTuneJob;
   data?: FineTuneJob;
 }
+/** A tunable hyper-parameter declared by a compression template. */
+export interface CompressHyperParameter {
+  name?: string;
+  /** `number` (data_range / step) or `string` (support_values). */
+  type?: string;
+  display_name?: string;
+  description?: string;
+  defaultValue?: string;
+  recommend_value?: string;
+  required?: boolean;
+  support_values?: string[];
+  data_range?: string[];
+  step?: number;
+  [k: string]: unknown;
+}
+/** A compression template bound to a quantizable model. */
+export interface CompressTemplate {
+  template_id?: string;
+  template_name?: string;
+  description?: string;
+  /** Currently always `quantization`. */
+  compress_type?: string;
+  hyper_parameters?: CompressHyperParameter[];
+  [k: string]: unknown;
+}
+/** A quantizable custom model and the templates it supports. */
+export interface CompressModel {
+  model?: string;
+  model_name?: string;
+  base_model?: string;
+  templates?: CompressTemplate[];
+  [k: string]: unknown;
+}
+/** GET /api/v1/fine-tunes/compress/templates response. */
+export interface ListCompressTemplatesResponse {
+  request_id?: string;
+  output?: {
+    base_models?: string[];
+    custom_models?: CompressModel[];
+    [k: string]: unknown;
+  };
+}
+/** POST /api/v1/fine-tunes/compress/jobs request body. */
+export interface CreateCompressJobRequest {
+  /** Source custom (full-parameter fine-tuned) model ID. */
+  model: string;
+  template_id: string;
+  job_name?: string;
+  job_description?: string;
+  /** Key-value overrides; only the keys to override. */
+  hyper_parameters?: Record<string, unknown>;
+  /** Calibration dataset file IDs; only effective when `calib_input=true`. */
+  custom_calibration_file_ids?: string[];
+  /** Output model name suffix (≤ 8 chars, lowercase letters and digits). */
+  output_model_suffix?: string;
+}
+/** A compression job record as returned by the platform. */
+export interface CompressJob {
+  job_id?: string;
+  job_name?: string;
+  job_description?: string;
+  /** PENDING | QUEUING | RUNNING | CANCELING | SUCCEEDED | FAILED | CANCELED */
+  status?: string;
+  model?: string;
+  base_model?: string;
+  template_id?: string;
+  template_name?: string;
+  template_description?: string;
+  training_type?: string;
+  compress_type?: string;
+  hyper_parameters?: Record<string, unknown>;
+  custom_calibration_file_ids?: string[];
+  /** Quantized output model ID (only set on SUCCEEDED). */
+  quantized_output?: string | null;
+  create_time?: string;
+  start_time?: string | null;
+  end_time?: string | null;
+  error?: {
+    code?: string;
+    message?: string;
+    [k: string]: unknown;
+  } | null;
+  group?: string;
+  /** GPU seconds; present on SUCCEEDED / CANCELED. */
+  usage?: number;
+  [k: string]: unknown;
+}
+/** POST /api/v1/fine-tunes/compress/jobs and GET /jobs/{job_id} response. */
+export interface CompressJobResponse {
+  request_id?: string;
+  output?: CompressJob;
+}
+/** GET /api/v1/fine-tunes/compress/jobs response. */
+export interface ListCompressJobsResponse {
+  request_id?: string;
+  output?: {
+    total?: number;
+    page_no?: number;
+    page_size?: number;
+    jobs?: CompressJob[];
+    [k: string]: unknown;
+  };
+}
+/** GET /api/v1/fine-tunes/compress/jobs/{job_id}/logs response. */
+export interface GetCompressJobLogsResponse {
+  request_id?: string;
+  output?: {
+    total?: number;
+    logs?: string[];
+    [k: string]: unknown;
+  };
+}
+/** POST /jobs/{job_id}/cancel and DELETE /jobs/{job_id} response. */
+export interface CompressJobActionResponse {
+  request_id?: string;
+  output?: {
+    status?: string;
+    [k: string]: unknown;
+  };
+}
 //#endregion
 //#region src/finetune/api.d.ts
 /** POST /api/v1/fine-tunes */
@@ -3031,6 +3250,52 @@ export declare function listCheckpoints(client: Client, jobId: string, signal?:
  */
 export declare function exportCheckpoint(client: Client, jobId: string, checkpoint: string, modelName: string, signal?: AbortSignal): Promise<ExportCheckpointResponse>;
 //#endregion
+//#region src/finetune/compress.d.ts
+export interface ListCompressTemplatesParams {
+  /** Filter by custom model ID, or a base model name to list all derived custom models. */
+  model?: string;
+  /** Response language: `zh-CN` | `en-US`. */
+  lang?: string;
+  signal?: AbortSignal;
+}
+/** GET /api/v1/fine-tunes/compress/templates */
+export declare function listCompressTemplates(client: Client, params?: ListCompressTemplatesParams): Promise<ListCompressTemplatesResponse>;
+/** POST /api/v1/fine-tunes/compress/jobs */
+export declare function createCompressJob(client: Client, body: CreateCompressJobRequest, signal?: AbortSignal): Promise<CompressJobResponse>;
+export interface ListCompressJobsParams {
+  status?: string;
+  model?: string;
+  templateId?: string;
+  quantSpec?: string;
+  quantMethod?: string;
+  startTime?: string;
+  endTime?: string;
+  searchKey?: string;
+  /** `job_id` | `job_name`; narrows `searchKey` to one field. */
+  selectKey?: string;
+  sortOrder?: string;
+  pageNo?: number;
+  pageSize?: number;
+  signal?: AbortSignal;
+}
+/** GET /api/v1/fine-tunes/compress/jobs */
+export declare function listCompressJobs(client: Client, params?: ListCompressJobsParams): Promise<ListCompressJobsResponse>;
+/** GET /api/v1/fine-tunes/compress/jobs/{job_id} */
+export declare function getCompressJob(client: Client, jobId: string, signal?: AbortSignal): Promise<CompressJobResponse>;
+export interface GetCompressJobLogsParams {
+  /** Skip the first N lines. */
+  offset?: number;
+  /** Number of lines to read (server cap: 1000). */
+  line?: number;
+  signal?: AbortSignal;
+}
+/** GET /api/v1/fine-tunes/compress/jobs/{job_id}/logs */
+export declare function getCompressJobLogs(client: Client, jobId: string, params?: GetCompressJobLogsParams): Promise<GetCompressJobLogsResponse>;
+/** POST /api/v1/fine-tunes/compress/jobs/{job_id}/cancel */
+export declare function cancelCompressJob(client: Client, jobId: string, signal?: AbortSignal): Promise<CompressJobActionResponse>;
+/** DELETE /api/v1/fine-tunes/compress/jobs/{job_id} */
+export declare function deleteCompressJob(client: Client, jobId: string, signal?: AbortSignal): Promise<CompressJobActionResponse>;
+//#endregion
 //#region src/finetune/capability.d.ts
 /**
  * Training-type vocabulary exposed to users.