@dmh2002/dsh-connect-qoder 0.0.0-stage → 0.4.0

package/lib/index.d.ts

@@ -0,0 +1,126 @@
+import z from "@deepseek-ai/schemastery";
+import { Context } from "@deepseek-ai/cordis";
+//#region src/upstream.d.ts
+type QoderRegion = 'cn' | 'global';
+//#endregion
+//#region src/catalog.d.ts
+interface QoderModelInfo {
+  key: string;
+  displayName: string;
+  /** 积分倍率（模型名内嵌 `· xN.NN`）。 */
+  priceFactor: number;
+  /** 原生输入窗口（由 context_config 首档或 max_input_tokens 决定）。 */
+  contextWindow: number;
+  maxOutputTokens: number;
+  supportsImages: boolean;
+  supportsThinking: boolean;
+  /** 可完全关闭思考（thinking_config.disabled 存在）。 */
+  canDisableThinking: boolean;
+  /**
+   * 上游声明的思考强度档位（`thinking_config.enabled.efforts` 的键，按强度
+   * 升序）。不存在时该模型没有可选档位，卡片不渲染这一项。
+   *
+   * 实测 Qoder 的档位名不统一：Qwen 系用 `low / medium / xhigh`，DeepSeek/GLM
+   * 用 `low / high / max`——所以只做展示，不做跨模型比较。上游给出的键序也不
+   * 可靠（JSON 里可能先出现 `xhigh`），必须按语义排序后再显示。
+   */
+  thinkingEfforts?: string[];
+  /** 上游标为默认的档位（`efforts[x].is_default`）。 */
+  defaultThinkingEffort?: string;
+  isDefault: boolean;
+  isFree: boolean;
+  isNew: boolean;
+  /**
+   * 网关声明可用的上下文档位（`context_config` 各项的 token_count，升序）。
+   * 不存在时无档位可选，卡片不渲染预算选择器。
+   */
+  contextTiers?: number[];
+}
+//#endregion
+//#region src/status-paths.d.ts
+/**
+ * The project's public repository.
+ *
+ * Lives here rather than beside one component because TWO sections link to it
+ * — the model section and the account pool — and a second copy of a URL is a
+ * second thing to forget when it moves. Node-free and side-effect free, so it
+ * costs nothing on the Host side either.
+ */
+declare const QODER_GITHUB_URL = "https://github.com/dingminhua/dsh-connect-qoder";
+//#endregion
+//#region src/version.d.ts
+/**
+ * Package version, injected at build time by `tsdown.config.ts`.
+ *
+ * 参考：dsh-connect-workbuddy（MIT）——版本由构建期 define 注入，而非
+ * 运行时读 package.json（发布包只含 lib/，不含可解析的 package.json 路径）。
+ *
+ * @module dsh-connect-qoder/version
+ */
+/** The npm package version this build was produced from. */
+declare const QODER_CONNECT_VERSION: string;
+//#endregion
+//#region src/index.d.ts
+declare const name = "dsh-connect-qoder";
+/** The model registry and settings service required before providers register. */
+declare const inject: string[];
+/** The namespace the HOST actually serves this plugin under (workbuddy probe). */
+declare function settingsNamespaceOf(ctx: unknown): string;
+declare function asVolatile<T>(schema: z<T>): z<T>;
+/** Unwrap a schemastery volatile's reactive `.get()` into a plain snapshot. */
+declare function unwrapVolatile<T>(value: T): T;
+interface Config {
+  regions: Record<string, unknown>;
+}
+declare const Config: z<Config>;
+/**
+ * 一份目录是否**声明了**思考档位。
+ *
+ * 「一个模型都没有档位」有两种完全不同的含义，必须分开：
+ * 1. 上游当前没声明（`thinkingEfforts` 字段缺席或为空）—— 那它是「上游没
+ *    档位」的诚实答案；
+ * 2. 这份目录来自一次没拉到档位的时刻 —— 本机实测 14 个 cn 模型的
+ *    `thinkingEfforts` 全是 `[]`，是旧 schema 把字段剥掉时的产物。用它当答案，
+ *    卡片就不渲染档位选择器（用户实拍「思考强度有时候有、有时候没有」：点一次
+ *    「从 Qoder 刷新」就有，重启后就没）。
+ *
+ * 两种情况从数据上分不开（空数组与缺席都判「没声明」），要不要重拉由**目录的
+ * 来源**决定：调用方只在「本进程还没成功拉到实时目录」时才据此触发重拉（见
+ * displayModels）—— 实时目录没档位是上游的诚实答案，重拉多少次都一样。
+ *
+ * 判据用 `length > 0` 而不是「字段在不在」：旧 schema 留下的是**空数组**而不是
+ * 缺席，所以「字段在」恰恰不能作为「声明过」的证据。
+ */
+declare function catalogSnapshotDeclaresEfforts(models: readonly {
+  thinkingEfforts?: readonly string[];
+}[]): boolean;
+/**
+ * 「手上的目录能不能当档位答案」——**判据与动作打包在一起**。
+ *
+ * 拆开成两个函数（判据一个、调用处自己判）会留下一条没被测试覆盖的接线：把调用处
+ * 变异掉，单测仍然全绿（第一版就是这么自我欺骗的）。这里让规则自己执行动作并
+ * 返回结论，于是「动作有没有真的发生」也能被断言。
+ *
+ * 检测到「一个档位都没声明」时**不改动要服务的模型列表**：模型不能从卡片上
+ * 消失，缺的只是档位 —— 后台拉回来之后的下一次读取自然补上。返回 `stale`
+ * 标记这次调用有没有触发过拉取。
+ */
+declare function serveSavedCatalog(models: readonly QoderModelInfo[], onStale: () => void): {
+  models: readonly QoderModelInfo[];
+  stale: boolean;
+};
+/** 某区域的配置状态（缺省返回空对象）。 */
+declare function regionStateOf(config: {
+  regions?: Record<string, unknown> | null;
+}, region: QoderRegion): Record<string, unknown>;
+/** 某区域是否启用（opt-out）。 */
+declare function regionEnabled(config: {
+  regions?: Record<string, unknown> | null;
+}, region: QoderRegion): boolean;
+/** 某区域是否配置了凭据（设置 PAT 或环境变量其一）。 */
+declare function regionHasCredential(config: {
+  regions?: Record<string, unknown> | null;
+}, region: QoderRegion): boolean;
+declare function apply(ctx: Context, config: Config): void;
+//#endregion
+export { Config, QODER_CONNECT_VERSION, QODER_GITHUB_URL, apply, asVolatile, catalogSnapshotDeclaresEfforts, inject, name, regionEnabled, regionHasCredential, regionStateOf, serveSavedCatalog, settingsNamespaceOf, unwrapVolatile };