@linxiraos/pi-utils 1.1.7 → 1.1.9

package/src/temp.ts

@@ -78,10 +78,12 @@ function normalizePrefix(prefix?: string): string {
 }
 
 const kRemoveOptions = { recursive: true, force: true } as const;
-const kRemoveRetries = 40;
-// 50ms × 40 retries = 2s total retry window. Windows holds file locks on
-// SQLite DBs for up to ~1.5s after close(); the previous 25ms (1s total)
-// was too short for some test cleanup scenarios.
+const kRemoveRetries = 150;
+// 50ms × 150 retries = 7.5s total retry window. Windows releases file locks on
+// SQLite DBs (and spawned-process CWDs) asynchronously after close(); the
+// measured release latency reaches ~730ms–5s when a child process just died
+// holding the directory, and the previous 2s window flaked suites that clean
+// up temp trees containing agent.db.
 const kRemoveRetryDelayMs = 50;
 const kRetryableRemoveErrorCodes = new Set(["EBUSY", "EPERM", "ENOTEMPTY"]);
 const kSleepBuffer = new Int32Array(new SharedArrayBuffer(4));
@@ -132,3 +134,13 @@ function sleepSync(ms: number): void {
 	}
 	Atomics.wait(kSleepBuffer, 0, 0, ms);
 }
+
+/**
+ * Create a directory symlink in a platform-correct way. Windows denies
+ * unprivileged file/dir symlinks (EPERM on `fs.symlink` without a type), but
+ * allows directory *junctions*, which every test that links temp directories
+ * should use instead. POSIX ignores the type argument.
+ */
+export function symlinkDirectorySync(target: string, linkPath: string): void {
+	fs.symlinkSync(target, linkPath, process.platform === "win32" ? "junction" : "dir");
+}

package/src/template.ts

@@ -549,7 +549,7 @@ export function compile<T = unknown>(source: string, options: CompileOptions = {
 	const nodes = parseTemplate(stripStandalone(source));
 	return (context, runtime = {}) => {
 		const root = context ?? {};
-		const frame: Frame = { context: root, parents: [], root, data: { root, ...(runtime.data ?? {}) } };
+		const frame: Frame = { context: root, parents: [], root, data: { root, ...runtime.data } };
 		return renderNodes(nodes, frame, { helpers, partials, options, runtime });
 	};
 }
@@ -579,7 +579,7 @@ export class TemplateEngine {
 		const nodes = parseTemplate(stripStandalone(source));
 		return (context, runtime = {}) => {
 			const root = context ?? {};
-			const frame: Frame = { context: root, parents: [], root, data: { root, ...(runtime.data ?? {}) } };
+			const frame: Frame = { context: root, parents: [], root, data: { root, ...runtime.data } };
 			return renderNodes(nodes, frame, { helpers: this.#helpers, partials: this.#partials, options, runtime });
 		};
 	}

package/src/tls-fetch.ts

@@ -76,7 +76,7 @@ let cacheValue: string | undefined;
  *   path, matching Node's "extensionless filename is still a path" contract.
  *   `ENOENT` becomes {@link ExtraCaError}; other I/O errors bubble.
  */
-function resolveExtraCa(): string | undefined {
+export function resolveExtraCa(): string | undefined {
 	const raw = $env.NODE_EXTRA_CA_CERTS?.trim();
 	if (!raw) return undefined;
 
@@ -122,7 +122,7 @@ export function __resetExtraCaCache(): void {
  * Anthropic Foundry's mTLS options, which already seed
  * `tls.rootCertificates`), only the extra CA is appended.
  */
-function withExtraCaInit(init: RequestInit | undefined, extraCa: string): RequestInit {
+export function withExtraCaInit(init: RequestInit | undefined, extraCa: string): RequestInit {
 	const existingTls = (init as BunTlsRequestInit | undefined)?.tls;
 	const existingCa = existingTls?.ca;
 	let mergedCa: string[];
@@ -162,17 +162,3 @@ export function wrapFetchForExtraCa(fetchImpl: FetchImpl): FetchImpl {
 	);
 	return wrapped;
 }
-
-/**
- * Convenience for options-bag composition (e.g. the stream-entry path in
- * `@linxiraos/pi-ai`'s `stream.ts`, which mirrors `withRequestDebugFetch` so
- * the proxy/debug/extra-CA wrappers compose uniformly). No-op when the env
- * var is unset.
- */
-export function withExtraCaFetch<T extends { fetch?: FetchImpl } | undefined>(options: T): T {
-	if (!$env.NODE_EXTRA_CA_CERTS?.trim()) return options;
-	const fetchImpl = options?.fetch ?? (globalThis.fetch as FetchImpl);
-	const wrapped = wrapFetchForExtraCa(fetchImpl);
-	if (wrapped === fetchImpl && options?.fetch !== undefined) return options;
-	return { ...(options ?? {}), fetch: wrapped } as T;
-}

package/src/turndown/html.ts

@@ -222,7 +222,7 @@ export function parseHtmlFragment(html: string): TurndownNode {
 	const stack: HtmlNode[] = [root];
 	for (const token of htmlTokens(html)) {
 		const parent = stack[stack.length - 1] ?? root;
-		if (token.startsWith("<!--") || /^<!/i.test(token)) continue;
+		if (token.startsWith("<!--") || token.startsWith("<!")) continue;
 		if (!token.startsWith("<")) {
 			parent.append(new HtmlText(decodeEntities(token)));
 			continue;

package/src/vterm/query-responder.ts

@@ -0,0 +1,76 @@
+/**
+ * Answers terminal capability queries emitted by programs on a headless PTY.
+ *
+ * A PTY that advertises `TERM=xterm-256color` but has no terminal behind it
+ * leaves capability probes unanswered: a program writes a query escape to
+ * stdout and blocks on stdin until the reply arrives (or its timeout expires,
+ * seconds later). This scanner watches raw PTY output for the standard queries
+ * and returns the bytes a real xterm-class terminal would send back, so the
+ * caller can write them into the PTY. It keeps no screen state — cursor
+ * position reports are answered with the home position — which makes it cheap
+ * enough to run on every byte of a long-lived supervised process. Use the full
+ * {@link Terminal} when the caller also renders the output.
+ *
+ * Queries can straddle chunk boundaries, so an unfinished trailing escape is
+ * carried into the next {@link feed}.
+ */
+export class TerminalQueryResponder {
+	/** Trailing bytes that may be the start of an unfinished query escape. */
+	#residual = "";
+
+	/**
+	 * Feed one raw PTY output chunk. Returns the reply bytes to write back into
+	 * the PTY, or an empty string when the chunk held no answerable query.
+	 */
+	feed(chunk: string): string {
+		const buffer = this.#residual + chunk;
+		let replies = "";
+		let lastEnd = 0;
+		QUERY.lastIndex = 0;
+		for (let match = QUERY.exec(buffer); match !== null; match = QUERY.exec(buffer)) {
+			lastEnd = match.index + match[0].length;
+			replies += replyFor(match);
+		}
+		// Keep only a short unmatched trailing escape: a query split across
+		// chunks completes on the next feed, while a long tail is ordinary output
+		// that can never become a query.
+		const tailEscape = buffer.lastIndexOf("\x1b");
+		this.#residual =
+			tailEscape >= lastEnd && buffer.length - tailEscape <= MAX_PARTIAL_QUERY ? buffer.slice(tailEscape) : "";
+		return replies;
+	}
+}
+
+/** Longest query escape we answer, bounding the cross-chunk residual. */
+const MAX_PARTIAL_QUERY = 32;
+
+/**
+ * CSI DSR/DA queries (final byte `n` or `c`) and OSC 10/11 color queries. Only
+ * forms with canned answers are matched; everything else stays plain output.
+ */
+const QUERY = /\x1b\[([?>=]?)([0-9;]*)([nc])|\x1b\](10|11);\?(\x07|\x1b\\)/gu;
+
+/** Reply a real xterm-class terminal would send for one matched query. */
+function replyFor(match: RegExpExecArray): string {
+	const final = match[3];
+	if (final !== undefined) {
+		const intermediate = match[1];
+		const params = match[2] ?? "";
+		if (final === "c") {
+			if (intermediate === ">") return "\x1b[>0;10;1c"; // secondary DA: VT100-class, firmware 10
+			if (intermediate === "" || intermediate === "0") return "\x1b[?1;2c"; // primary DA: VT100 with AVO
+			return ""; // tertiary (`=`) DA has no widely expected reply
+		}
+		if (intermediate !== "") return ""; // private DSR forms (DECXCPR, appearance) stay unanswered
+		const selector = params.split(";", 1)[0];
+		if (selector === "6") return "\x1b[1;1R"; // cursor position: home, there is no screen
+		if (selector === "5") return "\x1b[0n"; // device status: OK
+		return "";
+	}
+	// OSC color queries: neutral colors, terminated the way the request was.
+	const selector = match[4];
+	const terminator = match[5] ?? "\x07";
+	if (selector === "10") return `\x1b]10;rgb:ffff/ffff/ffff${terminator}`; // foreground
+	if (selector === "11") return `\x1b]11;rgb:0000/0000/0000${terminator}`; // background
+	return "";
+}

package/src/vterm.ts

@@ -1,5 +1,6 @@
 /** Behavior-compatible reimplementation of @xterm/headless's used surface. */
 export * from "./vterm/buffer";
+export * from "./vterm/query-responder";
 export * from "./vterm/terminal";
 
 import { Terminal } from "./vterm/terminal";