zeno-mobile-runner 0.1.3 → 0.2.0

package/src/runner_waits.zig

@@ -15,34 +15,62 @@ pub fn waitUntilVisible(
     timeout_ms: u64,
     writer: ?*trace.TraceWriter,
     options: RunOptions,
+) !bool {
+    return try untilVisibleKind(device, wanted, timeout_ms, writer, options, "wait.visible");
+}
+
+pub fn assertVisible(
+    device: anytype,
+    wanted: selector.Selector,
+    timeout_ms: u64,
+    writer: ?*trace.TraceWriter,
+    options: RunOptions,
+) !bool {
+    return try untilVisibleKind(device, wanted, timeout_ms, writer, options, "assert.visible");
+}
+
+fn untilVisibleKind(
+    device: anytype,
+    wanted: selector.Selector,
+    timeout_ms: u64,
+    writer: ?*trace.TraceWriter,
+    options: RunOptions,
+    kind: []const u8,
 ) !bool {
     const deadline = std.time.milliTimestamp() + @as(i64, @intCast(timeout_ms));
     while (true) {
         if (try nativeVisibleBySelector(device, wanted)) |visible| {
             if (visible) {
-                if (writer) |tw| try runner_events.recordNativeWait(tw, "wait.visible", wanted, null);
+                if (writer) |tw| try runner_events.recordNativeWait(tw, kind, wanted, null, timeout_ms);
                 return true;
             }
             if (std.time.milliTimestamp() >= deadline) {
-                if (writer) |tw| try runner_events.recordNativeWaitTimeoutWithDiagnostics(device, tw, "wait.visible", &[_]selector.Selector{wanted});
+                if (writer) |tw| try runner_events.recordNativeWaitTimeoutWithDiagnostics(device, tw, kind, &[_]selector.Selector{wanted}, timeout_ms);
                 return false;
             }
             try sleepMs(options.poll_ms);
             continue;
         }
         var snap = device.snapshot(writer) catch |err| {
-            if (try retryTransientObservation(err, "wait.visible", writer, deadline, options)) continue;
+            if (try retryTransientObservation(err, kind, writer, deadline, options)) continue;
             return err;
         };
         defer snap.deinit(device.allocator);
-        if (selector.find(snap.nodes, wanted) != null) {
-            if (writer) |tw| try tw.recordEvent("wait.visible", "{\"status\":\"ok\"}");
+        if (selector.find(snap.nodes, wanted)) |node| {
+            if (writer) |tw| {
+                var payload = std.ArrayList(u8).empty;
+                defer payload.deinit(tw.allocator);
+                try payload.writer(tw.allocator).print("{{\"status\":\"ok\",\"target\":\"{s}\",\"selector\":", .{node.stable_id});
+                try trace.writeSelectorJson(payload.writer(tw.allocator), wanted);
+                try payload.writer(tw.allocator).print(",\"timeoutMs\":{d}}}", .{timeout_ms});
+                try tw.recordEvent(kind, payload.items);
+            }
             return true;
         }
         if (std.time.milliTimestamp() >= deadline) {
             if (writer) |tw| {
                 const selectors = [_]selector.Selector{wanted};
-                try runner_events.recordWaitTimeout(tw, "wait.visible", selectors[0..], snap);
+                try runner_events.recordDiagnosticWithStrategyAndTimeout(tw, kind, "timeout", null, selectors[0..], snap, timeout_ms);
             }
             return false;
         }
@@ -56,34 +84,62 @@ pub fn waitUntilNotVisible(
     timeout_ms: u64,
     writer: ?*trace.TraceWriter,
     options: RunOptions,
+) !bool {
+    return try untilNotVisibleKind(device, wanted, timeout_ms, writer, options, "wait.notVisible");
+}
+
+pub fn assertNotVisible(
+    device: anytype,
+    wanted: selector.Selector,
+    timeout_ms: u64,
+    writer: ?*trace.TraceWriter,
+    options: RunOptions,
+) !bool {
+    return try untilNotVisibleKind(device, wanted, timeout_ms, writer, options, "assert.notVisible");
+}
+
+fn untilNotVisibleKind(
+    device: anytype,
+    wanted: selector.Selector,
+    timeout_ms: u64,
+    writer: ?*trace.TraceWriter,
+    options: RunOptions,
+    kind: []const u8,
 ) !bool {
     const deadline = std.time.milliTimestamp() + @as(i64, @intCast(timeout_ms));
     while (true) {
         if (try nativeVisibleBySelector(device, wanted)) |visible| {
             if (!visible) {
-                if (writer) |tw| try runner_events.recordNativeWait(tw, "wait.notVisible", wanted, null);
+                if (writer) |tw| try runner_events.recordNativeWait(tw, kind, wanted, null, timeout_ms);
                 return true;
             }
             if (std.time.milliTimestamp() >= deadline) {
-                if (writer) |tw| try runner_events.recordNativeWaitTimeoutWithDiagnostics(device, tw, "wait.notVisible", &[_]selector.Selector{wanted});
+                if (writer) |tw| try runner_events.recordNativeWaitTimeoutWithDiagnostics(device, tw, kind, &[_]selector.Selector{wanted}, timeout_ms);
                 return false;
             }
             try sleepMs(options.poll_ms);
             continue;
         }
         var snap = device.snapshot(writer) catch |err| {
-            if (try retryTransientObservation(err, "wait.notVisible", writer, deadline, options)) continue;
+            if (try retryTransientObservation(err, kind, writer, deadline, options)) continue;
             return err;
         };
         defer snap.deinit(device.allocator);
         if (selector.find(snap.nodes, wanted) == null) {
-            if (writer) |tw| try tw.recordEvent("wait.notVisible", "{\"status\":\"ok\"}");
+            if (writer) |tw| {
+                var payload = std.ArrayList(u8).empty;
+                defer payload.deinit(tw.allocator);
+                try payload.writer(tw.allocator).writeAll("{\"status\":\"ok\",\"selector\":");
+                try trace.writeSelectorJson(payload.writer(tw.allocator), wanted);
+                try payload.writer(tw.allocator).print(",\"timeoutMs\":{d}}}", .{timeout_ms});
+                try tw.recordEvent(kind, payload.items);
+            }
             return true;
         }
         if (std.time.milliTimestamp() >= deadline) {
             if (writer) |tw| {
                 const selectors = [_]selector.Selector{wanted};
-                try runner_events.recordWaitTimeout(tw, "wait.notVisible", selectors[0..], snap);
+                try runner_events.recordDiagnosticWithStrategyAndTimeout(tw, kind, "timeout", null, selectors[0..], snap, timeout_ms);
             }
             return false;
         }
@@ -104,7 +160,7 @@ pub fn waitUntilAnyVisible(
         for (selectors, 0..) |wanted, index| {
             if (try nativeVisibleBySelector(device, wanted)) |visible| {
                 if (visible) {
-                    if (writer) |tw| try runner_events.recordNativeWait(tw, "wait.any", wanted, index);
+                    if (writer) |tw| try runner_events.recordNativeWait(tw, "wait.any", wanted, index, timeout_ms);
                     return index;
                 }
             } else {
@@ -114,7 +170,7 @@ pub fn waitUntilAnyVisible(
         }
         if (all_native) {
             if (std.time.milliTimestamp() >= deadline) {
-                if (writer) |tw| try runner_events.recordNativeWaitTimeoutWithDiagnostics(device, tw, "wait.any", selectors);
+                if (writer) |tw| try runner_events.recordNativeWaitTimeoutWithDiagnostics(device, tw, "wait.any", selectors, timeout_ms);
                 return null;
             }
             try sleepMs(options.poll_ms);
@@ -132,7 +188,7 @@ pub fn waitUntilAnyVisible(
                     defer payload.deinit(tw.allocator);
                     try payload.writer(tw.allocator).print("{{\"status\":\"ok\",\"matchedIndex\":{d},\"target\":\"{s}\",\"selector\":", .{ index, node.stable_id });
                     try trace.writeSelectorJson(payload.writer(tw.allocator), wanted);
-                    try payload.writer(tw.allocator).writeAll("}");
+                    try payload.writer(tw.allocator).print(",\"timeoutMs\":{d}}}", .{timeout_ms});
                     try tw.recordEvent("wait.any", payload.items);
                 }
                 return index;
@@ -170,12 +226,12 @@ pub fn assertNoneVisible(
         }
 
         if (!matched) {
-            if (writer) |tw| try tw.recordEvent("assert.noneVisible", "{\"status\":\"ok\"}");
+            if (writer) |tw| try runner_events.recordSelectorArrayStatus(tw, "assert.noneVisible", "ok", selectors, timeout_ms);
             return true;
         }
 
         if (std.time.milliTimestamp() >= deadline) {
-            if (writer) |tw| try runner_events.recordDiagnostic(tw, "assert.noneVisible", "visible", selectors, snap);
+            if (writer) |tw| try runner_events.recordDiagnosticWithStrategyAndTimeout(tw, "assert.noneVisible", "visible", null, selectors, snap, timeout_ms);
             return false;
         }
 
@@ -199,12 +255,16 @@ pub fn assertHealthy(
         defer snap.deinit(device.allocator);
 
         if (!health.hasUnhealthyOverlay(snap.nodes)) {
-            if (writer) |tw| try tw.recordEvent("assert.healthy", "{\"status\":\"ok\"}");
+            if (writer) |tw| {
+                const payload = try std.fmt.allocPrint(tw.allocator, "{{\"status\":\"ok\",\"timeoutMs\":{d}}}", .{timeout_ms});
+                defer tw.allocator.free(payload);
+                try tw.recordEvent("assert.healthy", payload);
+            }
             return true;
         }
 
         if (std.time.milliTimestamp() >= deadline) {
-            if (writer) |tw| try runner_events.recordDiagnostic(tw, "assert.healthy", "unhealthy", health_selectors, snap);
+            if (writer) |tw| try runner_events.recordDiagnosticWithStrategyAndTimeout(tw, "assert.healthy", "unhealthy", null, health_selectors, snap, timeout_ms);
             return false;
         }
 
@@ -233,7 +293,10 @@ pub fn scrollUntilVisible(
                 defer payload.deinit(tw.allocator);
                 try payload.writer(tw.allocator).print("{{\"status\":\"ok\",\"target\":\"{s}\",\"selector\":", .{node.stable_id});
                 try trace.writeSelectorJson(payload.writer(tw.allocator), wanted);
-                try payload.writer(tw.allocator).writeAll("}");
+                try payload.writer(tw.allocator).print(",\"direction\":\"{s}\",\"timeoutMs\":{d}}}", .{
+                    if (direction == .down) "down" else "up",
+                    timeout_ms,
+                });
                 try tw.recordEvent("ui.scrollUntilVisible", payload.items);
             }
             return true;

package/src/scaffold.zig

@@ -149,21 +149,21 @@ fn writeAppConfig(path: []const u8, app_id: []const u8, force: bool) !void {
         \\    "schemas": "zmr schemas --json",
         \\    "validate": "zmr validate --json .zmr/android-smoke.json && zmr validate --json .zmr/ios-smoke.json",
         \\    "android": "zmr run .zmr/android-smoke.json --device emulator-5554 --trace-dir traces/zmr-android",
-        \\    "androidReport": "zmr report traces/zmr-android --out traces/zmr-android/report.html",
+        \\    "androidReport": "zmr report traces/zmr-android --out traces/zmr-android/report.html --junit traces/zmr-android/junit.xml",
         \\    "androidReliability": "export ZMR_BIN=\"${ZMR_BIN:-zmr}\"; zmr-benchmark --zmr .zmr/android-smoke.json --device emulator-5554 --app-id
     );
     try writer.writeAll(" ");
     try writeJsonShellArg(writer, app_id);
     try writer.writeAll(
-        \\ --runs 20 --trace-root traces/zmr-android-reliability --min-pass-rate 100 --max-failures 0 --max-p95-ms 30000 && \"$ZMR_BIN\" report traces/zmr-android-reliability --out traces/zmr-android-reliability/report.html",
+        \\ --runs 20 --trace-root traces/zmr-android-reliability --min-pass-rate 100 --max-failures 0 --max-p95-ms 30000 && \"$ZMR_BIN\" report traces/zmr-android-reliability --out traces/zmr-android-reliability/report.html --junit traces/zmr-android-reliability/junit.xml",
         \\    "ios": "zmr run .zmr/ios-smoke.json --platform ios --device booted --trace-dir traces/zmr-ios",
-        \\    "iosReport": "zmr report traces/zmr-ios --out traces/zmr-ios/report.html",
+        \\    "iosReport": "zmr report traces/zmr-ios --out traces/zmr-ios/report.html --junit traces/zmr-ios/junit.xml",
         \\    "iosReliability": "export ZMR_BIN=\"${ZMR_BIN:-zmr}\"; zmr-benchmark --zmr .zmr/ios-smoke.json --platform ios --device booted --app-id
     );
     try writer.writeAll(" ");
     try writeJsonShellArg(writer, app_id);
     try writer.writeAll(
-        \\ --xcrun xcrun --runs 20 --trace-root traces/zmr-ios-reliability --min-pass-rate 100 --max-failures 0 --max-p95-ms 45000 && \"$ZMR_BIN\" report traces/zmr-ios-reliability --out traces/zmr-ios-reliability/report.html",
+        \\ --xcrun xcrun --runs 20 --trace-root traces/zmr-ios-reliability --min-pass-rate 100 --max-failures 0 --max-p95-ms 45000 && \"$ZMR_BIN\" report traces/zmr-ios-reliability --out traces/zmr-ios-reliability/report.html --junit traces/zmr-ios-reliability/junit.xml",
         \\    "matrix": "ZMR_BIN=${ZMR_BIN:-zmr} zmr-device-matrix --matrix .zmr/device-matrix.json --trace-root traces/zmr-matrix --min-pass-rate 100 --max-failures 0",
         \\    "pilotGate": "zmr-pilot-gate --android --ios --android-app-root . --android-app-id
     );
@@ -318,6 +318,7 @@ fn writeAgentInstructions(path: []const u8, app_id: []const u8, force: bool) !vo
         \\## Setup Checks
         \\
         \\```bash
+        \\zmr inspect --json --dir .
         \\zmr doctor --strict --json --config .zmr/config.json
         \\zmr schemas --json
         \\zmr validate --json .zmr/android-smoke.json && zmr validate --json .zmr/ios-smoke.json
@@ -332,6 +333,19 @@ fn writeAgentInstructions(path: []const u8, app_id: []const u8, force: bool) !vo
         \\
         \\Use `semantic_snapshot` before choosing tap or type actions. Prefer selectors from accessibility identifiers, resource ids, labels, or exact text before coordinates. Export redacted traces before sharing artifacts.
         \\
+        \\## Discover From Trace
+        \\
+        \\```bash
+        \\zmr explore --from-trace traces/zmr-agent --out .zmr/discovered/login-smoke.json --goal "find a stable login smoke" --include-actions --validate --json
+        \\zmr discover --from-trace traces/zmr-agent --out .zmr/discovered/replay-smoke.json --include-actions --validate --json
+        \\zmr draft --from-trace traces/zmr-agent --out .zmr/discovered/surface-smoke.json --json
+        \\zmr validate --json .zmr/discovered/surface-smoke.json
+        \\zmr draft --from-trace traces/zmr-agent --out .zmr/discovered/replay-smoke.json --include-actions --json
+        \\zmr validate --json .zmr/discovered/replay-smoke.json
+        \\```
+        \\
+        \\Prefer `zmr explore` for CLI agent loops when the goal should travel with the generated candidate. Its JSON includes `autonomous:false`, `reviewRequired:true`, `guardrails`, replay coverage, validation, and deterministic next commands. Treat discover output as a lower-level reviewable starting point. It writes from trace evidence and validates the generated file when `--validate` is present, but it does not crawl, invent missing actions, discover credentials, or commit tests. Treat draft output as a reviewable starting point when using the lower-level split workflow. The default draft contains only `launch`, `snapshot`, and conservative `assertVisible` checks. Use `--include-actions` only when the trace came from a reviewed agent session; unsupported events are skipped with warnings instead of guessed. Do not commit a discovered or drafted scenario until a human has reviewed and rerun it.
+        \\
         \\## Failure Triage
         \\
         \\```bash
@@ -352,21 +366,21 @@ fn writeAgentInstructions(path: []const u8, app_id: []const u8, force: bool) !vo
         \\
         \\```bash
         \\zmr run .zmr/android-smoke.json --device emulator-5554 --trace-dir traces/zmr-android
-        \\zmr report traces/zmr-android --out traces/zmr-android/report.html
+        \\zmr report traces/zmr-android --out traces/zmr-android/report.html --junit traces/zmr-android/junit.xml
         \\export ZMR_BIN="${ZMR_BIN:-zmr}"; zmr-benchmark --zmr .zmr/android-smoke.json --device emulator-5554 --app-id
     );
     try writer.writeAll(" ");
     try writeShellArg(writer, app_id);
     try writer.writeAll(
-        \\ --runs 20 --trace-root traces/zmr-android-reliability --min-pass-rate 100 --max-failures 0 --max-p95-ms 30000 && "$ZMR_BIN" report traces/zmr-android-reliability --out traces/zmr-android-reliability/report.html
+        \\ --runs 20 --trace-root traces/zmr-android-reliability --min-pass-rate 100 --max-failures 0 --max-p95-ms 30000 && "$ZMR_BIN" report traces/zmr-android-reliability --out traces/zmr-android-reliability/report.html --junit traces/zmr-android-reliability/junit.xml
         \\zmr run .zmr/ios-smoke.json --platform ios --device booted --trace-dir traces/zmr-ios
-        \\zmr report traces/zmr-ios --out traces/zmr-ios/report.html
+        \\zmr report traces/zmr-ios --out traces/zmr-ios/report.html --junit traces/zmr-ios/junit.xml
         \\export ZMR_BIN="${ZMR_BIN:-zmr}"; zmr-benchmark --zmr .zmr/ios-smoke.json --platform ios --device booted --app-id
     );
     try writer.writeAll(" ");
     try writeShellArg(writer, app_id);
     try writer.writeAll(
-        \\ --xcrun xcrun --runs 20 --trace-root traces/zmr-ios-reliability --min-pass-rate 100 --max-failures 0 --max-p95-ms 45000 && "$ZMR_BIN" report traces/zmr-ios-reliability --out traces/zmr-ios-reliability/report.html
+        \\ --xcrun xcrun --runs 20 --trace-root traces/zmr-ios-reliability --min-pass-rate 100 --max-failures 0 --max-p95-ms 45000 && "$ZMR_BIN" report traces/zmr-ios-reliability --out traces/zmr-ios-reliability/report.html --junit traces/zmr-ios-reliability/junit.xml
         \\```
         \\
         \\## Release Claims
@@ -380,25 +394,26 @@ fn writeAgentInstructions(path: []const u8, app_id: []const u8, force: bool) !vo
         \\## App Commands
         \\
         \\```bash
+        \\zmr inspect --json --dir .
         \\zmr doctor --strict --json --config .zmr/config.json
         \\zmr schemas --json
         \\zmr validate --json .zmr/android-smoke.json && zmr validate --json .zmr/ios-smoke.json
         \\zmr run .zmr/android-smoke.json --device emulator-5554 --trace-dir traces/zmr-android
-        \\zmr report traces/zmr-android --out traces/zmr-android/report.html
+        \\zmr report traces/zmr-android --out traces/zmr-android/report.html --junit traces/zmr-android/junit.xml
         \\export ZMR_BIN="${ZMR_BIN:-zmr}"; zmr-benchmark --zmr .zmr/android-smoke.json --device emulator-5554 --app-id
     );
     try writer.writeAll(" ");
     try writeShellArg(writer, app_id);
     try writer.writeAll(
-        \\ --runs 20 --trace-root traces/zmr-android-reliability --min-pass-rate 100 --max-failures 0 --max-p95-ms 30000 && "$ZMR_BIN" report traces/zmr-android-reliability --out traces/zmr-android-reliability/report.html
+        \\ --runs 20 --trace-root traces/zmr-android-reliability --min-pass-rate 100 --max-failures 0 --max-p95-ms 30000 && "$ZMR_BIN" report traces/zmr-android-reliability --out traces/zmr-android-reliability/report.html --junit traces/zmr-android-reliability/junit.xml
         \\zmr run .zmr/ios-smoke.json --platform ios --device booted --trace-dir traces/zmr-ios
-        \\zmr report traces/zmr-ios --out traces/zmr-ios/report.html
+        \\zmr report traces/zmr-ios --out traces/zmr-ios/report.html --junit traces/zmr-ios/junit.xml
         \\export ZMR_BIN="${ZMR_BIN:-zmr}"; zmr-benchmark --zmr .zmr/ios-smoke.json --platform ios --device booted --app-id
     );
     try writer.writeAll(" ");
     try writeShellArg(writer, app_id);
     try writer.writeAll(
-        \\ --xcrun xcrun --runs 20 --trace-root traces/zmr-ios-reliability --min-pass-rate 100 --max-failures 0 --max-p95-ms 45000 && "$ZMR_BIN" report traces/zmr-ios-reliability --out traces/zmr-ios-reliability/report.html
+        \\ --xcrun xcrun --runs 20 --trace-root traces/zmr-ios-reliability --min-pass-rate 100 --max-failures 0 --max-p95-ms 45000 && "$ZMR_BIN" report traces/zmr-ios-reliability --out traces/zmr-ios-reliability/report.html --junit traces/zmr-ios-reliability/junit.xml
         \\ZMR_BIN=${ZMR_BIN:-zmr} zmr-device-matrix --matrix .zmr/device-matrix.json --trace-root traces/zmr-matrix --min-pass-rate 100 --max-failures 0
     );
     try writer.writeAll("zmr-pilot-gate --android --ios --android-app-root . --android-app-id ");
@@ -410,6 +425,7 @@ fn writeAgentInstructions(path: []const u8, app_id: []const u8, force: bool) !vo
         \\zmr-release-readiness --evidence traces/zmr-pilots/evidence.jsonl --target production --json
         \\zmr serve --transport stdio --config .zmr/config.json --trace-dir traces/zmr-agent
         \\zmr mcp --config .zmr/config.json --trace-dir traces/zmr-agent
+        \\zmr discover --from-trace traces/zmr-agent --out .zmr/discovered/replay-smoke.json --include-actions --validate --json
         \\zmr explain traces/zmr-agent --json
         \\zmr export traces/zmr-agent --out traces/zmr-agent-redacted.zmrtrace --redact
         \\```

package/src/scenario.zig

@@ -25,6 +25,15 @@ pub const WaitAny = struct {
     }
 };
 
+pub const VisibilityAssertion = struct {
+    selector: selector.Selector,
+    timeout_ms: ?u64 = null,
+
+    pub fn deinit(self: VisibilityAssertion, allocator: std.mem.Allocator) void {
+        self.selector.deinit(allocator);
+    }
+};
+
 pub const TypeText = struct {
     selector: ?selector.Selector = null,
     text: []const u8,
@@ -105,8 +114,8 @@ pub const Step = union(enum) {
     wait_visible: WaitVisible,
     wait_not_visible: WaitVisible,
     wait_any: WaitAny,
-    assert_visible: selector.Selector,
-    assert_not_visible: selector.Selector,
+    assert_visible: VisibilityAssertion,
+    assert_not_visible: VisibilityAssertion,
     assert_none_visible: WaitAny,
     assert_healthy_timeout_ms: u64,
     optional: *Step,
@@ -265,8 +274,22 @@ fn parseRawStep(allocator: std.mem.Allocator, object: std.json.ObjectMap) anyerr
             .timeout_ms = try fields.optionalU64(object, "timeoutMs", 5000),
         } };
     }
-    if (std.mem.eql(u8, action, "assertVisible")) return .{ .assert_visible = try fields.parseSelectorField(allocator, object) };
-    if (std.mem.eql(u8, action, "assertNotVisible")) return .{ .assert_not_visible = try fields.parseSelectorField(allocator, object) };
+    if (std.mem.eql(u8, action, "assertVisible")) {
+        const wanted = try fields.parseSelectorField(allocator, object);
+        errdefer wanted.deinit(allocator);
+        return .{ .assert_visible = .{
+            .selector = wanted,
+            .timeout_ms = try optionalTimeoutMs(object),
+        } };
+    }
+    if (std.mem.eql(u8, action, "assertNotVisible")) {
+        const wanted = try fields.parseSelectorField(allocator, object);
+        errdefer wanted.deinit(allocator);
+        return .{ .assert_not_visible = .{
+            .selector = wanted,
+            .timeout_ms = try optionalTimeoutMs(object),
+        } };
+    }
     if (std.mem.eql(u8, action, "assertHealthy")) return .{ .assert_healthy_timeout_ms = try fields.optionalU64(object, "timeoutMs", 0) };
     if (std.mem.eql(u8, action, "assertNoneVisible")) {
         const selectors = try fields.parseSelectorArrayField(allocator, object);
@@ -344,3 +367,8 @@ fn optionalDirection(object: std.json.ObjectMap, key: []const u8, default_value:
     if (std.mem.eql(u8, value.string, "up")) return .up;
     return error.UnknownScrollDirection;
 }
+
+fn optionalTimeoutMs(object: std.json.ObjectMap) !?u64 {
+    if (object.get("timeoutMs") == null) return null;
+    return try fields.optionalU64(object, "timeoutMs", 0);
+}

package/src/schema_registry.zig

@@ -26,6 +26,10 @@ const public_schemas = [_]PublicSchema{
     .{ .name = "capabilities-output", .path = "schemas/capabilities-output.schema.json", .id = "https://zmr.dev/schemas/capabilities-output.schema.json", .description = "Machine-readable runner.capabilities JSON-RPC result" },
     .{ .name = "explain-output", .path = "schemas/explain-output.schema.json", .id = "https://zmr.dev/schemas/explain-output.schema.json", .description = "Machine-readable zmr explain --json failure triage output" },
     .{ .name = "run-output", .path = "schemas/run-output.schema.json", .id = "https://zmr.dev/schemas/run-output.schema.json", .description = "Machine-readable zmr run --json terminal summary output" },
+    .{ .name = "inspect-output", .path = "schemas/inspect-output.schema.json", .id = "https://zmr.dev/schemas/inspect-output.schema.json", .description = "Machine-readable zmr inspect --json app and agent handoff output" },
+    .{ .name = "discover-output", .path = "schemas/discover-output.schema.json", .id = "https://zmr.dev/schemas/discover-output.schema.json", .description = "Machine-readable zmr discover --json trace-backed scenario discovery output" },
+    .{ .name = "explore-output", .path = "schemas/explore-output.schema.json", .id = "https://zmr.dev/schemas/explore-output.schema.json", .description = "Machine-readable zmr explore --json review-first trace exploration output" },
+    .{ .name = "draft-output", .path = "schemas/draft-output.schema.json", .id = "https://zmr.dev/schemas/draft-output.schema.json", .description = "Machine-readable zmr draft --json scenario draft output" },
     .{ .name = "release-manifest", .path = "schemas/release-manifest.schema.json", .id = "https://zmr.dev/schemas/release-manifest.schema.json", .description = "Machine-readable RELEASE_MANIFEST.json emitted with release archives" },
     .{ .name = "release-readiness-output", .path = "schemas/release-readiness-output.schema.json", .id = "https://zmr.dev/schemas/release-readiness-output.schema.json", .description = "Machine-readable zmr-release-readiness --json release evidence gate output" },
     .{ .name = "schemas-output", .path = "schemas/schemas-output.schema.json", .id = "https://zmr.dev/schemas/schemas-output.schema.json", .description = "Machine-readable zmr schemas --json public schema index" },

package/src/version.zig

@@ -1,4 +1,4 @@
-pub const runner_version = "0.1.3";
+pub const runner_version = "0.2.0";
 pub const protocol_version = "2026-04-28";
 pub const protocol_min_compatible_version = "2026-04-28";
 pub const protocol_stability = "dev-preview";

package/viewer/app.js

@@ -73,22 +73,42 @@ els.dropTarget.addEventListener("drop", async (event) => {
 });
 
 async function loadBundleFile(file) {
-  setStatus(`Loading ${file.name}`);
+  await loadBundle(file.name, () => file.arrayBuffer());
+}
+
+async function loadBundleFromUrl(url) {
+  const name = url.split("/").pop() || url;
+  await loadBundle(name, async () => {
+    const response = await fetch(url);
+    if (!response.ok) {
+      throw new Error(`Failed to fetch ${url}: HTTP ${response.status}`);
+    }
+    return await response.arrayBuffer();
+  });
+}
+
+async function loadBundle(name, getBuffer) {
+  setStatus(`Loading ${name}`);
   try {
     stopReplay();
     revokeObjectUrls();
-    const entries = parseTarArchive(await file.arrayBuffer());
+    const entries = parseTarArchive(await getBuffer());
     const model = buildTraceModel(entries);
     state.model = model;
     state.selectedFrameIndex = 0;
     state.selectedEvent = model.replayFrames[0]?.event ?? model.events[0] ?? null;
-    renderModel(file.name);
+    renderModel(name);
   } catch (error) {
     console.error(error);
     setStatus(error instanceof Error ? error.message : String(error), true);
   }
 }
 
+const bundleParam = new URLSearchParams(window.location.search).get("bundle");
+if (bundleParam) {
+  loadBundleFromUrl(bundleParam);
+}
+
 function renderModel(fileName) {
   const { summary } = state.model;
   els.emptyState.classList.add("hidden");