@linxiraos/pi-utils 1.1.8 → 1.1.9

package/CHANGELOG.md

@@ -2,10 +2,9 @@
 
 ## [Unreleased]
 
-## [1.1.8] - 2026-09-04
+## [1.1.9] - 2026-09-05
 
-- Added `symlinkDirectorySync` — Windows-correct directory links (junction) for tests and tooling that must link temp trees without elevation.
-- Extended the temp-removal retry window to 7.5s: measured Windows handle-release latency after a child process dies reaches ~5s, and the previous 2s window flaked suites cleaning up trees containing SQLite databases.
+- 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
 

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.8",
-	"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.8"
-	},
-	"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/async.ts

@@ -108,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/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;
+}