@allwright.dev/core 0.1.3 → 0.1.4

package/dist/bootstrap.js

@@ -12,7 +12,7 @@ const ALLWRIGHT_HOME_ENV_VAR = "ALLWRIGHT_HOME";
 const ALLWRIGHT_REPOSITORY_ENV_VAR = "ALLWRIGHT_REPOSITORY";
 const ALLWRIGHT_VERSION_ENV_VAR = "ALLWRIGHT_VERSION";
 const DEFAULT_RELEASE_REPOSITORY = "allwright-dev/allwright";
-const DEFAULT_RELEASE_VERSION = "0.1.3";
+const DEFAULT_RELEASE_VERSION = "0.1.4";
 const STARTUP_TIMEOUT_MS = 20_000;
 const PING_TIMEOUT_MS = 1_000;
 const PROTO_ROOT = fileURLToPath(new URL("../proto/", import.meta.url));

package/dist/mobile.js

@@ -200,6 +200,38 @@ class MobileAndroidAppImpl {
             }
         }
     }
+    async accessibilitySnapshot(options = {}) {
+        const mode = options.mode ?? "default";
+        if (!["default", "ai", "autoexpect", "codegen"].includes(mode)) {
+            throw new Error("invalid accessibility snapshot mode");
+        }
+        const format = options.format ?? "json";
+        if (format !== "json" && format !== "yaml") {
+            throw new Error("accessibility snapshot format must be 'json' or 'yaml'");
+        }
+        const handle = await this.#getHandle();
+        this.#ensureOpen(handle);
+        handle.stream.write({
+            surfaceSessionId: this.#surfaceSessionId,
+            contextSessionId: this.sessionId,
+            accessibilitySnapshot: {
+                format,
+                mode,
+                retryOptions: options.timeoutMs ? { timeoutMs: options.timeoutMs } : undefined,
+            },
+        });
+        while (true) {
+            const event = await handle.queue.next();
+            if (event.accessibilitySnapshotCaptured)
+                return event.accessibilitySnapshotCaptured.snapshot ?? "";
+            if (event.error?.message)
+                throw new Error(event.error.message);
+            if (event.closed) {
+                handle.closed = true;
+                throw new Error(`android app session ${this.sessionId} closed while waiting for accessibility snapshot`);
+            }
+        }
+    }
     async screenshot(options = {}) {
         const handle = await this.#getHandle();
         this.#ensureOpen(handle);

package/dist/types.d.ts

@@ -156,6 +156,7 @@ export interface MobileAndroidLocator {
     locator(selector: string): MobileAndroidLocator;
 }
 export interface MobileAndroidApp {
+    accessibilitySnapshot(options?: AccessibilitySnapshotOptions): Promise<string>;
     readonly sessionId: string;
     locator(selector: string): MobileAndroidLocator;
     click(selector: string, options?: CommandOptions): Promise<ClickResult>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@allwright.dev/core",
-  "version": "0.1.3",
+  "version": "0.1.4",
   "description": "High-level TypeScript client for the allwright automation engine.",
   "license": "MIT",
   "type": "module",

package/proto/core/v1/common.proto

@@ -2,6 +2,8 @@ syntax = "proto3";
 
 package allwright.engine.v1;
 option go_package = "allwright.dev/gen/allwright/engine/v1;enginev1";
+option java_package = "dev.allwright.engine.v1";
+option java_multiple_files = true;
 
 message PingRequest {}
 

package/proto/core/v1/context.proto

@@ -6,7 +6,6 @@ option java_package = "dev.allwright.engine.v1";
 option java_multiple_files = true;
 
 import "core/v1/common.proto";
-import "surfaces/web/v1/web.proto";
 
 message ContextSessionCommand {
   string surface_session_id = 1;
@@ -218,3 +217,18 @@ message ScreenshotCapturedEvent {
   bytes png_data = 1;
   string note = 2;
 }
+
+// Empty format defaults to JSON. Accepted values are "json" and "yaml".
+message AccessibilitySnapshotCommand {
+  // Empty mode defaults to default. AI assigns queryable references; reference storage is surface-owned.
+  // Supported: default, ai, autoexpect, codegen.
+  string mode = 3;
+  string format = 1;
+  optional CommandRetryOptions retry_options = 2;
+}
+
+// Both formats encode the same versioned, structured document.
+message AccessibilitySnapshotCapturedEvent {
+  string snapshot = 1;
+  string format = 2;
+}

package/proto/core/v1/surface.proto

@@ -2,6 +2,8 @@ syntax = "proto3";
 
 package allwright.engine.v1;
 option go_package = "allwright.dev/gen/allwright/engine/v1;enginev1";
+option java_package = "dev.allwright.engine.v1";
+option java_multiple_files = true;
 
 import "core/v1/common.proto";
 import "surfaces/mobile/v1/mobile.proto";

package/proto/engine/v1/engine.proto

@@ -2,6 +2,8 @@ syntax = "proto3";
 
 package allwright.engine.v1;
 option go_package = "allwright.dev/gen/allwright/engine/v1;enginev1";
+option java_package = "dev.allwright.engine.v1";
+option java_multiple_files = true;
 
 import "core/v1/surface.proto";
 import "core/v1/common.proto";

package/proto/surfaces/mobile/v1/mobile.proto

@@ -2,6 +2,8 @@ syntax = "proto3";
 
 package allwright.engine.v1;
 option go_package = "allwright.dev/gen/allwright/engine/v1;enginev1";
+option java_package = "dev.allwright.engine.v1";
+option java_multiple_files = true;
 
 import "core/v1/common.proto";
 

package/proto/surfaces/web/v1/web.proto

@@ -39,18 +39,3 @@ message ChromeLaunchedEvent {
   string user_data_dir = 4;
   string initial_page_session_id = 5;
 }
-
-// Empty format defaults to JSON. Accepted values are "json" and "yaml".
-message AccessibilitySnapshotCommand {
-  // Empty mode defaults to default. AI injects queryable aria-ref attributes.
-  // Supported: default, ai, autoexpect, codegen.
-  string mode = 3;
-  string format = 1;
-  optional CommandRetryOptions retry_options = 2;
-}
-
-// Both formats encode the same versioned, structured document.
-message AccessibilitySnapshotCapturedEvent {
-  string snapshot = 1;
-  string format = 2;
-}