@oh-my-pi/pi-natives 18.11.0 → 18.11.2

package/native/desktop-adapter.js

@@ -15,6 +15,8 @@ const REQUIRED_METHODS = [
 	"releaseControl",
 	"controlState",
 	"bringToCurrentSpace",
+	"holdDisplayUntilReleased",
+	"releaseDisplayAwake",
 ];
 
 /** Require the current desktop ABI; partial legacy emulation cannot preserve input ownership. */

package/native/index.d.ts

@@ -43,6 +43,19 @@ export declare class DesktopSession {
    * behind the worker, so it answers at once even while a request is stuck.
    */
   get screenState(): DesktopScreenState
+  /**
+   * Keeps the display awake from the next activity request until
+   * `releaseDisplayAwake()`, however long the session sits idle in between,
+   * instead of for the grace period after the last request. An agent calls
+   * this when it acts inside a turn.
+   */
+  holdDisplayUntilReleased(): void
+  /**
+   * Lets the display sleep now if a turn holds it, without waiting behind
+   * queued requests, and returns later activity to the grace period. Activity
+   * outside a turn keeps its grace. An agent calls this when its turn ends.
+   */
+  releaseDisplayAwake(): void
   listDisplays(): Promise<Array<DesktopDisplay>>
   listWindows(): Promise<Array<DesktopWindow>>
   listApplications(options?: ApplicationQuery | undefined | null): Promise<Array<Application>>
@@ -2058,7 +2071,10 @@ export interface GrepOptions {
   pattern: string
   /** Directory or file to search: a host path or an absolute `scheme://` URL. */
   path: string
-  /** Glob filter for filenames (e.g., "*.ts"). */
+  /**
+   * Glob filter for file paths (e.g., "*.ts"); a matched directory selects
+   * every file under it.
+   */
   glob?: string
   /**
    * Match simple glob patterns at any depth (default: true; `*.ts` ->
@@ -2459,6 +2475,13 @@ export interface ListWorkspaceOptions {
    * to find them. Default: false.
    */
   collectAgentsMd?: boolean
+  /**
+   * Report unreadable directories instead of silently skipping them: an
+   * unreadable root fails the scan, and unreadable subdirectories are
+   * returned in `unreadableDirectories` while the walk continues. Default:
+   * false (startup discovery stays best-effort).
+   */
+  reportDirectoryErrors?: boolean
   /** Timeout in milliseconds for the operation. */
   timeoutMs?: number
   /** Abort signal for cancelling the operation. */
@@ -2476,6 +2499,11 @@ export interface ListWorkspaceResult {
   agentsMdFiles: Array<string>
   /** True when any output cap was hit. */
   truncated: boolean
+  /**
+   * Subdirectories whose contents could not be listed. Always empty unless
+   * `reportDirectoryErrors` is set.
+   */
+  unreadableDirectories: Array<WorkspaceDirectoryError>
 }
 
 /**
@@ -2709,6 +2737,9 @@ export interface NodeSpan {
 /** Decode notebook JSON into the editable cell-marker text. */
 export declare function notebookToEditableText(json: string, displayPath: string): string
 
+/** Check syntax through the shared parse cache without constructing a summary. */
+export declare function parseCodeStatus(options: ParseStatusOptions): ParseStatus
+
 /** Parsed Kitty keyboard protocol sequence result for a Kitty input sequence. */
 export interface ParsedKittyResult {
   /** Primary codepoint associated with the key. */
@@ -2737,6 +2768,23 @@ export declare function parseKey(data: string, kittyProtocolActive: boolean): st
  */
 export declare function parseKittySequence(data: string): ParsedKittyResult | null
 
+export interface ParseStatus {
+  /** Canonical language name only when parsing succeeded. */
+  language?: string
+  /** True when non-empty source parses without syntax errors. */
+  parsed: boolean
+}
+
+/** Options for checking source syntax without generating a summary. */
+export interface ParseStatusOptions {
+  /** Source code to parse; empty input is not parsed. */
+  code: string
+  /** Language alias; a non-blank value overrides path-based detection. */
+  lang?: string
+  /** File path used to infer language when `lang` is omitted or blank. */
+  path?: string
+}
+
 /** One hunk of a unified diff, matching jsdiff `structuredPatch` hunks. */
 export interface PatchHunk {
   /** 1-based first line of the hunk in the old text. */
@@ -3850,8 +3898,8 @@ export declare function visibleWidth(text: string, tabWidth: number): number
  * [`enclosing_block_boundaries`], [`block_range_at`] and [`node_chain_at`]
  * are synchronous and parse on the JS thread when their source is not
  * cached; awaiting this first makes that parse a cache hit. Resolves without
- * parsing when the language is unrecognized or the source is too large for
- * the cache to keep.
+ * parsing when the language is unrecognized or the source is over 2 MiB,
+ * where a typical tree would not fit the cache's memory budget.
  */
 export declare function warmBlockParse(options: BlockParseOptions): Promise<undefined>
 
@@ -3908,6 +3956,14 @@ export interface WorkProfile {
   sampleCount: number
 }
 
+/** A subdirectory the scan could not list. */
+export interface WorkspaceDirectoryError {
+  /** Forward-slash path relative to the scan root. */
+  path: string
+  /** Platform error, e.g. `Permission denied (os error 13)`. */
+  message: string
+}
+
 /**
  * Wrap text to a visible width, preserving ANSI escape codes across line
  * breaks.

package/native/index.js

@@ -116,6 +116,7 @@ export const matchesLegacySequence = nativeBindings.matchesLegacySequence ?? mis
 export const mmrRerankIndices = nativeBindings.mmrRerankIndices ?? missingNativeExport("mmrRerankIndices");
 export const nodeChainAt = nativeBindings.nodeChainAt ?? missingNativeExport("nodeChainAt");
 export const notebookToEditableText = nativeBindings.notebookToEditableText ?? missingNativeExport("notebookToEditableText");
+export const parseCodeStatus = nativeBindings.parseCodeStatus ?? missingNativeExport("parseCodeStatus");
 export const parseKey = nativeBindings.parseKey ?? missingNativeExport("parseKey");
 export const parseKittySequence = nativeBindings.parseKittySequence ?? missingNativeExport("parseKittySequence");
 export const pdfToMarkdown = nativeBindings.pdfToMarkdown ?? missingNativeExport("pdfToMarkdown");

package/native/vcs.js

@@ -97,28 +97,55 @@ export function detachGitDir(worktreeRoot, sourceCommonDir, signal) {
 	return api().vcsDetachGitDir(worktreeRoot, sourceCommonDir, signal);
 }
 
+/**
+ * Publish `from` at `to` only once fully written: copy to a sibling temp name,
+ * then hard-link it into place (Git's own `finalize_object_file` strategy) so
+ * readers never see a partial file and an interrupted copy leaves only a
+ * `tmp_` file that `git gc` prunes. An existing `to` was itself published
+ * whole and holds the same content-addressed bytes, so it is kept.
+ */
+async function publishGitObjectFile(from, to) {
+	const tmp = path.join(path.dirname(to), `tmp_obj_omp_${crypto.randomUUID()}`);
+	try {
+		await fs.promises.copyFile(from, tmp, fs.constants.COPYFILE_EXCL);
+		try {
+			await fs.promises.link(tmp, to);
+		} catch (error) {
+			if (error?.code === "EEXIST") return;
+			// Filesystems without hard links: rename is still atomic, and any
+			// file it replaces holds identical content-addressed bytes.
+			if (error?.code !== "EPERM" && error?.code !== "ENOTSUP" && error?.code !== "EXDEV") throw error;
+			await fs.promises.rename(tmp, to);
+		}
+	} finally {
+		await fs.promises.rm(tmp, { force: true });
+	}
+}
+
 /**
  * Keep objects created in an isolated Git repository reachable after its
  * worktree is removed, without changing the destination's refs or index.
+ * Every file is published atomically; a pack is published before its index.
  */
 export async function copyGitObjects(isolationRoot, sourceRoot) {
 	const from = path.join(requireGit(isolationRoot).info().commonDir, "objects");
 	const to = path.join(requireGit(sourceRoot).info().commonDir, "objects");
 	for (const entry of await fs.promises.readdir(from, { withFileTypes: true })) {
-		if (entry.isDirectory() && /^[0-9a-f]{2}$/.test(entry.name)) {
-			await fs.promises.cp(path.join(from, entry.name), path.join(to, entry.name), {
-				recursive: true,
-				force: false,
-			});
+		if (!entry.isDirectory() || !/^[0-9a-f]{2}$/.test(entry.name)) continue;
+		await fs.promises.mkdir(path.join(to, entry.name), { recursive: true });
+		for (const name of await fs.promises.readdir(path.join(from, entry.name))) {
+			if (!/^[0-9a-f]{38,62}$/.test(name)) continue;
+			await publishGitObjectFile(path.join(from, entry.name, name), path.join(to, entry.name, name));
 		}
 	}
-	const packs = await fs.promises.readdir(path.join(from, "pack"));
+	const packs = (await fs.promises.readdir(path.join(from, "pack"))).filter(name => name.startsWith("pack-"));
+	await fs.promises.mkdir(path.join(to, "pack"), { recursive: true });
 	// The index must only become visible after the pack it describes.
 	for (const name of packs.filter(name => name.endsWith(".pack"))) {
-		await fs.promises.cp(path.join(from, "pack", name), path.join(to, "pack", name), { force: false });
+		await publishGitObjectFile(path.join(from, "pack", name), path.join(to, "pack", name));
 	}
 	for (const name of packs.filter(name => /\.(?:idx|rev|keep|promisor|mtimes)$/.test(name))) {
-		await fs.promises.cp(path.join(from, "pack", name), path.join(to, "pack", name), { force: false });
+		await publishGitObjectFile(path.join(from, "pack", name), path.join(to, "pack", name));
 	}
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@oh-my-pi/pi-natives",
-	"version": "18.11.0",
+	"version": "18.11.2",
 	"description": "Native Rust bindings for PDF conversion, audio, WebRTC, grep, clipboard, image processing, syntax highlighting, PTY, and shell operations via N-API",
 	"type": "module",
 	"homepage": "https://omp.sh",
@@ -113,11 +113,11 @@
 		}
 	},
 	"optionalDependencies": {
-		"@oh-my-pi/pi-natives-linux-x64": "18.11.0",
-		"@oh-my-pi/pi-natives-linux-arm64": "18.11.0",
-		"@oh-my-pi/pi-natives-darwin-x64": "18.11.0",
-		"@oh-my-pi/pi-natives-darwin-arm64": "18.11.0",
-		"@oh-my-pi/pi-natives-win32-x64": "18.11.0",
-		"@oh-my-pi/pi-natives-win32-arm64": "18.11.0"
+		"@oh-my-pi/pi-natives-linux-x64": "18.11.2",
+		"@oh-my-pi/pi-natives-linux-arm64": "18.11.2",
+		"@oh-my-pi/pi-natives-darwin-x64": "18.11.2",
+		"@oh-my-pi/pi-natives-darwin-arm64": "18.11.2",
+		"@oh-my-pi/pi-natives-win32-x64": "18.11.2",
+		"@oh-my-pi/pi-natives-win32-arm64": "18.11.2"
 	}
 }