@aaroncarry/pi-usage 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Aaron Lin
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,151 @@
+# pi-usage
+
+[English](./README.md) | [简体中文](./README.zh-CN.md)
+
+A [pi](https://github.com/earendil-works/pi) extension that shows the balances and usage windows of your subscription accounts — a footer status line for the account you are currently using, plus a `/usage` card with full details. Query methods adapted from [CodexBar](https://github.com/steipete/CodexBar); credentials come straight from pi's unified `auth.json`, nothing else is read.
+
+## What you get
+
+The footer status line (default mode) follows the model you are using and shows its quota windows plus this session's consumption:
+
+```
+Codex 5h 13% · weekly 2% · session 10.0k tok $0.020
+```
+
+`/usage` prints a card into the conversation (a custom entry — no popup, no focus steal):
+
+```
+ Usage · 02:15
+
+ ● Codex (Plus)
+   5h      ░░░░░░░░░░   0% · resets in 4h 54m
+   weekly  ░░░░░░░░░░   2% · resets in 6d 17h
+ ○ GLM
+   Balance ¥21.46  recharged ¥118.00 · spent ¥96.54
+ ○ DeepSeek
+   Balance ¥38.48
+```
+
+## Commands
+
+| Command | Effect |
+|---|---|
+| `/usage` | Print the usage card into the session. Re-running refreshes: served from cache within the 5-minute TTL, refetched afterwards (15 s timeout). Cards persist in the session and are re-rendered on `/reload` and session restore. |
+| `/usage active\|all\|off` | Switch the footer status line mode immediately and persist it to `usage.json` (tab-completed). |
+| `pi --usage-status all` | Set the footer mode for this run only (overrides `usage.json`, not written back). |
+
+Precedence: `/usage <mode>` (session) > `--usage-status` (this run) > `usage.json` (persistent).
+
+## Footer status line
+
+| Mode | Shows |
+|---|---|
+| `active` (default) | All windows and balance of the account matching the current model, plus the session consumption segment. Follows model switches. |
+| `all` | Every account on one line — active account first at full brightness, the rest dimmed — consumption appended last. |
+| `off` | Hidden entirely. |
+
+- The consumption segment (`session <tokens> tok`) updates immediately after every turn (local data, same accounting as pi's footer). A real cost (`· $0.020`) is appended only when non-zero — subscription providers report 0, which is omitted.
+- A failing account shows as `Label !` in the error color.
+
+## Supported accounts
+
+Accounts with a credential in pi's `auth.json` are detected automatically; nothing to configure:
+
+| auth.json key | Query | Shows |
+|---|---|---|
+| `openai-codex` | `GET chatgpt.com/backend-api/wham/usage` (Bearer OAuth token) | 5h/weekly windows, credits, monthly spend cap |
+| `anthropic` | `GET api.anthropic.com/api/oauth/usage` (Claude Code OAuth token, `anthropic-beta: oauth-2025-04-20`) | 5h/weekly windows, extra usage |
+| `github-copilot` | `GET github.com/copilot_internal/user` (GitHub OAuth token, `token` scheme) | premium/chat quota windows, plan, reset date |
+| `openrouter` | `GET openrouter.ai/api/v1/credits` (API key or OAuth token) | Prepaid credits balance |
+| `zai` | `GET api.z.ai/api/monitor/usage/quota/limit` (CN region: `open.bigmodel.cn`); falls back to the bigmodel.cn balance endpoint when the key has no coding plan | 5h/weekly/MCP windows, or CNY balance |
+| `deepseek` | `GET api.deepseek.com/user/balance` | Account balance |
+| any other configured provider | **Auto-detection** (see below): probes New API (`/dashboard/billing/*`), Sub2API (`/usage`), MiniMax, and Zhipu relay billing protocols | Balance or plan window, depending on what the gateway exposes |
+| any custom provider | Config-driven generic adapter (see below) | Balance / windows |
+
+### Auto-detection for custom providers
+
+Providers registered in pi without a built-in adapter (e.g. relays set up via
+[pi-provider-hub](https://github.com/aaroncarry/pi-provider-hub) or `models.json`) are probed
+automatically using their registry base URL and the stored credential:
+
+- **New API** gateways: `dashboard/billing/subscription` + `dashboard/billing/usage` (plus
+  `/api/usage/token/` when available) → remaining USD balance, used/total note.
+- **Sub2API** gateways: `usage` → remaining balance.
+- Hostname-pinned protocols for `api.deepseek.com`, MiniMax hosts, and `open.bigmodel.cn` / `api.z.ai`.
+
+The winning protocol is pinned per session; if every candidate rejects the request
+(e.g. HTTP 404/401), the account shows a "no balance endpoint detected" error without
+re-probing on every refresh. Transient network errors are retried. Disable with
+`"autoDetect": false` in `usage.json` or `providers.<id>.enabled: false` per account.
+
+## Credentials and security
+
+- OAuth tokens are resolved through pi's model registry (`getProviderAuth`), which refreshes them before expiry and writes them back to `auth.json`. Providers unknown to the registry fall back to reading `auth.json` directly.
+- API keys reuse pi's interpolation rules (`$ENV` / `${ENV}`, `$$` / `$!` escapes, `!command`).
+- The usage endpoints are undocumented provider APIs and may change or throttle; query frequency is capped by the TTL.
+
+## Install
+
+```sh
+pi install npm:@aaroncarry/pi-usage
+```
+
+Or add the package to `settings.json` manually, or point at a local checkout while developing:
+
+```json
+{
+  "packages": ["npm:@aaroncarry/pi-usage"]
+}
+```
+
+## Configuration
+
+Optional config file `<agentDir>/usage.json`:
+
+```json
+{
+  "intervalMinutes": 5,
+  "status": "active",
+  "providers": {
+    "zai": { "region": "cn", "label": "GLM" },
+    "deepseek": { "enabled": false },
+    "lingsuan": {
+      "label": "LingSuan",
+      "custom": {
+        "url": "https://relay.example/api/status",
+        "headers": { "Authorization": "Bearer {token}" },
+        "balancePath": "data.availableBalance",
+        "currency": "CNY",
+        "windowsPath": "data.limits",
+        "windowFields": { "label": "name", "percent": "percentage", "resetsAt": "reset_at" }
+      }
+    }
+  }
+}
+```
+
+- `intervalMinutes`: background refresh interval (default 5, minimum 1).
+- `status`: `active` (default) | `all` | `off`.
+- `autoDetect`: set `false` to disable endpoint auto-detection for unknown providers.
+- `providers.<id>.enabled: false`: hide an account from the status line and card.
+- `providers.<id>.label`: display name override.
+- `providers.<id>.region`: z.ai region — `auto` (default) | `global` | `cn`.
+- `custom`: generic adapter for any JSON endpoint. Header values support `$ENV` interpolation and a `{token}` placeholder for the provider's own `auth.json` credential, if present. `balancePath` / `windowsPath` are JSON dot paths (e.g. `data.list[0].percent`).
+
+## Development
+
+```sh
+npm install --ignore-scripts
+npm run typecheck
+npm test
+```
+
+After changing the code, `/reload` inside pi picks it up (local checkouts are referenced in place).
+
+## Known limitations
+
+- Kimi Coding (`kimi-coding`) is not supported yet: pi stores a token for `api.kimi.com/coding`, and no usage endpoint accepting it has been verified.
+- The Claude, Copilot, and OpenRouter adapters mirror the endpoints and response shapes used by CodexBar; they have not been verified against live accounts yet. Issue reports with the actual response payload are welcome.
+- DeepSeek usage data lives behind the platform web session and cannot be queried with the API key; only the balance is shown.
+- The `$` figure shown for subscription (OAuth) accounts is pi's list-price estimate, not an actual charge; real consumption is the server-side quota window.
+- The panel and status line are TUI features; the `/usage` card itself is written in every mode.

package/README.zh-CN.md

@@ -0,0 +1,152 @@
+# pi-usage
+
+[English](./README.md) | [简体中文](./README.zh-CN.md)
+
+一个 [pi](https://github.com/earendil-works/pi) 扩展：查看各订阅账号的余额与用量窗口——footer 状态行常显当前账号，`/usage` 卡片查看全部明细。查询方法参考
+[CodexBar](https://github.com/steipete/CodexBar)，凭据直接复用 pi 统一存储的
+`auth.json`，不读取任何第三方凭据文件。
+
+## 效果
+
+footer 状态行（默认模式）跟随当前模型，显示其额度窗口和本次会话消耗：
+
+```
+Codex 5h 13% · weekly 2% · session 10.0k tok $0.020
+```
+
+`/usage` 向会话流打印一张卡片（自定义条目渲染——非弹窗、不抢焦点）：
+
+```
+ Usage · 02:15
+
+ ● Codex (Plus)
+   5h      ░░░░░░░░░░   0% · resets in 4h 54m
+   weekly  ░░░░░░░░░░   2% · resets in 6d 17h
+ ○ GLM
+   Balance ¥21.46  recharged ¥118.00 · spent ¥96.54
+ ○ DeepSeek
+   Balance ¥38.48
+```
+
+## 命令
+
+| 命令 | 作用 |
+|---|---|
+| `/usage` | 向会话流打印用量卡片。重复执行即刷新：5 分钟 TTL 内秒回，过期则重新拉取（15 秒超时）。卡片留存在会话里，`/reload`、恢复旧会话时自动重放 |
+| `/usage active\|all\|off` | 立即切换 footer 状态行模式，并持久化到 `usage.json`（输入时有补全） |
+| `pi --usage-status all` | 指定本次运行的 footer 模式（覆盖 `usage.json`，不写回文件） |
+
+优先级：`/usage <mode>`（会话内）> `--usage-status`（本次启动）> `usage.json`（持久）。
+
+## footer 状态行
+
+| 模式 | 显示内容 |
+|---|---|
+| `active`（默认） | 当前模型对应账号的全部窗口 + 余额，末尾追加会话消耗。切换模型即时跟随 |
+| `all` | 全部账号压成一行——当前账号在前、正常亮度，其余置灰，消耗段固定在行尾 |
+| `off` | 整行隐藏 |
+
+- 消耗段（`session <tokens> tok`）每轮对话结束**即时更新**（本地数据，与 pi footer 同口径）。真实费用仅在非零时追加（`· $0.020`）——订阅账号恒为 0，自动省略。
+- 账号查询失败时显示红色的 `账号名 !`。
+
+## 支持的账号
+
+auth.json 里有凭据的自动识别，无需配置：
+
+| auth.json key | 查询接口 | 显示内容 |
+|---|---|---|
+| `openai-codex` | `GET chatgpt.com/backend-api/wham/usage`（Bearer OAuth token） | 5h/周窗口、credits、月度花销上限 |
+| `anthropic` | `GET api.anthropic.com/api/oauth/usage`（Claude Code OAuth token，`anthropic-beta: oauth-2025-04-20`） | 5h/周窗口、extra usage |
+| `github-copilot` | `GET github.com/copilot_internal/user`（GitHub OAuth token，`token` scheme） | premium/chat 配额窗口、计划、重置日期 |
+| `openrouter` | `GET openrouter.ai/api/v1/credits`（API key 或 OAuth token） | 预付余额 |
+| `zai` | `GET api.z.ai/api/monitor/usage/quota/limit`（CN 区 `open.bigmodel.cn`），无 coding plan 时回退 bigmodel.cn 余额接口 | 5h/周/MCP 窗口或人民币余额 |
+| `deepseek` | `GET api.deepseek.com/user/balance` | 账户余额 |
+| 其他任意已配置厂商 | **自动探测**（见下）：依次尝试 New API（`/dashboard/billing/*`）、Sub2API（`/usage`）、MiniMax、智谱等中转计费协议 | 余额或计划窗口，取决于网关暴露的接口 |
+| 任意自定义 provider | 配置驱动的通用适配器（见下） | 余额 / 窗口 |
+
+### 自定义厂商的自动探测
+
+pi 里没有专用适配器的厂商（例如通过
+[pi-provider-hub](https://github.com/aaroncarry/pi-provider-hub) 或 `models.json` 配置的中转），
+会基于 registry 中的 baseUrl 和已存凭据自动探测：
+
+- **New API** 网关：`dashboard/billing/subscription` + `dashboard/billing/usage`
+  （可用时再加 `/api/usage/token/`）→ 剩余美元余额与 used/total 明细。
+- **Sub2API** 网关：`usage` → 剩余余额。
+- `api.deepseek.com`、MiniMax 各域名、`open.bigmodel.cn` / `api.z.ai` 按域名固定协议。
+
+命中的协议在会话内固定；所有候选都拒绝（如 HTTP 404/401）时显示
+"no balance endpoint detected"，且不会每次刷新都重复探测；瞬时网络错误会自动重试。
+在 usage.json 里设 `"autoDetect": false` 可全局关闭，或 `providers.<id>.enabled: false` 单独隐藏。
+
+## 凭据与安全
+
+- OAuth token 经 pi 的 model registry 解析（`getProviderAuth`），临期自动刷新并写回 auth.json；registry 不认识的 provider 回退为直读 auth.json。
+- API key 复用 pi 的插值规则（`$ENV`/`${ENV}`、`$$`/`$!` 转义、`!command`）。
+- 用量接口均为未公开接口，可能随服务商改版失效；查询频率受 TTL 限制。
+
+## 安装
+
+```sh
+pi install npm:@aaroncarry/pi-usage
+```
+
+或在 settings.json 的 `packages` 里手动添加，开发期也可以指向本地目录：
+
+```json
+{
+  "packages": ["npm:@aaroncarry/pi-usage"]
+}
+```
+
+## 配置
+
+可选配置文件 `<agentDir>/usage.json`：
+
+```json
+{
+  "intervalMinutes": 5,
+  "status": "active",
+  "providers": {
+    "zai": { "region": "cn", "label": "GLM" },
+    "deepseek": { "enabled": false },
+    "lingsuan": {
+      "label": "LingSuan",
+      "custom": {
+        "url": "https://relay.example/api/status",
+        "headers": { "Authorization": "Bearer {token}" },
+        "balancePath": "data.availableBalance",
+        "currency": "CNY",
+        "windowsPath": "data.limits",
+        "windowFields": { "label": "name", "percent": "percentage", "resetsAt": "reset_at" }
+      }
+    }
+  }
+}
+```
+
+- `intervalMinutes`：后台刷新间隔（默认 5，最小 1）。
+- `status`：`active`（默认）/ `all` / `off`。
+- `autoDetect`：设为 `false` 关闭对未知厂商的余额端点自动探测。
+- `providers.<id>.enabled: false`：从状态行和卡片隐藏某账号。
+- `providers.<id>.label`：显示名覆盖。
+- `providers.<id>.region`：z.ai 区域 `auto`（默认）/`global`/`cn`。
+- `custom`：通用适配器，接入任意 JSON 接口——`headers` 支持 `$ENV` 插值和 `{token}` 占位符（取该 provider 在 auth.json 里的凭据，若有）；`balancePath`/`windowsPath` 为 JSON 点路径（如 `data.list[0].percent`）。
+
+## 开发
+
+```sh
+npm install --ignore-scripts
+npm run typecheck
+npm test
+```
+
+改完代码在 pi 里 `/reload` 即可生效（本地路径是原地引用）。
+
+## 已知限制
+
+- Kimi Coding（`kimi-coding`）暂不支持：pi 存的是 `api.kimi.com/coding` 的 token，尚未验证到接受它的用量接口。
+- Claude、Copilot、OpenRouter 适配器的端点与响应结构照搬 CodexBar 的实现，尚未用真实账号验证过；欢迎带实际响应 payload 提 issue。
+- DeepSeek 的用量数据在平台网页 session 后面，API key 查不到，只显示余额。
+- 订阅账号（OAuth 登录）显示的 `$` 是 pi 按模型目录单价估算的理论费用，并非真实扣费；真实消耗以服务端额度窗口为准。
+- 状态行是 TUI 特性；`/usage` 卡片在任意模式下都会写入会话。

package/package.json

@@ -0,0 +1,48 @@
+{
+	"name": "@aaroncarry/pi-usage",
+	"version": "0.1.0",
+	"description": "Usage and balance viewer for pi: subscription quota windows, prepaid balances, and session consumption in a footer status line and a /usage card",
+	"type": "module",
+	"license": "MIT",
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/aaroncarry/pi-usage.git"
+	},
+	"bugs": {
+		"url": "https://github.com/aaroncarry/pi-usage/issues"
+	},
+	"homepage": "https://github.com/aaroncarry/pi-usage#readme",
+	"files": ["src", "README.md", "README.zh-CN.md", "LICENSE"],
+	"keywords": [
+		"pi",
+		"pi-extension",
+		"pi-coding-agent",
+		"usage",
+		"balance",
+		"quota",
+		"codex",
+		"openai",
+		"glm",
+		"zai",
+		"deepseek"
+	],
+	"engines": {
+		"node": ">=20"
+	},
+	"publishConfig": {
+		"access": "public"
+	},
+	"pi": {
+		"extensions": ["./src/index.ts"]
+	},
+	"scripts": {
+		"typecheck": "tsc --noEmit",
+		"test": "node --test"
+	},
+	"devDependencies": {
+		"@earendil-works/pi-coding-agent": "0.85.1",
+		"@earendil-works/pi-tui": "0.85.1",
+		"@types/node": "22.20.2",
+		"typescript": "5.9.3"
+	}
+}

package/src/config.ts

@@ -0,0 +1,156 @@
+/**
+ * usage.json configuration: `<agentDir>/usage.json`.
+ *
+ * The file is optional; everything falls back to sensible defaults. Invalid
+ * entries are ignored rather than rejected so a hand-edited file cannot break
+ * the whole extension.
+ */
+
+import { readFileSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+
+export type StatusMode = "active" | "all" | "off";
+
+export const DEFAULT_INTERVAL_MINUTES = 5;
+export const MIN_INTERVAL_MINUTES = 1;
+
+/** Generic adapter configured entirely from usage.json. */
+export interface CustomProviderConfig {
+	/** Request URL. */
+	url: string;
+	/** HTTP method, defaults to GET. */
+	method?: string;
+	/**
+	 * Extra request headers. Values support $ENV interpolation and the
+	 * "{token}" placeholder for the provider's stored auth.json token.
+	 */
+	headers?: Record<string, string>;
+	/** Dot path (e.g. "data.availableBalance") to a numeric balance. */
+	balancePath?: string;
+	/** Currency code for the balance, e.g. "CNY". */
+	currency?: string;
+	/** Dot path to an array of usage window items. */
+	windowsPath?: string;
+	/** Field names inside each window item (defaults: label, percent, resetsAt). */
+	windowFields?: { label?: string; percent?: string; resetsAt?: string };
+}
+
+export interface ProviderConfig {
+	/** Set false to hide a provider from panel and status line. */
+	enabled?: boolean;
+	/** Display name override. */
+	label?: string;
+	/** z.ai region: "auto" (default), "global" or "cn". */
+	region?: string;
+	/** Generic adapter definition; entries with this are not built-in adapters. */
+	custom?: CustomProviderConfig;
+	[key: string]: unknown;
+}
+
+export interface BalanceConfig {
+	/** Background refresh interval in minutes (min 1, default 5). */
+	intervalMinutes?: number;
+	/** Footer status line: active account + session consumption (default), all accounts, or off. */
+	status?: StatusMode;
+	/**
+	 * Auto-detect balance endpoints for providers without a built-in adapter
+	 * (New API relays, Sub2API, MiniMax, Zhipu). Default true.
+	 */
+	autoDetect?: boolean;
+	/** Per-provider options; entries with `custom` define generic adapters. */
+	providers?: Record<string, ProviderConfig>;
+}
+
+export function isRecord(value: unknown): value is Record<string, unknown> {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+
+export function loadBalanceConfig(agentDir: string): BalanceConfig {
+	let raw: unknown;
+	try {
+		raw = JSON.parse(readFileSync(join(agentDir, "usage.json"), "utf8"));
+	} catch {
+		return {};
+	}
+	if (!isRecord(raw)) return {};
+	return sanitizeBalanceConfig(raw);
+}
+
+export function intervalMs(config: BalanceConfig): number {
+	const minutes = config.intervalMinutes;
+	const resolved =
+		typeof minutes === "number" && Number.isFinite(minutes)
+			? Math.max(MIN_INTERVAL_MINUTES, minutes)
+			: DEFAULT_INTERVAL_MINUTES;
+	return resolved * 60_000;
+}
+
+/**
+ * Persist a new footer status mode to usage.json, preserving all other
+ * fields. An unreadable file is replaced with a minimal valid config.
+ */
+export function saveStatusMode(agentDir: string, status: StatusMode): void {
+	const path = join(agentDir, "usage.json");
+	let raw: unknown;
+	try {
+		raw = JSON.parse(readFileSync(path, "utf8"));
+	} catch {
+		raw = undefined;
+	}
+	const config = isRecord(raw) ? raw : {};
+	config.status = status;
+	writeFileSync(path, `${JSON.stringify(config, null, "\t")}\n`, "utf8");
+}
+
+function sanitizeBalanceConfig(raw: Record<string, unknown>): BalanceConfig {
+	const config: BalanceConfig = {};
+	if (typeof raw.intervalMinutes === "number" && Number.isFinite(raw.intervalMinutes) && raw.intervalMinutes > 0) {
+		config.intervalMinutes = raw.intervalMinutes;
+	}
+	if (raw.status === "active" || raw.status === "all" || raw.status === "off") {
+		config.status = raw.status;
+	}
+	if (typeof raw.autoDetect === "boolean") config.autoDetect = raw.autoDetect;
+	if (isRecord(raw.providers)) {
+		const providers: Record<string, ProviderConfig> = {};
+		for (const [id, value] of Object.entries(raw.providers)) {
+			if (!isRecord(value)) continue;
+			providers[id] = sanitizeProviderConfig(value);
+		}
+		if (Object.keys(providers).length > 0) config.providers = providers;
+	}
+	return config;
+}
+
+function sanitizeProviderConfig(raw: Record<string, unknown>): ProviderConfig {
+	const entry: ProviderConfig = {};
+	if (typeof raw.enabled === "boolean") entry.enabled = raw.enabled;
+	if (typeof raw.label === "string") entry.label = raw.label;
+	if (typeof raw.region === "string") entry.region = raw.region;
+	if (isRecord(raw.custom)) entry.custom = sanitizeCustomConfig(raw.custom);
+	return entry;
+}
+
+function sanitizeCustomConfig(raw: Record<string, unknown>): CustomProviderConfig {
+	const custom: CustomProviderConfig = { url: typeof raw.url === "string" ? raw.url : "" };
+	if (typeof raw.method === "string") custom.method = raw.method;
+	if (isRecord(raw.headers)) {
+		const headers: Record<string, string> = {};
+		for (const [name, value] of Object.entries(raw.headers)) {
+			if (typeof value === "string") headers[name] = value;
+		}
+		custom.headers = headers;
+	}
+	if (typeof raw.balancePath === "string") custom.balancePath = raw.balancePath;
+	if (typeof raw.currency === "string") custom.currency = raw.currency;
+	if (typeof raw.windowsPath === "string") custom.windowsPath = raw.windowsPath;
+	if (isRecord(raw.windowFields)) {
+		const fields = raw.windowFields;
+		const windowFields: { label?: string; percent?: string; resetsAt?: string } = {};
+		if (typeof fields.label === "string") windowFields.label = fields.label;
+		if (typeof fields.percent === "string") windowFields.percent = fields.percent;
+		if (typeof fields.resetsAt === "string") windowFields.resetsAt = fields.resetsAt;
+		custom.windowFields = windowFields;
+	}
+	return custom;
+}