stelo 1.0.1

package/index.d.ts

@@ -0,0 +1,840 @@
+/* tslint:disable */
+/* eslint-disable */
+
+/* auto-generated by NAPI-RS */
+
+/**
+ * Force the process into Per-Monitor DPI Aware V2 mode.
+ * Call this ONCE at startup, before any screen/mouse operations.
+ * After this call, ALL coordinates and captures use the true native
+ * screen resolution (e.g., 2560×1440) — no DPI virtualization.
+ *
+ * Safe to call multiple times (idempotent). Also called automatically
+ * by screen and mouse functions as a safety net.
+ */
+export declare function ensureDpiAwareness(): void
+export interface NativeMousePosition {
+  x: number
+  y: number
+}
+export interface NativeClickObservation {
+  x: number
+  y: number
+  didChange: boolean
+  changeScore: number
+  beforeHash: string
+  afterHash: string
+}
+export interface NativeScreenSize {
+  width: number
+  height: number
+}
+export interface NativePixelColor {
+  r: number
+  g: number
+  b: number
+  hex: string
+}
+export interface NativeDisplayInfo {
+  id: number
+  x: number
+  y: number
+  width: number
+  height: number
+  isPrimary: boolean
+  scaleFactor: number
+  name: string
+}
+export interface NativeWindowInfo {
+  /** Window handle (as float64 since JS doesn't support u64 natively) */
+  id: number
+  title: string
+  x: number
+  y: number
+  width: number
+  height: number
+  isVisible: boolean
+  isMinimized: boolean
+  processId: number
+  processName: string
+  processPath: string
+}
+export interface NativeScreenCapture {
+  data: Buffer
+  width: number
+  height: number
+}
+/** Move mouse cursor instantly to absolute screen coordinates. */
+export declare function mouseMove(x: number, y: number): void
+/** Get current mouse cursor position. */
+export declare function mouseGetPosition(): NativeMousePosition
+/** Move mouse smoothly to target with configurable curve and duration. */
+export declare function mouseMoveSmooth(x: number, y: number, durationMs?: number | undefined | null, curve?: string | undefined | null, stepsPerSecond?: number | undefined | null): void
+/** Move mouse with humanized, natural-feeling motion. */
+export declare function mouseMoveHumanized(x: number, y: number, durationMs?: number | undefined | null, jitter?: number | undefined | null, overshoot?: boolean | undefined | null): void
+/** Click a mouse button. button: "left" | "right" | "middle" */
+export declare function mouseClick(button?: string | undefined | null): void
+/** Double-click a mouse button. */
+export declare function mouseDoubleClick(button?: string | undefined | null): void
+/** Triple-click a mouse button (select line/paragraph). */
+export declare function mouseTripleClick(button?: string | undefined | null): void
+/** Press (hold down) a mouse button. */
+export declare function mouseDown(button?: string | undefined | null): void
+/** Release a mouse button. */
+export declare function mouseUp(button?: string | undefined | null): void
+/** Scroll the mouse wheel. direction: "up" | "down" | "left" | "right" */
+export declare function mouseScroll(amount: number, direction?: string | undefined | null): void
+/** Scroll the mouse wheel smoothly over time. direction: "up" | "down" | "left" | "right" */
+export declare function mouseScrollSmooth(amount: number, direction?: string | undefined | null, durationMs?: number | undefined | null): void
+/** Drag from one point to another. */
+export declare function mouseDrag(fromX: number, fromY: number, toX: number, toY: number, button?: string | undefined | null, durationMs?: number | undefined | null): void
+/** Click at a specific position, optionally restoring the original position. */
+export declare function mouseClickAt(x: number, y: number, button?: string | undefined | null, restorePosition?: boolean | undefined | null): void
+/**
+ * Click at a position and immediately capture before/after visual state in a local region.
+ * This is optimized for fast action feedback loops so agents can avoid blind click chains.
+ */
+export declare function mouseClickObserved(x: number, y: number, button?: string | undefined | null, settleMs?: number | undefined | null, restorePosition?: boolean | undefined | null): NativeClickObservation
+/** Type a text string character by character. */
+export declare function keyboardType(text: string, delayMs?: number | undefined | null): void
+/** Type text with randomized human-like delays. */
+export declare function keyboardTypeHumanized(text: string, minDelayMs?: number | undefined | null, maxDelayMs?: number | undefined | null): void
+/** Press and release a single key. */
+export declare function keyboardPress(key: string): void
+/** Hold a key down. */
+export declare function keyboardDown(key: string): void
+/** Release a key. */
+export declare function keyboardUp(key: string): void
+/** Execute a keyboard shortcut (e.g., ["ctrl", "c"] for copy). */
+export declare function keyboardHotkey(keys: Array<string>): void
+/** Press a key multiple times. */
+export declare function keyboardTap(key: string, count?: number | undefined | null, delayMs?: number | undefined | null): void
+/** Check if a key is currently held down. */
+export declare function keyboardIsPressed(key: string): boolean
+/** Get a list of all recognized key names. */
+export declare function keyboardAllKeys(): Array<string>
+/**
+ * Type an entire string in a single atomic operation (10-100x faster).
+ * All characters are batched in one SendInput call — no inter-character delay.
+ */
+export declare function keyboardTypeBatch(text: string): void
+/** Execute a hotkey from a string like "ctrl+shift+s". */
+export declare function keyboardHotkeyString(combo: string): void
+/**
+ * Execute a sequence of keyboard actions separated by '|'.
+ * Each action can be: a hotkey ("ctrl+c"), a key ("enter"), or text ("type:hello").
+ * Example: "ctrl+a | ctrl+c | alt+tab | ctrl+v"
+ */
+export declare function keyboardSequence(sequence: string, delayBetweenMs?: number | undefined | null): void
+/**
+ * Type text while holding modifier keys.
+ * Example: typeWithModifiers("hello", ["shift"]) → types "HELLO"
+ */
+export declare function keyboardTypeWithModifiers(text: string, modifiers: Array<string>): void
+/** Check if a toggle key (CapsLock, NumLock, ScrollLock) is currently ON. */
+export declare function keyboardIsToggled(key: string): boolean
+/** Toggle a lock key (CapsLock, NumLock, ScrollLock). */
+export declare function keyboardToggleKey(key: string): void
+/**
+ * Check if multiple keys are all currently pressed.
+ * Returns an array of booleans matching the input keys.
+ */
+export declare function keyboardArePressed(keys: Array<string>): Array<boolean>
+/**
+ * Wait until a specific key is pressed (blocking).
+ * Returns true if pressed, false if timed out.
+ */
+export declare function keyboardWaitForKey(key: string, timeoutMs?: number | undefined | null): boolean
+/**
+ * Wait until a specific key is released (blocking).
+ * Returns true if released, false if timed out.
+ */
+export declare function keyboardWaitForKeyRelease(key: string, timeoutMs?: number | undefined | null): boolean
+/**
+ * Get primary screen dimensions.
+ * Returns the TRUE native resolution (DPI awareness is forced automatically).
+ */
+export declare function screenSize(): NativeScreenSize
+/** Get the color of a pixel at screen coordinates. */
+export declare function screenPixelColor(x: number, y: number): NativePixelColor
+/**
+ * Capture a screen region as raw RGBA pixel data.
+ * Captures at TRUE native resolution (DPI awareness is forced automatically).
+ */
+export declare function screenCapture(x?: number | undefined | null, y?: number | undefined | null, width?: number | undefined | null, height?: number | undefined | null): NativeScreenCapture
+/**
+ * Capture a screen region as raw BGRA pixel data (faster, no color conversion).
+ * BGRA is the native capture format — skipping the BGRA→RGBA conversion
+ * saves CPU time, ideal for real-time pipelines (vision models, streaming).
+ * Captures at TRUE native resolution (DPI awareness is forced automatically).
+ */
+export declare function screenCaptureBgra(x?: number | undefined | null, y?: number | undefined | null, width?: number | undefined | null, height?: number | undefined | null): NativeScreenCapture
+/**
+ * Get info about all connected displays.
+ * Returns TRUE native resolution and positions (DPI awareness is forced automatically).
+ */
+export declare function screenDisplays(): Array<NativeDisplayInfo>
+/** Search for a pixel color in a screen region. */
+export declare function screenFindColor(r: number, g: number, b: number, tolerance?: number | undefined | null, regionX?: number | undefined | null, regionY?: number | undefined | null, regionWidth?: number | undefined | null, regionHeight?: number | undefined | null): NativeMousePosition | null
+/** Get the currently active/focused window. */
+export declare function windowGetActive(): NativeWindowInfo
+/** Get all visible windows. */
+export declare function windowGetAll(): Array<NativeWindowInfo>
+/** Find windows by title substring. */
+export declare function windowFind(title: string): Array<NativeWindowInfo>
+/** Focus a window by ID. */
+export declare function windowFocus(id: number): void
+/** Focus a window by title substring. */
+export declare function windowFocusByTitle(title: string): void
+/** Resize a window. */
+export declare function windowResize(id: number, width: number, height: number): void
+/** Move a window to coordinates. */
+export declare function windowMove(id: number, x: number, y: number): void
+/** Minimize a window. */
+export declare function windowMinimize(id: number): void
+/** Maximize a window. */
+export declare function windowMaximize(id: number): void
+/** Restore a window from minimized/maximized. */
+export declare function windowRestore(id: number): void
+/** Close a window. */
+export declare function windowClose(id: number): void
+/** Set window bounds by title. */
+export declare function windowSetBounds(title: string, x: number, y: number, width: number, height: number): void
+/** Enable failsafe — moving mouse to screen corner triggers emergency stop. */
+export declare function safetyEnableFailsafe(thresholdPx?: number | undefined | null): void
+/** Disable failsafe. */
+export declare function safetyDisableFailsafe(): void
+/** Check if failsafe is enabled. */
+export declare function safetyIsFailsafeEnabled(): boolean
+/** Enable rate limiting (max actions per second). */
+export declare function safetySetRateLimit(maxPerSecond: number): void
+/** Disable rate limiting. */
+export declare function safetyDisableRateLimit(): void
+/** Trigger emergency stop (all operations will fail until reset). */
+export declare function safetyEmergencyStop(): void
+/** Check if emergency stop is active. */
+export declare function safetyIsStopped(): boolean
+/** Reset emergency stop and allow operations to resume. */
+export declare function safetyReset(): void
+export interface NativeStreamConfig {
+  /** Target FPS (1–120, default: 30) */
+  fps?: number
+  /** Capture region (None = full screen) */
+  regionX?: number
+  regionY?: number
+  regionWidth?: number
+  regionHeight?: number
+  /** Scale factor (0.1–1.0, default: 1.0). Use 0.5 for half res, etc. */
+  scale?: number
+  /** Max frames to buffer (default: 3) */
+  bufferSize?: number
+  /** If true, return raw BGRA data (faster, no color conversion) */
+  rawBgra?: boolean
+}
+export interface NativeStreamFrame {
+  /** Raw RGBA pixel data */
+  data: Buffer
+  /** Frame width */
+  width: number
+  /** Frame height */
+  height: number
+  /** Monotonic frame sequence number */
+  sequence: number
+  /** Milliseconds since stream started */
+  timestampMs: number
+  /** Current measured FPS */
+  measuredFps: number
+  /** Cursor X at time of capture */
+  cursorX: number
+  /** Cursor Y at time of capture */
+  cursorY: number
+}
+export interface NativeStreamStats {
+  isRunning: boolean
+  totalFrames: number
+  droppedFrames: number
+  currentFps: number
+  targetFps: number
+  uptimeMs: number
+}
+/** Start a continuous real-time screen stream. */
+export declare function streamStart(config?: NativeStreamConfig | undefined | null): void
+/** Stop the screen stream. */
+export declare function streamStop(): void
+/** Check if a stream is currently running. */
+export declare function streamIsRunning(): boolean
+/** Get the latest captured frame from the stream. */
+export declare function streamGetLatestFrame(): NativeStreamFrame | null
+/** Get the most recent N frames from the stream buffer. */
+export declare function streamGetRecentFrames(count?: number | undefined | null): Array<NativeStreamFrame>
+/** Wait for the next new frame (blocks until available or timeout). */
+export declare function streamWaitForFrame(timeoutMs?: number | undefined | null): NativeStreamFrame | null
+/** Get stream performance statistics. */
+export declare function streamGetStats(): NativeStreamStats
+export interface NativeAudioStreamConfig {
+  /** Max audio chunks to buffer (default: 30 ≈ 300ms) */
+  bufferSize?: number
+}
+export interface NativeAudioFormat {
+  /** Samples per second (e.g., 44100, 48000) */
+  sampleRate: number
+  /** Number of channels (e.g., 2 for stereo) */
+  channels: number
+  /** Bits per sample (typically 32 for float) */
+  bitsPerSample: number
+  /** Bytes per complete audio frame (channels * bits/8) */
+  blockAlign: number
+}
+export interface NativeAudioChunk {
+  /** Raw PCM audio data */
+  data: Buffer
+  /** Number of audio frames in this chunk */
+  frames: number
+  /** Sequence number */
+  sequence: number
+  /** Milliseconds since audio stream started */
+  timestampMs: number
+}
+export interface NativeAudioStreamStats {
+  isRunning: boolean
+  totalChunks: number
+  totalFrames: number
+  sampleRate: number
+  channels: number
+  bitsPerSample: number
+  uptimeMs: number
+}
+/**
+ * Start capturing system audio (loopback) via WASAPI.
+ * Captures all desktop audio (what you hear through speakers/headphones).
+ */
+export declare function audioStreamStart(config?: NativeAudioStreamConfig | undefined | null): void
+/** Stop the audio stream. */
+export declare function audioStreamStop(): void
+/** Check if audio stream is currently running. */
+export declare function audioStreamIsRunning(): boolean
+/** Get the audio format (sample rate, channels, bits per sample). */
+export declare function audioStreamGetFormat(): NativeAudioFormat | null
+/** Get the latest audio chunk. */
+export declare function audioStreamGetLatestChunk(): NativeAudioChunk | null
+/** Get recent audio chunks from the buffer. */
+export declare function audioStreamGetRecentChunks(count?: number | undefined | null): Array<NativeAudioChunk>
+/**
+ * Drain all buffered audio chunks (empties the buffer).
+ * Returns chunks in order, oldest first. Useful for writing to file.
+ */
+export declare function audioStreamDrainChunks(): Array<NativeAudioChunk>
+/** Get audio stream statistics. */
+export declare function audioStreamGetStats(): NativeAudioStreamStats
+export interface NativeMicStreamConfig {
+  /** Max mic audio chunks to buffer (default: 30 ≈ 300ms) */
+  bufferSize?: number
+}
+export interface NativeMicFormat {
+  sampleRate: number
+  channels: number
+  bitsPerSample: number
+  blockAlign: number
+}
+export interface NativeMicChunk {
+  data: Buffer
+  frames: number
+  sequence: number
+  timestampMs: number
+}
+export interface NativeMicStreamStats {
+  isRunning: boolean
+  totalChunks: number
+  totalFrames: number
+  sampleRate: number
+  channels: number
+  bitsPerSample: number
+  uptimeMs: number
+}
+/** Start capturing microphone audio via WASAPI. */
+export declare function micStreamStart(config?: NativeMicStreamConfig | undefined | null): void
+/** Stop the microphone stream. */
+export declare function micStreamStop(): void
+/** Check if mic stream is currently running. */
+export declare function micStreamIsRunning(): boolean
+/** Get the microphone audio format. */
+export declare function micStreamGetFormat(): NativeMicFormat | null
+/** Get the latest microphone audio chunk. */
+export declare function micStreamGetLatestChunk(): NativeMicChunk | null
+/** Get recent microphone audio chunks. */
+export declare function micStreamGetRecentChunks(count?: number | undefined | null): Array<NativeMicChunk>
+/** Drain all buffered microphone audio chunks. */
+export declare function micStreamDrainChunks(): Array<NativeMicChunk>
+/** Get microphone stream statistics. */
+export declare function micStreamGetStats(): NativeMicStreamStats
+export interface NativeSpeakerConfig {
+  /** Input sample rate of audio being fed (default: 24000 for Gemini) */
+  inputSampleRate?: number
+}
+export interface NativeSpeakerStats {
+  isRunning: boolean
+  outputSampleRate: number
+  outputChannels: number
+  outputBitsPerSample: number
+  queuedBytes: number
+}
+/**
+ * Start the speaker for audio playback.
+ * Accepts PCM16 mono audio via speaker_write() and plays through system speakers.
+ */
+export declare function speakerStart(config?: NativeSpeakerConfig | undefined | null): void
+/** Stop the speaker. */
+export declare function speakerStop(): void
+/** Check if speaker is currently running. */
+export declare function speakerIsRunning(): boolean
+/**
+ * Write PCM16 mono audio data for playback.
+ * Data should be 16-bit signed integers, little-endian, mono.
+ * The speaker will convert to the system's native format automatically.
+ */
+export declare function speakerWrite(data: Buffer): void
+/** Clear all queued audio (useful for handling interruptions). */
+export declare function speakerClear(): void
+/** Get speaker statistics. */
+export declare function speakerGetStats(): NativeSpeakerStats
+export interface NativeScreenDiff {
+  /** Percentage of pixels that changed (0.0 - 100.0) */
+  changePercentage: number
+  /** Total number of changed pixels */
+  changedPixelCount: number
+  /** Total pixels compared */
+  totalPixelCount: number
+  /** Bounding box of changed region (if any) */
+  changedX?: number
+  changedY?: number
+  changedWidth?: number
+  changedHeight?: number
+  /** Average color difference */
+  averageDiff: number
+  /** Maximum single-pixel difference */
+  maxDiff: number
+  /** True if any change was detected */
+  hasChanges: boolean
+}
+export interface NativeGridCell {
+  gridX: number
+  gridY: number
+  screenX: number
+  screenY: number
+  width: number
+  height: number
+  avgR: number
+  avgG: number
+  avgB: number
+  variance: number
+  likelyText: boolean
+  likelyUi: boolean
+}
+export interface NativeGridAnalysis {
+  cols: number
+  rows: number
+  cellWidth: number
+  cellHeight: number
+  cells: Array<NativeGridCell>
+  activeCellsX: Array<number>
+  activeCellsY: Array<number>
+}
+export interface NativeVerifyResult {
+  verified: boolean
+  changePercentage: number
+  durationMs: number
+}
+/**
+ * Compare two screen regions and return diff statistics.
+ * Pass the reference Buffer from a previous screen_capture call.
+ */
+export declare function visionDiff(referenceData: Buffer, referenceWidth: number, referenceHeight: number, regionX?: number | undefined | null, regionY?: number | undefined | null, regionWidth?: number | undefined | null, regionHeight?: number | undefined | null, tolerance?: number | undefined | null, sampleRate?: number | undefined | null): NativeScreenDiff
+/**
+ * Analyze screen as a grid for efficient region selection.
+ * Returns cell statistics useful for vision model guidance.
+ */
+export declare function visionAnalyzeGrid(cols: number, rows: number, regionX?: number | undefined | null, regionY?: number | undefined | null, regionWidth?: number | undefined | null, regionHeight?: number | undefined | null): NativeGridAnalysis
+/**
+ * Wait until screen changes beyond a threshold.
+ * Returns true if change detected, false if timed out.
+ */
+export declare function visionWaitForChange(thresholdPercent: number, timeoutMs: number, pollIntervalMs?: number | undefined | null, regionX?: number | undefined | null, regionY?: number | undefined | null, regionWidth?: number | undefined | null, regionHeight?: number | undefined | null): boolean
+/**
+ * Wait until screen stabilizes (stops changing).
+ * Useful after triggering actions to wait for animations to complete.
+ */
+export declare function visionWaitForStable(stabilityThreshold: number, stableDurationMs: number, timeoutMs: number, pollIntervalMs?: number | undefined | null, regionX?: number | undefined | null, regionY?: number | undefined | null, regionWidth?: number | undefined | null, regionHeight?: number | undefined | null): boolean
+/**
+ * Compute a perceptual hash of a screen region.
+ * Similar screens have hashes with low Hamming distance.
+ */
+export declare function visionPerceptualHash(regionX?: number | undefined | null, regionY?: number | undefined | null, regionWidth?: number | undefined | null, regionHeight?: number | undefined | null): number
+/**
+ * Compute Hamming distance between two perceptual hashes.
+ * Lower = more similar. 0 = identical.
+ */
+export declare function visionHashDistance(hash1: number, hash2: number): number
+/** Find all pixels matching a color within a region. */
+export declare function visionFindAllColors(r: number, g: number, b: number, tolerance: number, maxResults?: number | undefined | null, regionX?: number | undefined | null, regionY?: number | undefined | null, regionWidth?: number | undefined | null, regionHeight?: number | undefined | null): Array<NativeMousePosition>
+/** Find clusters of similar colors (potential UI elements like buttons). */
+export declare function visionFindColorClusters(r: number, g: number, b: number, tolerance: number, minClusterSize: number, regionX?: number | undefined | null, regionY?: number | undefined | null, regionWidth?: number | undefined | null, regionHeight?: number | undefined | null): Array<NativeRect>
+export interface NativeRect {
+  x: number
+  y: number
+  width: number
+  height: number
+}
+export interface NativeActionResult {
+  index: number
+  success: boolean
+  error?: string
+  durationMs: number
+  mouseX?: number
+  mouseY?: number
+  changeDetected?: boolean
+}
+export interface NativeBatchResult {
+  results: Array<NativeActionResult>
+  totalDurationMs: number
+  successCount: number
+  failureCount: number
+  firstFailureIndex: number
+  allSucceeded: boolean
+}
+export interface NativeClickVerifyResult {
+  verified: boolean
+  changePercentage: number
+  durationMs: number
+}
+/**
+ * Execute a batch of actions atomically.
+ * Actions format: Array of { type: string, ...params }
+ * Supported types: mouseMove, mouseMoveRel, mouseClick, mouseClickAt,
+ * mouseDoubleClick, mouseDown, mouseUp, mouseScroll, mouseDrag,
+ * type, typeHumanized, keyPress, keyDown, keyUp, hotkey, delay,
+ * waitForChange, waitForStable
+ */
+export declare function agentExecuteBatch(actions: Array<any>, stopOnError?: boolean | undefined | null): NativeBatchResult
+/**
+ * Click at position and verify visual change occurred.
+ * Essential for agents to confirm their click had an effect.
+ */
+export declare function agentClickAndVerify(x: number, y: number, button?: string | undefined | null, minChangePercent?: number | undefined | null, timeoutMs?: number | undefined | null, regionX?: number | undefined | null, regionY?: number | undefined | null, regionWidth?: number | undefined | null, regionHeight?: number | undefined | null): NativeClickVerifyResult
+/** Execute a hotkey and verify visual change. */
+export declare function agentHotkeyAndVerify(keys: Array<string>, minChangePercent?: number | undefined | null, timeoutMs?: number | undefined | null, regionX?: number | undefined | null, regionY?: number | undefined | null, regionWidth?: number | undefined | null, regionHeight?: number | undefined | null): NativeClickVerifyResult
+/** Move mouse relative to current position. */
+export declare function agentMoveRelative(dx: number, dy: number): NativeMousePosition
+/** Move mouse relative with smooth motion. */
+export declare function agentMoveRelativeSmooth(dx: number, dy: number, durationMs?: number | undefined | null): NativeMousePosition
+/** Type text and wait for screen to stabilize. */
+export declare function agentTypeAndWaitStable(text: string, stabilityThreshold?: number | undefined | null, stableDurationMs?: number | undefined | null, timeoutMs?: number | undefined | null): boolean
+/**
+ * Release all held modifier keys (shift, ctrl, alt, etc).
+ * Call this for error recovery or after complex operations.
+ */
+export declare function agentReleaseAllModifiers(): void
+export interface NativeMouseTrailPoint {
+  timestampMs: number
+  x: number
+  y: number
+}
+/**
+ * Record mouse movements for a duration.
+ * Useful for gesture capture and replay.
+ */
+export declare function agentRecordMouseTrail(durationMs: number, sampleRateHz?: number | undefined | null): Array<NativeMouseTrailPoint>
+/** Replay a recorded mouse trail. */
+export declare function agentReplayMouseTrail(trail: Array<NativeMouseTrailPoint>, speedMultiplier?: number | undefined | null): void
+/** Read text from the system clipboard. */
+export declare function clipboardReadText(): string | null
+/** Write text to the system clipboard. */
+export declare function clipboardWriteText(text: string): void
+/** Read HTML from the clipboard. */
+export declare function clipboardReadHtml(): string | null
+/** Write HTML to the clipboard. */
+export declare function clipboardWriteHtml(html: string): void
+export interface NativeClipboardImage {
+  data: Buffer
+  width: number
+  height: number
+}
+/** Read image data from the clipboard as RGBA bytes. */
+export declare function clipboardReadImage(): NativeClipboardImage | null
+/** Get available clipboard formats. */
+export declare function clipboardFormats(): Array<string>
+/** Clear the clipboard. */
+export declare function clipboardClear(): void
+export interface NativeProcessInfo {
+  pid: number
+  name: string
+  path?: string
+  parentPid?: number
+  memoryBytes?: number
+}
+/** List all running processes. */
+export declare function processList(): Array<NativeProcessInfo>
+/** Find processes by name (case-insensitive partial match). */
+export declare function processFind(name: string): Array<NativeProcessInfo>
+/** Check if a process with the given PID is running. */
+export declare function processIsRunning(pid: number): boolean
+/** Kill a process by PID. */
+export declare function processKill(pid: number, force?: boolean | undefined | null): void
+/** Launch a new process and return its PID. */
+export declare function processLaunch(command: string, args?: Array<string> | undefined | null): number
+/** Launch a process and wait for it to exit. Returns exit code. */
+export declare function processLaunchAndWait(command: string, args?: Array<string> | undefined | null): number
+/** Get the PID of the foreground window's process. */
+export declare function processForegroundPid(): number
+export interface NativeOsInfo {
+  name: string
+  version: string
+  arch: string
+  hostname: string
+}
+export interface NativeMemoryInfo {
+  totalBytes: number
+  availableBytes: number
+  usedBytes: number
+}
+/** Get the number of logical CPU cores. */
+export declare function sysCpuCount(): number
+/** Get operating system information. */
+export declare function sysOsInfo(): NativeOsInfo
+/** Get memory information (total, available, used). */
+export declare function sysMemoryInfo(): NativeMemoryInfo
+/** Get system uptime in seconds. */
+export declare function sysUptime(): number
+/** Get the current username. */
+export declare function sysUsername(): string
+/** Get the home directory path. */
+export declare function sysHomeDir(): string
+/** Get the temp directory path. */
+export declare function sysTempDir(): string
+/** Start recording input events. */
+export declare function recorderStart(): void
+/** Stop recording and return the recording as JSON bytes. */
+export declare function recorderStop(): Buffer
+/** Check if currently recording. */
+export declare function recorderIsRecording(): boolean
+/** Push a mouse move event into the recording. */
+export declare function recorderMouseMove(x: number, y: number): void
+/** Push a mouse button event into the recording. */
+export declare function recorderMouseButton(button: string, isDown: boolean): void
+/** Push a key event into the recording. */
+export declare function recorderKeyEvent(key: string, isDown: boolean): void
+/** Replay a recording from JSON bytes. */
+export declare function recorderReplay(data: Buffer, speed?: number | undefined | null): void
+export interface NativeHookConfig {
+  captureKeyboard?: boolean
+  captureMouseClicks?: boolean
+  captureMouseMove?: boolean
+  captureMouseWheel?: boolean
+  bufferSize?: number
+}
+export interface NativeInputEvent {
+  /** "key_down", "key_up", "mouse_move", "mouse_down", "mouse_up", "mouse_wheel" */
+  eventType: string
+  keyCode?: number
+  keyName?: string
+  x?: number
+  y?: number
+  button?: string
+  delta?: number
+  timestampMs: number
+}
+/** Start global input hooks. */
+export declare function hooksStart(config?: NativeHookConfig | undefined | null): void
+/** Stop global input hooks. */
+export declare function hooksStop(): void
+/** Check if hooks are active. */
+export declare function hooksIsActive(): boolean
+/** Drain all buffered input events. */
+export declare function hooksDrainEvents(): Array<NativeInputEvent>
+/** Get buffered event count. */
+export declare function hooksEventCount(): number
+export interface NativeMatchResult {
+  x: number
+  y: number
+  width: number
+  height: number
+  confidence: number
+}
+/**
+ * Find a template image on screen.
+ * needle: RGBA pixel data of the template image.
+ */
+export declare function templateFindOnScreen(needleData: Buffer, needleWidth: number, needleHeight: number, threshold?: number | undefined | null, regionX?: number | undefined | null, regionY?: number | undefined | null, regionWidth?: number | undefined | null, regionHeight?: number | undefined | null): NativeMatchResult | null
+/** Find all occurrences of a template on screen. */
+export declare function templateFindAllOnScreen(needleData: Buffer, needleWidth: number, needleHeight: number, threshold?: number | undefined | null, maxResults?: number | undefined | null, regionX?: number | undefined | null, regionY?: number | undefined | null, regionWidth?: number | undefined | null, regionHeight?: number | undefined | null): Array<NativeMatchResult>
+/** Wait for a template to appear on screen. */
+export declare function templateWaitFor(needleData: Buffer, needleWidth: number, needleHeight: number, threshold?: number | undefined | null, timeoutMs?: number | undefined | null, pollIntervalMs?: number | undefined | null, regionX?: number | undefined | null, regionY?: number | undefined | null, regionWidth?: number | undefined | null, regionHeight?: number | undefined | null): NativeMatchResult | null
+/** Capture a screen region and return it as PNG bytes. */
+export declare function screenCapturePng(x?: number | undefined | null, y?: number | undefined | null, width?: number | undefined | null, height?: number | undefined | null): Buffer
+/**
+ * Capture a screen region and return it as JPEG bytes.
+ * Quality is 1–100 (80 is a good default for real-time use).
+ */
+export declare function screenCaptureJpeg(quality?: number | undefined | null, x?: number | undefined | null, y?: number | undefined | null, width?: number | undefined | null, height?: number | undefined | null): Buffer
+/** Capture a screen region and save to a PNG file. */
+export declare function screenSaveScreenshot(path: string, x?: number | undefined | null, y?: number | undefined | null, width?: number | undefined | null, height?: number | undefined | null): void
+/** Move mouse relative to current position. */
+export declare function mouseMoveRelative(dx: number, dy: number): NativeMousePosition
+/** Move mouse relative with smooth motion. */
+export declare function mouseMoveRelativeSmooth(dx: number, dy: number, durationMs?: number | undefined | null, curve?: string | undefined | null): NativeMousePosition
+/** Right-click at current position. */
+export declare function mouseRightClick(): void
+/** Middle-click at current position. */
+export declare function mouseMiddleClick(): void
+/** Hover over a position for a duration, then return. */
+export declare function mouseHover(x: number, y: number, durationMs?: number | undefined | null): void
+/** Get distance from current mouse position to target. */
+export declare function mouseDistanceTo(x: number, y: number): number
+/** Move the cursor smoothly through a sequence of waypoints. */
+export declare function mouseMoveThroughPoints(points: Array<Array<number>>, durationMs: number, curve?: string | undefined | null, stepsPerSecond?: number | undefined | null): void
+/** Trace a circular path around a center point. */
+export declare function mouseGestureCircle(centerX: number, centerY: number, radius: number, durationMs: number, clockwise?: boolean | undefined | null, stepsPerSecond?: number | undefined | null): void
+/** Quick swipe gesture from one point to another. */
+export declare function mouseGestureSwipe(fromX: number, fromY: number, toX: number, toY: number, durationMs?: number | undefined | null, holdButton?: string | undefined | null): void
+/** Drag along an arbitrary path of waypoints while holding a mouse button. */
+export declare function mouseGestureDragPath(points: Array<Array<number>>, button: string | undefined | null, durationMs: number, stepsPerSecond?: number | undefined | null): void
+/** Spiral inward or outward from a center point. */
+export declare function mouseGestureSpiral(centerX: number, centerY: number, startRadius: number, endRadius: number, turns: number, durationMs: number, stepsPerSecond?: number | undefined | null): void
+/** Zigzag motion between two points with perpendicular oscillation. */
+export declare function mouseGestureZigzag(fromX: number, fromY: number, toX: number, toY: number, amplitude: number, waves: number, durationMs: number, stepsPerSecond?: number | undefined | null): void
+/** Trace a rectangular path. */
+export declare function mouseGestureRectangle(x: number, y: number, width: number, height: number, durationMs: number, curve?: string | undefined | null): void
+/** Wait until OCR finds the specified text on screen. Returns the word position. */
+export declare function waitForText(needle: string, timeoutMs?: number | undefined | null, intervalMs?: number | undefined | null, regionX?: number | undefined | null, regionY?: number | undefined | null, regionWidth?: number | undefined | null, regionHeight?: number | undefined | null): NativeOcrWord | null
+/** Wait until OCR finds the text, then click on it. Returns position clicked or None on timeout. */
+export declare function waitForTextAndClick(needle: string, timeoutMs?: number | undefined | null, intervalMs?: number | undefined | null, button?: string | undefined | null, regionX?: number | undefined | null, regionY?: number | undefined | null, regionWidth?: number | undefined | null, regionHeight?: number | undefined | null): NativeMousePosition | null
+/**
+ * Monitor a screen region and return when it changes beyond the threshold.
+ * Returns the diff percentage when change is detected, or None on timeout.
+ */
+export declare function watchRegionOnce(x: number, y: number, width: number, height: number, threshold?: number | undefined | null, timeoutMs?: number | undefined | null, intervalMs?: number | undefined | null): number | null
+/** Find windows by process name. */
+export declare function windowFindByProcess(name: string): Array<NativeWindowInfo>
+/** Find windows by process ID. */
+export declare function windowFindByPid(pid: number): Array<NativeWindowInfo>
+/** Set window always-on-top. */
+export declare function windowSetAlwaysOnTop(id: number, topmost: boolean): void
+/** Set window opacity (0.0 transparent – 1.0 opaque). */
+export declare function windowSetOpacity(id: number, opacity: number): void
+/** Get window bounds. */
+export declare function windowGetBounds(id: number): NativeRect
+/** Check if a window has focus. */
+export declare function windowIsForeground(id: number): boolean
+/** Bring a window to front aggressively. */
+export declare function windowBringToFront(id: number): void
+/** Wait for a window with matching title to appear. */
+export declare function windowWaitFor(title: string, timeoutMs?: number | undefined | null): NativeWindowInfo
+/** Center a window on the primary screen. */
+export declare function windowCenter(id: number): void
+/**
+ * Capture a specific window's content as raw RGBA pixel data.
+ * Works on background (non-foreground) windows — no focus required.
+ */
+export declare function windowCapture(id: number): NativeScreenCapture
+/**
+ * Capture a specific window's content as JPEG bytes.
+ * Works on background (non-foreground) windows — no focus required.
+ */
+export declare function windowCaptureJpeg(id: number, quality?: number | undefined | null): Buffer
+/**
+ * Send a mouse click to a window without focusing it.
+ * Coordinates are relative to the window's client area. Button: "left" or "right".
+ */
+export declare function windowSendClick(id: number, x: number, y: number, button?: string | undefined | null): void
+/**
+ * Send a key press to a window without focusing it.
+ * vk_code is the Windows virtual-key code (e.g. 0x0D = Enter, 0x09 = Tab).
+ */
+export declare function windowSendKey(id: number, vkCode: number): void
+/** Get the current platform name. */
+export declare function getPlatform(): string
+/** Get the Stelo native addon version. */
+export declare function getVersion(): string
+/** Delay execution for the specified milliseconds (blocking). */
+export declare function delay(ms: number): void
+export interface NativeGroupResult {
+  groupId: string
+  results: Array<NativeActionResult>
+  durationMs: number
+  successCount: number
+  failureCount: number
+}
+export interface NativeParallelResult {
+  groups: Array<NativeGroupResult>
+  totalDurationMs: number
+  totalActions: number
+  totalSuccess: number
+  totalFailures: number
+  allSucceeded: boolean
+}
+/**
+ * Execute multiple action groups in parallel on native OS threads.
+ *
+ * Each group is an object { groupId: string, actions: Action[], stopOnError?: bool, startDelayMs?: number }.
+ * Groups run concurrently on separate threads. Within a group, actions are sequential.
+ *
+ * This is the core primitive that makes Stelo faster than any other SDK —
+ * true OS-level parallelism, not async pretend.
+ */
+export declare function parallelExecute(groups: Array<any>): NativeParallelResult
+/**
+ * Execute actions with interleaved timing (human-like overlapping input).
+ *
+ * Each entry is { startAtMs: number, ...action }. Actions with the same
+ * start time run in parallel. This enables overlapping mouse + keyboard.
+ */
+export declare function interleavedExecute(timedActions: Array<any>): NativeParallelResult
+export interface NativeOcrWord {
+  /** The recognized text */
+  text: string
+  /** Bounding box X */
+  x: number
+  /** Bounding box Y */
+  y: number
+  /** Bounding box width */
+  width: number
+  /** Bounding box height */
+  height: number
+  /** Confidence (0.0 - 1.0) when available */
+  confidence: number
+}
+export interface NativeOcrLine {
+  /** Full text of the line */
+  text: string
+  /** Individual words with positions */
+  words: Array<NativeOcrWord>
+  /** Line bounding box */
+  x: number
+  y: number
+  width: number
+  height: number
+}
+export interface NativeOcrResult {
+  /** Full recognized text */
+  text: string
+  /** Lines with word-level detail */
+  lines: Array<NativeOcrLine>
+  /** Duration of OCR in milliseconds */
+  durationMs: number
+}
+/**
+ * Perform OCR on a screen region. Returns recognized text with word positions.
+ * Uses the built-in Windows OCR engine (no external dependencies).
+ *
+ * Pass region coordinates to OCR a specific area, or omit for full screen.
+ */
+export declare function ocrRecognize(regionX?: number | undefined | null, regionY?: number | undefined | null, regionWidth?: number | undefined | null, regionHeight?: number | undefined | null): NativeOcrResult
+/**
+ * Find text on screen and return its bounding box center.
+ * Returns the first match found, or null if text not found.
+ */
+export declare function ocrFindText(needle: string, regionX?: number | undefined | null, regionY?: number | undefined | null, regionWidth?: number | undefined | null, regionHeight?: number | undefined | null): NativeOcrWord | null
+/**
+ * Click on text found via OCR. Finds the text, clicks its center.
+ * Returns the position clicked, or error if text not found.
+ */
+export declare function ocrClickText(needle: string, button?: string | undefined | null, regionX?: number | undefined | null, regionY?: number | undefined | null, regionWidth?: number | undefined | null, regionHeight?: number | undefined | null): NativeMousePosition