@simular-ai/simulang-js 6.0.0 → 6.0.1

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/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
@@ -1266,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 {
@@ -1637,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
@@ -1663,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
@@ -1679,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. */
@@ -1687,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 !== '6.0.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 6.0.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 !== '6.0.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 6.0.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 !== '6.0.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 6.0.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 !== '6.0.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 6.0.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 !== '6.0.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 6.0.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 !== '6.0.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 6.0.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 !== '6.0.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 6.0.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 !== '6.0.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 6.0.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 !== '6.0.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 6.0.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 !== '6.0.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 6.0.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 !== '6.0.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 6.0.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 !== '6.0.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 6.0.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 !== '6.0.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 6.0.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 !== '6.0.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 6.0.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 !== '6.0.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 6.0.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 !== '6.0.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 6.0.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 !== '6.0.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 6.0.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 !== '6.0.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 6.0.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 !== '6.0.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 6.0.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 !== '6.0.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 6.0.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 !== '6.0.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 6.0.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 !== '6.0.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 6.0.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 !== '6.0.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 6.0.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 !== '6.0.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 6.0.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 !== '6.0.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 6.0.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 !== '6.0.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 6.0.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,6 +1,6 @@
 {
   "name": "@simular-ai/simulang-js",
-  "version": "6.0.0",
+  "version": "6.0.1",
   "description": "Node.js bindings for simulang-rs",
   "main": "wrapped.js",
   "types": "./wrapped.d.ts",
@@ -116,11 +116,11 @@
     "arrowParens": "always"
   },
   "optionalDependencies": {
-    "@simular-ai/simulang-js-win32-x64-msvc": "6.0.0",
-    "@simular-ai/simulang-js-win32-arm64-msvc": "6.0.0",
-    "@simular-ai/simulang-js-darwin-x64": "6.0.0",
-    "@simular-ai/simulang-js-darwin-arm64": "6.0.0",
-    "@simular-ai/simulang-js-linux-x64-gnu": "6.0.0",
-    "@simular-ai/simulang-js-linux-arm64-gnu": "6.0.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"
   }
 }