@ansight/react-native 1.4.0-preview.5 → 1.5.0

package/README.md

@@ -1,6 +1,14 @@
 # @ansight/react-native
 
-React Native bridge for the Ansight mobile SDK.
+Ansight gives coding agents the runtime evidence to verify their own work in
+React Native and Expo development builds. The SDK captures screenshots, visual trees, touches, logs,
+crashes and unhandled errors, HTTP requests, screen views and navigation, lifecycle events, app events, custom metrics, and sampled memory,
+FPS, frame timing, and battery while the app runs, and exposes app state,
+preferences, secure storage, files, SQLite, artifacts, and your own custom
+tools through guarded remote tools on request. Your agent reads all of it
+through the `ansight` CLI. Nothing leaves your machine unless you export or
+share it. See https://www.ansight.ai and the
+[getting started guide](https://www.ansight.ai/docs/getting-started).
 
 The package is intentionally thin: pairing, transport, telemetry, screen
 capture, touch capture, native tool discovery, and native tool execution are
@@ -80,8 +88,8 @@ bundle; its API requires the native Ansight module.
 
 This package version expects matching native SDK packages:
 
-- CocoaPods: `Ansight`, `AnsightObjC` version `1.4.0-preview.5`
-- Maven: `ai.ansight:ansight-android:1.4.0-preview.5`
+- CocoaPods: `Ansight`, `AnsightObjC` version `1.5.0`
+- Maven: `ai.ansight:ansight-android:1.5.0`
 
 ## Quickstart
 
@@ -144,9 +152,9 @@ where reconnects should only happen after an explicit app action.
 > max-width settings, and disable `sessionJpegCapture` for performance-focused
 > runs unless visual evidence is required.
 
-For simulator/emulator sessions, Studio can acknowledge the native
+For simulator/emulator sessions, host can acknowledge the native
 `device.profile` with host screenshot mode. The native SDK then suspends
-periodic in-app JPEG capture for that session so Studio can use a host-side
+periodic in-app JPEG capture for that session so host can use a host-side
 source such as `simctl` or `adb`.
 
 ## Options
@@ -156,7 +164,7 @@ The TypeScript `AnsightOptions` surface mirrors Android `AnsightOptions`, iOS
 
 | Option | Purpose |
 | --- | --- |
-| `useNativeAllInOneDefaults` | Applies native iOS/Android all-in-one defaults when true. Defaults to false. This enables the native visual-tree/screenshot tools required by Studio visual tree inspection unless `remoteTools.visualTree` is explicitly false. Configure `toolGuard`, capture options, and `hostConnection` separately. |
+| `useNativeAllInOneDefaults` | Applies native iOS/Android all-in-one defaults when true. Defaults to false. This enables the native visual-tree/screenshot tools required by host visual tree inspection unless `remoteTools.visualTree` is explicitly false. Configure `toolGuard`, capture options, and `hostConnection` separately. |
 | `clientName` | Default client name for host auto-probe and connections. |
 | `sampleFrequencyMilliseconds` | Built-in telemetry sampling interval. |
 | `retentionPeriodSeconds` | Local metric/event retention window. |
@@ -273,7 +281,7 @@ app-side policy for inspection or testing.
 
 ## Native Tool Options
 
-`remoteTools` configures the native tool suites registered by the bridge. `useNativeAllInOneDefaults: true` enables visual tree tools by default so Studio can pair `ui.get_visual_tree` data with `ui.get_screenshot` frames. Apps that do not use all-in-one defaults can opt in explicitly:
+`remoteTools` configures the native tool suites registered by the bridge. `useNativeAllInOneDefaults: true` enables visual tree tools by default so host can pair `ui.get_visual_tree` data with `ui.get_screenshot` frames. Apps that do not use all-in-one defaults can opt in explicitly:
 
 ```ts
 await Ansight.initializeAndActivate(
@@ -472,7 +480,7 @@ locale; if the app selects a different language through an i18n library, set
 
 ## JavaScript Tools
 
-Custom JavaScript tools can be exposed to Ansight Studio:
+Custom JavaScript tools can be exposed to Ansight host:
 
 ```ts
 const registration = Ansight.registerTool(
@@ -547,7 +555,7 @@ await reportProvider.ready;
 The first provider installs the `read` policy `artifacts.query` and
 `artifacts.request` JavaScript tools in the native registry. A provider can
 return text, base64, byte arrays, `ArrayBuffer`, or `Uint8Array`. Artifact
-requests require a live Studio tool call; the bridge forwards the returned
+requests require a live host tool call; the bridge forwards the returned
 bytes through the native binary-transfer channel. Call
 `reportProvider.unregister()` during teardown or hot-reload cleanup.
 
@@ -670,5 +678,9 @@ The current-Expo validation app lives in:
 
 It is pinned to Expo SDK 57 and React Native 0.86 with the New Architecture and
 Hermes enabled. It validates Expo CNG/autolinking, the bundled config plugin,
-Android and iOS native builds, and the same live Studio feature surface as the
+Android and iOS native builds, and the same live host feature surface as the
 baseline harness.
+
+## Purchase diagnostics
+
+See [purchase observations, adapters, and remote validation](../../docs/purchases.md) for the base SDK purchase suite.

package/android/build.gradle

@@ -67,6 +67,6 @@ repositories {
 dependencies {
   implementation("com.facebook.react:react-android")
   def ansightAndroidVersion =
-      findProperty("ansightAndroidVersion") ?: "1.4.0-preview.5"
-  implementation("ai.ansight:ansight-android:1.4.0-preview.5")
+      findProperty("ansightAndroidVersion") ?: "1.5.0"
+  implementation("ai.ansight:ansight-android:1.5.0")
 }

package/android/src/main/kotlin/ai/ansight/reactnative/AnsightReactNativeModule.kt

@@ -48,6 +48,8 @@ import ai.ansight.tools.filesystem.AndroidFileSystemRoot
 import ai.ansight.tools.filesystem.AndroidFileSystemToolsOptions
 import ai.ansight.tools.filesystem.withFileSystemTools
 import ai.ansight.tools.preferences.AndroidPreferencesToolsOptions
+import ai.ansight.tools.clipboard.ClipboardToolIds
+import ai.ansight.tools.clipboard.withClipboardTools
 import ai.ansight.tools.preferences.withPreferencesTools
 import ai.ansight.tools.reflection.AndroidReflectionToolsOptions
 import ai.ansight.tools.reflection.withReflectionTools
@@ -135,6 +137,13 @@ class AnsightReactNativeModule(
 
     override fun onHostDestroy() = Unit
 
+    @ReactMethod
+    fun purchaseCommand(json: String, promise: Promise) {
+        try { promise.resolve(ai.ansight.runtime.purchases.PurchaseDiagnostics.shared.command(json)) }
+        catch (error: ai.ansight.runtime.purchases.PurchaseEnvironmentException) { promise.reject(ai.ansight.runtime.purchases.PurchaseEnvironmentException.ERROR_CODE, error.message, error) }
+        catch (error: Exception) { promise.reject("purchases_command_failed", "Purchase command failed.", error) }
+    }
+
     @ReactMethod
     fun addListener(eventName: String) {
         listenerCount.incrementAndGet()
@@ -894,7 +903,7 @@ class AnsightReactNativeModule(
                     val crash = map.getMapOrNull("crashCapture")
                     AnsightCrashCaptureOptions(
                         enabled = crash.booleanValue("enabled", true),
-                        studioHandoffEnabled = crash.booleanValue("studioHandoffEnabled", true),
+                        hostHandoffEnabled = crash.booleanValue("hostHandoffEnabled", true),
                         offlineCaptureAttachmentEnabled = crash.booleanValue("offlineCaptureAttachmentEnabled", true),
                         maximumPendingReports = crash.intValue("maximumPendingReports", 8),
                         retentionDays = crash.intValue("retentionDays", 7),
@@ -962,6 +971,11 @@ class AnsightReactNativeModule(
     ): AnsightOptions {
         val remoteTools = map.getMapOrNull("remoteTools")
         val builder = AnsightOptions.createBuilder(this)
+        val clipboardIds = setOf(ClipboardToolIds.GetText, ClipboardToolIds.HasText, ClipboardToolIds.SetText, ClipboardToolIds.Clear)
+        builder.withTools(initialTools.filterNot { it.definition.id in clipboardIds })
+        if (remoteTools.booleanValue("clipboard", true)) {
+            builder.withClipboardTools()
+        }
         if (remoteTools.toolSuiteEnabled("visualTree", enableVisualTreeToolsByDefault)) {
             builder.withVisualTreeTools()
         }

package/expo-plugin.js

@@ -1,9 +1,9 @@
 "use strict";
 
 const DEFAULT_CAMERA_PERMISSION =
-  "Allow $(PRODUCT_NAME) to use the camera to scan an Ansight Studio enrollment QR code.";
+  "Allow $(PRODUCT_NAME) to use the camera to scan an Ansight host enrollment QR code.";
 const DEFAULT_LOCAL_NETWORK_PERMISSION =
-  "Allow $(PRODUCT_NAME) to connect to Ansight Studio on your local network during development.";
+  "Allow $(PRODUCT_NAME) to connect to Ansight host on your local network during development.";
 
 function withAnsightReactNative(config, options = {}) {
   const { withInfoPlist } = loadExpoConfigPlugins();

package/index.d.ts

@@ -1,3 +1,6 @@
+import type { PurchaseDiagnostics } from "./purchases";
+export * from "./purchases";
+export const purchases: PurchaseDiagnostics;
 export type AnsightLifecycleState = "unknown" | "foreground" | "background";
 export type AnsightToolPolicy = "read" | "write" | "critical";
 
@@ -144,6 +147,8 @@ export interface AnsightVisualTreeToolsOptions {
 }
 
 export interface AnsightRemoteToolsOptions {
+  /** Include native clipboard tools; defaults to true. */
+  clipboard?: boolean;
   visualTree?: boolean | AnsightVisualTreeToolsOptions;
   fileSystem?: AnsightFileSystemToolsOptions;
   database?: AnsightDatabaseToolsOptions;
@@ -217,7 +222,7 @@ export interface AnsightOptions {
 
 export interface AnsightCrashCaptureOptions {
   enabled?: boolean;
-  studioHandoffEnabled?: boolean;
+  hostHandoffEnabled?: boolean;
   offlineCaptureAttachmentEnabled?: boolean;
   maximumPendingReports?: number;
   retentionDays?: number;
@@ -392,6 +397,7 @@ export class AnsightOptionsBuilder {
   withoutVisualTreeTools(): this;
   withFileSystemTools(options?: AnsightFileSystemToolsOptions): this;
   withDatabaseTools(options?: AnsightDatabaseToolsOptions): this;
+  withClipboardTools(enabled?: boolean): this;
   withPreferencesTools(options?: AnsightPreferencesToolsOptions): this;
   withReflectionTools(options?: AnsightReflectionToolsOptions): this;
   build(): AnsightOptions;
@@ -617,7 +623,7 @@ export function screenViewed(name: string, details?: Record<string, string>): Pr
 export function trackRoute(name: string, details?: Record<string, string>): Promise<AnsightDebugSnapshot>;
 export function setAppLifecycleState(state: AnsightLifecycleState): Promise<AnsightDebugSnapshot>;
 export function connect(pairingPayload?: string | object | null, options?: AnsightConnectOptions): Promise<AnsightHostConnectionResult>;
-/** Scans a one-use Studio invite, registers this installation, and saves automatic reconnect state. */
+/** Scans a one-use host invite, registers this installation, and saves automatic reconnect state. */
 export function enrollFromQrCode(options?: AnsightScanPairingOptions): Promise<AnsightHostConnectionResult>;
 export function scanPairingQrCode(options?: AnsightScanPairingOptions): Promise<AnsightHostConnectionResult>;
 export function openSession(pairingPayload: string | object, options?: AnsightOpenSessionOptions): Promise<AnsightHostConnectionResult>;
@@ -676,6 +682,7 @@ export function installErrorHandlers(options?: { chain?: boolean }): () => void;
 export function createReactNavigationTracker(navigationRef: unknown, options?: { recordInitial?: boolean }): ReactNavigationTracker;
 
 declare const Ansight: {
+  purchases: PurchaseDiagnostics;
   initialize: typeof initialize;
   initializeAndActivate: typeof initializeAndActivate;
   activate: typeof activate;

package/index.js

@@ -608,6 +608,11 @@ class AnsightOptionsBuilder {
     return this;
   }
 
+  withClipboardTools(enabled = true) {
+    this._options.remoteTools = { ...this._options.remoteTools, clipboard: enabled };
+    return this;
+  }
+
   withPreferencesTools(options = {}) {
     this._options.remoteTools = {
       ...(this._options.remoteTools || {}),
@@ -2669,3 +2674,6 @@ module.exports.recordNetworkRequest = recordNetworkRequest;
 module.exports.installNetworkCapture = installNetworkCapture;
 module.exports.uninstallNetworkCapture = uninstallNetworkCapture;
 module.exports.sanitizeNetworkRequest = sanitizeNetworkRequest;
+
+module.exports.purchases = require("./purchases").createPurchaseDiagnostics((json) => nativeModule.purchaseCommand(json));
+module.exports.createPurchaseDiagnostics = require("./purchases").createPurchaseDiagnostics;

package/ios/AnsightReactNative.swift

@@ -4,6 +4,15 @@ import React
 
 @objc(AnsightReactNative)
 final class AnsightReactNative: RCTEventEmitter {
+    @objc(purchaseCommand:resolver:rejecter:)
+    func purchaseCommand(_ json: String, resolver resolve: @escaping RCTPromiseResolveBlock, rejecter reject: @escaping RCTPromiseRejectBlock) {
+        Task {
+            do { resolve(try await PurchaseDiagnostics.shared.commandAsync(json)) }
+            catch PurchaseDiagnosticsError.environmentNotAllowed { reject(PurchaseDiagnosticsError.environmentErrorCode, "Purchase interop is restricted to simulators and emulators.", PurchaseDiagnosticsError.environmentNotAllowed) }
+            catch { reject("purchases_command_failed", "Purchase command failed.", error) }
+        }
+    }
+
     private final class PendingToolCall {
         let semaphore = DispatchSemaphore(value: 0)
         var result: AnsightToolExecutionResult?
@@ -1093,7 +1102,7 @@ final class AnsightReactNative: RCTEventEmitter {
             } else if let crash = raw as? NSDictionary {
                 options.crashCapture = AnsightCrashCaptureOptions(
                     enabled: boolValue(crash, "enabled", defaultValue: true),
-                    studioHandoffEnabled: boolValue(crash, "studioHandoffEnabled", defaultValue: true),
+                    hostHandoffEnabled: boolValue(crash, "hostHandoffEnabled", defaultValue: true),
                     offlineCaptureAttachmentEnabled: boolValue(crash, "offlineCaptureAttachmentEnabled", defaultValue: true),
                     maximumPendingReports: intValue(crash, "maximumPendingReports", defaultValue: 8),
                     retentionDays: intValue(crash, "retentionDays", defaultValue: 7),
@@ -1153,6 +1162,7 @@ final class AnsightReactNative: RCTEventEmitter {
                 remoteTools?["visualTree"],
                 defaultValue: useNativeAllInOneDefaults
             ),
+            clipboard: boolValue(remoteTools, "clipboard", defaultValue: true),
             database: databaseToolsOptions(remoteTools?["database"] as? NSDictionary),
             fileSystem: fileSystemToolsOptions(remoteTools?["fileSystem"] as? NSDictionary),
             preferences: preferencesToolsOptions(remoteTools?["preferences"] as? NSDictionary),

package/ios/AnsightReactNativeModule.m

@@ -3,6 +3,10 @@
 
 @interface RCT_EXTERN_MODULE(AnsightReactNative, RCTEventEmitter)
 
+RCT_EXTERN_METHOD(purchaseCommand:(NSString *)json
+                  resolver:(RCTPromiseResolveBlock)resolve
+                  rejecter:(RCTPromiseRejectBlock)reject)
+
 RCT_EXTERN_METHOD(initialize:(NSDictionary *)options
                   resolver:(RCTPromiseResolveBlock)resolve
                   rejecter:(RCTPromiseRejectBlock)reject)

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@ansight/react-native",
-  "version": "1.4.0-preview.5",
-  "description": "React Native bridge for the Ansight mobile SDK.",
+  "version": "1.5.0",
+  "description": "React Native bridge for Ansight: runtime evidence from your app for coding agents. Screenshots, UI trees, logs, network, telemetry, and app state.",
   "main": "index.js",
   "types": "index.d.ts",
   "license": "SEE LICENSE IN LICENSE",
@@ -34,7 +34,9 @@
     "expo-plugin.js",
     "tsconfig.json",
     "AnsightReactNative.podspec",
-    "react-native.config.js"
+    "react-native.config.js",
+    "purchases.js",
+    "purchases.d.ts"
   ],
   "keywords": [
     "ansight",

package/purchases.d.ts

@@ -0,0 +1,61 @@
+export interface PurchaseObservation {
+  productId: string;
+  source: "store" | "app" | "backend";
+  transactionRef?: string | null;
+  observedAt?: number;
+  state?: "unknown" | "pending" | "purchased" | "cancelled" | "expired" | "revoked" | "failed" | "gracePeriod" | "billingRetry";
+  verification?: "unknown" | "verified" | "unverified";
+  entitled?: boolean | null;
+  deliveryCount?: number | null;
+  finished?: boolean | null;
+  acknowledged?: boolean | null;
+  consumed?: boolean | null;
+  expiresAt?: number | null;
+  gracePeriodExpiresAt?: number | null;
+  environment?: "unknown" | "xcode" | "sandbox" | "production";
+  productType?: "unknown" | "consumable" | "nonConsumable" | "subscription" | "nonRenewingSubscription";
+}
+export interface PurchaseProduct {
+  productId: string;
+  available: boolean;
+  observedAt?: number;
+  displayPrice?: string | null;
+  price?: string | null;
+  currencyCode?: string | null;
+  productType?: PurchaseObservation["productType"];
+}
+export interface PurchaseExpectations {
+  transactionRef?: string;
+  productId: string;
+  expectedEntitled: boolean;
+  requireVerified?: boolean;
+  requireBackendVerification?: boolean;
+  expectedDeliveryCount?: number;
+  maxAgeMilliseconds?: number;
+}
+export interface PurchaseSnapshot {
+  schema: "ansight.purchases.v1";
+  capturedAt: number;
+  droppedEvents: number;
+  coverage: "observedOnly";
+  observations: PurchaseObservation[];
+  products: PurchaseProduct[];
+}
+export interface PurchaseValidationReport extends PurchaseSnapshot {
+  status: "pass" | "fail" | "inconclusive";
+  checks: { source: string; status: "pass" | "fail" | "inconclusive"; reason: string }[];
+}
+export interface PurchaseDiagnostics {
+  createTransactionReference(identifier: string): Promise<{ transactionRef: string }>;
+  /** Register read-only remote tools after SDK initialization. */
+  register(): Promise<{ success: boolean }>;
+  record(observation: PurchaseObservation): Promise<{ success: boolean }>;
+  recordProduct(product: PurchaseProduct): Promise<{ success: boolean }>;
+  /** Clear evidence on account switch. Does not clear store transactions. */
+  clear(): Promise<{ success: boolean }>;
+  snapshot(productId?: string): Promise<PurchaseSnapshot>;
+  validate(expectations: PurchaseExpectations): Promise<PurchaseValidationReport>;
+  /** Apple only. Reads StoreKit 2 using known product IDs. */
+  refreshStoreKit(productIds: string[]): Promise<PurchaseSnapshot>;
+}
+export function createPurchaseDiagnostics(send: (json: string) => Promise<string>): PurchaseDiagnostics;

package/purchases.js

@@ -0,0 +1,17 @@
+"use strict";
+
+// All observation retention, validation and tools live in the native base SDK.
+function createPurchaseDiagnostics(send) {
+  const command = async (action, fields = {}) => JSON.parse(await send(JSON.stringify({ action, ...fields })));
+  return {
+    createTransactionReference: (identifier) => command("reference", { identifier }),
+    register: () => command("register"),
+    record: (observation) => command("record", { observation: { observedAt: Date.now(), ...observation } }),
+    recordProduct: (product) => command("recordProduct", { product: { observedAt: Date.now(), productType: "unknown", ...product } }),
+    clear: () => command("clear"),
+    snapshot: (productId) => command("purchases.get_state", { arguments: productId === undefined ? {} : { productId } }),
+    validate: (expectations) => command("purchases.validate", { arguments: expectations }),
+    refreshStoreKit: (productIds) => command("refreshStoreKit", { productIds }),
+  };
+}
+module.exports = { createPurchaseDiagnostics };