@eddyskywalker/dsh-chatgpt-subscription 0.36.1 → 0.37.0

package/lib/types/host/progress-updates/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/host/progress-updates/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AA8BH,sCAAsC;AACtC,MAAM,WAAW,uBAAuB;IACtC,WAAW;IACX,OAAO,EAAE,OAAO,CAAA;IAChB,mCAAmC;IACnC,cAAc,EAAE,MAAM,CAAA;CACvB;AAED;;;;;;GAMG;AACH,UAAU,SAAS,CAAC,CAAC;IACnB,iBAAiB;IACjB,GAAG,IAAI,CAAC,GAAG,SAAS,CAAA;CACrB;AAED,sBAAsB;AACtB,MAAM,MAAM,0BAA0B,CAAC,CAAC,IAAI,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,SAAS,CAAA;AAExE,mCAAmC;AACnC,MAAM,WAAW,2BAA2B;IAC1C,aAAa;IACb,eAAe,CAAC,EAAE,0BAA0B,CAAC,OAAO,CAAC,CAAA;IACrD,eAAe;IACf,6BAA6B,CAAC,EAAE,0BAA0B,CAAC,MAAM,CAAC,CAAA;CACnE;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,CAAC,EAAE,KAAK,EAAE,0BAA0B,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,SAAS,CAM9F;AAED;;;;GAIG;AACH,wBAAgB,8BAA8B,CAAC,MAAM,CAAC,EAAE,2BAA2B,GAAG,uBAAuB,CAU5G;AAED,YAAY;AACZ,MAAM,WAAW,sBAAsB;IACrC;;;;;;OAMG;IACH,QAAQ,EAAE,MAAM,uBAAuB,CAAA;CACxC;AAED,kDAAkD;AAClD,MAAM,WAAW,sBAAsB;IACrC,6CAA6C;IAC7C,MAAM,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;IACrD,oBAAoB;IACpB,EAAE,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,OAAO,GAAG,MAAM,IAAI,CAAA;IACvE,uCAAuC;IACvC,GAAG,CAAC,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAA;CAC5B;AAuJD;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,sBAAsB,EAAE,OAAO,EAAE,sBAAsB,GAAG,MAAM,IAAI,CA6O/G"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/host/progress-updates/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAaH,OAAO,EAKL,KAAK,sBAAsB,EAC5B,MAAM,aAAa,CAAA;AAiBpB,sCAAsC;AACtC,MAAM,WAAW,uBAAuB;IACtC,WAAW;IACX,OAAO,EAAE,OAAO,CAAA;IAChB,mCAAmC;IACnC,cAAc,EAAE,MAAM,CAAA;IACtB,sCAAsC;IACtC,QAAQ,EAAE,sBAAsB,CAAA;CACjC;AAED;;;;;;GAMG;AACH,UAAU,SAAS,CAAC,CAAC;IACnB,iBAAiB;IACjB,GAAG,IAAI,CAAC,GAAG,SAAS,CAAA;CACrB;AAED,sBAAsB;AACtB,MAAM,MAAM,0BAA0B,CAAC,CAAC,IAAI,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,SAAS,CAAA;AAExE,mCAAmC;AACnC,MAAM,WAAW,2BAA2B;IAC1C,aAAa;IACb,eAAe,CAAC,EAAE,0BAA0B,CAAC,OAAO,CAAC,CAAA;IACrD,eAAe;IACf,6BAA6B,CAAC,EAAE,0BAA0B,CAAC,MAAM,CAAC,CAAA;IAClE,cAAc;IACd,uBAAuB,CAAC,EAAE,0BAA0B,CAAC,sBAAsB,CAAC,CAAA;CAC7E;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,CAAC,EAAE,KAAK,EAAE,0BAA0B,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,SAAS,CAM9F;AAED;;;;GAIG;AACH,wBAAgB,8BAA8B,CAAC,MAAM,CAAC,EAAE,2BAA2B,GAAG,uBAAuB,CAc5G;AAED,YAAY;AACZ,MAAM,WAAW,sBAAsB;IACrC;;;;;;OAMG;IACH,QAAQ,EAAE,MAAM,uBAAuB,CAAA;CACxC;AAED,kDAAkD;AAClD,MAAM,WAAW,sBAAsB;IACrC,6CAA6C;IAC7C,MAAM,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;IACrD,oBAAoB;IACpB,EAAE,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,OAAO,GAAG,MAAM,IAAI,CAAA;IACvE,uCAAuC;IACvC,GAAG,CAAC,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAA;CAC5B;AAuJD;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,sBAAsB,EAAE,OAAO,EAAE,sBAAsB,GAAG,MAAM,IAAI,CA6O/G"}

package/lib/types/host/progress-updates/prompt.d.ts

@@ -4,6 +4,13 @@
  * 文本用函数形式提供（而不是静态字符串）：开关关闭时返回空串，装配期就地
  * 抹掉引导，不需要重启会话、也不需要重挂插件行。
  *
+ * ## 为什么是英文
+ *
+ * 提示词是写给模型看的，不是写给用户看的：同一段要求在英文下最短、歧义最少，
+ * 也和工具描述（`tool.ts` 的 `PROGRESS_UPDATE_DESCRIPTION`，本来就是英文）保持
+ * 同一套措辞。用户看到的语言由 {@link progressLanguageDirective} 单独钉住——
+ * 「指令用英文」与「输出用中文」是两件事，不要混在一起。
+ *
  * @module dsh-chatgpt-subscription/host/progress-updates/prompt
  */
 /**
@@ -19,16 +26,43 @@ export declare const PROGRESS_SECTION_NAME = "plugin:progress-updates";
  * 不与它们并列。
  */
 export declare const PROGRESS_SECTION_ORDER = 220;
+/**
+ * 进展更新的输出语言。
+ *
+ * - `auto`：跟随对话语言（默认）；
+ * - `zh`：一律中文；
+ * - `en`：一律英文。
+ *
+ * 只管 `progress_update` 的标题与正文，不影响会话里其它任何输出。
+ */
+export type ProgressUpdateLanguage = 'auto' | 'zh' | 'en';
+/** 允许的取值，供设置解析做白名单校验（配置里写错就等于没写）。 */
+export declare const PROGRESS_UPDATE_LANGUAGES: readonly ProgressUpdateLanguage[];
 /**
  * 引导词正文。写法对齐 Kimi 的「进展更新」：先说清多步任务早期的思路，再报
  * 有意义的结论、阶段判断、长等待与阻塞；每条给一行标题，细节放正文；不重复
- * 没有变化的状态。
+ * 没有变化的状态。开头与结尾两条被提成硬要求——没有它们，面板在任务的两端
+ * 都是空的。
  */
 export declare const PROGRESS_GUIDANCE: string;
+/**
+ * 每个语言档位对应的一句指令。
+ *
+ * 只约束输出的标题与正文，不约束引导词本身；三条都必须自洽——`auto` 不许在
+ * 用户说中文时滑回英文，`zh`/`en` 则明确压过对话语言。
+ */
+export declare const PROGRESS_LANGUAGE_DIRECTIVES: Readonly<Record<ProgressUpdateLanguage, string>>;
+/**
+ * 取一个语言档位的指令文本；未知取值按 `auto` 处理。
+ * @param language - 配置里读到的语言档位。
+ * @returns 追加到引导词末尾的一句指令。
+ */
+export declare function progressLanguageDirective(language: ProgressUpdateLanguage): string;
 /**
  * 生成提示词分节的文本提供者。
  * @param isEnabled - 读取当前开关状态的函数（每次装配重新求值）。
- * @returns 开关打开时返回引导词，关闭时返回空串。
+ * @param language - 读取当前输出语言的函数；缺省按 `auto` 处理。
+ * @returns 开关打开时返回引导词加语言指令，关闭时返回空串。
  */
-export declare function progressSectionText(isEnabled: () => boolean): () => string;
+export declare function progressSectionText(isEnabled: () => boolean, language?: () => ProgressUpdateLanguage): () => string;
 //# sourceMappingURL=prompt.d.ts.map

package/lib/types/host/progress-updates/prompt.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../../../../src/host/progress-updates/prompt.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,4BAA4B,CAAA;AAE9D;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,MAAM,CAAA;AAEzC;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,QAmBlB,CAAA;AAEZ;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,OAAO,GAAG,MAAM,MAAM,CAE1E"}
+{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../../../../src/host/progress-updates/prompt.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,4BAA4B,CAAA;AAE9D;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,MAAM,CAAA;AAEzC;;;;;;;;GAQG;AACH,MAAM,MAAM,sBAAsB,GAAG,MAAM,GAAG,IAAI,GAAG,IAAI,CAAA;AAEzD,qCAAqC;AACrC,eAAO,MAAM,yBAAyB,EAAE,SAAS,sBAAsB,EAAyB,CAAA;AAEhG;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,QAwBlB,CAAA;AAEZ;;;;;GAKG;AACH,eAAO,MAAM,4BAA4B,EAAE,QAAQ,CAAC,MAAM,CAAC,sBAAsB,EAAE,MAAM,CAAC,CAIzF,CAAA;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,sBAAsB,GAAG,MAAM,CAElF;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,MAAM,OAAO,EACxB,QAAQ,GAAE,MAAM,sBAAqC,GACpD,MAAM,MAAM,CAEd"}

package/lib/types/host/progress-updates/tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tool.d.ts","sourceRoot":"","sources":["../../../../src/host/progress-updates/tool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAA;AAE5D,OAAO,EAAgB,KAAK,cAAc,EAAE,MAAM,YAAY,CAAA;AAE9D,4BAA4B;AAC5B,eAAO,MAAM,gBAAgB,oBAAoB,CAAA;AAEjD,iDAAiD;AACjD,eAAO,MAAM,oBAAoB,iEAAiE,CAAA;AAElG,iBAAiB;AACjB,eAAO,MAAM,2BAA2B,QAW7B,CAAA;AAEX,wCAAwC;AACxC,MAAM,WAAW,kBAAkB;IACjC,yBAAyB;IACzB,IAAI,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAA;CACtC;AAED,sCAAsC;AACtC,MAAM,WAAW,oBAAoB;IACnC,sBAAsB;IACtB,SAAS,EAAE,OAAO,CAAA;CACnB;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE;IAC7C,0BAA0B;IAC1B,SAAS,EAAE,MAAM,OAAO,CAAA;IACxB,uCAAuC;IACvC,IAAI,CAAC,EAAE,MAAM,kBAAkB,GAAG,SAAS,CAAA;IAC3C,8BAA8B;IAC9B,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,MAAM,GAAG,SAAS,CAAA;CACjD,GAAG,cAAc,CAgDjB"}
+{"version":3,"file":"tool.d.ts","sourceRoot":"","sources":["../../../../src/host/progress-updates/tool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAA;AAE5D,OAAO,EAAgB,KAAK,cAAc,EAAE,MAAM,YAAY,CAAA;AAE9D,4BAA4B;AAC5B,eAAO,MAAM,gBAAgB,oBAAoB,CAAA;AAEjD,iDAAiD;AACjD,eAAO,MAAM,oBAAoB,iEAAiE,CAAA;AAElG,iBAAiB;AACjB,eAAO,MAAM,2BAA2B,QAa7B,CAAA;AAEX,wCAAwC;AACxC,MAAM,WAAW,kBAAkB;IACjC,yBAAyB;IACzB,IAAI,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAA;CACtC;AAED,sCAAsC;AACtC,MAAM,WAAW,oBAAoB;IACnC,sBAAsB;IACtB,SAAS,EAAE,OAAO,CAAA;CACnB;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE;IAC7C,0BAA0B;IAC1B,SAAS,EAAE,MAAM,OAAO,CAAA;IACxB,uCAAuC;IACvC,IAAI,CAAC,EAAE,MAAM,kBAAkB,GAAG,SAAS,CAAA;IAC3C,8BAA8B;IAC9B,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,MAAM,GAAG,SAAS,CAAA;CACjD,GAAG,cAAc,CAgDjB"}

package/lib/types/host/proxy-manager.d.ts

@@ -12,27 +12,89 @@ export interface ParseEnvProxyOptions {
     envFile?: string | null;
 }
 export declare function parseEnvProxy(env?: Record<string, string | undefined>, options?: ParseEnvProxyOptions): string | null;
-export declare function detectSystemProxy(platform?: NodeJS.Platform, env?: Record<string, string | undefined>): string | null;
+export interface ParseNoProxyOptions {
+    /**
+     * `$DSH_HOME/.env`, consulted after the process environment; `null` disables
+     * the file fallback, exactly like {@link ParseEnvProxyOptions}.
+     */
+    envFile?: string | null;
+}
+/**
+ * The raw `NO_PROXY` list, or an empty string when none is configured.
+ *
+ * Read next to the proxy itself on purpose: a proxy that a line is *told* to use
+ * and a bypass list that lives somewhere else are how "the local gateway
+ * suddenly goes through Clash" happens.
+ */
+export declare function parseNoProxy(env?: Record<string, string | undefined>, options?: ParseNoProxyOptions): string;
+/**
+ * Whether a host is loopback, and therefore never worth a proxy hop.
+ *
+ * The whole `127.0.0.0/8` block, not just `127.0.0.1`: a second loopback alias
+ * is a normal way to run a local gateway, and a proxy cannot reach it any
+ * better than the process itself can.
+ */
+export declare function isLoopbackHostname(hostname: string): boolean;
+/**
+ * Standard `NO_PROXY` matching: `*`, exact hosts, domain suffixes, `host:port`.
+ *
+ * Deliberately not CIDR: a proxy configured for this plugin is a local GUI
+ * proxy, and the entries that matter are the ones a user types.
+ */
+export declare function noProxyBypasses(hostname: string, port: string, list: string): boolean;
+/**
+ * Whether a request target must skip the proxy.
+ *
+ * Loopback first: a local gateway behind a proxy hop is a request the proxy has
+ * to refuse (or worse, forwards to itself), and the plugin's own loopback reads
+ * already use a bare fetch for the same reason.
+ */
+export declare function shouldBypassProxy(target: URL | string, noProxyList?: string): boolean;
+/**
+ * GNOME's manual proxy, the Linux equivalent of the Windows registry read.
+ *
+ * `auto` is a PAC URL, which cannot be applied by posting through an agent, and
+ * `none` means no system proxy; both fall through to the environment.
+ */
+export declare function parseLinuxSystemProxy(read: (key: string) => string | null): string | null;
+export declare function detectSystemProxy(platform?: NodeJS.Platform, env?: Record<string, string | undefined>, readSettings?: (key: string) => string | null): string | null;
 /** Called with the proxy URL the first time detection reports one after a `null`. */
 export type SystemProxyListener = (proxyUrl: string) => void;
 export interface ProxyFetchOptions {
     getPreferences: () => Pick<SubscriptionPreferencesDto, 'proxyMode' | 'customProxyUrl'>;
     baseFetch?: FetchLike;
     systemProxyDetector?: () => string | null;
+    /**
+     * The `NO_PROXY` list, read per request (subject to the same TTL as the system
+     * proxy) so an edit takes effect without a restart. A test injects this rather
+     * than inheriting the machine's own bypass list.
+     */
+    noProxyReader?: () => string;
     logger?: Pick<Console, 'info' | 'warn' | 'error'>;
 }
 export declare class ProxyManager {
     private readonly getPreferences;
     private readonly baseFetch;
     private readonly systemProxyDetector;
+    private readonly noProxyReader;
     private readonly logger?;
     private cachedSystemProxy;
     private lastSystemProxyCheck;
+    private cachedNoProxy;
+    private lastNoProxyCheck;
     private detected;
     private readonly proxyListeners;
     private readonly agents;
     constructor(options: ProxyFetchOptions);
     getSystemProxy(force?: boolean): string | null;
+    /**
+     * The active `NO_PROXY` list, re-read at most once per TTL.
+     *
+     * A reader that throws (an unreadable `$DSH_HOME/.env`) reads as "no bypass
+     * list", never as "bypass everything": the wrong guess in that direction would
+     * take an active proxy away from every line at once.
+     */
+    getNoProxyList(force?: boolean): string;
     /**
      * Observe the system proxy becoming known.
      *

package/lib/types/host/proxy-manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"proxy-manager.d.ts","sourceRoot":"","sources":["../../../src/host/proxy-manager.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAa,0BAA0B,EAAE,MAAM,wBAAwB,CAAA;AAEnF,MAAM,MAAM,SAAS,GAAG,OAAO,KAAK,CAAA;AAqBpC,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAOxD;AAED,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAqCvE;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAwBnE;AAED,MAAM,WAAW,oBAAoB;IACnC;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CACxB;AAED,wBAAgB,aAAa,CAC3B,GAAG,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAe,EACrD,OAAO,GAAE,oBAAyB,GACjC,MAAM,GAAG,IAAI,CA2Bf;AAED,wBAAgB,iBAAiB,CAAC,QAAQ,GAAE,MAAM,CAAC,QAA2B,EAAE,GAAG,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAe,GAAG,MAAM,GAAG,IAAI,CAuBpJ;AAED,qFAAqF;AACrF,MAAM,MAAM,mBAAmB,GAAG,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAA;AAE5D,MAAM,WAAW,iBAAiB;IAChC,cAAc,EAAE,MAAM,IAAI,CAAC,0BAA0B,EAAE,WAAW,GAAG,gBAAgB,CAAC,CAAA;IACtF,SAAS,CAAC,EAAE,SAAS,CAAA;IACrB,mBAAmB,CAAC,EAAE,MAAM,MAAM,GAAG,IAAI,CAAA;IACzC,MAAM,CAAC,EAAE,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAA;CAClD;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAwE;IACvG,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAW;IACrC,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAqB;IACzD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAA0C;IAElE,OAAO,CAAC,iBAAiB,CAAsB;IAC/C,OAAO,CAAC,oBAAoB,CAAI;IAChC,OAAO,CAAC,QAAQ,CAAQ;IACxB,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAiC;IAChE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgC;gBAE3C,OAAO,EAAE,iBAAiB;IAOtC,cAAc,CAAC,KAAK,UAAQ,GAAG,MAAM,GAAG,IAAI;IA8B5C;;;;;;;;;OASG;IACH,qBAAqB,CAAC,QAAQ,EAAE,mBAAmB,GAAG,MAAM,IAAI;IAKhE,qBAAqB,IAAI,MAAM,GAAG,IAAI;IAgBtC,OAAO,CAAC,gBAAgB;IAcxB,WAAW,IAAI,SAAS;IAsBxB,OAAO,IAAI,IAAI;CAOhB"}
+{"version":3,"file":"proxy-manager.d.ts","sourceRoot":"","sources":["../../../src/host/proxy-manager.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAa,0BAA0B,EAAE,MAAM,wBAAwB,CAAA;AAEnF,MAAM,MAAM,SAAS,GAAG,OAAO,KAAK,CAAA;AAqBpC,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAOxD;AAED,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAqCvE;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAwBnE;AAED,MAAM,WAAW,oBAAoB;IACnC;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CACxB;AAED,wBAAgB,aAAa,CAC3B,GAAG,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAe,EACrD,OAAO,GAAE,oBAAyB,GACjC,MAAM,GAAG,IAAI,CA2Bf;AAED,MAAM,WAAW,mBAAmB;IAClC;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CACxB;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAC1B,GAAG,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAe,EACrD,OAAO,GAAE,mBAAwB,GAChC,MAAM,CAkBR;AAaD;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAM5D;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CA4BrF;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,GAAG,GAAG,MAAM,EAAE,WAAW,SAAK,GAAG,OAAO,CAUjF;AAqBD;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,GAAG,MAAM,GAAG,IAAI,CAYzF;AAED,wBAAgB,iBAAiB,CAC/B,QAAQ,GAAE,MAAM,CAAC,QAA2B,EAC5C,GAAG,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAe,EACrD,YAAY,GAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,GAAG,IAAoB,GAC3D,MAAM,GAAG,IAAI,CA0Bf;AAaD,qFAAqF;AACrF,MAAM,MAAM,mBAAmB,GAAG,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAA;AAE5D,MAAM,WAAW,iBAAiB;IAChC,cAAc,EAAE,MAAM,IAAI,CAAC,0BAA0B,EAAE,WAAW,GAAG,gBAAgB,CAAC,CAAA;IACtF,SAAS,CAAC,EAAE,SAAS,CAAA;IACrB,mBAAmB,CAAC,EAAE,MAAM,MAAM,GAAG,IAAI,CAAA;IACzC;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,MAAM,CAAA;IAC5B,MAAM,CAAC,EAAE,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAA;CAClD;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAwE;IACvG,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAW;IACrC,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAqB;IACzD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAc;IAC5C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAA0C;IAElE,OAAO,CAAC,iBAAiB,CAAsB;IAC/C,OAAO,CAAC,oBAAoB,CAAI;IAChC,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,gBAAgB,CAAI;IAC5B,OAAO,CAAC,QAAQ,CAAQ;IACxB,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAiC;IAChE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgC;gBAE3C,OAAO,EAAE,iBAAiB;IAQtC,cAAc,CAAC,KAAK,UAAQ,GAAG,MAAM,GAAG,IAAI;IA8B5C;;;;;;OAMG;IACH,cAAc,CAAC,KAAK,UAAQ,GAAG,MAAM;IAYrC;;;;;;;;;OASG;IACH,qBAAqB,CAAC,QAAQ,EAAE,mBAAmB,GAAG,MAAM,IAAI;IAKhE,qBAAqB,IAAI,MAAM,GAAG,IAAI;IAgBtC,OAAO,CAAC,gBAAgB;IAcxB,WAAW,IAAI,SAAS;IA8BxB,OAAO,IAAI,IAAI;CAOhB"}

package/lib/types/host/widget-board/line-contracts.d.ts

@@ -0,0 +1,192 @@
+/**
+ * Shape C: everything ONE card needs about ONE subscription line.
+ *
+ * A card is identified by \`props.line\`, so the whole answer is produced per
+ * line: the line's own quota windows, plus the account rows of that line's
+ * pool. The two halves come from different authorities and are merged here:
+ *
+ *  - the account half reads this plugin's own pool objects through ONE generic
+ *    adapter (every line's pool speaks \`listAccounts\` / \`setPrimary\` /
+ *    \`setStrategy\`), never over HTTP;
+ *  - the quota half reads the line's OWN \`/status\` route over loopback HTTP,
+ *    because each line already normalizes its upstream payload into its own
+ *    DTO and duplicating those readers here would be a second implementation
+ *    of the same thing, free to drift.
+ *
+ * The mix is deliberate: an account list is a local document read (no upstream
+ * call, no credential needed), while a quota answer travels through the line's
+ * route, which owns its cache, its refresh flight and its error reporting.
+ *
+ * Two conventions this file fixes once, because a card must not have to know:
+ *
+ *  - EVERY instant here is Unix MILLISECONDS. The lines disagree on the wire
+ *    (codex states seconds, antigravity and cline-pass state ISO strings,
+ *    kimi/minimax/qoder/glm/step state milliseconds); the normalizers convert,
+ *    so a card never guesses a unit from a magnitude.
+ *  - \`null\` means "nobody measured this", and is never 0. A window that was
+ *    never read, a plan nobody named, a balance that could not be fetched —
+ *    all null, all rendered as a placeholder rather than as a zero.
+ */
+import type { AccountAuthStatus, AccountRotationStrategy } from '../../shared/account-pool-contracts.ts';
+/**
+ * Provider name this plugin registers under: the BARE package id, without the
+ * `@eddyskywalker/` scope.
+ *
+ * A manifest names a data source or a capability as `<provider>:<id>`, and that
+ * whole string has to match the board's id regular expression
+ * `^[a-z][a-z0-9.-]{1,39}(?::[a-z][a-z0-9.-]{1,39})?$` — which accepts neither
+ * `@` nor `/`. A scoped provider name would therefore be registrable on the host
+ * and unreachable from every manifest, so the registration and the manifests
+ * must agree on this literal.
+ */
+export declare const WIDGET_BOARD_PROVIDER = "dsh-chatgpt-subscription";
+/**
+ * The name a widget manifest writes to reach one of this provider's
+ * registrations, e.g. `dsh-chatgpt-subscription:line-card`.
+ *
+ * @param id - One of the four registration ids below.
+ * @returns The `<provider>:<id>` spelling, which is the only one the board resolves.
+ */
+export declare function widgetFullName(id: string): string;
+/** Data source: shape C for the line named by \`props.line\`. */
+export declare const LINE_CARD_DATA_SOURCE_ID = "line-card";
+/** Capability: refresh one line's quota, then answer shape C. */
+export declare const LINE_REFRESH_CAPABILITY_ID = "line-refresh";
+/** Capability: pin one pooled account of one line, then answer shape C. */
+export declare const LINE_ACCOUNT_SWITCH_CAPABILITY_ID = "line-account-switch";
+/** Capability: change one line's rotation strategy, then answer shape C. */
+export declare const LINE_ACCOUNT_STRATEGY_CAPABILITY_ID = "line-account-strategy";
+/** One quota window of a line, already normalized for the card. */
+export interface LineCardWindow {
+    /**
+     * Display name, e.g. \`5 小时\`.
+     *
+     * Filled by the line's normalizer whenever the source states it or the
+     * window's nominal length makes it inferable; empty when nobody said, in
+     * which case the card falls back to its own wording.
+     */
+    label: string;
+    /** Share of the window consumed, clamped to 0-100. */
+    usedPercent: number;
+    /** Nominal window length in minutes, when the source stated one. */
+    windowMinutes: number | null;
+    /** Unix MILLISECONDS the window reopens, when the source stated one. */
+    resetsAt: number | null;
+}
+/** Credit balance a line reports beside its windows. */
+export interface LineCardCredits {
+    unlimited: boolean;
+    /**
+     * Balance as the line strings it, unit included when the line has one
+     * (\`"10.00"\` for provider credits, \`"12.34 USD"\` for a wallet).
+     *
+     * A string rather than a number on purpose: the units differ per line and a
+     * single numeric field would silently invite arithmetic across them.
+     */
+    balance: string | null;
+}
+/** Reset credits available to reopen a spent window. */
+export interface LineCardResetCredits {
+    available: number;
+    /** Unix MILLISECONDS the earliest credit expires, when stated. */
+    expiresAt: number | null;
+}
+/**
+ * One line's quota.
+ *
+ * \`null\` on the card means "this line answered nothing usable" — which is a
+ * different statement from "this line has no windows", and the reason the whole
+ * object is nullable rather than an empty one.
+ */
+export interface LineCardQuota {
+    windows: LineCardWindow[];
+    credits: LineCardCredits | null;
+    resetCredits: LineCardResetCredits | null;
+    /** Unix MILLISECONDS the snapshot was taken, when the line stated one. */
+    fetchedAt: number | null;
+    /** Whether THIS line's own refresh is running behind the answer. */
+    refreshing: boolean;
+    /** Why these numbers are missing or old, when the line said so. */
+    error: string | null;
+}
+/** One pooled account of this line, as the card renders it. */
+export interface LineCardAccount {
+    id: string;
+    /** Alias when one is set, then the email, then the id. Never blank. */
+    label: string;
+    email: string | null;
+    primary: boolean;
+    /** Plan label the account's own credential states, when it states one. */
+    plan: string | null;
+    /** Unix MILLISECONDS a 429 cooldown lifts, when one is running. */
+    cooldownUntil: number | null;
+    authStatus: AccountAuthStatus | null;
+    /**
+     * Share of THIS account's own newest snapshot, shortest window.
+     *
+     * Absent together with \`resetsAt\` when the account was never read — a
+     * different statement from "nothing used".
+     */
+    usedPercent: number | null;
+    resetsAt: number | null;
+    /**
+     * Every window THIS account's own reading stated, shortest first.
+     *
+     * ABSENT, not empty, on a line with no per-account quota hook: there is
+     * nothing per-account to say there, and an empty list would claim "we asked
+     * this account and it has no windows". `[]` on a hooked line means exactly
+     * that — the read was made and measured nothing — which is why the list is
+     * never padded with a 0 % placeholder to look like data.
+     *
+     * It sits BESIDE `usedPercent` rather than replacing it: that field stays the
+     * headline (shortest) window's share, which the card's back face draws as one
+     * small bar, while this list is what the account's own detail view opens up.
+     */
+    windows?: LineCardWindow[];
+}
+/** Shape C: what \`line-card\` and the three line capabilities answer. */
+export interface LineCardData {
+    /** Line id this card reads, e.g. \`codex\`. */
+    line: string;
+    /** Display name of the line, e.g. \`ChatGPT\`. */
+    label: string;
+    /** Whether the line holds any credential that could serve a request. */
+    signedIn: boolean;
+    /** Whether this plugin's pool for the line is installed at all. */
+    installed: boolean;
+    /** Plan the line is metered on (e.g. \`free\`), when stated. */
+    planLabel: string | null;
+    /** Signed-in account label, when known. */
+    accountLabel: string | null;
+    /** Accounts in this line's pool; empty when it has none. */
+    accounts: LineCardAccount[];
+    activeAccountId: string | null;
+    strategy: AccountRotationStrategy;
+    quota: LineCardQuota | null;
+    /**
+     * Why this card cannot show its numbers: the line's interface is
+     * unreachable, OR the line reached its upstream and reported a failure.
+     *
+     * Both cases leave the card with nothing to draw, and both need the same
+     * thing from the user (a reason), so they share one field instead of one of
+     * them being dropped — a \`quota: null\` alone would say "no data" and lose the
+     * sentence that explains it.
+     */
+    error: string | null;
+}
+/**
+ * The JSON Schema a capability's return value is validated against.
+ *
+ * Capability outputs only, like the two older shapes: the DATA SOURCE's answer
+ * is validated against the \`data\` schema of the card that reads it, which
+ * lives in \`widgets/<id>/widget.json\` and is therefore a second declaration of
+ * this shape (kept aligned by a test that compares their key sets literally).
+ */
+export declare const LINE_CARD_SCHEMA: Record<string, unknown>;
+/** Arguments of the quota-refresh capability. */
+export declare const LINE_REFRESH_INPUT_SCHEMA: Record<string, unknown>;
+/** Arguments of the account-switch capability. */
+export declare const LINE_ACCOUNT_SWITCH_INPUT_SCHEMA: Record<string, unknown>;
+/** Arguments of the account-strategy capability. */
+export declare const LINE_ACCOUNT_STRATEGY_INPUT_SCHEMA: Record<string, unknown>;
+//# sourceMappingURL=line-contracts.d.ts.map

package/lib/types/host/widget-board/line-contracts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"line-contracts.d.ts","sourceRoot":"","sources":["../../../../src/host/widget-board/line-contracts.ts"],"names":[],"mappings":"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"}