@kaeawc/auto-mobile 0.0.9 → 0.0.12

package/dist/schemas/tool-definitions.json

@@ -807,6 +807,60 @@
       "additionalProperties": {}
     }
   },
+  {
+    "name": "exportPlan",
+    "description": "Stop the active test recording and export recorded interactions as a YAML plan. Returns the plan content.",
+    "inputSchema": {
+      "$schema": "https://json-schema.org/draft/2020-12/schema",
+      "type": "object",
+      "properties": {
+        "recordingId": {
+          "description": "Recording ID to export (uses active recording if not specified)",
+          "type": "string"
+        },
+        "planName": {
+          "description": "Name for the exported plan (auto-generated if not specified)",
+          "type": "string"
+        }
+      },
+      "additionalProperties": false
+    },
+    "outputSchema": {
+      "$schema": "https://json-schema.org/draft/2020-12/schema",
+      "type": "object",
+      "properties": {
+        "success": {
+          "type": "boolean"
+        },
+        "recordingId": {
+          "type": "string"
+        },
+        "planName": {
+          "type": "string"
+        },
+        "planContent": {
+          "type": "string"
+        },
+        "stepCount": {
+          "type": "integer",
+          "minimum": -9007199254740991,
+          "maximum": 9007199254740991
+        },
+        "durationMs": {
+          "type": "integer",
+          "minimum": -9007199254740991,
+          "maximum": 9007199254740991
+        },
+        "error": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "success"
+      ],
+      "additionalProperties": false
+    }
+  },
   {
     "name": "getDeepLinks",
     "description": "Query deep links for app",
@@ -3600,34 +3654,34 @@
             "in",
             "out"
           ],
-          "description": "Pinch direction (in=zoom out, out=zoom in)"
+          "description": "Pinch direction"
         },
         "distanceStart": {
-          "description": "Start distance px",
+          "description": "Initial finger distance (px, default: 400)",
           "type": "number"
         },
         "distanceEnd": {
-          "description": "End distance px",
+          "description": "Final finger distance (px, default: 100)",
           "type": "number"
         },
         "scale": {
-          "description": "Scale multiplier",
+          "description": "Scale factor (overrides distances)",
           "type": "number"
         },
         "duration": {
-          "description": "Duration ms (default: 300)",
+          "description": "Gesture duration (ms)",
           "type": "number"
         },
         "rotationDegrees": {
-          "description": "Rotation degrees (+ = clockwise)",
+          "description": "Rotation during pinch (degrees)",
           "type": "number"
         },
         "includeSystemInsets": {
-          "description": "Include system bars (default false)",
+          "description": "Use full screen including status/nav bars",
           "type": "boolean"
         },
         "container": {
-          "description": "Container to pinch within",
+          "description": "Container selector object to scope search. Provide { \"elementId\": \"<id>\" } or { \"text\": \"<text>\" }.",
           "anyOf": [
             {
               "type": "object",
@@ -3658,7 +3712,7 @@
           ]
         },
         "autoTarget": {
-          "description": "Auto-target surface (default true)",
+          "description": "Auto-target pinchable containers",
           "type": "boolean"
         },
         "platform": {
@@ -4112,6 +4166,44 @@
       "additionalProperties": false
     }
   },
+  {
+    "name": "startTestRecording",
+    "description": "Start test recording mode on the active device. Records user interactions for later export as a test plan. Returns the session ID which can be used with exportPlan.",
+    "inputSchema": {
+      "$schema": "https://json-schema.org/draft/2020-12/schema",
+      "type": "object",
+      "properties": {},
+      "additionalProperties": false
+    },
+    "outputSchema": {
+      "$schema": "https://json-schema.org/draft/2020-12/schema",
+      "type": "object",
+      "properties": {
+        "success": {
+          "type": "boolean"
+        },
+        "recordingId": {
+          "type": "string"
+        },
+        "startedAt": {
+          "type": "string"
+        },
+        "deviceId": {
+          "type": "string"
+        },
+        "platform": {
+          "type": "string"
+        },
+        "error": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "success"
+      ],
+      "additionalProperties": false
+    }
+  },
   {
     "name": "swipeOn",
     "description": "Swipe/scroll on screen or elements",
@@ -4120,11 +4212,11 @@
       "type": "object",
       "properties": {
         "includeSystemInsets": {
-          "description": "Include system bars (default false)",
+          "description": "Use full screen including status/nav bars",
           "type": "boolean"
         },
         "container": {
-          "description": "Container to swipe within (elementId or text). REQUIRED for lists. Omit for full-screen swipes.",
+          "description": "Container selector object to scope search. Provide { \"elementId\": \"<id>\" } or { \"text\": \"<text>\" }.",
           "anyOf": [
             {
               "type": "object",
@@ -4155,7 +4247,7 @@
           ]
         },
         "autoTarget": {
-          "description": "Auto-target scrollable container (default true)",
+          "description": "Auto-target scrollable containers (default: true)",
           "type": "boolean"
         },
         "direction": {
@@ -4166,10 +4258,10 @@
             "left",
             "right"
           ],
-          "description": "Finger movement direction. up=finger up/reveals above, down=finger down/reveals below, left/right=finger left/right"
+          "description": "Swipe/scroll direction"
         },
         "gestureType": {
-          "description": "swipeFingerTowardsDirection=finger moves in direction (default), scrollTowardsDirection=content scrolls in direction",
+          "description": "swipeFingerTowardsDirection: finger moves in direction (e.g., 'up' = finger up = content scrolls down). scrollTowardsDirection: content moves in direction (e.g., 'up' = content up = see content below). Default: scrollTowardsDirection.",
           "type": "string",
           "enum": [
             "swipeFingerTowardsDirection",
@@ -4177,7 +4269,7 @@
           ]
         },
         "lookFor": {
-          "description": "Swipe until we find a match",
+          "description": "Element to look for during swipe",
           "anyOf": [
             {
               "type": "object",
@@ -4208,21 +4300,23 @@
           ]
         },
         "boomerang": {
-          "description": "Return to the starting point after swiping (default false)",
+          "description": "Return to start position after swipe apex",
           "type": "boolean"
         },
         "apexPause": {
-          "description": "Pause at the furthest point in ms (default 100)",
+          "description": "Pause duration at swipe apex in ms (0-3000)",
           "type": "number",
-          "minimum": 0
+          "minimum": 0,
+          "maximum": 3000
         },
         "returnSpeed": {
-          "description": "Return speed multiplier (default 1.0)",
+          "description": "Speed multiplier for return swipe (0.1-3.0)",
           "type": "number",
-          "exclusiveMinimum": 0
+          "minimum": 0.1,
+          "maximum": 3
         },
         "speed": {
-          "description": "Scroll speed",
+          "description": "Swipe speed preset",
           "type": "string",
           "enum": [
             "slow",
@@ -5119,36 +5213,34 @@
             "dismiss",
             "clearAll"
           ],
-          "description": "System tray action"
+          "description": "Action: open=expand tray, find=search for notification, tap=tap notification, dismiss=swipe away, clearAll=dismiss all for app"
         },
         "notification": {
-          "description": "Notification match criteria",
+          "description": "Notification criteria to match",
           "type": "object",
           "properties": {
             "title": {
-              "description": "Notification title (case-insensitive, partial match)",
+              "description": "Notification title to match",
               "type": "string"
             },
             "body": {
-              "description": "Notification body (case-insensitive, partial match)",
+              "description": "Notification body to match",
               "type": "string"
             },
             "appId": {
-              "description": "Notification app package ID (Android only)",
+              "description": "App package ID to match",
               "type": "string"
             },
             "tapActionLabel": {
-              "description": "Notification action button label to tap (tap only)",
+              "description": "Action button label to tap (for 'tap' action)",
               "type": "string"
             }
           },
           "additionalProperties": false
         },
         "awaitTimeout": {
-          "description": "Wait timeout ms (default: 5000)",
-          "type": "integer",
-          "minimum": 0,
-          "maximum": 9007199254740991
+          "description": "Timeout in ms to wait for notification (default: 5000)",
+          "type": "number"
         },
         "platform": {
           "type": "string",

package/dist/src/db/migrations/2025_12_28_000_initial_schema.ts

@@ -4,6 +4,7 @@ export async function up(db: Kysely<unknown>): Promise<void> {
   // Create device_configs table
   await db.schema
     .createTable("device_configs")
+    .ifNotExists()
     .addColumn("id", "integer", col => col.primaryKey().autoIncrement())
     .addColumn("device_id", "text", col => col.notNull().unique())
     .addColumn("platform", "text", col => col.notNull())
@@ -18,6 +19,7 @@ export async function up(db: Kysely<unknown>): Promise<void> {
   // Create index on device_id for fast lookups
   await db.schema
     .createIndex("idx_device_configs_device_id")
+    .ifNotExists()
     .on("device_configs")
     .column("device_id")
     .execute();

package/dist/src/db/migrations/2025_12_30_000_performance_thresholds.ts

@@ -4,6 +4,7 @@ export async function up(db: Kysely<unknown>): Promise<void> {
   // Create performance_thresholds table
   await db.schema
     .createTable("performance_thresholds")
+    .ifNotExists()
     .addColumn("id", "integer", col => col.primaryKey().autoIncrement())
     .addColumn("device_id", "text", col => col.notNull())
     .addColumn("session_id", "text", col => col.notNull())
@@ -26,6 +27,7 @@ export async function up(db: Kysely<unknown>): Promise<void> {
   // Create index on device_id for fast lookups
   await db.schema
     .createIndex("idx_performance_thresholds_device_id")
+    .ifNotExists()
     .on("performance_thresholds")
     .column("device_id")
     .execute();
@@ -33,6 +35,7 @@ export async function up(db: Kysely<unknown>): Promise<void> {
   // Create index on session_id for session-specific queries
   await db.schema
     .createIndex("idx_performance_thresholds_session_id")
+    .ifNotExists()
     .on("performance_thresholds")
     .column("session_id")
     .execute();
@@ -40,6 +43,7 @@ export async function up(db: Kysely<unknown>): Promise<void> {
   // Create composite index for device + created_at for TTL queries
   await db.schema
     .createIndex("idx_performance_thresholds_device_created")
+    .ifNotExists()
     .on("performance_thresholds")
     .columns(["device_id", "created_at"])
     .execute();
@@ -47,6 +51,7 @@ export async function up(db: Kysely<unknown>): Promise<void> {
   // Create performance_audit_results table to store audit outcomes
   await db.schema
     .createTable("performance_audit_results")
+    .ifNotExists()
     .addColumn("id", "integer", col => col.primaryKey().autoIncrement())
     .addColumn("device_id", "text", col => col.notNull())
     .addColumn("session_id", "text", col => col.notNull())
@@ -72,6 +77,7 @@ export async function up(db: Kysely<unknown>): Promise<void> {
   // Create index on device_id + timestamp for historical queries
   await db.schema
     .createIndex("idx_performance_audit_results_device_timestamp")
+    .ifNotExists()
     .on("performance_audit_results")
     .columns(["device_id", "timestamp"])
     .execute();

package/dist/src/db/migrations/2025_12_30_001_navigation_graph.ts

@@ -4,6 +4,7 @@ export async function up(db: Kysely<unknown>): Promise<void> {
   // Create navigation_apps table
   await db.schema
     .createTable("navigation_apps")
+    .ifNotExists()
     .addColumn("app_id", "text", col => col.primaryKey())
     .addColumn("created_at", "text", col =>
       col.notNull().defaultTo("datetime('now')")
@@ -14,6 +15,7 @@ export async function up(db: Kysely<unknown>): Promise<void> {
   // Create navigation_nodes table
   await db.schema
     .createTable("navigation_nodes")
+    .ifNotExists()
     .addColumn("id", "integer", col => col.primaryKey().autoIncrement())
     .addColumn("app_id", "text", col =>
       col.notNull().references("navigation_apps.app_id").onDelete("cascade")
@@ -32,6 +34,7 @@ export async function up(db: Kysely<unknown>): Promise<void> {
   // Create unique constraint on (app_id, screen_name)
   await db.schema
     .createIndex("idx_navigation_nodes_app_screen")
+    .ifNotExists()
     .on("navigation_nodes")
     .columns(["app_id", "screen_name"])
     .unique()
@@ -40,6 +43,7 @@ export async function up(db: Kysely<unknown>): Promise<void> {
   // Create navigation_edges table
   await db.schema
     .createTable("navigation_edges")
+    .ifNotExists()
     .addColumn("id", "integer", col => col.primaryKey().autoIncrement())
     .addColumn("app_id", "text", col =>
       col.notNull().references("navigation_apps.app_id").onDelete("cascade")
@@ -57,18 +61,21 @@ export async function up(db: Kysely<unknown>): Promise<void> {
   // Create indices for navigation_edges
   await db.schema
     .createIndex("idx_navigation_edges_app")
+    .ifNotExists()
     .on("navigation_edges")
     .column("app_id")
     .execute();
 
   await db.schema
     .createIndex("idx_navigation_edges_from")
+    .ifNotExists()
     .on("navigation_edges")
     .column("from_screen")
     .execute();
 
   await db.schema
     .createIndex("idx_navigation_edges_to")
+    .ifNotExists()
     .on("navigation_edges")
     .column("to_screen")
     .execute();
@@ -76,6 +83,7 @@ export async function up(db: Kysely<unknown>): Promise<void> {
   // Create ui_elements table
   await db.schema
     .createTable("ui_elements")
+    .ifNotExists()
     .addColumn("id", "integer", col => col.primaryKey().autoIncrement())
     .addColumn("app_id", "text", col =>
       col.notNull().references("navigation_apps.app_id").onDelete("cascade")
@@ -100,6 +108,7 @@ export async function up(db: Kysely<unknown>): Promise<void> {
   // Create index on app_id for ui_elements
   await db.schema
     .createIndex("idx_ui_elements_app")
+    .ifNotExists()
     .on("ui_elements")
     .column("app_id")
     .execute();
@@ -107,6 +116,7 @@ export async function up(db: Kysely<unknown>): Promise<void> {
   // Create edge_ui_elements junction table
   await db.schema
     .createTable("edge_ui_elements")
+    .ifNotExists()
     .addColumn("edge_id", "integer", col =>
       col.notNull().references("navigation_edges.id").onDelete("cascade")
     )
@@ -119,6 +129,7 @@ export async function up(db: Kysely<unknown>): Promise<void> {
   // Create primary key for edge_ui_elements
   await db.schema
     .createIndex("idx_edge_ui_elements_pk")
+    .ifNotExists()
     .on("edge_ui_elements")
     .columns(["edge_id", "ui_element_id"])
     .unique()
@@ -127,6 +138,7 @@ export async function up(db: Kysely<unknown>): Promise<void> {
   // Create node_modals table
   await db.schema
     .createTable("node_modals")
+    .ifNotExists()
     .addColumn("node_id", "integer", col =>
       col.notNull().references("navigation_nodes.id").onDelete("cascade")
     )
@@ -140,6 +152,7 @@ export async function up(db: Kysely<unknown>): Promise<void> {
   // Create primary key for node_modals
   await db.schema
     .createIndex("idx_node_modals_pk")
+    .ifNotExists()
     .on("node_modals")
     .columns(["node_id", "stack_level"])
     .unique()
@@ -148,6 +161,7 @@ export async function up(db: Kysely<unknown>): Promise<void> {
   // Create edge_modals table
   await db.schema
     .createTable("edge_modals")
+    .ifNotExists()
     .addColumn("edge_id", "integer", col =>
       col.notNull().references("navigation_edges.id").onDelete("cascade")
     )
@@ -162,6 +176,7 @@ export async function up(db: Kysely<unknown>): Promise<void> {
   // Create primary key for edge_modals
   await db.schema
     .createIndex("idx_edge_modals_pk")
+    .ifNotExists()
     .on("edge_modals")
     .columns(["edge_id", "position", "stack_level"])
     .unique()
@@ -170,6 +185,7 @@ export async function up(db: Kysely<unknown>): Promise<void> {
   // Create scroll_positions table
   await db.schema
     .createTable("scroll_positions")
+    .ifNotExists()
     .addColumn("edge_id", "integer", col =>
       col.primaryKey().references("navigation_edges.id").onDelete("cascade")
     )

package/dist/src/db/migrations/2025_12_31_000_accessibility_baselines.ts

@@ -4,6 +4,7 @@ export async function up(db: Kysely<unknown>): Promise<void> {
   // Create accessibility_baselines table
   await db.schema
     .createTable("accessibility_baselines")
+    .ifNotExists()
     .addColumn("id", "integer", col => col.primaryKey().autoIncrement())
     .addColumn("screen_id", "text", col => col.notNull().unique())
     .addColumn("violations_json", "text", col => col.notNull()) // JSON blob of WcagViolation[]
@@ -16,6 +17,7 @@ export async function up(db: Kysely<unknown>): Promise<void> {
   // Create index on screen_id for fast lookups
   await db.schema
     .createIndex("idx_accessibility_baselines_screen_id")
+    .ifNotExists()
     .on("accessibility_baselines")
     .column("screen_id")
     .execute();
@@ -23,6 +25,7 @@ export async function up(db: Kysely<unknown>): Promise<void> {
   // Create index on updated_at for cleanup queries
   await db.schema
     .createIndex("idx_accessibility_baselines_updated_at")
+    .ifNotExists()
     .on("accessibility_baselines")
     .column("updated_at")
     .execute();

package/dist/src/db/migrations/2025_12_31_001_memory_audit.ts

@@ -4,6 +4,7 @@ export async function up(db: Kysely<unknown>): Promise<void> {
   // Create memory_thresholds table for per-app threshold configuration
   await db.schema
     .createTable("memory_thresholds")
+    .ifNotExists()
     .addColumn("id", "integer", col => col.primaryKey().autoIncrement())
     .addColumn("device_id", "text", col => col.notNull())
     .addColumn("package_name", "text", col => col.notNull())
@@ -22,6 +23,7 @@ export async function up(db: Kysely<unknown>): Promise<void> {
   // Create index on device_id + package_name for fast lookups
   await db.schema
     .createIndex("idx_memory_thresholds_device_package")
+    .ifNotExists()
     .on("memory_thresholds")
     .columns(["device_id", "package_name"])
     .execute();
@@ -29,6 +31,7 @@ export async function up(db: Kysely<unknown>): Promise<void> {
   // Create memory_baselines table for adaptive baseline tracking
   await db.schema
     .createTable("memory_baselines")
+    .ifNotExists()
     .addColumn("id", "integer", col => col.primaryKey().autoIncrement())
     .addColumn("device_id", "text", col => col.notNull())
     .addColumn("package_name", "text", col => col.notNull())
@@ -48,6 +51,7 @@ export async function up(db: Kysely<unknown>): Promise<void> {
   // Create unique index on device_id + package_name + tool_name
   await db.schema
     .createIndex("idx_memory_baselines_device_package_tool")
+    .ifNotExists()
     .on("memory_baselines")
     .columns(["device_id", "package_name", "tool_name"])
     .unique()
@@ -56,6 +60,7 @@ export async function up(db: Kysely<unknown>): Promise<void> {
   // Create memory_audit_results table to store audit outcomes
   await db.schema
     .createTable("memory_audit_results")
+    .ifNotExists()
     .addColumn("id", "integer", col => col.primaryKey().autoIncrement())
     .addColumn("device_id", "text", col => col.notNull())
     .addColumn("session_id", "text", col => col.notNull())
@@ -92,6 +97,7 @@ export async function up(db: Kysely<unknown>): Promise<void> {
   // Create index on device_id + timestamp for historical queries
   await db.schema
     .createIndex("idx_memory_audit_results_device_timestamp")
+    .ifNotExists()
     .on("memory_audit_results")
     .columns(["device_id", "timestamp"])
     .execute();
@@ -99,6 +105,7 @@ export async function up(db: Kysely<unknown>): Promise<void> {
   // Create index on package_name + timestamp for app-specific queries
   await db.schema
     .createIndex("idx_memory_audit_results_package_timestamp")
+    .ifNotExists()
     .on("memory_audit_results")
     .columns(["package_name", "timestamp"])
     .execute();
@@ -106,6 +113,7 @@ export async function up(db: Kysely<unknown>): Promise<void> {
   // Create index on passed for filtering failures
   await db.schema
     .createIndex("idx_memory_audit_results_passed")
+    .ifNotExists()
     .on("memory_audit_results")
     .column("passed")
     .execute();

package/dist/src/db/migrations/2026_01_01_000_recomposition_metrics.ts

@@ -3,6 +3,7 @@ import { Kysely } from "kysely";
 export async function up(db: Kysely<any>): Promise<void> {
   await db.schema
     .createTable("recomposition_metrics")
+    .ifNotExists()
     .addColumn("id", "integer", col => col.primaryKey().autoIncrement())
     .addColumn("device_id", "text", col => col.notNull())
     .addColumn("session_id", "text", col => col.notNull())
@@ -25,12 +26,14 @@ export async function up(db: Kysely<any>): Promise<void> {
 
   await db.schema
     .createIndex("idx_recomposition_metrics_timestamp")
+    .ifNotExists()
     .on("recomposition_metrics")
     .column("timestamp")
     .execute();
 
   await db.schema
     .createIndex("idx_recomposition_metrics_composable")
+    .ifNotExists()
     .on("recomposition_metrics")
     .columns(["package_name", "composable_id", "timestamp"])
     .execute();

package/dist/src/db/migrations/2026_01_02_000_prediction_history.ts

@@ -3,6 +3,7 @@ import type { Kysely } from "kysely";
 export async function up(db: Kysely<unknown>): Promise<void> {
   await db.schema
     .createTable("prediction_outcomes")
+    .ifNotExists()
     .addColumn("id", "integer", col => col.primaryKey().autoIncrement())
     .addColumn("app_id", "text", col =>
       col.notNull().references("navigation_apps.app_id").onDelete("cascade")
@@ -28,30 +29,35 @@ export async function up(db: Kysely<unknown>): Promise<void> {
 
   await db.schema
     .createIndex("idx_prediction_outcomes_app")
+    .ifNotExists()
     .on("prediction_outcomes")
     .column("app_id")
     .execute();
 
   await db.schema
     .createIndex("idx_prediction_outcomes_from")
+    .ifNotExists()
     .on("prediction_outcomes")
     .column("from_screen")
     .execute();
 
   await db.schema
     .createIndex("idx_prediction_outcomes_predicted")
+    .ifNotExists()
     .on("prediction_outcomes")
     .column("predicted_screen")
     .execute();
 
   await db.schema
     .createIndex("idx_prediction_outcomes_tool")
+    .ifNotExists()
     .on("prediction_outcomes")
     .column("tool_name")
     .execute();
 
   await db.schema
     .createTable("prediction_transition_stats")
+    .ifNotExists()
     .addColumn("id", "integer", col => col.primaryKey().autoIncrement())
     .addColumn("app_id", "text", col =>
       col.notNull().references("navigation_apps.app_id").onDelete("cascade")
@@ -72,6 +78,7 @@ export async function up(db: Kysely<unknown>): Promise<void> {
 
   await db.schema
     .createIndex("idx_prediction_transition_key")
+    .ifNotExists()
     .on("prediction_transition_stats")
     .columns(["app_id", "from_screen", "to_screen", "tool_name", "tool_args"])
     .unique()

package/dist/src/db/migrations/2026_01_03_000_feature_flags.ts

@@ -3,6 +3,7 @@ import type { Kysely } from "kysely";
 export async function up(db: Kysely<unknown>): Promise<void> {
   await db.schema
     .createTable("feature_flags")
+    .ifNotExists()
     .addColumn("key", "text", col => col.primaryKey())
     .addColumn("enabled", "integer", col => col.notNull().defaultTo(0))
     .addColumn("config_json", "text")

package/dist/src/db/migrations/2026_01_03_000_test_executions.ts

@@ -3,6 +3,7 @@ import type { Kysely } from "kysely";
 export async function up(db: Kysely<unknown>): Promise<void> {
   await db.schema
     .createTable("test_executions")
+    .ifNotExists()
     .addColumn("id", "integer", col => col.primaryKey().autoIncrement())
     .addColumn("test_class", "text", col => col.notNull())
     .addColumn("test_method", "text", col => col.notNull())
@@ -28,12 +29,14 @@ export async function up(db: Kysely<unknown>): Promise<void> {
 
   await db.schema
     .createIndex("idx_test_executions_lookup")
+    .ifNotExists()
     .on("test_executions")
     .columns(["test_class", "test_method"])
     .execute();
 
   await db.schema
     .createIndex("idx_test_executions_timestamp")
+    .ifNotExists()
     .on("test_executions")
     .column("timestamp")
     .execute();