@simular-ai/simulang-js 5.5.0 → 6.0.1

package/CLAUDE.md

@@ -31,6 +31,28 @@ restatement elsewhere.
   screen is 3840×2160 in these coordinates. Image and screenshot dimensions
   are likewise in physical pixels.
 
+## Logging is on by default
+
+`import '@simular-ai/simulang-js'` auto-installs a stderr logger sink — no
+explicit `initLogger()` call required. Records from simulang-rs (clipboard
+reads/writes, keyboard input, app launches, window state changes, …) show
+up on the host process's stderr formatted as `[level] message`. The Rust
+`target` (module path, e.g. `simulang_rs::common::clipboard`) is omitted
+from the default format to keep terminal output readable; install a
+custom callback via `initLogger(cb)` to access it on the record payload.
+
+Filter resolution: `RUST_LOG` if set, otherwise `simulang_rs=info,warn` —
+info-level records from simulang's own actions, warn-level from every
+other crate. Override at any time with `initLogger(...)`:
+
+- `initLogger(null, 'off')` — silence everything
+- `initLogger(null, 'simulang_rs=debug,warn')` — bump verbosity
+- `initLogger(cb)` — forward records to a JS callback (log window, file
+  appender, pino/winston, Electron renderer over IPC, …) instead of stderr
+
+`initLogger` atomically swaps both the sink and the filter on every call,
+so it composes cleanly with the auto-install.
+
 ## Live log viewer (optional)
 
 `@simular-ai/simulang-log-viewer` is a **human-facing aid**: a floating,
@@ -52,7 +74,8 @@ else, also shown inside the window) toggles "grab mode": pressing it once
 turns click-through off, pauses execution, and makes the window draggable;
 pressing it again restores click-through and resumes.
 
-Wire it up via `initLogger` and respect the pause inside automation loops:
+Re-route records into the window via `initLogger` (overriding the
+default stderr sink) and respect the pause inside automation loops:
 
 ```js
 import { initLogger } from '@simular-ai/simulang-js'
@@ -66,12 +89,15 @@ initLogger((rec) => win.log(`[${rec.level}] [${rec.target}] ${rec.message}`), 'i
 await win.waitIfPaused()
 ```
 
+(The simpler way is to `import '@simular-ai/simulang-log-viewer'` for its
+side effect — the package's auto-install entry point spawns the window,
+registers the pause hook, and calls `initLogger` for you.)
+
 The second argument to `initLogger` is a filter spec in the `RUST_LOG`
 environment-variable syntax used by Rust's `env_logger` / `log` crates —
 e.g. `'info'` for a global level, `'simulang_rs=debug,warn'` for per-module
-scoping. Omit it to inherit the value of the `RUST_LOG` env var (or fall
-back to `'error'` if it's unset). See `initLogger`'s JSDoc in
-`index.d.ts` for the full grammar.
+scoping. See `initLogger`'s JSDoc in `index.d.ts` for the full grammar
+and the auto-install default.
 
 Other methods: `clear()` drops displayed messages, `isPaused` getter for a
 non-blocking check, `close()` to shut the viewer (also automatic on parent

package/examples/README.md

@@ -31,6 +31,7 @@ node screenshot.mjs
 | `chrome_google_search_button.mjs` | Opens google.com in Chrome and locates the search button by _concept text_, using BoW Jaccard scoring over `overallDescription`.                                                             |
 | `open-app.mjs`                    | Opens an app, lists its windows, snapshots its accessibility tree.                                                                                                                           |
 | `loopback.mjs`                    | Plays an audio file while capturing system audio, then transcribes it.                                                                                                                       |
+| `ask.mjs`                         | Drives the `AskModel` LLM primitive through prompt-only, text-only, image-only, and text + multi-image calls, using a real ax-tree snapshot and back-to-back screenshots as context.         |
 | `logger.mjs`                      | Forwards Rust `log` records to a JS callback (env_logger-style filter spec).                                                                                                                 |
 | `log-window.mjs`                  | Pipes Rust `log::*!` records into a floating, always-on-top log window. Requires the optional [`@simular-ai/simulang-log-viewer`](../README.md#3-optional--install-the-log-viewer) peer dep. |
 
@@ -40,8 +41,9 @@ Unlike a sandboxed library call, most of these examples perform **real actions**
 
 - `keyboard.mjs` and `google_search.mjs` synthesize keystrokes — make sure the intended window is focused, or text will land somewhere unexpected.
 - `clipboard.mjs` overwrites your current clipboard contents (it restores them at the end).
-- `screenshot.mjs`, `google_search.mjs`, and `loopback.mjs` capture your screen or system audio.
+- `screenshot.mjs`, `google_search.mjs`, `loopback.mjs`, and `ask.mjs` capture your screen or system audio.
 - `system.mjs` and `google_search.mjs` launch a browser window.
+- `ask.mjs` and `loopback.mjs` send screen captures / audio to a remote LLM provider — make sure the configured provider is one you're OK sharing that content with. Set `OPENROUTER_API_KEY` (or drop a custom provider config under `~/.config/simulang/providers/`) before running `ask.mjs`.
 
 ### Required OS permissions
 

package/examples/ask.mjs

@@ -0,0 +1,76 @@
+// Run: node examples/ask.mjs
+//
+// Drive `AskModel` through its four input shapes — prompt-only, text-only,
+// image-only, and text + multiple images — using a real accessibility-tree
+// snapshot of the foreground window as text context and back-to-back
+// screen captures as images.
+//
+// This is the JS analog of `simulang-rs/examples/ask_about_screenshot.rs`.
+//
+// Requirements:
+//   - A configured ask provider (the bundled `openrouter` provider needs
+//     `OPENROUTER_API_KEY`; see PROVIDERS.md for alternatives)
+//   - Screen recording permission (for the screenshots)
+//   - Accessibility permission (for the ax-tree snapshot)
+
+import { AccessibilityTree, AskModel, Screen, ariaRoleToString, screenshotFull } from '@simular-ai/simulang-js'
+
+/**
+ * Render an `AccessibilityNodeJs` subtree as an indented Playwright-style
+ * aria snapshot (mirrors `WindowTrait::snapshot()` in simulang-rs).
+ *
+ * @param {import('@simular-ai/simulang-js').AccessibilityNodeJs} node
+ * @param {number} [depth]
+ * @returns {string}
+ */
+function snapshotToString(node, depth = 0) {
+  const indent = '  '.repeat(depth)
+  let line = `${indent}- ${ariaRoleToString(node.role)}`
+  if (node.name) line += ` ${JSON.stringify(node.name)}`
+  if (node.value) line += `: ${JSON.stringify(node.value)}`
+  const childLines = node.children.map((c) => snapshotToString(c, depth + 1))
+  return [line, ...childLines].join('\n')
+}
+
+const aliases = AskModel.availableAliases()
+if (aliases.length === 0) {
+  console.error(
+    'No LLM model is reachable. Set OPENROUTER_API_KEY (or drop a custom provider config under ~/.config/simulang/providers/) and try again.',
+  )
+  process.exit(1)
+}
+
+const model = AskModel.default()
+console.log(`Using ask model ${JSON.stringify(model.name)}`)
+console.log(`Available aliases: ${aliases.join(', ')}\n`)
+
+// 1. Prompt-only — no context at all.
+const pong = model.ask('Reply with just the word PONG.')
+console.log(`[prompt only] -> ${JSON.stringify(pong)}\n`)
+
+// 2. Text-only — ground the model on a real accessibility-tree snapshot of
+//    whatever window is currently in the foreground.
+const tree = AccessibilityTree.fromForeground()
+const axSnapshot = snapshotToString(tree.snapshot())
+console.log(`Snapshotted foreground window: ${JSON.stringify(tree.windowTitle)}`)
+const summary = model.ask('Summarize this UI in one sentence and list any buttons that look clickable.', axSnapshot)
+console.log(`[text only]\n${summary}\n`)
+
+// 3. Image-only — full screenshot of the main display.
+const shotA = screenshotFull(true, Screen.mainScreen())
+shotA.shrink(1024, 1024)
+shotA.compress(80)
+const description = model.ask('Describe what is on screen in one sentence.', null, [shotA])
+console.log(`[image only]\n${description}\n`)
+
+// 4. Text + multiple images — capture a second screenshot back-to-back and
+//    ask the model to compare them with the ax-tree snapshot for context.
+const shotB = screenshotFull(true, Screen.mainScreen())
+shotB.shrink(1024, 1024)
+shotB.compress(80)
+const diff = model.ask(
+  'These two screenshots were taken back-to-back. Did anything change between them? Be specific.',
+  axSnapshot,
+  [shotA, shotB],
+)
+console.log(`[text + 2 images]\n${diff}`)

package/examples/log-window.mjs

@@ -26,29 +26,33 @@ win.spawn()
 
 // `'info'` mirrors `RUST_LOG=info`. Use e.g. `'simulang_rs=debug,warn'` to
 // scope per-module. Omit the second argument to fall back to `RUST_LOG`.
+//
+// `win.log` already mirrors every line to the host's stderr internally,
+// so a single call here gets the record into both the floating viewer
+// and the terminal — no extra `console.log` needed.
 initLogger((rec) => {
-  const line = `[${rec.level}] [${rec.target}] ${rec.message}`
-  console.log(line)
-  win.log(line)
+  win.log(`[${rec.level}] ${rec.message}`)
 }, 'info')
 
 // Run a few simulang-js calls so there's actually something to look at.
-win.log('--- starting clipboard demo ---')
+// Each call emits its own `[info]` record via `initLogger` above, so the
+// `win.log` lines below stick to script-level milestones rather than
+// re-narrating every call.
+win.log('clipboard + screenshot demo')
 try {
   const cb = new Clipboard()
   const previous = cb.setString('hello from simulang-js')
-  win.log(`clipboard now contains: ${cb.getString()}`)
+  cb.getString()
   if (previous !== null) cb.setString(previous)
 
-  win.log('--- starting screenshot demo ---')
   const shot = screenshotFull(true, Screen.mainScreen())
   shot.shrink(640, 480)
-  win.log(`captured ${shot.base64().length} bytes (base64)`)
+  win.log(`screenshot captured: ${shot.base64().length} bytes base64`)
 } catch (err) {
   win.log(`demo failed: ${err instanceof Error ? err.message : String(err)}`)
 }
 
-win.log('done. Holding window open for 30s — press the grab hotkey to pause.')
+win.log('holding window open for 30s, press the grab hotkey to pause')
 await new Promise((resolve) => setTimeout(resolve, 30_000))
 // In real automation, scatter `await win.waitIfPaused()` between actions
 // so the script yields whenever the user has grabbed the window.

package/index.d.ts

@@ -87,13 +87,7 @@ export declare class AccessibilityNode {
    *                           against each node's `overallDescription`
    * - `threshold`           – minimum score to keep a node
    */
-  scoredSearch(
-    order: TraversalOrder,
-    maxNodes: number,
-    collapseStructural: boolean,
-    query: string,
-    threshold: number,
-  ): Array<AccessibilityNode>
+  scoredSearch(order: TraversalOrder, maxNodes: number, collapseStructural: boolean, query: string, threshold: number): Array<AccessibilityNode>
   /** Invoke / click the element (button, link, menu item). */
   activate(): void
   /** Set the text value of the element (textbox, combobox, …). */
@@ -189,14 +183,7 @@ export declare class AccessibilityTree {
    * Clears existing refs; returned nodes carry `refId` values usable
    * with action methods (`activate`, `setValue`, …).
    */
-  find(
-    order: TraversalOrder,
-    role?: AriaRole | undefined | null,
-    name?: string | undefined | null,
-    visibleOnly?: boolean | undefined | null,
-    maxResults?: number | undefined | null,
-    collapseStructural?: boolean | undefined | null,
-  ): Array<AccessibilityNodeJs>
+  find(order: TraversalOrder, role?: AriaRole | undefined | null, name?: string | undefined | null, visibleOnly?: boolean | undefined | null, maxResults?: number | undefined | null, collapseStructural?: boolean | undefined | null): Array<AccessibilityNodeJs>
 }
 
 /** Represents an application that can be opened. */
@@ -227,12 +214,54 @@ export declare class App {
    * When `wait_for_load_complete` is true, this blocks for a short, fixed
    * delay to allow the app or URL to become responsive before returning.
    */
-  open(
-    url: string | undefined | null,
-    focusPolicy: FocusPolicy,
-    visibility: Visibility,
-    waitForLoadComplete: boolean,
-  ): Instance
+  open(url: string | undefined | null, focusPolicy: FocusPolicy, visibility: Visibility, waitForLoadComplete: boolean): Instance
+}
+
+/**
+ * A free-form chat-completions LLM (optionally vision-capable) — the JS
+ * analogue of the `ask` primitive.
+ *
+ * Given a `prompt`, optional accessibility/structural `text`, and zero or
+ * more `images`, [`AskModel.ask`] returns the model's response as a plain
+ * string. The wire format is OpenAI-compatible chat completions, so any
+ * provider config that points at such an endpoint works.
+ */
+export declare class AskModel {
+  /**
+   * First LLM model advertised by the first LLM-capable provider in the
+   * loaded configuration whose credentials are currently available.
+   * Throws if no provider in the loaded config advertises an LLM service.
+   */
+  static default(): AskModel
+  /**
+   * Resolve a model alias against the loaded config (e.g.
+   * `"openrouter_gpt_4o_mini"` from the bundled `openrouter` provider, or
+   * any alias declared by a user provider). Throws if the alias is unknown.
+   */
+  static byAlias(alias: string): AskModel
+  /**
+   * Every LLM model alias accepted by `byAlias` on this machine,
+   * deduplicated and sorted alphabetically. Use to discover what aliases
+   * the loaded config (bundled defaults plus any user provider files)
+   * advertises.
+   */
+  static availableAliases(): Array<string>
+  /** The wire-level model identifier sent in the request body. */
+  get name(): string
+  /**
+   * Ask the model a question, optionally grounded in accessibility text
+   * and/or images.
+   *
+   * - `prompt`: the question or task to answer.
+   * - `text`: optional accessibility-tree (or any) text included as
+   *   structural context. Pass `null` / omit to skip.
+   * - `images`: zero or more images to attach. Each is encoded as a
+   *   base64 data URL and sent as an `image_url` chat content part. Pass
+   *   `null` / omit for none.
+   *
+   * Returns the trimmed assistant response on success.
+   */
+  ask(prompt: string, text?: string | undefined | null, images?: Array<Image> | undefined | null): string
 }
 
 /**
@@ -559,13 +588,7 @@ export declare class Instance {
    * methods (`activate`, `setValue`, …) directly on them, walk children
    * with `.children()`, or render a snapshot with `.snapshot()`.
    */
-  scoredSearch(
-    order: TraversalOrder,
-    maxNodes: number,
-    collapseStructural: boolean,
-    query: string,
-    threshold: number,
-  ): Array<AccessibilityNode>
+  scoredSearch(order: TraversalOrder, maxNodes: number, collapseStructural: boolean, query: string, threshold: number): Array<AccessibilityNode>
 }
 
 /**
@@ -1042,13 +1065,7 @@ export declare class Window {
    * methods (`activate`, `setValue`, …) directly on them, walk children
    * with `.children()`, or render a snapshot with `.snapshot()`.
    */
-  scoredSearch(
-    order: TraversalOrder,
-    maxNodes: number,
-    collapseStructural: boolean,
-    query: string,
-    threshold: number,
-  ): Array<AccessibilityNode>
+  scoredSearch(order: TraversalOrder, maxNodes: number, collapseStructural: boolean, query: string, threshold: number): Array<AccessibilityNode>
 }
 
 export interface AccessibilityNodeJs {
@@ -1161,7 +1178,7 @@ export declare enum AriaRole {
   TreeItem = 84,
   Treegrid = 85,
   Video = 86,
-  Window = 87,
+  Window = 87
 }
 
 /**
@@ -1195,20 +1212,20 @@ export declare enum Button {
   ScrollUp = 5,
   ScrollDown = 6,
   ScrollLeft = 7,
-  ScrollRight = 8,
+  ScrollRight = 8
 }
 
 /** Specifies if coordinates are relative or absolute. */
 export declare enum Coordinate {
   Abs = 0,
-  Rel = 1,
+  Rel = 1
 }
 
 /** The direction of a button event. */
 export declare enum Direction {
   Press = 0,
   Release = 1,
-  Click = 2,
+  Click = 2
 }
 
 /** Enables the accessibility tree for the frontmost application. */
@@ -1222,7 +1239,7 @@ export declare enum FocusPolicy {
    */
   DoNotSteal = 0,
   /** Allow the launched app to become active/frontmost. */
-  Steal = 1,
+  Steal = 1
 }
 
 export declare function hasScreenCapturePermission(): boolean
@@ -1230,16 +1247,25 @@ export declare function hasScreenCapturePermission(): boolean
 /**
  * Initialize the logger.
  *
+ * **You usually don't need to call this.** The package's `main` entry
+ * (`wrapped.js`) calls `initLogger()` with no arguments on first
+ * evaluation, so simply `import '@simular-ai/simulang-js'` is enough to
+ * see `[level] message` records on stderr. Call this directly
+ * only when you want to *override* that default — to forward records to
+ * a JS callback, change the filter spec, or silence everything.
+ *
  * - **No callback** (`initLogger()` or `initLogger(null, spec)`): records
- *   are formatted as `[level] [target] message` and written to stderr.
+ *   are formatted as `[level] message` and written to stderr.
  * - **With a callback** (`initLogger(cb, spec)`): records are forwarded to
  *   the JS callback via a non-blocking, unref'd threadsafe function. Use
  *   this for GUI panels, file appenders, or routing through a logging
  *   library like pino. The unref'd dispatch means the logger does not keep
  *   the Node event loop alive on its own.
  *
- * Omit `spec` to read `RUST_LOG` (defaults to `"error"` if unset). Pass an
- * explicit `spec` to override `RUST_LOG`. Syntax is identical to `RUST_LOG`:
+ * Omit `spec` to read `RUST_LOG` (falls back to `"simulang_rs=info,warn"`
+ * when `RUST_LOG` is unset — info-level records from simulang's own
+ * actions, warn-level from every other crate). Pass an explicit `spec`
+ * to override `RUST_LOG`. Syntax is identical to `RUST_LOG`:
  *
  * - `"info"` — global level
  * - `"simulang_rs=debug,warn"` — per-module override + default
@@ -1257,10 +1283,7 @@ export declare function hasScreenCapturePermission(): boolean
  * on forever. The callback itself runs on the Node main thread; the
  * non-blocking dispatch from Rust is what creates the recursion risk.
  */
-export declare function initLogger(
-  cb?: ((arg: JsLogRecord) => unknown) | undefined | null,
-  spec?: string | undefined | null,
-): void
+export declare function initLogger(cb?: (((arg: JsLogRecord) => unknown)) | undefined | null, spec?: string | undefined | null): void
 
 /** A single log entry forwarded to the JS callback. */
 export interface JsLogRecord {
@@ -1628,19 +1651,14 @@ export declare enum Key {
   /** Use `key_unicode` to provide the character. */
   Unicode = 290,
   /** Use `key_other` to provide the raw key value. */
-  Other = 291,
+  Other = 291
 }
 
 /** Convert a string representation into a `Key`. */
 export declare function keyFromString(value: string): Key
 
 /** Legacy helper used by Electron to open an app or URL. */
-export declare function legacyOpen(
-  app: string | undefined | null,
-  url: string | undefined | null,
-  focusPolicy: FocusPolicy,
-  visibility: Visibility,
-): void
+export declare function legacyOpen(app: string | undefined | null, url: string | undefined | null, focusPolicy: FocusPolicy, visibility: Visibility): void
 
 /** Legacy helper used by Electron to capture a screenshot as base64. */
 export declare function legacyTakeScreenshot(needsCompression: boolean, shrinkTo1080P: boolean): string
@@ -1654,13 +1672,7 @@ export declare function legacyTakeScreenshot(needsCompression: boolean, shrinkTo
 export declare function readFile(path: string): string
 
 /** Takes the screenshot of a cropped region of the workspace. */
-export declare function screenshotCropped(
-  x: number,
-  y: number,
-  width: number,
-  height: number,
-  hideCursor: boolean,
-): Screenshot
+export declare function screenshotCropped(x: number, y: number, width: number, height: number, hideCursor: boolean): Screenshot
 
 /** Takes the screenshot of the entire selected screen */
 export declare function screenshotFull(hideCursor: boolean, screen: Screen): Screenshot
@@ -1670,7 +1682,7 @@ export declare enum TraversalOrder {
   /** Pre-order depth-first (each node before its descendants). */
   DepthFirst = 0,
   /** Level-order breadth-first (parents before children). */
-  BreadthFirst = 1,
+  BreadthFirst = 1
 }
 
 /** Visibility behavior when opening an application. */
@@ -1678,7 +1690,7 @@ export declare enum Visibility {
   /** Launch hidden when supported by the platform. */
   Hidden = 0,
   /** Launch in a visible state. */
-  Show = 1,
+  Show = 1
 }
 
 /**

package/index.js

@@ -77,8 +77,8 @@ function requireNative() {
       try {
         const binding = require('@simular-ai/simulang-js-android-arm64')
         const bindingPackageVersion = require('@simular-ai/simulang-js-android-arm64/package.json').version
-        if (bindingPackageVersion !== '5.5.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 5.5.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '6.0.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 6.0.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -93,8 +93,8 @@ function requireNative() {
       try {
         const binding = require('@simular-ai/simulang-js-android-arm-eabi')
         const bindingPackageVersion = require('@simular-ai/simulang-js-android-arm-eabi/package.json').version
-        if (bindingPackageVersion !== '5.5.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 5.5.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '6.0.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 6.0.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -114,8 +114,8 @@ function requireNative() {
       try {
         const binding = require('@simular-ai/simulang-js-win32-x64-gnu')
         const bindingPackageVersion = require('@simular-ai/simulang-js-win32-x64-gnu/package.json').version
-        if (bindingPackageVersion !== '5.5.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 5.5.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '6.0.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 6.0.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -130,8 +130,8 @@ function requireNative() {
       try {
         const binding = require('@simular-ai/simulang-js-win32-x64-msvc')
         const bindingPackageVersion = require('@simular-ai/simulang-js-win32-x64-msvc/package.json').version
-        if (bindingPackageVersion !== '5.5.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 5.5.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '6.0.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 6.0.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -147,8 +147,8 @@ function requireNative() {
       try {
         const binding = require('@simular-ai/simulang-js-win32-ia32-msvc')
         const bindingPackageVersion = require('@simular-ai/simulang-js-win32-ia32-msvc/package.json').version
-        if (bindingPackageVersion !== '5.5.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 5.5.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '6.0.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 6.0.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -163,8 +163,8 @@ function requireNative() {
       try {
         const binding = require('@simular-ai/simulang-js-win32-arm64-msvc')
         const bindingPackageVersion = require('@simular-ai/simulang-js-win32-arm64-msvc/package.json').version
-        if (bindingPackageVersion !== '5.5.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 5.5.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '6.0.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 6.0.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -182,8 +182,8 @@ function requireNative() {
     try {
       const binding = require('@simular-ai/simulang-js-darwin-universal')
       const bindingPackageVersion = require('@simular-ai/simulang-js-darwin-universal/package.json').version
-      if (bindingPackageVersion !== '5.5.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-        throw new Error(`Native binding package version mismatch, expected 5.5.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+      if (bindingPackageVersion !== '6.0.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+        throw new Error(`Native binding package version mismatch, expected 6.0.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
       }
       return binding
     } catch (e) {
@@ -198,8 +198,8 @@ function requireNative() {
       try {
         const binding = require('@simular-ai/simulang-js-darwin-x64')
         const bindingPackageVersion = require('@simular-ai/simulang-js-darwin-x64/package.json').version
-        if (bindingPackageVersion !== '5.5.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 5.5.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '6.0.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 6.0.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -214,8 +214,8 @@ function requireNative() {
       try {
         const binding = require('@simular-ai/simulang-js-darwin-arm64')
         const bindingPackageVersion = require('@simular-ai/simulang-js-darwin-arm64/package.json').version
-        if (bindingPackageVersion !== '5.5.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 5.5.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '6.0.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 6.0.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -234,8 +234,8 @@ function requireNative() {
       try {
         const binding = require('@simular-ai/simulang-js-freebsd-x64')
         const bindingPackageVersion = require('@simular-ai/simulang-js-freebsd-x64/package.json').version
-        if (bindingPackageVersion !== '5.5.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 5.5.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '6.0.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 6.0.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -250,8 +250,8 @@ function requireNative() {
       try {
         const binding = require('@simular-ai/simulang-js-freebsd-arm64')
         const bindingPackageVersion = require('@simular-ai/simulang-js-freebsd-arm64/package.json').version
-        if (bindingPackageVersion !== '5.5.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 5.5.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '6.0.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 6.0.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -271,8 +271,8 @@ function requireNative() {
         try {
           const binding = require('@simular-ai/simulang-js-linux-x64-musl')
           const bindingPackageVersion = require('@simular-ai/simulang-js-linux-x64-musl/package.json').version
-          if (bindingPackageVersion !== '5.5.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 5.5.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '6.0.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 6.0.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -287,8 +287,8 @@ function requireNative() {
         try {
           const binding = require('@simular-ai/simulang-js-linux-x64-gnu')
           const bindingPackageVersion = require('@simular-ai/simulang-js-linux-x64-gnu/package.json').version
-          if (bindingPackageVersion !== '5.5.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 5.5.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '6.0.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 6.0.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -305,8 +305,8 @@ function requireNative() {
         try {
           const binding = require('@simular-ai/simulang-js-linux-arm64-musl')
           const bindingPackageVersion = require('@simular-ai/simulang-js-linux-arm64-musl/package.json').version
-          if (bindingPackageVersion !== '5.5.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 5.5.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '6.0.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 6.0.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -321,8 +321,8 @@ function requireNative() {
         try {
           const binding = require('@simular-ai/simulang-js-linux-arm64-gnu')
           const bindingPackageVersion = require('@simular-ai/simulang-js-linux-arm64-gnu/package.json').version
-          if (bindingPackageVersion !== '5.5.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 5.5.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '6.0.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 6.0.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -339,8 +339,8 @@ function requireNative() {
         try {
           const binding = require('@simular-ai/simulang-js-linux-arm-musleabihf')
           const bindingPackageVersion = require('@simular-ai/simulang-js-linux-arm-musleabihf/package.json').version
-          if (bindingPackageVersion !== '5.5.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 5.5.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '6.0.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 6.0.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -355,8 +355,8 @@ function requireNative() {
         try {
           const binding = require('@simular-ai/simulang-js-linux-arm-gnueabihf')
           const bindingPackageVersion = require('@simular-ai/simulang-js-linux-arm-gnueabihf/package.json').version
-          if (bindingPackageVersion !== '5.5.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 5.5.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '6.0.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 6.0.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -373,8 +373,8 @@ function requireNative() {
         try {
           const binding = require('@simular-ai/simulang-js-linux-loong64-musl')
           const bindingPackageVersion = require('@simular-ai/simulang-js-linux-loong64-musl/package.json').version
-          if (bindingPackageVersion !== '5.5.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 5.5.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '6.0.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 6.0.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -389,8 +389,8 @@ function requireNative() {
         try {
           const binding = require('@simular-ai/simulang-js-linux-loong64-gnu')
           const bindingPackageVersion = require('@simular-ai/simulang-js-linux-loong64-gnu/package.json').version
-          if (bindingPackageVersion !== '5.5.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 5.5.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '6.0.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 6.0.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -407,8 +407,8 @@ function requireNative() {
         try {
           const binding = require('@simular-ai/simulang-js-linux-riscv64-musl')
           const bindingPackageVersion = require('@simular-ai/simulang-js-linux-riscv64-musl/package.json').version
-          if (bindingPackageVersion !== '5.5.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 5.5.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '6.0.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 6.0.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -423,8 +423,8 @@ function requireNative() {
         try {
           const binding = require('@simular-ai/simulang-js-linux-riscv64-gnu')
           const bindingPackageVersion = require('@simular-ai/simulang-js-linux-riscv64-gnu/package.json').version
-          if (bindingPackageVersion !== '5.5.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 5.5.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '6.0.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 6.0.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -440,8 +440,8 @@ function requireNative() {
       try {
         const binding = require('@simular-ai/simulang-js-linux-ppc64-gnu')
         const bindingPackageVersion = require('@simular-ai/simulang-js-linux-ppc64-gnu/package.json').version
-        if (bindingPackageVersion !== '5.5.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 5.5.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '6.0.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 6.0.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -456,8 +456,8 @@ function requireNative() {
       try {
         const binding = require('@simular-ai/simulang-js-linux-s390x-gnu')
         const bindingPackageVersion = require('@simular-ai/simulang-js-linux-s390x-gnu/package.json').version
-        if (bindingPackageVersion !== '5.5.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 5.5.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '6.0.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 6.0.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -476,8 +476,8 @@ function requireNative() {
       try {
         const binding = require('@simular-ai/simulang-js-openharmony-arm64')
         const bindingPackageVersion = require('@simular-ai/simulang-js-openharmony-arm64/package.json').version
-        if (bindingPackageVersion !== '5.5.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 5.5.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '6.0.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 6.0.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -492,8 +492,8 @@ function requireNative() {
       try {
         const binding = require('@simular-ai/simulang-js-openharmony-x64')
         const bindingPackageVersion = require('@simular-ai/simulang-js-openharmony-x64/package.json').version
-        if (bindingPackageVersion !== '5.5.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 5.5.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '6.0.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 6.0.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -508,8 +508,8 @@ function requireNative() {
       try {
         const binding = require('@simular-ai/simulang-js-openharmony-arm')
         const bindingPackageVersion = require('@simular-ai/simulang-js-openharmony-arm/package.json').version
-        if (bindingPackageVersion !== '5.5.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 5.5.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '6.0.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 6.0.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -579,6 +579,7 @@ module.exports = nativeBinding
 module.exports.AccessibilityNode = nativeBinding.AccessibilityNode
 module.exports.AccessibilityTree = nativeBinding.AccessibilityTree
 module.exports.App = nativeBinding.App
+module.exports.AskModel = nativeBinding.AskModel
 module.exports.AudioOutput = nativeBinding.AudioOutput
 module.exports.Clipboard = nativeBinding.Clipboard
 module.exports.Directory = nativeBinding.Directory

package/package.json

@@ -1,13 +1,13 @@
 {
   "name": "@simular-ai/simulang-js",
-  "version": "5.5.0",
+  "version": "6.0.1",
   "description": "Node.js bindings for simulang-rs",
-  "main": "index.js",
-  "types": "./index.d.ts",
+  "main": "wrapped.js",
+  "types": "./wrapped.d.ts",
   "exports": {
     ".": {
-      "types": "./index.d.ts",
-      "default": "./index.js"
+      "types": "./wrapped.d.ts",
+      "default": "./wrapped.js"
     }
   },
   "bin": {
@@ -34,6 +34,8 @@
   "files": [
     "index.d.ts",
     "index.js",
+    "wrapped.d.ts",
+    "wrapped.js",
     "CLAUDE.md",
     "bin/init-claude.mjs",
     "bin/postinstall-hint.mjs",
@@ -114,11 +116,11 @@
     "arrowParens": "always"
   },
   "optionalDependencies": {
-    "@simular-ai/simulang-js-win32-x64-msvc": "5.5.0",
-    "@simular-ai/simulang-js-win32-arm64-msvc": "5.5.0",
-    "@simular-ai/simulang-js-darwin-x64": "5.5.0",
-    "@simular-ai/simulang-js-darwin-arm64": "5.5.0",
-    "@simular-ai/simulang-js-linux-x64-gnu": "5.5.0",
-    "@simular-ai/simulang-js-linux-arm64-gnu": "5.5.0"
+    "@simular-ai/simulang-js-win32-x64-msvc": "6.0.1",
+    "@simular-ai/simulang-js-win32-arm64-msvc": "6.0.1",
+    "@simular-ai/simulang-js-darwin-x64": "6.0.1",
+    "@simular-ai/simulang-js-darwin-arm64": "6.0.1",
+    "@simular-ai/simulang-js-linux-x64-gnu": "6.0.1",
+    "@simular-ai/simulang-js-linux-arm64-gnu": "6.0.1"
   }
 }

package/wrapped.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Hand-authored entry that re-exports the napi-generated bindings from
+ * `index.d.ts` and adds the `setPauseHook` API used by
+ * `@simular-ai/simulang-log-viewer` to weave pause-handshake behavior
+ * through every simulang-js call.
+ *
+ * The package's `types` field points here. `index.d.ts` stays as the
+ * napi-rs codegen output (and the source of truth for the public API
+ * surface that auto-docs and Claude skills consume).
+ */
+
+export * from './index'
+
+/**
+ * Register a function to be called synchronously before every
+ * simulang-js method or free function executes. Used by
+ * `@simular-ai/simulang-log-viewer` to make the log window's
+ * pause/grab-hotkey state transparently affect every simulang-js call.
+ * Pass `null` to clear.
+ *
+ * The hook runs on the calling thread, before delegating to the
+ * native binding. It must not call back into simulang-js — that would
+ * recurse.
+ */
+export declare function setPauseHook(fn: (() => void) | null): void

package/wrapped.js

@@ -0,0 +1,139 @@
+// Re-export the napi bindings, but with a global pause hook woven into
+// every callable. Set the hook via `setPauseHook(fn)`; clear with `null`.
+// While set, the hook runs synchronously before every method or
+// free-function call delegates to the native binding — that lets
+// `@simular-ai/simulang-log-viewer` make its grab/pause state apply to
+// every simulang-js call transparently, without forcing user code to
+// switch import paths or add awaits.
+//
+// The package's `main` points here, so `import '@simular-ai/simulang-js'`
+// resolves to this wrapper. The napi-rs codegen still owns `index.js`
+// and `index.d.ts` verbatim — auto-doc and Claude-skill tooling that
+// reads those files keeps working unchanged.
+//
+// Wrapping happens once at module load against `index.js`'s own
+// exports, so any new function or class added to the napi crate is
+// picked up automatically as long as `napi build` emits it through
+// the generated `index.js`.
+
+module.exports = require('./index.js')
+const binding = module.exports
+
+let pauseHook = null
+
+/**
+ * Register a function to call synchronously before every simulang-js
+ * method or free function executes. Pass `null` to clear. The hook
+ * must not call back into simulang-js — that would recurse.
+ */
+function setPauseHook(fn) {
+  pauseHook = typeof fn === 'function' ? fn : null
+}
+
+function wrap(orig) {
+  return function pauseAware(...args) {
+    if (pauseHook) pauseHook()
+    return orig.apply(this, args)
+  }
+}
+
+// Patch instance methods in place on the prototype. napi-rs emits these
+// as writable+configurable properties, so direct assignment works and
+// every existing or future instance — wherever the class is imported
+// from — sees the wrapped method through prototype lookup.
+function patchPrototype(klass) {
+  for (const name of Object.getOwnPropertyNames(klass.prototype)) {
+    if (name === 'constructor') continue
+    const desc = Object.getOwnPropertyDescriptor(klass.prototype, name)
+    // Skip accessor properties (getters/setters): reading a property
+    // shouldn't trigger pause-wait. Only wrap method-valued slots.
+    if (typeof desc?.value !== 'function') continue
+    klass.prototype[name] = wrap(desc.value)
+  }
+}
+
+const RESERVED_STATIC_KEYS = new Set(['length', 'name', 'prototype'])
+
+// Static methods on napi-rs classes are non-writable AND non-configurable,
+// so direct assignment fails and Proxy invariants forbid returning a
+// different value through `get`. We work around it by exporting a thin
+// subclass that redefines the statics as writable properties; the
+// subclass's own prototype chain delegates everything else to the
+// original class.
+//
+// `[Symbol.hasInstance]` is overridden so that instances returned by
+// the underlying napi factories (which carry the original prototype, not
+// the subclass's) still satisfy `inst instanceof WrappedKlass`.
+function wrapStatics(klass) {
+  const statics = []
+  for (const name of Object.getOwnPropertyNames(klass)) {
+    if (RESERVED_STATIC_KEYS.has(name)) continue
+    const desc = Object.getOwnPropertyDescriptor(klass, name)
+    if (typeof desc?.value !== 'function') continue
+    statics.push([name, wrap(desc.value)])
+  }
+  if (statics.length === 0) return klass
+
+  class Wrapped extends klass {
+    static [Symbol.hasInstance](inst) {
+      return inst instanceof klass
+    }
+  }
+  // Plain assignment (`Wrapped[name] = wrapped`) walks the prototype
+  // chain and silently fails when it finds the inherited non-writable
+  // static. defineProperty bypasses the chain and installs an own,
+  // shadowing slot.
+  for (const [name, wrapped] of statics) {
+    Object.defineProperty(Wrapped, name, {
+      value: wrapped,
+      writable: true,
+      configurable: true,
+      enumerable: false,
+    })
+  }
+  // Preserve `name` for stack traces / `toString()` output.
+  Object.defineProperty(Wrapped, 'name', { value: klass.name, configurable: true })
+  return Wrapped
+}
+
+// napi-rs classes carry either instance methods on the prototype (beyond
+// `constructor`) or static methods on the class itself, or both. Plain
+// free function exports have neither. Enums are plain objects.
+//
+// The static-method check has to look for function-VALUED own properties
+// specifically, not just any own property beyond the reserved set: Node
+// 24's `napi_create_function` installs legacy `arguments` and `caller`
+// slots on every napi-emitted function object (Node 25+ does not), and
+// without the function-value filter those would make every free function
+// (`keyFromString`, `ariaRoleToString`, …) misclassify as a class and
+// silently bypass the `wrap(fn)` branch — pause hooks never firing for
+// free-function calls is exactly what that bug looked like.
+function isClass(value) {
+  if (typeof value !== 'function' || !value.prototype) return false
+  if (Object.getOwnPropertyNames(value.prototype).length > 1) return true
+  for (const name of Object.getOwnPropertyNames(value)) {
+    if (RESERVED_STATIC_KEYS.has(name)) continue
+    const desc = Object.getOwnPropertyDescriptor(value, name)
+    if (typeof desc?.value === 'function') return true
+  }
+  return false
+}
+
+for (const key of Object.keys(binding)) {
+  const value = binding[key]
+  if (isClass(value)) {
+    patchPrototype(value)
+    module.exports[key] = wrapStatics(value)
+  } else if (typeof value === 'function') {
+    module.exports[key] = wrap(value)
+  }
+}
+module.exports.setPauseHook = setPauseHook
+
+// Auto-install the stderr logger sink so simulang-rs `log::*!` records
+// (clipboard reads/writes, keyboard input, app launches, window state,
+// etc.) are visible in the terminal as soon as `import
+// '@simular-ai/simulang-js'` evaluates — no explicit `initLogger()` call
+// required. Without this, the `log` crate has no logger registered at
+// all, so every `log::*!` is a silent no-op regardless of `RUST_LOG`.
+binding.initLogger()