bailian-cli-core 2.8.6 → 2.9.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.d.mts CHANGED
@@ -1370,6 +1370,11 @@ interface Identity {
1370
1370
  interface Settings {
1371
1371
  configPath?: string;
1372
1372
  configName?: string;
1373
+ /**
1374
+ * Profile name pinned in recovery command hints.
1375
+ * Explicit `--config default` stays `"default"`; implicit default is undefined.
1376
+ */
1377
+ recoveryConfigName?: string;
1373
1378
  output: "text" | "json";
1374
1379
  /**
1375
1380
  * Whether `output` came from an explicit source (flag/env/file) rather than
@@ -2199,6 +2204,17 @@ export declare function buildSources(flags: Partial<SourceFlags>, onWarning?: (w
2199
2204
  export declare function buildOutputSettings({ flags, env, file }: Pick<ResolutionSources, "flags" | "env"> & {
2200
2205
  file?: ConfigFile;
2201
2206
  }): Pick<Settings, "output" | "outputExplicit" | "outputSource" | "quiet" | "verbose">;
2207
+ /**
2208
+ * Config name for recovery hints (does not change IO-layer `configName` semantics).
2209
+ * Explicit `--config default` is normalized to undefined in the loader; keep
2210
+ * `"default"` here so copying the hint does not fall back to an active named profile.
2211
+ */
2212
+ export declare function resolveRecoveryConfigName(sources: {
2213
+ flags: {
2214
+ config?: unknown;
2215
+ };
2216
+ configName?: string;
2217
+ }): string | undefined;
2202
2218
  /**
2203
2219
  * 纯解析 sources → Settings(命令唯一会读的配置面)。不含身份、baseUrl、鉴权。
2204
2220
  * 各字段链序 flag > env > file > 默认;锁定表 tests/config-priority.test.ts。
@@ -5577,14 +5593,14 @@ export declare function createTrackingEvent(opts: {
5577
5593
  //#endregion
5578
5594
  //#region src/telemetry/sink.d.ts
5579
5595
  /**
5580
- * 尽力等待所有在途的埋点发送完成(best-effort)。
5596
+ * Best-effort wait for all in-flight telemetry sends.
5581
5597
  *
5582
- * 1. 先调用 `_sendAll` 排空 tracker 内部的去抖队列,把还卡在 500ms 合并窗口里
5583
- * 的事件立刻推上网络。
5584
- * 2. 在预算内等待发送,预算耗尽时真正取消 DNS/HTTP/body 工作。
5598
+ * 1. Call `_sendAll` to drain the tracker's debounce queue so events still in
5599
+ * the 500ms merge window are pushed to the network immediately.
5600
+ * 2. Wait for sends within the budget; on timeout, cancel DNS/HTTP/body work.
5585
5601
  *
5586
- * 埋点永远不应阻塞 CLI:调用方应传入较短的超时(例如 1000ms),并始终与超时
5587
- * race。错误与超时一律静默吞掉。
5602
+ * Telemetry must never block the CLI: callers should pass a short timeout
5603
+ * (e.g. 1000ms) and always race against it. Errors and timeouts are swallowed.
5588
5604
  */
5589
5605
  export declare function flushTelemetry(timeoutMs?: number): Promise<void>;
5590
5606
  export declare function localSink(event: TrackingEvent): Promise<void>;