@oh-my-pi/pi-natives 18.15.0 → 18.17.0

package/THIRD-PARTY-NOTICES.txt

@@ -9,56 +9,6 @@ governs only the material it names.
 VENDORED SOURCE AND DATA
 ========================
 
--------------------------------------------------------------------------------
-brush-core 0.5.0 — crates/vendor/brush-core
-
-This directory contains a vendored, locally-patched copy of brush-core from the
-brush shell project (https://github.com/reubeno/brush), used under the MIT
-License. It is wired into the workspace via `[patch.crates-io]` so these
-modifications can be maintained against the published release (brush-core
-0.5.0).
-
-  Copyright (c) 2024 reuben olinsky
-
-Local modifications include: Windows path handling fixes (drive-alias and
-rooted-path normalization in globs), an async background-PID fix for the nohup
-wrapper, treating `/dev/null` as poll-ready to avoid an infinite poll on macOS,
-and indentation/formatting standardization. The remaining logic tracks upstream
-so behavior matches the published crate.
-
-MIT License
-
-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.
-
--------------------------------------------------------------------------------
-brush-builtins — crates/pi-builtins
-
-The POSIX/bash builtins began as a locally-patched copy of brush-builtins from
-the brush shell project (https://github.com/reubeno/brush), used under the MIT
-License; the full license text is reproduced with brush-core above.
-
-  Copyright (c) 2024 reuben olinsky
-
-Local modifications include: implementing previously-stubbed builtins, the
-`wait` builtin (PID targeting plus the `-f`/`-n`/`-p` flags), and cancellation
-support for the `read` builtin via poll.
-
 -------------------------------------------------------------------------------
 Command-line utilities — crates/pi-builtins
 
@@ -11855,35 +11805,6 @@ 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.
 
--------------------------------------------------------------------------------
-License: MIT License (MIT)
-Used by:
-- brush-parser 0.4.0 (https://github.com/reubeno/brush)
-
-Full license text:
-
-MIT License
-
-Copyright (c) 2024 reuben olinsky
-
-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.
-
 -------------------------------------------------------------------------------
 License: MIT License (MIT)
 Used by:
@@ -12098,7 +12019,6 @@ SOFTWARE.
 -------------------------------------------------------------------------------
 License: MIT License (MIT)
 Used by:
-- brush-core 0.5.0 (https://github.com/reubeno/brush)
 - napi 3.14.2 (https://github.com/napi-rs/napi-rs)
 - asn1-rs-impl 0.2.0 (https://github.com/rusticata/asn1-rs.git)
 - ast-grep-core 0.39.9 (https://github.com/ast-grep/ast-grep)

package/native/index.d.ts

@@ -87,8 +87,8 @@ export declare class DesktopSession {
   retire(): void
   /**
    * Sets when the current run ends, `remaining_ms` from now; each run sets
-   * it before its first call. On macOS, input waiting for the user to pause
-   * in its app gives up shortly before it.
+   * it before its first call. Input waiting for the user to pause in its app
+   * (macOS) or for a Wayland permission prompt gives up shortly before it.
    */
   setRunDeadline(remainingMs: number): void
   capture(target: string, caps?: CaptureCaps | undefined | null): Promise<DesktopCapture>
@@ -428,6 +428,24 @@ export declare class MacAppearanceObserver {
   stop(): void
 }
 
+/** The app the user had in front when `macOSFrontApp()` read it. */
+export declare class MacOSFrontApp {
+  /**
+   * Puts this app back in front, without raising its windows, each time the
+   * app that took the front from it takes it again during the next
+   * `durationMs`. Ends early once a hardware mouse button or ⌘/⌃ is used
+   * after the app was read, the app came from a launcher or Spotlight panel,
+   * or a different app comes forward: that is the user picking an app.
+   * Typing does not end it, and a hand-back macOS refuses for a key typed
+   * meanwhile is asked again. Holds nothing when called over a second after
+   * the latest read, as picks made since then went unwatched. Owns desktop
+   * input/focus control only for each hand-back, and rejects if another
+   * operation owns it then. Resolves how many times it put the app back.
+   */
+  keepInFront(durationMs: number): Promise<number>
+}
+export type MacosFrontApp = MacOSFrontApp
+
 /** A transactional, process-owned native OAuth callback receiver. */
 export declare class NativeOAuthCallback {
   /** Create a receiver without touching the filesystem or OS registration. */
@@ -549,7 +567,46 @@ export declare class PtySession {
   kill(): void
 }
 
-/** Persistent brush-core shell session. */
+/**
+ * Actual command state, source units and bounded history for one shell run,
+ * including observed assignments and producer-attributed output.
+ *
+ * Create one over the command text and
+ * pass it as [`ShellRunOptions::trace`]; poll [`RunTrace::version`] while the
+ * run is in flight and take [`RunTrace::snapshot`] when it changed.
+ */
+export declare class RunTrace {
+  /** A trace of `script`, the exact command text about to run. */
+  constructor(script: string)
+  /**
+   * Revision of semantic events, assignments and visible output; unchanged
+   * means `snapshot()` is unchanged, even when adjacent output coalesces.
+   */
+  version(): number
+  /**
+   * The `ShellTrace` JSON with byte-offset layout, current node states and
+   * ordered replay `history`. The newest 20,000 records retain at most
+   * 2 MiB visible output and 8 MiB payload; `historyTruncated` explicitly
+   * reports eviction. History timestamps are measured ns since `RunStart`;
+   * output identifies its real producer (`u`, `n`, `command`) when known.
+   * Semantic entries carry their actual `vpid`; `rootVpid` distinguishes
+   * root lifecycle from owned tool children even after journal trimming.
+   * A UTF-8 scalar spanning producers has exact byte `contributors`
+   * instead of an invented primary producer. Decoding ends at capture EOF.
+   * Segmented minimizer submissions share one epoch and final status;
+   * their history carries `segment`, with `logicalEnd`/`logicalStatus`
+   * finalizing the last actual root RunEnd after output draining.
+   * Serialization borrows the locked model rather than cloning its history.
+   */
+  snapshot(): string
+  /**
+   * Render directly over the borrowed native state; no snapshot or syntax
+   * roundtrip.
+   */
+  present(options: ShellVizOptions): string
+}
+
+/** Persistent embedded bash engine (pi-shell) shell session. */
 export declare class Shell {
   /**
    * Create a new shell session from optional configuration.
@@ -589,6 +646,15 @@ export declare class Shell {
   pids(): Array<number>
 }
 
+/**
+ * Persisted native visualization, restored once rather than reparsed on each
+ * frame.
+ */
+export declare class ShellVisualization {
+  constructor(snapshot: string)
+  present(options: ShellVizOptions): string
+}
+
 /** One word-completion engine running on its own thread. */
 export declare class TextPredictor {
   /**
@@ -1424,10 +1490,8 @@ export declare function countTokens(input: string | string[], encoding?: Encodin
 /**
  * Decode one complete SIXEL control string into a PNG on the calling thread.
  *
- * The decoder is deliberately bounded before handing the stream to
- * `icy_sixel`: raster declarations, repeats, and row advances are scanned
- * first so hostile dimensions cannot make the dependency allocate its much
- * larger internal maximum.
+ * Raster declarations, repeats, and row advances are bounded before allocating
+ * the decoded RGBA buffer.
  */
 export declare function decodeSixelToPng(bytes: Uint8Array): Uint8Array
 
@@ -2017,7 +2081,7 @@ export declare enum Encoding {
 export declare function execReplace(argv: Array<string>): void
 
 /**
- * Execute a brush shell command.
+ * Execute a command in the embedded bash engine (pi-shell).
  *
  * Creates a fresh session for each call. The `on_chunk` callback receives
  * streamed stdout/stderr output. Returns the exit code when the command
@@ -2377,6 +2441,25 @@ export declare function hashlineStripPrefixes(lines: Array<string>): Array<strin
  */
 export declare function hasMatch(content: string | Uint8Array, pattern: string | Uint8Array, ignoreCase?: boolean | undefined | null, multiline?: boolean | undefined | null): boolean
 
+/**
+ * How `path` is held by this process: open through another descriptor and
+ * locked. `null` when it is not, and always outside Linux.
+ *
+ * Looks at the path's inode through the descriptors already open, without
+ * opening the file.
+ */
+export declare function heldFileKind(path: string): HeldFileKind | null
+
+/** What a file this process holds locked is. */
+export declare enum HeldFileKind {
+  /** A SQLite database this process has open with its locks. */
+  Database = 'database',
+  /** A SQLite WAL-index (`-shm`) file this process has open with its locks. */
+  WalIndex = 'wal-index',
+  /** Another file this process holds open with a record lock. */
+  Locked = 'locked'
+}
+
 /**
  * Highlight code and return ANSI-colored lines.
  *
@@ -2467,6 +2550,15 @@ export interface InlineSloppyRegion {
   payload: string
 }
 
+/**
+ * Moves this process's SQLite record locks onto open-file-description locks.
+ *
+ * No other close of the file can release those (see `ofd_locks.rs`). Call it
+ * before the process opens any SQLite database. Returns whether SQLite now
+ * uses them: `false` outside Linux, or when Bun's SQLite is not found.
+ */
+export declare function installSqliteLockShim(): boolean
+
 /** Options for `IpcConnection.connect`. */
 export interface IpcConnectOptions {
   /**
@@ -2739,6 +2831,12 @@ export declare function macOSAutocorrectWord(text: string, start: number, length
  */
 export declare function macOSCheckSpelling(text: string): Promise<Array<SpellingRange>>
 
+/**
+ * The app macOS `WindowServer` has in front. `null` off macOS and when the
+ * front-process SPI is unavailable.
+ */
+export declare function macOSFrontApp(): MacOSFrontApp | null
+
 /** Whether the host can use Apple's native spelling service. */
 export declare function macOSSpellCheckerAvailable(): boolean
 
@@ -3312,6 +3410,19 @@ export declare function renderMermaidAscii(text: string, options?: MermaidRender
  */
 export declare function renderSnapcompactPng(text: string, options: SnapcompactRenderOptions): Promise<string>
 
+/**
+ * Run the pi-shell engine as a process shell in this process (`omp zsh`,
+ * `omp bash`, `omp sh`): `argv` is the shell's whole command line,
+ * `argv[0]` naming it (`zsh`, `bash` or `sh` pick the dialect), as a real
+ * shell gets it. Synchronous: blocks the calling thread until the shell
+ * exits and returns the status the process should exit with (0–255; 101
+ * after a panic). The shell uses the process's own stdin, stdout, stderr,
+ * terminal and inherited descriptors (duplicated, never taken over); the
+ * job-control and termination signals the runtime handles are reset to
+ * their defaults for the run and restored after it.
+ */
+export declare function runShellMain(argv: Array<string>): number
+
 /**
  * Search content for a pattern (one-shot, compiles pattern each time).
  * For repeated searches with the same pattern, use [`grep`] with file filters.
@@ -3363,7 +3474,10 @@ export interface SearchResult {
 
 export declare function setHangulCompatJamoWidthOverride(value: number): void
 
-/** Options for executing a shell command via brush-core. */
+/**
+ * Options for executing a shell command via the embedded bash engine
+ * (pi-shell).
+ */
 export interface ShellExecuteOptions {
   /** Command string to execute in the shell. */
   command: string
@@ -3733,6 +3847,8 @@ export interface ShellRunOptions {
   filesystem?: ShellFilesystem
   /** Receives a copy of every byte crossing the run's pipeline pipes. */
   streams?: PipeStreams
+  /** Folds the run's engine events into a live model of the command. */
+  trace?: RunTrace
 }
 
 /** Result of running a shell command. */
@@ -3754,6 +3870,28 @@ export interface ShellRunResult {
   workingDir?: string
 }
 
+/** Native non-executing visualization transformations. */
+export interface ShellVizLayers {
+  color: boolean
+  inline: boolean
+  idioms: boolean
+  effects: boolean
+  unwrap: boolean
+}
+
+/** Native presentation controls. Node identities are opaque engine keys. */
+export interface ShellVizOptions {
+  view: 'raw' | 'pseudo'
+  layers: ShellVizLayers
+  split: boolean
+  cursor?: number
+  cursorSeq?: number
+  playing: boolean
+  speed: number
+  selectedNode?: string
+  expandedNodes: Array<string>
+}
+
 /**
  * Visible slice of a line after ANSI-aware column selection
  * (`sliceWithWidth`).

package/native/index.js

@@ -36,12 +36,15 @@ export const IpcServer = nativeBindings.IpcServer;
 export const LineMatcher = nativeBindings.LineMatcher;
 export const LiveWebRtcPeer = nativeBindings.LiveWebRtcPeer;
 export const MacAppearanceObserver = nativeBindings.MacAppearanceObserver;
+export const MacOSFrontApp = nativeBindings.MacOSFrontApp;
 export const NativeOAuthCallback = nativeBindings.NativeOAuthCallback;
 export const PipeStreams = nativeBindings.PipeStreams;
 export const PowerAssertion = nativeBindings.PowerAssertion;
 export const Process = nativeBindings.Process;
 export const PtySession = nativeBindings.PtySession;
+export const RunTrace = nativeBindings.RunTrace;
 export const Shell = nativeBindings.Shell;
+export const ShellVisualization = nativeBindings.ShellVisualization;
 export const TextPredictor = nativeBindings.TextPredictor;
 export const TtyWriter = nativeBindings.TtyWriter;
 export const VcsGitRepo = nativeBindings.VcsGitRepo;
@@ -100,8 +103,10 @@ export const hashlineFormatNumberedLines = nativeBindings.hashlineFormatNumbered
 export const hashlineIsReadTruncationNotice = nativeBindings.hashlineIsReadTruncationNotice ?? missingNativeExport("hashlineIsReadTruncationNotice");
 export const hashlineStripPrefixes = nativeBindings.hashlineStripPrefixes ?? missingNativeExport("hashlineStripPrefixes");
 export const hasMatch = nativeBindings.hasMatch ?? missingNativeExport("hasMatch");
+export const heldFileKind = nativeBindings.heldFileKind ?? missingNativeExport("heldFileKind");
 export const highlightCode = nativeBindings.highlightCode ?? missingNativeExport("highlightCode");
 export const htmlToMarkdown = nativeBindings.htmlToMarkdown ?? missingNativeExport("htmlToMarkdown");
+export const installSqliteLockShim = nativeBindings.installSqliteLockShim ?? missingNativeExport("installSqliteLockShim");
 export const ipcEndpoint = nativeBindings.ipcEndpoint ?? missingNativeExport("ipcEndpoint");
 export const isoBackend = nativeBindings.isoBackend ?? missingNativeExport("isoBackend");
 export const isoDiff = nativeBindings.isoDiff ?? missingNativeExport("isoDiff");
@@ -113,6 +118,7 @@ export const isoStop = nativeBindings.isoStop ?? missingNativeExport("isoStop");
 export const listWorkspace = nativeBindings.listWorkspace ?? missingNativeExport("listWorkspace");
 export const macOSAutocorrectWord = nativeBindings.macOSAutocorrectWord ?? missingNativeExport("macOSAutocorrectWord");
 export const macOSCheckSpelling = nativeBindings.macOSCheckSpelling ?? missingNativeExport("macOSCheckSpelling");
+export const macOSFrontApp = nativeBindings.macOSFrontApp ?? missingNativeExport("macOSFrontApp");
 export const macOSSpellCheckerAvailable = nativeBindings.macOSSpellCheckerAvailable ?? missingNativeExport("macOSSpellCheckerAvailable");
 export const macOSSpellingGuesses = nativeBindings.macOSSpellingGuesses ?? missingNativeExport("macOSSpellingGuesses");
 export const matchesKey = nativeBindings.matchesKey ?? missingNativeExport("matchesKey");
@@ -131,6 +137,7 @@ export const readImageFromClipboard = nativeBindings.readImageFromClipboard ?? m
 export const readTextFromClipboard = nativeBindings.readTextFromClipboard ?? missingNativeExport("readTextFromClipboard");
 export const renderMermaidAscii = nativeBindings.renderMermaidAscii ?? missingNativeExport("renderMermaidAscii");
 export const renderSnapcompactPng = nativeBindings.renderSnapcompactPng ?? missingNativeExport("renderSnapcompactPng");
+export const runShellMain = nativeBindings.runShellMain ?? missingNativeExport("runShellMain");
 export const search = nativeBindings.search ?? missingNativeExport("search");
 export const setHangulCompatJamoWidthOverride = nativeBindings.setHangulCompatJamoWidthOverride ?? missingNativeExport("setHangulCompatJamoWidthOverride");
 export const sliceWithWidth = nativeBindings.sliceWithWidth ?? missingNativeExport("sliceWithWidth");
@@ -198,6 +205,11 @@ export const GrepOutputMode = {
 	Count: "count",
 	FilesWithMatches: "filesWithMatches",
 };
+export const HeldFileKind = {
+	Database: "database",
+	WalIndex: "wal-index",
+	Locked: "locked",
+};
 export const IsoBackendKind = {
 	Apfs: 0,
 	Btrfs: 1,

package/native/sqlite-locks.d.ts

@@ -0,0 +1,12 @@
+import type { HeldFileKind } from "./index.js";
+
+/**
+ * Lazily loading forms of the SQLite lock exports in `index.d.ts`: the addon
+ * loads on the first call instead of at import.
+ */
+
+/** Moves this process's SQLite record locks onto open-file-description locks; `false` when unavailable. */
+export declare function installSqliteLockShim(): boolean;
+
+/** How `path` is held by this process (open elsewhere and locked), or `null`. */
+export declare function heldFileKind(path: string): HeldFileKind | null;

package/native/sqlite-locks.js

@@ -0,0 +1,26 @@
+import { loadNative } from "./loader-state.js";
+
+let bindings;
+
+/**
+ * Load the addon on first use, so importing this module (pi-utils' SQLite
+ * helpers) costs nothing in processes that never open a database. An addon
+ * built before these exports existed (a stale local build, or PR CI, which
+ * tests against main's newest addon) yields `undefined`: the store still opens,
+ * unprotected, and `ensureSqliteLockShim` reports it.
+ */
+function native(symbolName) {
+	bindings ??= loadNative();
+	const value = bindings[symbolName];
+	return typeof value === "function" ? value : undefined;
+}
+
+/** See `installSqliteLockShim` in `index.d.ts`; `false` from an addon predating it. */
+export function installSqliteLockShim() {
+	return native("installSqliteLockShim")?.() ?? false;
+}
+
+/** See `heldFileKind` in `index.d.ts`; `null` from an addon predating it. */
+export function heldFileKind(path) {
+	return native("heldFileKind")?.(path) ?? null;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@oh-my-pi/pi-natives",
-	"version": "18.15.0",
+	"version": "18.17.0",
 	"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",
@@ -35,7 +35,7 @@
 		"build": "bun ../../scripts/bazel-natives.ts host --dest native",
 		"build:bindings": "bun scripts/build-bindings.ts",
 		"check": "oxlint . && oxfmt --check --no-error-on-unmatched-pattern 'src/**/*.{ts,tsx}' '{test,bench,examples,scripts}/**/*.ts' '*.ts' && bun run check:types",
-		"check:types": "tsgo -p tsconfig.json --noEmit",
+		"check:types": "bun check --no-script -p tsconfig.json",
 		"lint": "oxlint .",
 		"test": "bun test --parallel",
 		"fix": "oxlint --fix --fix-suggestions . && bun run fmt",
@@ -49,7 +49,6 @@
 		"@napi-rs/cli": "3.7.2",
 		"@types/bun": "^1.3.14",
 		"cli-truncate": "6.1.1",
-		"diff": "9.0.0",
 		"gpt-tokenizer": "4.0.0",
 		"mitata": "1.0.34",
 		"slice-ansi": "9.0.0",
@@ -78,6 +77,8 @@
 		"native/loader-state.d.ts",
 		"native/path.js",
 		"native/path.d.ts",
+		"native/sqlite-locks.js",
+		"native/sqlite-locks.d.ts",
 		"native/vcs.js",
 		"native/vcs.d.ts",
 		"native/embedded-addon.js",
@@ -111,14 +112,19 @@
 			"types": "./native/vcs.d.ts",
 			"import": "./native/vcs.js",
 			"default": "./native/vcs.js"
+		},
+		"./sqlite-locks": {
+			"types": "./native/sqlite-locks.d.ts",
+			"import": "./native/sqlite-locks.js",
+			"default": "./native/sqlite-locks.js"
 		}
 	},
 	"optionalDependencies": {
-		"@oh-my-pi/pi-natives-linux-x64": "18.15.0",
-		"@oh-my-pi/pi-natives-linux-arm64": "18.15.0",
-		"@oh-my-pi/pi-natives-darwin-x64": "18.15.0",
-		"@oh-my-pi/pi-natives-darwin-arm64": "18.15.0",
-		"@oh-my-pi/pi-natives-win32-x64": "18.15.0",
-		"@oh-my-pi/pi-natives-win32-arm64": "18.15.0"
+		"@oh-my-pi/pi-natives-linux-x64": "18.17.0",
+		"@oh-my-pi/pi-natives-linux-arm64": "18.17.0",
+		"@oh-my-pi/pi-natives-darwin-x64": "18.17.0",
+		"@oh-my-pi/pi-natives-darwin-arm64": "18.17.0",
+		"@oh-my-pi/pi-natives-win32-x64": "18.17.0",
+		"@oh-my-pi/pi-natives-win32-arm64": "18.17.0"
 	}
 }