@goliapkg/smix 1.0.27 → 2.1.0

package/README.md

@@ -1,9 +1,33 @@
 # @goliapkg/smix
 
-Playwright-style iOS Simulator + Android emulator UI automation SDK for
-TypeScript / React Native / Expo / Detox-compatible test runners. Brings
-smix's Rust-core selector resolver to TS via HTTP client (production) or
-in-process mock (unit tests), packaged as an ESM Node 20+ module.
+TypeScript types and host-side building blocks for
+[smix](https://github.com/goliajp/smix) — AI-native UI automation for the
+iOS Simulator and Android emulator.
+
+**Live driving runs through the napi addon.** This package ships the same
+typed API surface as the Swift / Kotlin / Rust SDKs; `Smix.launchApp`,
+`App.tap`, `App.fill`, and the rest drive a device by calling into
+`@goliapkg/smix-node`. `Smix.launchApp` loads the per-platform addon
+automatically (via `loadNodeDriver`); the addon is built by a per-triple
+prebuild matrix in CI, and its npm release follows in a later version — you
+can also inject a `NodeDriver` explicitly for tests or a custom transport.
+Three surfaces still throw `SmixNotImplementedError` pending their transport:
+`App.screenshot` and `App.openUrl` need a runner wire route, and
+`App.launchFresh` needs host-side state clearing. To drive a device without
+the addon today, use the [`smix` CLI](https://crates.io/crates/smix-cli) or
+one of the Swift / Kotlin / Rust SDKs.
+
+## What works today
+
+- **Selector DSL** — the full selector language, encoding to the exact
+  JSON wire shape the Rust core resolves.
+- **Session lifecycle** — `Session.open` / `stillValid` / `relaunchApp` /
+  `renewActivation` / `close` against a running smix runner, over HTTP.
+- **`ExpectationFailure`** — parse and produce smix's AI-readable
+  failure JSON.
+- **`A11yNode`** — typed accessibility-tree model with `flatten` /
+  `findById` / `rectCenter` helpers for working with `smix tree --json`
+  output.
 
 ## Installation
 
@@ -13,165 +37,64 @@ bun add -D @goliapkg/smix
 npm install -D @goliapkg/smix
 ```
 
-For test target / Detox-equivalent consumer. This package should only be
-listed in `devDependencies` — never bundled into a production RN/Expo app
-via metro/expo tree-shaking.
+Test-target only: keep it in `devDependencies`, never bundled into a
+production RN / Expo app.
 
-## Quick start (MockSimRuntime — unit tests)
+## Selector
 
 ```typescript
-import { Smix, Selector, literal, MockSimRuntime, MockSelectorResolver, bundleId } from '@goliapkg/smix'
+import { Selector, literal, regex } from '@goliapkg/smix'
 
-const runtime = new MockSimRuntime({ snapshotResult: /* A11yNode tree */ })
-const resolver = new MockSelectorResolver()
-resolver.registerHit('{"id":"btn-login"}', 'btn-login')
-
-const app = await Smix.launchApp(bundleId('com.example.MyApp'), runtime, resolver.resolve)
-await app.tap(Selector.id('btn-login'))
-await app.fill(Selector.id('input-username'), 'alice')
-
-const welcome = app.find(Selector.text(literal('Welcome back')))
-await welcome.toBeVisible({ timeoutMs: 5_000 })
-```
-
-## Production: HTTP runtime
-
-```typescript
-import { Smix, Selector, bundleId, HttpSimRuntime } from '@goliapkg/smix'
-
-// Connects to smix-runner-server running on host (see swift-bridge/SmixRunnerCore)
-const runtime = new HttpSimRuntime('http://localhost:14101')
-
-const app = await Smix.launchApp(bundleId('com.example.MyApp'), runtime, runtime.resolver, runtime.labelsResolver)
-await app.tap(Selector.id('btn-login').below(Selector.text(literal('Sign In'))).nth(0))
-await app.find(Selector.role('button')).toHaveCount(3, { timeoutMs: 5_000 })
-```
-
-HTTP endpoints documented in [`src/HttpRunner.ts`](src/HttpRunner.ts) +
-[Swift server route handler](../../swift-bridge/Sources/SmixRunnerCore/SmixRunnerServer.swift).
-
-## API surface
-
-### Selector
-
-```typescript
-// Base discriminators (untagged JSON wire shape — matches Rust smix-selector)
 Selector.id('btn-login')
 Selector.text(literal('Sign In'))
 Selector.text(regex('^Sub', 'i'))
 Selector.label('Settings')
-Selector.role('button')
 Selector.role('button', literal('Submit'))
-Selector.focused()
-Selector.anchor({ below: Selector.text(literal('Total')) }, { nth: 0 })
 Selector.localizedText({ en: 'Submit', ja: '送信' })
 
-// Fluent modifier chaining (returns new Selector with Modifiers updated)
-Selector.id('btn').below(Selector.text(literal('Address')))
-Selector.label('Edit').nth(0)
-Selector.text(literal('Item')).above(Selector.text(literal('Footer'))).first()
-Selector.role('button').near(Selector.text(literal('Confirm'))).ancestor(Selector.role('dialog'))
+// Fluent modifier chaining (returns a new Selector)
+Selector.id('btn').below(Selector.text(literal('Address'))).nth(0)
+Selector.role('button').near(Selector.text(literal('Confirm')))
 ```
 
-Wire JSON (untagged + flatten — byte-identical to Rust smix-selector):
+Wire JSON (untagged + flattened — byte-identical to Rust `smix-selector`):
 
 ```json
 {"id": "btn-login", "below": {"text": "Address"}, "nth": 0}
 ```
 
-### App (act)
+## Session lifecycle
 
 ```typescript
-await app.tap(selector: Selector, opts?: { timeoutMs?: number })
-await app.fill(selector: Selector, text: string)
-await app.pressKey(key: KeyName)  // 'return' | 'delete' | 'space' | 'tab' | 'escape' | 'enter'
-await app.swipe(direction: SwipeDirection)  // 'up' | 'down' | 'left' | 'right'
-await app.tapAtCoord(nx: number, ny: number)  // 0..1, throws if out-of-range
-await app.terminate()
-await app.relaunch()
-await app.launchFresh({ clearState?: boolean, clearKeychain?: boolean, appPath?: string })
-```
+import { HttpSimRuntime, Session } from '@goliapkg/smix'
 
-### App (sense)
-
-```typescript
-const png: Uint8Array = await app.screenshot()
-const tree: A11yNode = await app.tree()
-const popups: A11yNode[] = await app.systemPopups()
-await app.openUrl('myapp://deep/link')
+const runtime = new HttpSimRuntime('http://127.0.0.1:22087')
+const session = await Session.open(runtime, 'com.example.app')
+await session.relaunchApp()
+await session.close()
 ```
 
-### Locator (assertions)
+`HttpSimRuntime` also exposes `resolver` / `labelsResolver`, which
+resolve a selector against a caller-supplied tree JSON via the runner's
+`/select/resolve` routes.
 
-```typescript
-const loc = app.find(Selector.text(literal('Welcome')))
-await loc.toBeVisible({ timeoutMs: 5_000 })    // polls 250ms
-await loc.toContainText('alice', { timeoutMs: 5_000 })  // substring
-await loc.toHaveLabel('Sign In', { timeoutMs: 5_000 })  // strict equal
-await loc.toHaveCount(3, { timeoutMs: 5_000 })  // exact match count
-```
-
-### ExpectationFailure (AI-readable JSON)
+## ExpectationFailure
 
 ```typescript
+import { ExpectationFailure } from '@goliapkg/smix'
+
 try {
-  await app.tap(Selector.id('btn-missing'))
+  // a driving call, once the native transport lands
 } catch (e) {
   if (e instanceof ExpectationFailure) {
-    e.code              // 'notFound' | 'ambiguous' | 'notInteractable' | 'timeout' | 'wrongState' | 'unknown'
-    e.message           // human-readable
-    e.selectorJson      // original Selector encoded as JSON
-    e.visibleElements   // A11yNode[] — first 20 nodes from current tree
-    e.suggestions       // string[] — ['check accessibilityIdentifier...', ...]
-    e.toJson()          // single-line sorted-keys JSON for AI agent consumption
+    e.code            // 'ELEMENT_NOT_FOUND' | 'AMBIGUOUS' | 'TIMEOUT' | ...
+    e.visibleElements // A11yNode[] — context for AI diagnosis
+    e.suggestions     // string[]
+    e.toJson()        // single-line JSON for agent consumption
   }
 }
 ```
 
-## Demos
-
-Run any of the realistic e2e flows in [`examples/demo-app/`](examples/demo-app):
-
-```bash
-cd examples/demo-app
-bun login-flow.ts             # login + welcome assertion
-bun form-validation-flow.ts   # 3-cycle form validation + inline errors
-bun list-scroll-flow.ts       # scrollable list + toHaveCount semantics
-bun multi-screen-nav-flow.ts  # nav + tapAtCoord + openUrl + relaunch
-```
-
-See [`examples/demo-app/COVERAGE.md`](examples/demo-app/COVERAGE.md) for the
-SDK surface coverage matrix across demos.
-
-## Conformance
-
-Cross-binary harness verifies SDK output byte-identical to Rust:
-
-```bash
-bash ../../scripts/sdk/run-cross-binary-harness.sh
-# Summary: 24 / 24 fixtures byte-identical (Rust + Swift + TS)
-```
-
-## Test-target-only
-
-`@goliapkg/smix` is intended for `devDependencies` only — never bundled
-into a production RN/Expo app. `metro`/`expo`'s tree-shaking guarantees
-the production bundle excludes it. The `HttpSimRuntime` connects to a
-smix-runner-server running on the host (via `127.0.0.1:port` loopback),
-not in-process.
-
-## Architecture
-
-- **Rust stone core** (`crates/smix-{selector,selector-resolver,screen,error}`):
-  selector resolution + AI-readable failure types, shared across all
-  language SDKs.
-- **HTTP runtime** (`src/HttpRunner.ts`): wraps fetch to smix-runner-server
-  on the host. Production-default.
-- **Mock runtime** (`src/SimRuntime.ts MockSimRuntime`): in-memory tree +
-  event log. Used by vitest unit tests + demo flows.
-- **SDK facade** (`src/{Smix,App,Selector,Modifiers,Locator,ExpectationFailure}.ts`):
-  Playwright-style ergonomic surface, class-based fluent chaining.
-
 ## License
 
 Apache-2.0 OR MIT (dual, at your option).

package/dist/A11yNode.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"A11yNode.d.ts","sourceRoot":"","sources":["../src/A11yNode.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,IAAI;IACnB,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,EAAE,MAAM,CAAA;CACV;AAED,wBAAgB,UAAU,CAAC,CAAC,EAAE,IAAI,GAAG;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAE5D;AAED,MAAM,MAAM,QAAQ,GAChB,QAAQ,GAAG,MAAM,GAAG,WAAW,GAAG,iBAAiB,GAAG,aAAa,GACnE,QAAQ,GAAG,QAAQ,GAAG,UAAU,GAAG,OAAO,GAAG,OAAO,GAAG,YAAY,GACnE,KAAK,GAAG,QAAQ,GAAG,eAAe,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,GAChE,QAAQ,GAAG,aAAa,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAU,GACzD,YAAY,GAAG,kBAAkB,GAAG,OAAO,GAAG,gBAAgB,GAC9D,SAAS,GAAG,UAAU,CAAA;AAE1B,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAA;IAC3B,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC/B,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC1B,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC1B,gBAAgB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACrC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC1B,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACzB,MAAM,EAAE,IAAI,CAAA;IACZ,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;IAC7B,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;IAC9B,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;IAC9B,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;IAC7B,QAAQ,CAAC,EAAE,QAAQ,EAAE,GAAG,SAAS,CAAA;CAClC;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,CAOpE;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,QAAQ,GAAG,QAAQ,EAAE,CAMlD"}
+{"version":3,"file":"A11yNode.d.ts","sourceRoot":"","sources":["../src/A11yNode.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,IAAI;IACnB,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,EAAE,MAAM,CAAA;CACV;AAED,wBAAgB,UAAU,CAAC,CAAC,EAAE,IAAI,GAAG;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAE5D;AAED,MAAM,MAAM,QAAQ,GAChB,QAAQ,GAAG,MAAM,GAAG,WAAW,GAAG,iBAAiB,GAAG,aAAa,GACnE,QAAQ,GAAG,QAAQ,GAAG,UAAU,GAAG,OAAO,GAAG,OAAO,GAAG,YAAY,GACnE,KAAK,GAAG,QAAQ,GAAG,eAAe,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,GAChE,QAAQ,GAAG,aAAa,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAU,GACzD,YAAY,GAAG,kBAAkB,GAAG,OAAO,GAAG,gBAAgB,GAC9D,SAAS,GAAG,UAAU,CAAA;AAE1B,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAA;IAC3B,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC/B,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC1B,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC1B,gBAAgB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACrC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC1B,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACzB,MAAM,EAAE,IAAI,CAAA;IACZ,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;IAC7B,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;IAC9B,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;IAC9B,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;IAC7B,QAAQ,CAAC,EAAE,QAAQ,EAAE,GAAG,SAAS,CAAA;CAClC;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,CAOpE;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,QAAQ,GAAG,QAAQ,EAAE,CAMlD"}

package/dist/A11yNode.js

@@ -1,6 +1,5 @@
-// v7.5 c1 — A11yNode + Rect mirror Rust smix-screen A11yNode +
-// Swift v7.2 + Kotlin v7.4 A11yNode. CamelCase wire keys match
-// Rust `#[serde(rename_all = "camelCase")]`.
+// The wire form of `smix-screen`'s types. The camelCase keys are the
+// contract with the runner, not a local style choice.
 export function rectCenter(r) {
     return { x: r.x + r.w / 2, y: r.y + r.h / 2 };
 }

package/dist/A11yNode.js.map

@@ -1 +1 @@
-{"version":3,"file":"A11yNode.js","sourceRoot":"","sources":["../src/A11yNode.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,+DAA+D;AAC/D,6CAA6C;AAS7C,MAAM,UAAU,UAAU,CAAC,CAAO;IAChC,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAA;AAC/C,CAAC;AA2BD;;GAEG;AACH,MAAM,UAAU,QAAQ,CAAC,IAAc,EAAE,EAAU;IACjD,IAAI,IAAI,CAAC,UAAU,KAAK,EAAE;QAAE,OAAO,IAAI,CAAA;IACvC,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,QAAQ,IAAI,EAAE,EAAE,CAAC;QACxC,MAAM,GAAG,GAAG,QAAQ,CAAC,KAAK,EAAE,EAAE,CAAC,CAAA;QAC/B,IAAI,GAAG,KAAK,IAAI;YAAE,OAAO,GAAG,CAAA;IAC9B,CAAC;IACD,OAAO,IAAI,CAAA;AACb,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,OAAO,CAAC,IAAc;IACpC,MAAM,GAAG,GAAe,CAAC,IAAI,CAAC,CAAA;IAC9B,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,QAAQ,IAAI,EAAE,EAAE,CAAC;QACxC,GAAG,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,CAAA;IAC7B,CAAC;IACD,OAAO,GAAG,CAAA;AACZ,CAAC"}
+{"version":3,"file":"A11yNode.js","sourceRoot":"","sources":["../src/A11yNode.ts"],"names":[],"mappings":"AAAA,qEAAqE;AACrE,sDAAsD;AAStD,MAAM,UAAU,UAAU,CAAC,CAAO;IAChC,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAA;AAC/C,CAAC;AA2BD;;GAEG;AACH,MAAM,UAAU,QAAQ,CAAC,IAAc,EAAE,EAAU;IACjD,IAAI,IAAI,CAAC,UAAU,KAAK,EAAE;QAAE,OAAO,IAAI,CAAA;IACvC,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,QAAQ,IAAI,EAAE,EAAE,CAAC;QACxC,MAAM,GAAG,GAAG,QAAQ,CAAC,KAAK,EAAE,EAAE,CAAC,CAAA;QAC/B,IAAI,GAAG,KAAK,IAAI;YAAE,OAAO,GAAG,CAAA;IAC9B,CAAC;IACD,OAAO,IAAI,CAAA;AACb,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,OAAO,CAAC,IAAc;IACpC,MAAM,GAAG,GAAe,CAAC,IAAI,CAAC,CAAA;IAC9B,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,QAAQ,IAAI,EAAE,EAAE,CAAC;QACxC,GAAG,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,CAAA;IAC7B,CAAC;IACD,OAAO,GAAG,CAAA;AACZ,CAAC"}

package/dist/App.d.ts

@@ -1,57 +1,72 @@
 import { type A11yNode } from './A11yNode.js';
 import { Locator, SmixNotImplementedError } from './Locator.js';
+import type { NodeDriver, NodeSession } from './NodeDriver.js';
 import { type Selector } from './Selector.js';
-import { type KeyName, type SmixSimRuntime, type SwipeDirection } from './SimRuntime.js';
 import type { LabelsResolver, SelectorResolver } from './SelectorResolver.js';
+import type { SystemPopup } from './SystemPopup.js';
+type KeyName = 'return' | 'delete' | 'space' | 'tab' | 'escape' | 'enter';
+type SwipeDirection = 'up' | 'down' | 'left' | 'right';
 /**
  * A handle to a running app on the simulator / emulator.
  */
 export declare class App {
     readonly bundleId: string;
-    readonly runtime: SmixSimRuntime;
+    /** The napi driver (act + sense); a mock in tests, the real addon in prod. */
+    readonly driver: NodeDriver;
+    /** The napi session this app was launched in (lifecycle verbs). */
+    readonly session: NodeSession;
     readonly resolver: SelectorResolver;
     /**
-     * v7.6 c1 — wraps Rust `resolve_selector_labels` (each match's
-     * `.label`). Used by Locator.toHaveCount + toHaveLabel. Defaults
-     * to a stub that throws — tests + production should pass a real
-     * impl (HttpSimRuntime.labelsResolver or MockLabelsResolver.resolve).
+     * Wraps `resolve_selector_labels`, backing toHaveCount and
+     * toHaveLabel. The default throws rather than guessing: there is no
+     * sensible answer without a resolver, and a silent empty list would
+     * read as "no matches".
      */
     readonly labelsResolver: LabelsResolver;
-    constructor(bundleId: string, runtime: SmixSimRuntime, resolver: SelectorResolver, 
+    constructor(bundleId: string, 
+    /** The napi driver (act + sense); a mock in tests, the real addon in prod. */
+    driver: NodeDriver, 
+    /** The napi session this app was launched in (lifecycle verbs). */
+    session: NodeSession, resolver: SelectorResolver, 
     /**
-     * v7.6 c1 — wraps Rust `resolve_selector_labels` (each match's
-     * `.label`). Used by Locator.toHaveCount + toHaveLabel. Defaults
-     * to a stub that throws — tests + production should pass a real
-     * impl (HttpSimRuntime.labelsResolver or MockLabelsResolver.resolve).
+     * Wraps `resolve_selector_labels`, backing toHaveCount and
+     * toHaveLabel. The default throws rather than guessing: there is no
+     * sensible answer without a resolver, and a silent empty list would
+     * read as "no matches".
      */
     labelsResolver?: LabelsResolver);
+    /**
+     * Snapshot the tree, resolve `selector` against it, and return the first
+     * matching id. Selectors resolve to an id on this side; only the id crosses
+     * the napi boundary. No match throws ELEMENT_NOT_FOUND with the visible
+     * elements so the failure is AI-readable.
+     */
+    private resolveFirstOrThrow;
     tap(selector: Selector, _opts?: {
         timeoutMs?: number;
     }): Promise<void>;
-    /**
-     * Resolve [selector], tap to focus, then type [text]. Mirror
-     * Kotlin App.fill from v7.4 c3.
-     */
     fill(selector: Selector, text: string): Promise<void>;
     pressKey(key: KeyName): Promise<void>;
     swipe(direction: SwipeDirection): Promise<void>;
     screenshot(): Promise<Uint8Array>;
-    /**
-     * Tap at a normalized coordinate (0..1) — escape hatch per §9 #3.
-     * Out-of-range values throw ExpectationFailure code=wrongState.
-     */
+    /** Tap at a normalized coordinate (0..1) — escape hatch per §9 #3. */
     tapAtCoord(nx: number, ny: number): Promise<void>;
     terminate(): Promise<void>;
     relaunch(): Promise<void>;
-    launchFresh(opts?: {
+    launchFresh(_opts?: {
         clearState?: boolean;
         clearKeychain?: boolean;
         appPath?: string;
     }): Promise<void>;
     find(selector: Selector): Locator;
+    /**
+     * The tree seam Locator polls. Pending napi: without an FFI path there is
+     * no live simulator to snapshot. Lands with the napi axis.
+     */
+    snapshotTree(): Promise<A11yNode>;
     tree(): Promise<A11yNode>;
-    systemPopups(): Promise<A11yNode[]>;
-    openUrl(url: string): Promise<void>;
+    systemPopups(): Promise<SystemPopup[]>;
+    openUrl(_url: string): Promise<void>;
 }
 export { SmixNotImplementedError };
 //# sourceMappingURL=App.d.ts.map

package/dist/App.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"App.d.ts","sourceRoot":"","sources":["../src/App.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,QAAQ,EAAqB,MAAM,eAAe,CAAA;AAEhE,OAAO,EAAE,OAAO,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAA;AAC/D,OAAO,EAEL,KAAK,QAAQ,EACd,MAAM,eAAe,CAAA;AACtB,OAAO,EACL,KAAK,OAAO,EACZ,KAAK,cAAc,EACnB,KAAK,cAAc,EACpB,MAAM,iBAAiB,CAAA;AACxB,OAAO,KAAK,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AAE7E;;GAEG;AACH,qBAAa,GAAG;aAEI,QAAQ,EAAE,MAAM;aAChB,OAAO,EAAE,cAAc;aACvB,QAAQ,EAAE,gBAAgB;IAC1C;;;;;OAKG;aACa,cAAc,EAAE,cAAc;gBAT9B,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,cAAc,EACvB,QAAQ,EAAE,gBAAgB;IAC1C;;;;;OAKG;IACa,cAAc,GAAE,cAE/B;IAKG,GAAG,CAAC,QAAQ,EAAE,QAAQ,EAAE,KAAK,GAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAsChF;;;OAGG;IACG,IAAI,CAAC,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKrD,QAAQ,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAIrC,KAAK,CAAC,SAAS,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAI/C,UAAU,IAAI,OAAO,CAAC,UAAU,CAAC;IAIvC;;;OAGG;IACG,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAWjD,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAI1B,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAKzB,WAAW,CAAC,IAAI,GAAE;QACtB,UAAU,CAAC,EAAE,OAAO,CAAA;QACpB,aAAa,CAAC,EAAE,OAAO,CAAA;QACvB,OAAO,CAAC,EAAE,MAAM,CAAA;KACZ,GAAG,OAAO,CAAC,IAAI,CAAC;IAWtB,IAAI,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO;IAI3B,IAAI,IAAI,OAAO,CAAC,QAAQ,CAAC;IAIzB,YAAY,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;IAInC,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAG1C;AAED,OAAO,EAAE,uBAAuB,EAAE,CAAA"}
+{"version":3,"file":"App.d.ts","sourceRoot":"","sources":["../src/App.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,KAAK,QAAQ,EAAW,MAAM,eAAe,CAAA;AAEtD,OAAO,EAAE,OAAO,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAA;AAC/D,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAC9D,OAAO,EAAE,KAAK,QAAQ,EAAsB,MAAM,eAAe,CAAA;AACjE,OAAO,KAAK,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AAC7E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAEnD,KAAK,OAAO,GAAG,QAAQ,GAAG,QAAQ,GAAG,OAAO,GAAG,KAAK,GAAG,QAAQ,GAAG,OAAO,CAAA;AACzE,KAAK,cAAc,GAAG,IAAI,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAA;AAEtD;;GAEG;AACH,qBAAa,GAAG;aAEI,QAAQ,EAAE,MAAM;IAChC,8EAA8E;aAC9D,MAAM,EAAE,UAAU;IAClC,mEAAmE;aACnD,OAAO,EAAE,WAAW;aACpB,QAAQ,EAAE,gBAAgB;IAC1C;;;;;OAKG;aACa,cAAc,EAAE,cAAc;gBAZ9B,QAAQ,EAAE,MAAM;IAChC,8EAA8E;IAC9D,MAAM,EAAE,UAAU;IAClC,mEAAmE;IACnD,OAAO,EAAE,WAAW,EACpB,QAAQ,EAAE,gBAAgB;IAC1C;;;;;OAKG;IACa,cAAc,GAAE,cAE/B;IAKH;;;;;OAKG;YACW,mBAAmB;IAiB3B,GAAG,CAAC,QAAQ,EAAE,QAAQ,EAAE,KAAK,GAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAI1E,IAAI,CAAC,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAMrD,QAAQ,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAIrC,KAAK,CAAC,SAAS,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAI/C,UAAU,IAAI,OAAO,CAAC,UAAU,CAAC;IAMvC,sEAAsE;IAChE,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAUjD,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAI1B,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAIzB,WAAW,CAAC,KAAK,GAAE;QACvB,UAAU,CAAC,EAAE,OAAO,CAAA;QACpB,aAAa,CAAC,EAAE,OAAO,CAAA;QACvB,OAAO,CAAC,EAAE,MAAM,CAAA;KACZ,GAAG,OAAO,CAAC,IAAI,CAAC;IAStB,IAAI,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO;IAIjC;;;OAGG;IACG,YAAY,IAAI,OAAO,CAAC,QAAQ,CAAC;IAIjC,IAAI,IAAI,OAAO,CAAC,QAAQ,CAAC;IAIzB,YAAY,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;IAItC,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAK3C;AAED,OAAO,EAAE,uBAAuB,EAAE,CAAA"}

package/dist/App.js

@@ -1,122 +1,128 @@
-// v7.5 c3 — App class full wire mirrors Kotlin v7.4 c5 / Swift v7.2.
-import { findById, flatten } from './A11yNode.js';
+// A handle to a running app. Live driving (tap/fill/swipe/...) and live
+// sense (snapshotTree) are pending the napi axis: the TS SDK has no FFI
+// path, so with the fictional HTTP wire deleted there is no way to reach a
+// simulator from here yet. These methods throw SmixNotImplementedError
+// rather than posting to a route the runner never served. What does work is
+// the resolver seam: given a treeJson, `resolver` / `labelsResolver` resolve
+// selectors against the runner's served /select/resolve* routes.
+import { flatten } from './A11yNode.js';
 import { ExpectationFailure } from './ExpectationFailure.js';
 import { Locator, SmixNotImplementedError } from './Locator.js';
-import { encodeSelectorJson, } from './Selector.js';
+import { encodeSelectorJson } from './Selector.js';
 /**
  * A handle to a running app on the simulator / emulator.
  */
 export class App {
     bundleId;
-    runtime;
+    driver;
+    session;
     resolver;
     labelsResolver;
-    constructor(bundleId, runtime, resolver, 
+    constructor(bundleId, 
+    /** The napi driver (act + sense); a mock in tests, the real addon in prod. */
+    driver, 
+    /** The napi session this app was launched in (lifecycle verbs). */
+    session, resolver, 
     /**
-     * v7.6 c1 — wraps Rust `resolve_selector_labels` (each match's
-     * `.label`). Used by Locator.toHaveCount + toHaveLabel. Defaults
-     * to a stub that throws — tests + production should pass a real
-     * impl (HttpSimRuntime.labelsResolver or MockLabelsResolver.resolve).
+     * Wraps `resolve_selector_labels`, backing toHaveCount and
+     * toHaveLabel. The default throws rather than guessing: there is no
+     * sensible answer without a resolver, and a silent empty list would
+     * read as "no matches".
      */
     labelsResolver = async () => {
         throw new Error('labelsResolver not configured; pass one to Smix.launchApp or App constructor');
     }) {
         this.bundleId = bundleId;
-        this.runtime = runtime;
+        this.driver = driver;
+        this.session = session;
         this.resolver = resolver;
         this.labelsResolver = labelsResolver;
     }
     // ---- act methods --------------------------------------------------
-    async tap(selector, _opts = {}) {
-        const tree = await this.runtime.snapshotTree();
+    /**
+     * Snapshot the tree, resolve `selector` against it, and return the first
+     * matching id. Selectors resolve to an id on this side; only the id crosses
+     * the napi boundary. No match throws ELEMENT_NOT_FOUND with the visible
+     * elements so the failure is AI-readable.
+     */
+    async resolveFirstOrThrow(selector) {
+        const treeJson = await this.driver.snapshotTree();
         const selectorJson = encodeSelectorJson(selector);
-        const treeJson = JSON.stringify(tree);
-        let matches;
-        try {
-            matches = await this.resolver(treeJson, selectorJson);
-        }
-        catch (e) {
-            const msg = e instanceof Error ? e.message : String(e);
+        const ids = await this.resolver(treeJson, selectorJson);
+        const first = ids[0];
+        if (first === undefined) {
+            const tree = JSON.parse(treeJson);
             throw new ExpectationFailure({
-                code: 'unknown',
-                message: `FFI resolveSelector raised: ${msg}`,
-                selectorJson,
-            });
-        }
-        const firstId = matches[0];
-        const node = firstId !== undefined ? findById(tree, firstId) : null;
-        if (node === null) {
-            throw new ExpectationFailure({
-                code: 'notFound',
-                message: 'no candidates after spatial + index filters',
+                code: 'ELEMENT_NOT_FOUND',
+                message: `no element matched selector ${selectorJson}`,
                 selectorJson,
                 visibleElements: flatten(tree).slice(0, 20),
-                suggestions: [
-                    'check `accessibilityIdentifier` is set on the target view',
-                    'consider relaxing to text(...) if the label is more stable than the id',
-                ],
             });
         }
-        await this.runtime.synthesizeTap(node.bounds.x + node.bounds.w / 2, node.bounds.y + node.bounds.h / 2);
+        return first;
+    }
+    async tap(selector, _opts = {}) {
+        await this.driver.tapById(await this.resolveFirstOrThrow(selector));
     }
-    /**
-     * Resolve [selector], tap to focus, then type [text]. Mirror
-     * Kotlin App.fill from v7.4 c3.
-     */
     async fill(selector, text) {
-        await this.tap(selector);
-        await this.runtime.sendString(text);
+        const id = await this.resolveFirstOrThrow(selector);
+        await this.driver.tapById(id);
+        await this.driver.inputText(text);
     }
     async pressKey(key) {
-        await this.runtime.pressKey(key);
+        await this.driver.pressKey(key === 'enter' ? 'return' : key);
     }
     async swipe(direction) {
-        await this.runtime.swipe(direction);
+        await this.driver.swipe(direction);
     }
     async screenshot() {
-        return this.runtime.screenshot();
+        // No runner wire route yet — singled out to a later checkpoint (v2.md
+        // decision, 2026-07-24). The blocker is the wire, not napi.
+        throw new SmixNotImplementedError('wire', 'App.screenshot');
     }
-    /**
-     * Tap at a normalized coordinate (0..1) — escape hatch per §9 #3.
-     * Out-of-range values throw ExpectationFailure code=wrongState.
-     */
+    /** Tap at a normalized coordinate (0..1) — escape hatch per §9 #3. */
     async tapAtCoord(nx, ny) {
         if (nx < 0 || nx > 1 || ny < 0 || ny > 1) {
             throw new ExpectationFailure({
-                code: 'wrongState',
-                message: `tapAtCoord arguments out of [0,1] range: nx=${nx}, ny=${ny}`,
-                suggestions: ['use normalized 0..1 — for raw points, divide by viewport size'],
+                code: 'ASSERTION_FAILED',
+                message: `tapAtCoord expects normalized 0..1 coordinates, got (${nx}, ${ny})`,
             });
         }
-        await this.runtime.synthesizeTapAtNormalized(nx, ny);
+        await this.driver.tapAtCoord(nx, ny);
     }
     async terminate() {
-        await this.runtime.terminate(this.bundleId);
+        await this.session.terminateApp();
     }
     async relaunch() {
-        await this.runtime.terminate(this.bundleId);
-        await this.runtime.launch(this.bundleId);
+        await this.session.relaunchApp();
     }
-    async launchFresh(opts = {}) {
-        await this.runtime.launchFresh({
-            bundleId: this.bundleId,
-            clearState: opts.clearState ?? false,
-            clearKeychain: opts.clearKeychain ?? false,
-            appPath: opts.appPath,
-        });
+    async launchFresh(_opts = {}) {
+        // Clearing state / installing an appPath is host-side (simctl), with no
+        // runner wire — singled out to a later checkpoint. The blocker is the
+        // host, not napi.
+        throw new SmixNotImplementedError('host', 'App.launchFresh');
     }
     // ---- sense methods ------------------------------------------------
     find(selector) {
         return new Locator(this, selector);
     }
+    /**
+     * The tree seam Locator polls. Pending napi: without an FFI path there is
+     * no live simulator to snapshot. Lands with the napi axis.
+     */
+    async snapshotTree() {
+        return JSON.parse(await this.driver.snapshotTree());
+    }
     async tree() {
-        return this.runtime.snapshotTree();
+        return this.snapshotTree();
     }
     async systemPopups() {
-        return this.runtime.systemPopups();
+        return JSON.parse(await this.driver.systemPopups());
     }
-    async openUrl(url) {
-        await this.runtime.openUrl(url);
+    async openUrl(_url) {
+        // No runner wire route yet — singled out to a later checkpoint. The
+        // blocker is the wire, not napi.
+        throw new SmixNotImplementedError('wire', 'App.openUrl');
     }
 }
 export { SmixNotImplementedError };

package/dist/App.js.map

@@ -1 +1 @@
-{"version":3,"file":"App.js","sourceRoot":"","sources":["../src/App.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"App.js","sourceRoot":"","sources":["../src/App.ts"],"names":[],"mappings":"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"}

package/dist/ExpectationFailure.d.ts

@@ -1,5 +1,12 @@
 import type { A11yNode } from './A11yNode.js';
-export type FailureCode = 'notFound' | 'ambiguous' | 'notInteractable' | 'timeout' | 'wrongState' | 'unknown';
+/**
+ * Rust `smix_error::FailureCode`'s wire strings verbatim —
+ * `crates/smix-error/tests/sdk_failure_code_parity.rs` reads this
+ * declaration and fails if the two sets ever diverge.
+ */
+export type FailureCode = 'ELEMENT_NOT_FOUND' | 'NOT_VISIBLE' | 'NOT_ENABLED' | 'AMBIGUOUS' | 'TIMEOUT' | 'ASSERTION_FAILED' | 'APP_NOT_RUNNING' | 'SIMULATOR_NOT_BOOTED'
+/** The touch was synthesised, and it did not land inside the element the selector matched. Distinct from element-not-found: not-found means fix the selector, missed means the element was there and the touch went elsewhere. */
+ | 'TAP_MISSED' | 'DRIVER_ERROR';
 export declare const FAILURE_CODES: readonly FailureCode[];
 /**
  * Structured failure thrown by SDK resolver paths (App.tap, Locator

package/dist/ExpectationFailure.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ExpectationFailure.d.ts","sourceRoot":"","sources":["../src/ExpectationFailure.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAE7C,MAAM,MAAM,WAAW,GACnB,UAAU,GACV,WAAW,GACX,iBAAiB,GACjB,SAAS,GACT,YAAY,GACZ,SAAS,CAAA;AAEb,eAAO,MAAM,aAAa,EAAE,SAAS,WAAW,EAGtC,CAAA;AAEV;;;;GAIG;AACH,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAA;IAC1B,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAA;IACpC,QAAQ,CAAC,eAAe,EAAE,SAAS,QAAQ,EAAE,CAAA;IAC7C,QAAQ,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAA;IACvC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;gBAEd,IAAI,EAAE;QAChB,IAAI,EAAE,WAAW,CAAA;QACjB,OAAO,EAAE,MAAM,CAAA;QACf,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;QACjC,eAAe,CAAC,EAAE,SAAS,QAAQ,EAAE,GAAG,SAAS,CAAA;QACjD,WAAW,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAA;QAC3C,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;KAC/B;IAUD;;;;OAIG;IACH,MAAM,IAAI,MAAM;CAUjB"}
+{"version":3,"file":"ExpectationFailure.d.ts","sourceRoot":"","sources":["../src/ExpectationFailure.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAE7C;;;;GAIG;AACH,MAAM,MAAM,WAAW,GACnB,mBAAmB,GACnB,aAAa,GACb,aAAa,GACb,WAAW,GACX,SAAS,GACT,kBAAkB,GAClB,iBAAiB,GACjB,sBAAsB;AACxB,kOAAkO;GAChO,YAAY,GACZ,cAAc,CAAA;AAElB,eAAO,MAAM,aAAa,EAAE,SAAS,WAAW,EAItC,CAAA;AAEV;;;;GAIG;AACH,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAA;IAC1B,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAA;IACpC,QAAQ,CAAC,eAAe,EAAE,SAAS,QAAQ,EAAE,CAAA;IAC7C,QAAQ,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAA;IACvC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;gBAEd,IAAI,EAAE;QAChB,IAAI,EAAE,WAAW,CAAA;QACjB,OAAO,EAAE,MAAM,CAAA;QACf,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;QACjC,eAAe,CAAC,EAAE,SAAS,QAAQ,EAAE,GAAG,SAAS,CAAA;QACjD,WAAW,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAA;QAC3C,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;KAC/B;IAUD;;;;OAIG;IACH,MAAM,IAAI,MAAM;CAUjB"}

package/dist/ExpectationFailure.js

@@ -1,12 +1,12 @@
-// v7.5 c1 — ExpectationFailure + FailureCode mirror Swift v7.2 c4 +
-// Kotlin v7.4 c1 + Rust smix-error.
+// The wire form of `smix-error`'s failure surface.
 //
-// AI-readable JSON contract: toJson() emits sorted-keys, ISO-8601
-// timestamp single-line JSON matching Swift errorDescription contract
-// (per design.md §9 #11).
+// toJson() emits sorted keys and an ISO-8601 timestamp on one line. Every
+// SDK emits the same bytes for the same failure, so a reader — human or
+// model — sees one format whichever language raised it.
 export const FAILURE_CODES = [
-    'notFound', 'ambiguous', 'notInteractable',
-    'timeout', 'wrongState', 'unknown',
+    'ELEMENT_NOT_FOUND', 'NOT_VISIBLE', 'NOT_ENABLED',
+    'AMBIGUOUS', 'TIMEOUT', 'ASSERTION_FAILED',
+    'APP_NOT_RUNNING', 'SIMULATOR_NOT_BOOTED', 'TAP_MISSED', 'DRIVER_ERROR',
 ];
 /**
  * Structured failure thrown by SDK resolver paths (App.tap, Locator