@eddyskywalker/dsh-chatgpt-subscription 0.36.2 → 0.37.0

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":"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"}

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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"}

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

@@ -0,0 +1,284 @@
+/**
+ * One normalizer per subscription line: that line's own `GET /status` payload
+ * folded into shape C's `quota` half.
+ *
+ * Every function here takes `unknown` on purpose. The input is a loopback HTTP
+ * response — read from a route this plugin owns but not necessarily at the same
+ * version it was written against — so the mapper cannot lean on a DTO type that
+ * the running host might not satisfy. A field that is missing, null, a string
+ * where a number was expected, or an array where an object was expected must
+ * degrade to "nothing measured", never to a thrown error: one line's odd
+ * payload must not be able to take the card down.
+ *
+ * THE THREE THINGS EACH ONE EXISTS TO GET RIGHT
+ *
+ * 1. Units. The lines disagree: codex states Unix SECONDS (resetsAt),
+ *    antigravity and cline-pass state ISO 8601 strings, kimi / minimax / qoder /
+ *    glm / step / command-code state milliseconds. Each normalizer knows which
+ *    family it holds and converts exactly once — nothing here guesses a unit
+ *    from a magnitude.
+ * 2. Percentages. Some lines state used percent, some a used fraction in
+ *    [0, 1], some only the remaining share. All of them leave here as used
+ *    percent in [0, 100].
+ * 3. Absence. Null is not zero. A window without a measurement is dropped
+ *    rather than drawn as a full bar, and a line that answered nothing leaves
+ *    `quota` null with the reason carried beside it.
+ *
+ * Windows are ordered shortest first, unstated lengths last — the order a card
+ * relies on to draw the tightest limit at the top. The sort is stable, so equal
+ * lengths keep the order the line listed them in.
+ */
+import type { LineCardQuota, LineCardWindow } from './line-contracts.ts';
+/** What one line's status payload says about its quota, accounts aside. */
+export interface LineQuotaFacts {
+    /** The normalized quota, or null when the payload carried nothing usable. */
+    quota: LineCardQuota | null;
+    /** Plan the line is metered on, when the payload states one. */
+    planLabel: string | null;
+    /**
+     * Account identity the payload itself states (usually a masked email).
+     *
+     * Null when the payload names no account, which is the caller's cue to fall
+     * back to the pool's own primary row.
+     */
+    accountLabel: string | null;
+    /** Whether the payload says a credential exists; null when it never said. */
+    signedIn: boolean | null;
+    /** The line's own reason its numbers are missing, when it reported one. */
+    error: string | null;
+}
+/**
+ * The ChatGPT line's quota, as `GET /status` answers it.
+ *
+ * Units: `QuotaWindowDto.resetsAt`, `resetCredits.expiresAt` and
+ * `quota.fetchedAt` are Unix SECONDS here (that line's own quota service
+ * multiplies them by 1000 further out), while everything else on the payload is
+ * already milliseconds. The bucket list also carries an older
+ * `primary`/`secondary` pair that some payload generations state instead of
+ * `windows`; both are read, so the card shows the same bars the settings card
+ * does.
+ *
+ * @param status - The route's `value`.
+ * @returns The facts.
+ */
+export declare function normalizeCodexQuota(status: unknown): LineQuotaFacts;
+/**
+ * The Kimi Code line's quota.
+ *
+ * Units: `resetsAt` and `fetchedAt` are already milliseconds. The fallback
+ * wallet (`extraUsage`) is stated in the currency's minor unit, so it is
+ * divided once and kept with its currency: a bare "75.00" would be read as
+ * provider credits by every other card on the board.
+ *
+ * @param status - The route's `value`.
+ * @returns The facts.
+ */
+export declare function normalizeKimiCodeQuota(status: unknown): LineQuotaFacts;
+/**
+ * The MiniMax Code line's quota.
+ *
+ * Units: milliseconds throughout (`resetsAtMs`, `fetchedAtMs`). The windows are
+ * keyed (`interval` / `weekly`) rather than labelled — the line leaves the
+ * wording to the client — and carry a REMAINING percent, sometimes only a
+ * remaining one; both are inverted into the used share here.
+ *
+ * @param status - The route's `value`.
+ * @returns The facts.
+ */
+export declare function normalizeMinimaxCodeQuota(status: unknown): LineQuotaFacts;
+/**
+ * The Antigravity line's quota.
+ *
+ * Units: the harder one of the set. Each allowance is stated as
+ * `remainingFraction` in [0, 1] (null when the service measured nothing, and
+ * NOT zero), named windows arrive as `window: '5h' | 'weekly'`, and reset
+ * instants as ISO 8601. Windows are grouped (Gemini models, third-party
+ * models); each bucket's label is prefixed with its group once there is more
+ * than one group, because "Weekly" twice on one card says nothing about which
+ * allowance it is.
+ *
+ * @param status - The route's `value`.
+ * @returns The facts.
+ */
+export declare function normalizeAntigravityQuota(status: unknown): LineQuotaFacts;
+/**
+ * The Command Code line's quota.
+ *
+ * Units: two different meter shapes, and both are needed. `windows[]` is
+ * already normalized (`usedPercent`, `windowDurationMins`, milliseconds);
+ * `meters[]` states a used FRACTION that is null whenever the service reports a
+ * spend meter instead of a bounded allowance, and only the ones that did state
+ * a fraction become bars. The credit balance is that line's own string, kept
+ * verbatim.
+ *
+ * @param status - The route's `value`.
+ * @returns The facts.
+ */
+export declare function normalizeCommandCodeQuota(status: unknown): LineQuotaFacts;
+/**
+ * The Claude line's quota.
+ *
+ * Units: millisecond `fetchedAt` / `observedAt`, ISO 8601 `resetsAt`, and a
+ * used share that may be stated as percent or as a fraction in [0, 1] — the
+ * three numeric fields are null together when the source said nothing, so the
+ * fraction is only consulted when the percent is absent.
+ *
+ * The line answers `quota: null` on a first read and only fills it after its
+ * own `POST /quota`; that is what the refresh capability exists for, so an
+ * empty first read is reported as-is rather than as an error.
+ *
+ * @param status - The route's `value`.
+ * @returns The facts.
+ */
+export declare function normalizeClaudeQuota(status: unknown): LineQuotaFacts;
+/**
+ * The GLM Coding Plan line's quota.
+ *
+ * Units: milliseconds (`resetsAt`, `fetchedAt`). Windows are keyed
+ * (`five-hour` / `weekly` / `monthly`) and their used percent is null when the
+ * upstream reported no bounded allowance — an unlimited plan states no
+ * fraction, and drawing that as 0% used would invent a measurement.
+ *
+ * @param status - The route's `value`.
+ * @returns The facts.
+ */
+export declare function normalizeGlmCodingPlanQuota(status: unknown): LineQuotaFacts;
+/**
+ * The Step Code line's quota.
+ *
+ * Units: milliseconds. Two payload generations share one snapshot: an older
+ * account has 5-hour and weekly windows, a newer one has `creditBuckets` — an
+ * absolute amount per bucket, with no percentage at all. The buckets become the
+ * card's credit figure (their remaining amounts summed) rather than being
+ * squeezed into a progress bar nobody measured; the `credit` window key, which
+ * names the same thing, is deliberately left without a bar for the same reason.
+ *
+ * @param status - The route's `value`.
+ * @returns The facts.
+ */
+export declare function normalizeStepCodeQuota(status: unknown): LineQuotaFacts;
+/**
+ * The Qoder line's quota.
+ *
+ * Units: milliseconds, with one sentinel: the account period ends at
+ * `253402214400000` (year 9999) for a subscription that never expires, and a
+ * card would print that as a real date, so the shared ceiling drops it.
+ *
+ * Qoder states ABSOLUTE amounts (total / used / remaining + unit), not windows.
+ * A ratio is derived only when both total and used are stated AND total is
+ * positive; anything else is reported as a credit balance instead of a bar.
+ *
+ * @param status - The route's `value`.
+ * @returns The facts.
+ */
+export declare function normalizeQoderQuota(status: unknown): LineQuotaFacts;
+/**
+ * The Cline Pass line's quota.
+ *
+ * Units: `percentUsed` is a percent, `resetsAt` is an ISO 8601 string, and the
+ * window's length is only stated as a gateway token (`five_hour` / `weekly` /
+ * `monthly`). The payload carries one reading PER ACCOUNT, so the row shown is
+ * the pool's active account when it has a reading, else the first account that
+ * did read something. An account that failed states its own reason, which is
+ * what the card shows instead of an empty frame.
+ *
+ * @param status - The route's `value`.
+ * @returns The facts.
+ */
+export declare function normalizeClinePassQuota(status: unknown): LineQuotaFacts;
+/**
+ * The OpenDesign line's quota.
+ *
+ * Units: this line's REAL allowance is the "Design Plan" window pair the console
+ * renders as a remaining percentage — a 5-hour window and a 7-day one, each
+ * stating an integer credit LIMIT and what is LEFT of it, plus an ISO reset
+ * instant. A bar is therefore the USED share, `(limit − remaining) / limit`;
+ * the remaining percentage is `100 − used` and is derived by whoever prints it.
+ *
+ * `quota.credits` keeps the WALLET balance, and only that: the spendable USD
+ * figure is a different quantity from a window's allowance, and folding one into
+ * the other is how a card ends up stating a percentage of the wrong thing.
+ *
+ * Absence is the honest half of this reader. The endpoint is only known to accept
+ * a browser session, so a control-key read may be refused; `codingPlan.error`
+ * then carries the reason and `windows` is empty. An empty list is reported as
+ * exactly that — never padded with a 0 % bar, which would claim a limit nobody
+ * observed — and the reason rides along so the card can say why.
+ *
+ * @param status - The route's `value`.
+ * @returns The facts.
+ */
+export declare function normalizeOpenDesignQuota(status: unknown): LineQuotaFacts;
+/**
+ * One pooled account's own quota, as a card row draws it.
+ *
+ * A row states a bar, the instant it reopens, and — since this reading is the
+ * only place any line computes an account's windows — the WHOLE list behind that
+ * bar. Never a plan, a label or an error: those belong to the pool's row.
+ *
+ * `null` in either scalar keeps the contract's own meaning — nobody measured that
+ * fact — and is what makes a half-known reading useless rather than half-true
+ * (see the two readers below). `windows` is then `[]` rather than a padded
+ * placeholder: a line that measured nothing has no window to show, and a 0 % bar
+ * would report a limit nobody observed.
+ */
+export interface LineAccountQuotaReading {
+    /** Share of the account's shortest window consumed, 0-100, or null. */
+    usedPercent: number | null;
+    /** Unix MILLISECONDS that window reopens, or null when nobody said. */
+    resetsAt: number | null;
+    /**
+     * Every window this account's quota stated, shortest first.
+     *
+     * Empty — never absent — when the line has no window vocabulary of its own
+     * (Qoder states absolute amounts, not percentages) or measured nothing.
+     */
+    windows: LineCardWindow[];
+}
+/**
+ * The Qoder account's own reading, from one `quota/usage` snapshot.
+ *
+ * Qoder states ABSOLUTE amounts per bucket (total / used / remaining), never a
+ * percentage, so a share is derived here only under the same rule
+ * {@link normalizeQoderQuota} already applies to the line-level card: BOTH a
+ * total (positive) and a used figure must be stated. A bucket that states
+ * amounts without a bounded allowance — a top-up balance, an org cap nobody
+ * measured — is not turned into a bar, and a snapshot with no such bucket
+ * answers null rather than a made-up zero.
+ *
+ * No window list accompanies it: this line has no percentage windows at all
+ * (its buckets are absolute amounts, and its only instant is the snapshot's own
+ * expiry), so `windows` is `[]` — the honest answer rather than a manufactured
+ * one-window list nobody measured.
+ *
+ * @param snapshot - The account's quota snapshot (`{ buckets, expiresAt }`).
+ * @returns The reading, or null when nothing bounded was measured.
+ */
+export declare function qoderAccountQuotaReading(snapshot: unknown): LineAccountQuotaReading | null;
+/**
+ * The MiniMax Code account's own reading, from one Token Plan snapshot.
+ *
+ * The window the row's BAR draws is the rolling 5-hour one — the line's own
+ * headline, and the tightest limit the plan has: its machine key is `interval`,
+ * and a payload that named no key is placed by its nominal length instead. The
+ * weekly window is deliberately NOT substituted (a row saying 5% while the
+ * 5-hour window is spent is worse than a row saying nothing), and an `unlimited`
+ * window states no share at all, so nothing becomes a bar.
+ *
+ * `windows` carries the WHOLE list all the same: this line states it — `interval`
+ * and `weekly`, each with a share and a reset instant — so an account can be
+ * opened up and show both of its limits instead of only the bar.
+ *
+ * @param quota - The parsed `MinimaxCodeQuota`.
+ * @returns The reading, or null when the 5-hour window measured nothing.
+ */
+export declare function minimaxAccountQuotaReading(quota: unknown): LineAccountQuotaReading | null;
+/**
+ * Every normalizer, keyed by the line id a card names.
+ *
+ * The registry looks a line up here; a line that is registered but has no entry
+ * falls back to nothing measured, so adding a pool without a normalizer
+ * degrades to "no quota window" instead of to a thrown error.
+ */
+export declare const LINE_QUOTA_NORMALIZERS: Readonly<Record<string, (status: unknown) => LineQuotaFacts>>;
+//# sourceMappingURL=line-quota.d.ts.map