@linxiraos/pi-utils 1.1.7 → 1.1.9

package/CHANGELOG.md

@@ -2,9 +2,9 @@
 
 ## [Unreleased]
 
-## [1.1.7] - 2026-09-01
+## [1.1.9] - 2026-09-05
 
-- 同步上游 OMP v18.0.11（`b8ce33a58911c26bed1d84f0db9a5e2e727c49a2`）。
+- USER_AGENT constant restored to zeta/<version> (the v18.1.10 merge re-introduced the upstream omp/ UA on every provider request); brand wording in path-resolver docs corrected; profile validation error message Zeta'd.
 
 ## [1.1.6] - 2026-08-30
 
@@ -15,12 +15,6 @@
 
 - 同步上游 OMP v18.0.5 / v18.0.6：新增 browsers / json 工具，SHA-2/SHA-3 在 ARM64 上加速。
 
-## [1.1.3] - 2026-08-25
-
-### Fixed
-
-- Republished as 1.1.3 to reset the latest tag after the broken 1.1.2 (no functional change over 1.1.1).
-
 ## [1.1.2] - 2026-08-25
 
 ### Fixed

package/README.md

@@ -1,25 +1,25 @@
 # @linxiraos/pi-utils
 
-Shared utilities for [Zeta](https://github.com/Linxira-OS/linxira-zeta) packages. Zero ceremony, Bun-first.
+Shared utilities for [oh-my-pi](https://github.com/can1357/oh-my-pi) packages. Zero ceremony, Bun-first.
 
 ## Notable modules
 
-| Module | Purpose |
-| --- | --- |
-| `logger` | Centralized logger writing to `~/.zeta/logs/` with rotation (TUI-safe — never stdout) |
-| `prompt` | Handlebars-based prompt templating and formatting helpers |
-| `dirs` | Path helpers for Zeta config directories (`~/.zeta`, XDG-aware on Linux) |
-| `stream` | `readStream` / `readLines` helpers over `ReadableStream` |
-| `ptree` / `procmgr` | Process trees, `ChildProcess` wrapper, process lifecycle management |
-| `postmortem` | Cleanup callbacks on exit, signals, and fatal exceptions |
-| `which` | `$which()` binary lookup with caching |
-| `fetch-retry` | `fetch` with retry/backoff policies |
-| `fs-error` | Errno guards (`isEnoent` and friends) |
-| `env` / `worker-host` | Environment plumbing and side-effect-free worker-host entry contract (`workerHostEntry`) |
-| `abortable` / `async` | AbortSignal-aware stream/promise helpers |
-| `math-delimiters` | LaTeX span/block delimiter grammar (offsets only) shared by the TUI and collab-web renderers |
-| `peek-file` | Read the first N bytes of a file with pooled buffers |
-| `frontmatter`, `glob`, `mime`, `temp`, `format`, `color`, `snowflake`, `tab-spacing`, `path-tree`, `sanitize-text` | Smaller single-purpose helpers |
+| Module                                                                                                             | Purpose                                                                                      |
+| ------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------- |
+| `logger`                                                                                                           | Centralized logger writing to `~/.zeta/logs/` with rotation (TUI-safe — never stdout)         |
+| `prompt`                                                                                                           | Handlebars-based prompt templating and formatting helpers                                    |
+| `dirs`                                                                                                             | Path helpers for omp config directories (`~/.zeta`, XDG-aware on Linux)                       |
+| `stream`                                                                                                           | `readStream` / `readLines` helpers over `ReadableStream`                                     |
+| `ptree` / `procmgr`                                                                                                | Process trees, `ChildProcess` wrapper, process lifecycle management                          |
+| `postmortem`                                                                                                       | Cleanup callbacks on exit, signals, and fatal exceptions                                     |
+| `which`                                                                                                            | `$which()` binary lookup with caching                                                        |
+| `fetch-retry`                                                                                                      | `fetch` with retry/backoff policies                                                          |
+| `fs-error`                                                                                                         | Errno guards (`isEnoent` and friends)                                                        |
+| `env` / `worker-host`                                                                                              | Environment plumbing and side-effect-free worker-host entry contract (`workerHostEntry`)     |
+| `abortable` / `async`                                                                                              | AbortSignal-aware stream/promise helpers                                                     |
+| `math-delimiters`                                                                                                  | LaTeX span/block delimiter grammar (offsets only) shared by the TUI and collab-web renderers |
+| `peek-file`                                                                                                        | Read the first N bytes of a file with pooled buffers                                         |
+| `frontmatter`, `glob`, `mime`, `temp`, `format`, `color`, `snowflake`, `tab-spacing`, `path-tree`, `sanitize-text` | Smaller single-purpose helpers                                                               |
 
 Import from the root barrel or per-module subpaths (`@linxiraos/pi-utils/<module>`).
 
@@ -33,5 +33,5 @@ Ships TypeScript source directly (no build step); requires Bun ≥ 1.3.14.
 
 ## References
 
-- [Monorepo README](https://github.com/Linxira-OS/linxira-zeta#readme)
+- [Monorepo README](https://github.com/can1357/oh-my-pi#readme)
 - [CHANGELOG](./CHANGELOG.md)

package/package.json

@@ -1,65 +1,59 @@
 {
-	"type": "module",
-	"name": "@linxiraos/pi-utils",
-	"version": "1.1.7",
-	"description": "Shared utilities for pi packages",
-	"homepage": "https://linxira-os.github.io/zeta/",
-	"author": "Can Boluk",
-	"license": "MIT",
-	"repository": {
-		"type": "git",
-		"url": "git+https://github.com/Linxira-OS/linxira-zeta.git",
-		"directory": "packages/utils"
-	},
-	"bugs": {
-		"url": "https://github.com/Linxira-OS/linxira-zeta/issues"
-	},
-	"keywords": [
-		"utilities",
-		"cli",
-		"logging",
-		"streams"
-	],
-	"main": "./src/index.ts",
-	"types": "./dist/types/index.d.ts",
-	"scripts": {
-		"check": "biome check . && bun run check:types",
-		"check:types": "tsgo -p tsconfig.json --noEmit",
-		"lint": "biome lint .",
-		"test": "bun test --parallel",
-		"fix": "biome check --write --unsafe .",
-		"fmt": "biome format --write ."
-	},
-	"dependencies": {
-		"@linxiraos/pi-natives": "1.1.7"
-	},
-	"devDependencies": {
-		"@types/bun": "^1.3.14"
-	},
-	"engines": {
-		"bun": ">=1.3.14"
-	},
-	"files": [
-		"src",
-		"README.md",
-		"CHANGELOG.md",
-		"LICENSE",
-		"THIRD-PARTY-NOTICES.txt",
-		"dist/types"
-	],
-	"exports": {
-		".": {
-			"types": "./dist/types/index.d.ts",
-			"import": "./src/index.ts"
-		},
-		"./ar": {
-			"types": "./dist/types/ar/index.d.ts",
-			"import": "./src/ar/index.ts"
-		},
-		"./*": {
-			"types": "./dist/types/*.d.ts",
-			"import": "./src/*.ts"
-		},
-		"./*.js": "./src/*.ts"
-	}
+  "engines": {
+    "bun": ">=1.3.14"
+  },
+  "devDependencies": {
+    "@types/bun": "^1.3.14"
+  },
+  "dependencies": {
+    "@linxiraos/pi-natives": "1.1.9"
+  },
+  "scripts": {
+    "test": "bun test --parallel",
+    "check:types": "tsgo -p tsconfig.json --noEmit",
+    "check": "tsgo -p tsconfig.json --noEmit"
+  },
+  "exports": {
+    "./*.js": "./src/*.ts",
+    "./*": {
+      "import": "./src/*.ts",
+      "types": "./src/*.ts"
+    },
+    "./ar": {
+      "import": "./src/ar/index.ts",
+      "types": "./src/ar/index.ts"
+    },
+    ".": {
+      "import": "./src/index.ts",
+      "types": "./src/index.ts"
+    }
+  },
+  "types": "./src/index.ts",
+  "main": "./src/index.ts",
+  "type": "module",
+  "files": [
+    "src",
+    "README.md",
+    "CHANGELOG.md"
+  ],
+  "repository": {
+    "directory": "packages/utils",
+    "url": "git+https://github.com/Linxira-OS/linxira-zeta.git",
+    "type": "git"
+  },
+  "author": "Can Boluk",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/Linxira-OS/linxira-zeta/issues"
+  },
+  "homepage": "https://linxira-os.github.io/zeta/",
+  "keywords": [
+    "utilities",
+    "cli",
+    "logging",
+    "streams"
+  ],
+  "description": "Shared utilities for pi packages",
+  "version": "1.1.9",
+  "name": "@linxiraos/pi-utils"
 }

package/src/acp/connection.ts

@@ -67,13 +67,11 @@ export class AgentSideConnection {
 	#connection: RpcConnection;
 
 	constructor(toAgent: (connection: AgentSideConnection) => Agent, stream: Stream) {
-		let agent: Agent | undefined;
 		this.#connection = new RpcConnection(stream, async (method, params, notification) => {
-			const target = agent;
-			if (!target) throw RequestError.internalError(undefined, "Agent is not initialized");
-			return dispatchAgent(target, method, params, notification);
+			if (!agent) throw RequestError.internalError(undefined, "Agent is not initialized");
+			return dispatchAgent(agent, method, params, notification);
 		});
-		agent = toAgent(this);
+		const agent = toAgent(this);
 	}
 
 	/** Signal aborted when the transport closes. */
@@ -170,13 +168,11 @@ export class ClientSideConnection {
 	#connection: RpcConnection;
 
 	constructor(toClient: (connection: ClientSideConnection) => Client, stream: Stream) {
-		let client: Client | undefined;
 		this.#connection = new RpcConnection(stream, async (method, params, notification) => {
-			const target = client;
-			if (!target) throw RequestError.internalError(undefined, "Client is not initialized");
-			return dispatchClient(target, method, params, notification);
+			if (!client) throw RequestError.internalError(undefined, "Client is not initialized");
+			return dispatchClient(client, method, params, notification);
 		});
-		client = toClient(this);
+		const client = toClient(this);
 	}
 	/** Signal aborted when the transport closes. */
 	get signal(): AbortSignal {

package/src/ar/entries.ts

@@ -45,7 +45,7 @@ export function upsertArchiveEntry(
  */
 export function ensureParentDirectories(map: Map<string, ArchiveIndexEntry>, limits: ArchiveLimits): void {
 	assertEntryCount(map.size, limits);
-	for (const entry of [...map.values()]) {
+	for (const entry of Array.from(map.values())) {
 		const parts = entry.path.split("/");
 		const stop = parts.length - 1;
 		for (let index = 1; index <= stop; index++) {

package/src/ar/sevenzip.ts

@@ -107,6 +107,7 @@ interface FileMetadata {
 }
 
 function readBoolVector(reader: HeaderReader, count: number): boolean[] {
+	// [suppressed] length preallocation
 	const result = new Array<boolean>(count);
 	let byte = 0;
 	let mask = 0;
@@ -122,12 +123,16 @@ function readBoolVector(reader: HeaderReader, count: number): boolean[] {
 }
 
 function readDefinedVector(reader: HeaderReader, count: number): boolean[] {
-	if (reader.readByte() !== 0) return new Array<boolean>(count).fill(true);
+	if (reader.readByte() !== 0) {
+		// [suppressed] length preallocation
+		return new Array<boolean>(count).fill(true);
+	}
 	return readBoolVector(reader, count);
 }
 
 function readDigests(reader: HeaderReader, count: number): Digests {
 	const defined = readDefinedVector(reader, count);
+	// [suppressed] length preallocation
 	const values = new Array<number | undefined>(count);
 	for (let index = 0; index < count; index++) if (defined[index]) values[index] = reader.readUInt32();
 	return { defined, values };
@@ -229,7 +234,10 @@ function parsePackInfo(reader: HeaderReader, streams: SevenZipStreams, options:
 		} else reader.skipSizedProperty();
 	}
 	if (streams.packSizes.length !== count) throw new ArchiveError("Invalid 7z PackInfo without complete sizes");
-	if (streams.packCrcs.length === 0) streams.packCrcs = new Array(count).fill(undefined);
+	if (streams.packCrcs.length === 0) {
+		// [suppressed] length preallocation
+		streams.packCrcs = new Array(count).fill(undefined);
+	}
 }
 
 function parseUnpackInfo(reader: HeaderReader, streams: SevenZipStreams, options: FormatReadOptions): void {
@@ -254,6 +262,7 @@ function parseUnpackInfo(reader: HeaderReader, streams: SevenZipStreams, options
 }
 
 function parseSubStreamsInfo(reader: HeaderReader, streams: SevenZipStreams): void {
+	// [suppressed] length preallocation
 	const counts = new Array<number>(streams.folders.length).fill(1);
 	let sizes: number[] | undefined;
 	let rawDigests: Digests | undefined;
@@ -398,6 +407,7 @@ function parseNames(reader: HeaderReader, count: number, external: Uint8Array[],
 function parseTimes(reader: HeaderReader, count: number, external: Uint8Array[]): Array<number | undefined> {
 	const defined = readDefinedVector(reader, count);
 	const values = selectPropertyStream(reader, external);
+	// [suppressed] length preallocation
 	const result = new Array<number | undefined>(count);
 	for (let index = 0; index < count; index++)
 		if (defined[index]) {
@@ -411,6 +421,7 @@ function parseTimes(reader: HeaderReader, count: number, external: Uint8Array[])
 function parseAttributes(reader: HeaderReader, count: number, external: Uint8Array[]): Array<number | undefined> {
 	const defined = readDefinedVector(reader, count);
 	const values = selectPropertyStream(reader, external);
+	// [suppressed] length preallocation
 	const result = new Array<number | undefined>(count);
 	for (let index = 0; index < count; index++) if (defined[index]) result[index] = values.readUInt32();
 	return result;
@@ -420,11 +431,15 @@ function parseFilesInfo(reader: HeaderReader, external: Uint8Array[], options: F
 	const count = reader.readNumber("file count");
 	assertEntryCount(count, options.limits);
 	const metadata: FileMetadata = {
+		// [suppressed] length preallocation
 		names: new Array<string>(count).fill(""),
+		// [suppressed] length preallocation
 		emptyStreams: new Array<boolean>(count).fill(false),
 		emptyFiles: [],
 		antiFiles: [],
+		// [suppressed] length preallocation
 		mtimes: new Array<number | undefined>(count),
+		// [suppressed] length preallocation
 		attributes: new Array<number | undefined>(count),
 	};
 	for (;;) {

package/src/async.ts

@@ -1,9 +1,14 @@
 /**
  * Wrap a promise with a timeout and optional abort signal.
- * Rejects with the given message if the timeout fires first.
- * Cleans up all listeners on settlement.
+ * Rejects with the given error or a new error containing the given message if
+ * the timeout fires first. Cleans up all listeners on settlement.
  */
-export function withTimeout<T>(promise: Promise<T>, ms: number, message: string, signal?: AbortSignal): Promise<T> {
+export function withTimeout<T>(
+	promise: Promise<T>,
+	ms: number,
+	timeout: string | Error,
+	signal?: AbortSignal,
+): Promise<T> {
 	if (signal?.aborted) {
 		const reason = signal.reason instanceof Error ? signal.reason : new Error("Aborted");
 		return Promise.reject(reason);
@@ -15,7 +20,7 @@ export function withTimeout<T>(promise: Promise<T>, ms: number, message: string,
 		if (settled) return;
 		settled = true;
 		if (signal) signal.removeEventListener("abort", onAbort);
-		reject(new Error(message));
+		reject(typeof timeout === "string" ? new Error(timeout) : timeout);
 	}, ms);
 
 	const onAbort = () => {
@@ -103,3 +108,19 @@ export class AsyncDrain<T> {
 		return this.#promise;
 	}
 }
+
+/**
+ * Runs async operations one at a time in call order. Each `run` starts after
+ * the previous operation settles (success or failure) and returns that
+ * operation's own promise, so a rejected step never poisons the queue. Used by
+ * stateful cursors whose concurrent pulls must not interleave.
+ */
+export class Serial {
+	#tail: Promise<unknown> = Promise.resolve();
+
+	run<T>(op: () => Promise<T>): Promise<T> {
+		const result = this.#tail.then(op, op);
+		this.#tail = result.catch(() => {});
+		return result;
+	}
+}

package/src/browsers.ts

@@ -39,6 +39,13 @@ export enum BrowserPlatform {
 	WIN32 = "win32",
 	WIN64 = "win64",
 }
+type ChromeForTestingPlatform = Exclude<BrowserPlatform, BrowserPlatform.LINUX_ARM>;
+
+function requireChromeForTestingPlatform(platform: BrowserPlatform): ChromeForTestingPlatform {
+	if (platform === BrowserPlatform.LINUX_ARM)
+		throw new Error("Chrome for Testing does not provide linux/arm64 builds");
+	return platform;
+}
 
 const BROWSERS = [
 	Browser.CHROME,
@@ -163,13 +170,13 @@ export function getDownloadUrl(
 
 /** Compute the executable path in Puppeteer's cache layout. */
 export function computeExecutablePath(options: ComputeExecutablePathOptions): string {
-	const platform = options.platform ?? detectBrowserPlatform();
-	if (!platform) throw new Error("Cannot determine a browser platform for this host");
+	const detectedPlatform = options.platform ?? detectBrowserPlatform();
+	if (!detectedPlatform) throw new Error("Cannot determine a browser platform for this host");
 	if (options.browser !== Browser.CHROME) throw new Error(`Unsupported browser executable: ${options.browser}`);
+	const platform = requireChromeForTestingPlatform(detectedPlatform);
 	const installDir = installationDir(options.cacheDir, options.browser, platform, options.buildId);
 	switch (platform) {
 		case BrowserPlatform.LINUX:
-		case BrowserPlatform.LINUX_ARM:
 			return path.join(installDir, "chrome-linux64", "chrome");
 		case BrowserPlatform.MAC:
 			return path.join(
@@ -292,9 +299,8 @@ async function fetchMetadata<T>(filename: string): Promise<T> {
 }
 
 function chromeArchivePlatform(platform: BrowserPlatform): string {
-	switch (platform) {
+	switch (requireChromeForTestingPlatform(platform)) {
 		case BrowserPlatform.LINUX:
-		case BrowserPlatform.LINUX_ARM:
 			return "linux64";
 		case BrowserPlatform.MAC:
 			return "mac-x64";

package/src/dirs.ts

@@ -8,7 +8,7 @@
  * variables are set, paths are redirected to XDG-compliant locations under
  * $XDG_*_HOME/zeta/. This requires running `zeta config migrate` first to
  * move data to the new locations. No filesystem existence checks are performed
- * — if the env var is set, omp trusts that the migration has been done.
+ * — if the env var is set, zeta trusts that the migration has been done.
  */
 
 import * as fs from "node:fs";
@@ -17,7 +17,7 @@ import * as path from "node:path";
 import { engines, version } from "../package.json" with { type: "json" };
 import { isEnoent, isEnotdir } from "./fs-error";
 
-/** App name (e.g. "omp") */
+/** App name (e.g. "zeta") */
 export const APP_NAME: string = "zeta";
 
 /** Config directory name (e.g. ".zeta") */
@@ -67,7 +67,7 @@ export function normalizeProfileName(profile: string | undefined): string | unde
 		WINDOWS_RESERVED_BASENAME_RE.test(normalized)
 	) {
 		throw new Error(
-			`Invalid OMP profile "${profile}". Profile names must match ${PROFILE_NAME_RE.source}, ` +
+			`Invalid Zeta profile "${profile}". Profile names must match ${PROFILE_NAME_RE.source}, ` +
 				`cannot be "." or "..", cannot end with ".", and cannot be a Windows reserved device name ` +
 				`(CON, PRN, AUX, NUL, COM0-9, LPT0-9, or any of those with an extension).`,
 		);
@@ -97,7 +97,7 @@ function getProfileFromEnv(): string | undefined {
  * crash a bare `import` of this module with an uncaught stack trace before the
  * CLI's error handling is in scope. The default profile is used instead; the
  * CLI re-validates the env (see `runCli` in coding-agent/src/cli.ts) so the
- * user still gets a clean "Invalid OMP profile" message.
+ * user still gets a clean "Invalid Zeta profile" message.
  */
 function readProfileFromEnvSafe(): string | undefined {
 	try {
@@ -295,7 +295,7 @@ export function getConfigAgentDirName(): string {
 type XdgCategory = "data" | "state" | "cache";
 
 /**
- * Resolves and caches all omp directory paths. On Linux, when XDG environment
+ * Resolves and caches all zeta directory paths. On Linux, when XDG environment
  * variables are set, paths are redirected under $XDG_*_HOME/zeta/. A new
  * instance is created whenever the agent directory changes, which naturally
  * invalidates all cached paths.
@@ -949,6 +949,11 @@ export function getSecretPlaceholderKeyPath(): string {
 	return keyPath;
 }
 
+/** Directory holding the per-model tiny-worker sockets and logs (~/.zeta/run/tiny; XDG default: $XDG_STATE_HOME/zeta/run/tiny). */
+export function getTinyWorkerRuntimeDir(): string {
+	return dirs.rootSubdir(path.join("run", "tiny"), "state");
+}
+
 /** Root directory containing every per-project daemon runtime scope (~/.zeta/run/daemons; XDG default: $XDG_STATE_HOME/zeta/run/daemons). */
 export function getDaemonRuntimeRoot(): string {
 	return dirs.rootSubdir(path.join("run", "daemons"), "state");
@@ -1108,11 +1113,6 @@ export function getInstallId(): string {
 	return next;
 }
 
-/** Test-only: clear cached install id. Never call from production code. */
-export function __resetInstallIdCacheForTests(): void {
-	cachedInstallId = null;
-}
-
 /** Get the project-level tracking directory (<project>/.zeta/tracking). */
 export function getProjectTrackingDir(cwd: string = getProjectDir()): string {
 	return path.join(getProjectAgentDir(cwd), "tracking");
@@ -1122,3 +1122,8 @@ export function getProjectTrackingDir(cwd: string = getProjectDir()): string {
 export function getTrackingIndexPath(agentDir?: string): string {
 	return path.join(agentDir ?? getAgentDir(), "tracking-index.json");
 }
+
+/** Test-only: clear cached install id. Never call from production code. */
+export function __resetInstallIdCacheForTests(): void {
+	cachedInstallId = null;
+}

package/src/dom/core.ts

@@ -105,7 +105,7 @@ export class EventTarget {
 	dispatchEvent(event: Event): boolean {
 		if (!event.target) event.target = this;
 		event.currentTarget = this;
-		for (const listener of [...(this.#listeners.get(event.type) ?? [])]) {
+		for (const listener of Array.from(this.#listeners.get(event.type) ?? [])) {
 			if (typeof listener === "function") listener.call(this, event);
 			else listener.handleEvent(event);
 			if (event.propagationStopped) break;
@@ -196,7 +196,7 @@ export class Node extends EventTarget {
 		const node: Node = child;
 		if (node === this || node.contains(this)) throw new Error("The new child is an ancestor of this node");
 		if (child instanceof DocumentFragment) {
-			for (const nested of [...child.childNodes]) this.appendChild(nested);
+			for (const nested of Array.from(child.childNodes)) this.appendChild(nested);
 			return child;
 		}
 		child.parentNode?.removeChild(child);
@@ -212,7 +212,7 @@ export class Node extends EventTarget {
 		const index = this.childNodes.indexOf(reference);
 		if (index < 0) throw new Error("The reference node is not a child of this node");
 		if (child instanceof DocumentFragment) {
-			for (const nested of [...child.childNodes]) this.insertBefore(nested, reference);
+			for (const nested of Array.from(child.childNodes)) this.insertBefore(nested, reference);
 			return child;
 		}
 		child.parentNode?.removeChild(child);
@@ -681,7 +681,7 @@ export class Element extends Node {
 		const parent = this.parentNode;
 		if (!parent) return;
 		const fragment = parseFragment(value, this.documentForCreation(), this.parentElement?.localName);
-		for (const child of [...fragment.childNodes]) parent.insertBefore(child, this);
+		for (const child of Array.from(fragment.childNodes)) parent.insertBefore(child, this);
 		parent.removeChild(this);
 	}
 

package/src/env.ts

@@ -36,6 +36,18 @@ export function isMacosMallocStackLoggingEnvName(name: string): boolean {
 	return name === "MallocStackLogging" || name === "MallocStackLoggingNoCompact";
 }
 
+/**
+ * True when running inside a WSL (Windows Subsystem for Linux) distribution.
+ *
+ * WSL reports `linux` for `process.platform`, so the only reliable signal is
+ * the `WSL_DISTRO_NAME`/`WSL_INTEROP` variables the interop layer injects.
+ * Callers use this to translate Windows drive paths to their `/mnt/<drive>`
+ * mounts and to route clipboard access through `powershell.exe`.
+ */
+export function isWsl(platform: NodeJS.Platform = process.platform, env: NodeJS.ProcessEnv = process.env): boolean {
+	return platform === "linux" && Boolean(env.WSL_DISTRO_NAME || env.WSL_INTEROP);
+}
+
 export function filterProcessEnv(env: Record<string, string | undefined>): Record<string, string> {
 	const result: Record<string, string> = {};
 	for (const key in env) {

package/src/fetch-retry.ts

@@ -12,6 +12,12 @@ const RETRY_DELAY_FIELD_PATTERN = /"retryDelay":\s*"([0-9.]+)(ms|s)"/i;
 const TRY_AGAIN_PATTERN = /try again in\s+~?\s*([0-9.]+)\s*(ms|sec|s|minutes?|mins?|m|hours?|hrs?|h)\b/i;
 // "Your limit will reset in 13 minutes" / "reset in 13 minutes" / "will reset in 2h"
 const WILL_RESET_IN_PATTERN = /(?:will\s+)?reset in\s+~?\s*([0-9.]+)\s*(ms|sec|s|minutes?|mins?|m|hours?|hrs?|h)\b/i;
+// "Your limit will reset at 2026-09-01 09:44:51" / "reset at 2026-09-01T09:44:51Z"
+const WILL_RESET_AT_PATTERN =
+	/(?:will\s+)?reset at\s+([0-9]{4}-[0-9]{2}-[0-9]{2}[ T][0-9]{2}:[0-9]{2}:[0-9]{2}(?:\.[0-9]+)?(?:Z|[+-][0-9]{2}:?[0-9]{2})?)/i;
+const CN_RESET_AT_PATTERN = /将在\s*([0-9]{4}-[0-9]{2}-[0-9]{2}\s+[0-9]{2}:[0-9]{2}:[0-9]{2})\s*重置/;
+// "retry-after-ms=98497000"
+const RETRY_AFTER_MS_BODY_PATTERN = /\bretry-after-ms=([0-9]+)\b/i;
 
 /**
  * Server-suggested retry delay extraction. Merges the patterns historically used
@@ -29,6 +35,8 @@ const WILL_RESET_IN_PATTERN = /(?:will\s+)?reset in\s+~?\s*([0-9.]+)\s*(ms|sec|s
  *  - `Please retry in 250ms` / `Please retry in 12s`
  *  - `"retryDelay": "34.074824224s"` (JSON error detail field)
  *  - `try again in 250ms` / `try again in 12s` / `try again in 5 min` / `try again in ~158 min`
+ *  - `retry-after-ms=98497000`
+ *  - `Your limit will reset at 2026-09-01 09:44:51` / `将在 2026-09-01 09:44:51 重置`
  *
  * Returns `undefined` if no signal is found.
  */
@@ -85,11 +93,38 @@ export function extractRetryHint(source: Response | Headers | null | undefined,
 			if (totalMs > 0) return totalMs;
 		}
 	}
+	for (const pattern of [WILL_RESET_AT_PATTERN, CN_RESET_AT_PATTERN]) {
+		const match = pattern.exec(body);
+		if (match?.[1]) {
+			// Provider timestamps without an explicit offset are interpreted as UTC.
+			const normalized = match[1].replace(" ", "T");
+			const hasOffset = /(?:Z|[+-][0-9]{2}:?[0-9]{2})$/i.test(normalized);
+			const parsed = Date.parse(hasOffset ? normalized : `${normalized}Z`);
+			if (!Number.isNaN(parsed) && parsed > Date.now()) {
+				return parsed - Date.now();
+			}
+		}
+	}
 	// Account-reset hints ("will reset in …") take precedence over short
 	// retry hints ("please retry in 5s"): a body carrying both must honour the
 	// longer account window, not the shorter generic one. QUOTA_RESET_PATTERN
 	// ("reset after …") above already runs first and stays first.
-	for (const pattern of [WILL_RESET_IN_PATTERN, PLEASE_RETRY_PATTERN, RETRY_DELAY_FIELD_PATTERN, TRY_AGAIN_PATTERN]) {
+	const accountResetMatch = WILL_RESET_IN_PATTERN.exec(body);
+	if (accountResetMatch?.[1]) {
+		const value = Number.parseFloat(accountResetMatch[1]);
+		if (Number.isFinite(value) && value > 0) {
+			const unitMs = unitToMs(accountResetMatch[2]!);
+			if (unitMs !== undefined) return value * unitMs;
+		}
+	}
+
+	const retryAfterMsMatch = RETRY_AFTER_MS_BODY_PATTERN.exec(body);
+	if (retryAfterMsMatch?.[1]) {
+		const ms = Number(retryAfterMsMatch[1]);
+		if (Number.isFinite(ms) && ms > 0) return ms;
+	}
+
+	for (const pattern of [PLEASE_RETRY_PATTERN, RETRY_DELAY_FIELD_PATTERN, TRY_AGAIN_PATTERN]) {
 		const match = pattern.exec(body);
 		if (match?.[1]) {
 			const value = Number.parseFloat(match[1]);

package/src/format.ts

@@ -9,7 +9,7 @@ const DAY = 24 * HOUR;
  */
 export function formatDuration(ms: number): string {
 	if (!Number.isFinite(ms) || ms <= 0) return "0ms";
-	if (ms < SEC) return `${ms}ms`;
+	if (ms < SEC) return `${Math.floor(ms)}ms`;
 	if (ms < MIN) return `${(ms / SEC).toFixed(1)}s`;
 	if (ms < HOUR) {
 		const mins = Math.floor(ms / MIN);

package/src/frontmatter.ts

@@ -22,6 +22,7 @@ export function normalizeFrontmatterKeys<T>(obj: T): T {
 	if (obj === null || typeof obj !== "object") return obj;
 	if (Array.isArray(obj)) {
 		let changed = false;
+		// [suppressed] length preallocation
 		const out: unknown[] = new Array(obj.length);
 		for (let i = 0; i < obj.length; i++) {
 			const v = obj[i];