@dyno-cloud/schema 0.1.2 → 0.1.3

package/json/catalogue.schema.json

@@ -1256,6 +1256,46 @@
         }
       ]
     },
+    "MemorySample": {
+      "description": "One process's memory at one moment.",
+      "type": "object",
+      "properties": {
+        "private_bytes": {
+          "description": "The memory that only this process holds, as the OS counts it for the process (see\n[`TimelineMethod`]).",
+          "type": "integer",
+          "format": "uint64",
+          "minimum": 0
+        },
+        "resident_bytes": {
+          "description": "Resident memory, shared pages included. Null when the method does not read it.",
+          "type": [
+            "integer",
+            "null"
+          ],
+          "format": "uint64",
+          "minimum": 0
+        },
+        "shared_bytes": {
+          "description": "Resident shared memory, such as the buffers the GPU process and the renderers share. Null\nwhen the method does not read it.",
+          "type": [
+            "integer",
+            "null"
+          ],
+          "format": "uint64",
+          "minimum": 0
+        },
+        "t_ms": {
+          "description": "Since the navigation, on the driver's clock.",
+          "type": "integer",
+          "format": "uint64",
+          "minimum": 0
+        }
+      },
+      "required": [
+        "t_ms",
+        "private_bytes"
+      ]
+    },
     "Method": {
       "description": "How a value was found. Declared in alphabetical order, so evidence sorts by name.",
       "oneOf": [
@@ -1343,6 +1383,36 @@
         "android"
       ]
     },
+    "ProcessRole": {
+      "description": "The part a process plays in the run, as far as the driver can tell.",
+      "oneOf": [
+        {
+          "description": "It runs the game frame.",
+          "type": "string",
+          "const": "game"
+        },
+        {
+          "description": "It runs the harness page.",
+          "type": "string",
+          "const": "page"
+        },
+        {
+          "description": "The GPU process.",
+          "type": "string",
+          "const": "gpu"
+        },
+        {
+          "description": "The browser's main process.",
+          "type": "string",
+          "const": "browser"
+        },
+        {
+          "description": "Any other process, such as a spare renderer or the network service.",
+          "type": "string",
+          "const": "other"
+        }
+      ]
+    },
     "ProfileRef": {
       "description": "Which host profile, and which version of it, a result used.",
       "type": "object",
@@ -1558,6 +1628,18 @@
         "tier": {
           "$ref": "#/$defs/TierReport"
         },
+        "timeline": {
+          "description": "The memory of each browser process through the browser run, with the run's steps. Null\nwhen the driver read none, such as on a machine without a sampler.",
+          "anyOf": [
+            {
+              "$ref": "#/$defs/Timeline"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null
+        },
         "tool_build": {
           "$ref": "#/$defs/ToolBuild"
         }
@@ -1574,6 +1656,51 @@
         "tier"
       ]
     },
+    "RunMark": {
+      "description": "The steps of a run. They sort in the order they are declared.",
+      "oneOf": [
+        {
+          "description": "The harness page started loading the game frame.",
+          "type": "string",
+          "const": "navigated"
+        },
+        {
+          "description": "The game frame went idle.",
+          "type": "string",
+          "const": "idle"
+        },
+        {
+          "description": "The harness made the game active, such as by sending `reels:active` `true`.",
+          "type": "string",
+          "const": "activated"
+        },
+        {
+          "description": "The harness made the game inactive.",
+          "type": "string",
+          "const": "deactivated"
+        },
+        {
+          "description": "The game frame committed a new document, as a script redirect does. Probe events after\nit are on the new document's clock.",
+          "type": "string",
+          "const": "frame_document"
+        },
+        {
+          "description": "The driver forced a garbage collection and sent a critical memory pressure signal, after\nthe active watch. The memory after it is what the game holds once garbage and caches go.",
+          "type": "string",
+          "const": "purged"
+        },
+        {
+          "description": "The phone's kernel killed the game's process: jetsam did, or it went over a fatal memory\nlimit.",
+          "type": "string",
+          "const": "killed"
+        },
+        {
+          "description": "The game's process went over a memory limit that does not kill it, such as iOS's soft\nlimit.",
+          "type": "string",
+          "const": "over_memory_limit"
+        }
+      ]
+    },
     "Scenario": {
       "description": "The harness scenario of a browser run.",
       "oneOf": [
@@ -1789,6 +1916,112 @@
         "phase"
       ]
     },
+    "Timeline": {
+      "description": "The memory of each browser process through one run.",
+      "type": "object",
+      "properties": {
+        "every_ms": {
+          "description": "The time between samples that the sampler asked for. A busy machine can make it longer.",
+          "type": "integer",
+          "format": "uint32",
+          "minimum": 0
+        },
+        "marks": {
+          "description": "The run's steps, on the samples' clock. Sorted by time, then step.",
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/TimelineMark"
+          }
+        },
+        "method": {
+          "$ref": "#/$defs/TimelineMethod"
+        },
+        "processes": {
+          "description": "Every process the sampler saw. Sorted by pid.",
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/TimelineProcess"
+          }
+        }
+      },
+      "required": [
+        "method",
+        "every_ms",
+        "marks",
+        "processes"
+      ]
+    },
+    "TimelineMark": {
+      "description": "One step of the run, on the timeline's clock.",
+      "type": "object",
+      "properties": {
+        "mark": {
+          "$ref": "#/$defs/RunMark"
+        },
+        "t_ms": {
+          "description": "Since the navigation, on the driver's clock.",
+          "type": "integer",
+          "format": "uint64",
+          "minimum": 0
+        }
+      },
+      "required": [
+        "mark",
+        "t_ms"
+      ]
+    },
+    "TimelineMethod": {
+      "description": "How a timeline's samples were read.",
+      "oneOf": [
+        {
+          "description": "Linux's `/proc/<pid>/status`: `private_bytes` is `RssAnon` plus `VmSwap`, the private\nmemory footprint that Chromium reports on Linux.",
+          "type": "string",
+          "const": "proc"
+        },
+        {
+          "description": "An Activity Monitor trace that xctrace exported, such as a device cloud's: `private_bytes`\nis the physical footprint that jetsam reads.",
+          "type": "string",
+          "const": "xctrace"
+        },
+        {
+          "description": "The iPhone's sysmontap service, which `--device` reads: `private_bytes` is the physical\nfootprint that jetsam reads.",
+          "type": "string",
+          "const": "sysmontap"
+        }
+      ]
+    },
+    "TimelineProcess": {
+      "description": "One process of the browser, and its memory through the run.",
+      "type": "object",
+      "properties": {
+        "kind": {
+          "description": "What the browser calls the process, such as \"renderer\", \"gpu-process\" or\n\"utility:network.mojom.NetworkService\", or its name, such as\n\"com.apple.WebKit.WebContent\".",
+          "type": "string"
+        },
+        "pid": {
+          "description": "The OS process id. It only tells processes apart within this run.",
+          "type": "integer",
+          "format": "uint32",
+          "minimum": 0
+        },
+        "role": {
+          "$ref": "#/$defs/ProcessRole"
+        },
+        "samples": {
+          "description": "Sorted by time.",
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/MemorySample"
+          }
+        }
+      },
+      "required": [
+        "pid",
+        "role",
+        "kind",
+        "samples"
+      ]
+    },
     "ToolBuild": {
       "description": "The dyno binary that made the result.",
       "type": "object",

package/json/driver-message.schema.json

@@ -164,6 +164,67 @@
         "t_ms"
       ]
     },
+    {
+      "description": "The memory of every browser process at one moment, read from the OS. A driver that cannot\nread it sends none.",
+      "type": "object",
+      "properties": {
+        "every_ms": {
+          "description": "The time between samples that the driver asked for.",
+          "type": "integer",
+          "format": "uint32",
+          "minimum": 0
+        },
+        "method": {
+          "$ref": "#/$defs/TimelineMethod"
+        },
+        "processes": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/ProcessMemory"
+          }
+        },
+        "t_ms": {
+          "type": "number",
+          "format": "double"
+        },
+        "type": {
+          "type": "string",
+          "const": "memory"
+        }
+      },
+      "required": [
+        "type",
+        "method",
+        "every_ms",
+        "processes",
+        "t_ms"
+      ]
+    },
+    {
+      "description": "The part that each named process plays in the run, as far as the driver knows. A later\n`roles` message overrides an earlier one for the same process. A process that no message\nnames is `other`.",
+      "type": "object",
+      "properties": {
+        "roles": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/AssignedRole"
+          }
+        },
+        "t_ms": {
+          "type": "number",
+          "format": "double"
+        },
+        "type": {
+          "type": "string",
+          "const": "roles"
+        }
+      },
+      "required": [
+        "type",
+        "roles",
+        "t_ms"
+      ]
+    },
     {
       "description": "The last line of a run that finished.",
       "type": "object",
@@ -206,6 +267,24 @@
     }
   ],
   "$defs": {
+    "AssignedRole": {
+      "description": "One process's part in a `roles` message.",
+      "type": "object",
+      "properties": {
+        "pid": {
+          "type": "integer",
+          "format": "uint32",
+          "minimum": 0
+        },
+        "role": {
+          "$ref": "#/$defs/ProcessRole"
+        }
+      },
+      "required": [
+        "pid",
+        "role"
+      ]
+    },
     "AudioState": {
       "description": "An audio context's state.",
       "type": "string",
@@ -675,8 +754,82 @@
         }
       ]
     },
+    "ProcessMemory": {
+      "description": "One process's memory in a `memory` message.",
+      "type": "object",
+      "properties": {
+        "kind": {
+          "description": "What the browser calls the process, such as \"renderer\" or \"gpu-process\".",
+          "type": "string"
+        },
+        "pid": {
+          "type": "integer",
+          "format": "uint32",
+          "minimum": 0
+        },
+        "private_bytes": {
+          "description": "The memory that only this process holds (see `TimelineMethod`).",
+          "type": "integer",
+          "format": "uint64",
+          "minimum": 0
+        },
+        "resident_bytes": {
+          "description": "Resident memory, shared pages included. Null when not read.",
+          "type": [
+            "integer",
+            "null"
+          ],
+          "format": "uint64",
+          "minimum": 0
+        },
+        "shared_bytes": {
+          "description": "Resident shared memory. Null when not read.",
+          "type": [
+            "integer",
+            "null"
+          ],
+          "format": "uint64",
+          "minimum": 0
+        }
+      },
+      "required": [
+        "pid",
+        "kind",
+        "private_bytes"
+      ]
+    },
+    "ProcessRole": {
+      "description": "The part a process plays in the run, as far as the driver can tell.",
+      "oneOf": [
+        {
+          "description": "It runs the game frame.",
+          "type": "string",
+          "const": "game"
+        },
+        {
+          "description": "It runs the harness page.",
+          "type": "string",
+          "const": "page"
+        },
+        {
+          "description": "The GPU process.",
+          "type": "string",
+          "const": "gpu"
+        },
+        {
+          "description": "The browser's main process.",
+          "type": "string",
+          "const": "browser"
+        },
+        {
+          "description": "Any other process, such as a spare renderer or the network service.",
+          "type": "string",
+          "const": "other"
+        }
+      ]
+    },
     "RunMark": {
-      "description": "The steps of a run.",
+      "description": "The steps of a run. They sort in the order they are declared.",
       "oneOf": [
         {
           "description": "The harness page started loading the game frame.",
@@ -702,6 +855,21 @@
           "description": "The game frame committed a new document, as a script redirect does. Probe events after\nit are on the new document's clock.",
           "type": "string",
           "const": "frame_document"
+        },
+        {
+          "description": "The driver forced a garbage collection and sent a critical memory pressure signal, after\nthe active watch. The memory after it is what the game holds once garbage and caches go.",
+          "type": "string",
+          "const": "purged"
+        },
+        {
+          "description": "The phone's kernel killed the game's process: jetsam did, or it went over a fatal memory\nlimit.",
+          "type": "string",
+          "const": "killed"
+        },
+        {
+          "description": "The game's process went over a memory limit that does not kill it, such as iOS's soft\nlimit.",
+          "type": "string",
+          "const": "over_memory_limit"
         }
       ]
     },
@@ -719,6 +887,26 @@
           "const": "canvas"
         }
       ]
+    },
+    "TimelineMethod": {
+      "description": "How a timeline's samples were read.",
+      "oneOf": [
+        {
+          "description": "Linux's `/proc/<pid>/status`: `private_bytes` is `RssAnon` plus `VmSwap`, the private\nmemory footprint that Chromium reports on Linux.",
+          "type": "string",
+          "const": "proc"
+        },
+        {
+          "description": "An Activity Monitor trace that xctrace exported, such as a device cloud's: `private_bytes`\nis the physical footprint that jetsam reads.",
+          "type": "string",
+          "const": "xctrace"
+        },
+        {
+          "description": "The iPhone's sysmontap service, which `--device` reads: `private_bytes` is the physical\nfootprint that jetsam reads.",
+          "type": "string",
+          "const": "sysmontap"
+        }
+      ]
     }
   }
 }

package/json/result.schema.json

@@ -1202,6 +1202,46 @@
         }
       ]
     },
+    "MemorySample": {
+      "description": "One process's memory at one moment.",
+      "type": "object",
+      "properties": {
+        "private_bytes": {
+          "description": "The memory that only this process holds, as the OS counts it for the process (see\n[`TimelineMethod`]).",
+          "type": "integer",
+          "format": "uint64",
+          "minimum": 0
+        },
+        "resident_bytes": {
+          "description": "Resident memory, shared pages included. Null when the method does not read it.",
+          "type": [
+            "integer",
+            "null"
+          ],
+          "format": "uint64",
+          "minimum": 0
+        },
+        "shared_bytes": {
+          "description": "Resident shared memory, such as the buffers the GPU process and the renderers share. Null\nwhen the method does not read it.",
+          "type": [
+            "integer",
+            "null"
+          ],
+          "format": "uint64",
+          "minimum": 0
+        },
+        "t_ms": {
+          "description": "Since the navigation, on the driver's clock.",
+          "type": "integer",
+          "format": "uint64",
+          "minimum": 0
+        }
+      },
+      "required": [
+        "t_ms",
+        "private_bytes"
+      ]
+    },
     "Method": {
       "description": "How a value was found. Declared in alphabetical order, so evidence sorts by name.",
       "oneOf": [
@@ -1289,6 +1329,36 @@
         "android"
       ]
     },
+    "ProcessRole": {
+      "description": "The part a process plays in the run, as far as the driver can tell.",
+      "oneOf": [
+        {
+          "description": "It runs the game frame.",
+          "type": "string",
+          "const": "game"
+        },
+        {
+          "description": "It runs the harness page.",
+          "type": "string",
+          "const": "page"
+        },
+        {
+          "description": "The GPU process.",
+          "type": "string",
+          "const": "gpu"
+        },
+        {
+          "description": "The browser's main process.",
+          "type": "string",
+          "const": "browser"
+        },
+        {
+          "description": "Any other process, such as a spare renderer or the network service.",
+          "type": "string",
+          "const": "other"
+        }
+      ]
+    },
     "ProfileRef": {
       "description": "Which host profile, and which version of it, a result used.",
       "type": "object",
@@ -1504,6 +1574,18 @@
         "tier": {
           "$ref": "#/$defs/TierReport"
         },
+        "timeline": {
+          "description": "The memory of each browser process through the browser run, with the run's steps. Null\nwhen the driver read none, such as on a machine without a sampler.",
+          "anyOf": [
+            {
+              "$ref": "#/$defs/Timeline"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null
+        },
         "tool_build": {
           "$ref": "#/$defs/ToolBuild"
         }
@@ -1520,6 +1602,51 @@
         "tier"
       ]
     },
+    "RunMark": {
+      "description": "The steps of a run. They sort in the order they are declared.",
+      "oneOf": [
+        {
+          "description": "The harness page started loading the game frame.",
+          "type": "string",
+          "const": "navigated"
+        },
+        {
+          "description": "The game frame went idle.",
+          "type": "string",
+          "const": "idle"
+        },
+        {
+          "description": "The harness made the game active, such as by sending `reels:active` `true`.",
+          "type": "string",
+          "const": "activated"
+        },
+        {
+          "description": "The harness made the game inactive.",
+          "type": "string",
+          "const": "deactivated"
+        },
+        {
+          "description": "The game frame committed a new document, as a script redirect does. Probe events after\nit are on the new document's clock.",
+          "type": "string",
+          "const": "frame_document"
+        },
+        {
+          "description": "The driver forced a garbage collection and sent a critical memory pressure signal, after\nthe active watch. The memory after it is what the game holds once garbage and caches go.",
+          "type": "string",
+          "const": "purged"
+        },
+        {
+          "description": "The phone's kernel killed the game's process: jetsam did, or it went over a fatal memory\nlimit.",
+          "type": "string",
+          "const": "killed"
+        },
+        {
+          "description": "The game's process went over a memory limit that does not kill it, such as iOS's soft\nlimit.",
+          "type": "string",
+          "const": "over_memory_limit"
+        }
+      ]
+    },
     "Scenario": {
       "description": "The harness scenario of a browser run.",
       "oneOf": [
@@ -1712,6 +1839,112 @@
         "phase"
       ]
     },
+    "Timeline": {
+      "description": "The memory of each browser process through one run.",
+      "type": "object",
+      "properties": {
+        "every_ms": {
+          "description": "The time between samples that the sampler asked for. A busy machine can make it longer.",
+          "type": "integer",
+          "format": "uint32",
+          "minimum": 0
+        },
+        "marks": {
+          "description": "The run's steps, on the samples' clock. Sorted by time, then step.",
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/TimelineMark"
+          }
+        },
+        "method": {
+          "$ref": "#/$defs/TimelineMethod"
+        },
+        "processes": {
+          "description": "Every process the sampler saw. Sorted by pid.",
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/TimelineProcess"
+          }
+        }
+      },
+      "required": [
+        "method",
+        "every_ms",
+        "marks",
+        "processes"
+      ]
+    },
+    "TimelineMark": {
+      "description": "One step of the run, on the timeline's clock.",
+      "type": "object",
+      "properties": {
+        "mark": {
+          "$ref": "#/$defs/RunMark"
+        },
+        "t_ms": {
+          "description": "Since the navigation, on the driver's clock.",
+          "type": "integer",
+          "format": "uint64",
+          "minimum": 0
+        }
+      },
+      "required": [
+        "mark",
+        "t_ms"
+      ]
+    },
+    "TimelineMethod": {
+      "description": "How a timeline's samples were read.",
+      "oneOf": [
+        {
+          "description": "Linux's `/proc/<pid>/status`: `private_bytes` is `RssAnon` plus `VmSwap`, the private\nmemory footprint that Chromium reports on Linux.",
+          "type": "string",
+          "const": "proc"
+        },
+        {
+          "description": "An Activity Monitor trace that xctrace exported, such as a device cloud's: `private_bytes`\nis the physical footprint that jetsam reads.",
+          "type": "string",
+          "const": "xctrace"
+        },
+        {
+          "description": "The iPhone's sysmontap service, which `--device` reads: `private_bytes` is the physical\nfootprint that jetsam reads.",
+          "type": "string",
+          "const": "sysmontap"
+        }
+      ]
+    },
+    "TimelineProcess": {
+      "description": "One process of the browser, and its memory through the run.",
+      "type": "object",
+      "properties": {
+        "kind": {
+          "description": "What the browser calls the process, such as \"renderer\", \"gpu-process\" or\n\"utility:network.mojom.NetworkService\", or its name, such as\n\"com.apple.WebKit.WebContent\".",
+          "type": "string"
+        },
+        "pid": {
+          "description": "The OS process id. It only tells processes apart within this run.",
+          "type": "integer",
+          "format": "uint32",
+          "minimum": 0
+        },
+        "role": {
+          "$ref": "#/$defs/ProcessRole"
+        },
+        "samples": {
+          "description": "Sorted by time.",
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/MemorySample"
+          }
+        }
+      },
+      "required": [
+        "pid",
+        "role",
+        "kind",
+        "samples"
+      ]
+    },
     "ToolBuild": {
       "description": "The dyno binary that made the result.",
       "type": "object",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dyno-cloud/schema",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "TypeScript types and JSON Schema for the JSON that dyno writes: check results, compare results, the runner protocol and the probe events.",
   "license": "MIT OR Apache-2.0",
   "repository": {

package/ts/AssignedRole.ts

@@ -0,0 +1,7 @@
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { ProcessRole } from "./ProcessRole";
+
+/**
+ * One process's part in a `roles` message.
+ */
+export type AssignedRole = { pid: number, role: ProcessRole, };

package/ts/DriverMessage.ts

@@ -1,7 +1,10 @@
 // This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { AssignedRole } from "./AssignedRole";
 import type { DriverInfo } from "./DriverInfo";
 import type { ProbeEvent } from "./ProbeEvent";
+import type { ProcessMemory } from "./ProcessMemory";
 import type { RunMark } from "./RunMark";
+import type { TimelineMethod } from "./TimelineMethod";
 
 /**
  * One line from a driver. `t_ms` is the time since the driver started the navigation.
@@ -27,4 +30,8 @@ webgl_renderer: string | null,
  * at frame time `t` happened at `t + frame_clock_at_ms` after the navigation. Null from
  * a driver that does not read it.
  */
-frame_clock_at_ms: number | null, t_ms: number, } | { "type": "mark", mark: RunMark, t_ms: number, } | { "type": "done", t_ms: number, } | { "type": "error", message: string, t_ms: number, };
+frame_clock_at_ms: number | null, t_ms: number, } | { "type": "mark", mark: RunMark, t_ms: number, } | { "type": "memory", method: TimelineMethod, 
+/**
+ * The time between samples that the driver asked for.
+ */
+every_ms: number, processes: Array<ProcessMemory>, t_ms: number, } | { "type": "roles", roles: Array<AssignedRole>, t_ms: number, } | { "type": "done", t_ms: number, } | { "type": "error", message: string, t_ms: number, };

package/ts/MemorySample.ts

@@ -0,0 +1,24 @@
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+/**
+ * One process's memory at one moment.
+ */
+export type MemorySample = { 
+/**
+ * Since the navigation, on the driver's clock.
+ */
+t_ms: number, 
+/**
+ * The memory that only this process holds, as the OS counts it for the process (see
+ * [`TimelineMethod`]).
+ */
+private_bytes: number, 
+/**
+ * Resident memory, shared pages included. Null when the method does not read it.
+ */
+resident_bytes: number | null, 
+/**
+ * Resident shared memory, such as the buffers the GPU process and the renderers share. Null
+ * when the method does not read it.
+ */
+shared_bytes: number | null, };

package/ts/ProcessMemory.ts

@@ -0,0 +1,22 @@
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+/**
+ * One process's memory in a `memory` message.
+ */
+export type ProcessMemory = { pid: number, 
+/**
+ * What the browser calls the process, such as "renderer" or "gpu-process".
+ */
+kind: string, 
+/**
+ * The memory that only this process holds (see `TimelineMethod`).
+ */
+private_bytes: number, 
+/**
+ * Resident memory, shared pages included. Null when not read.
+ */
+resident_bytes: number | null, 
+/**
+ * Resident shared memory. Null when not read.
+ */
+shared_bytes: number | null, };

package/ts/ProcessRole.ts

@@ -0,0 +1,6 @@
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+/**
+ * The part a process plays in the run, as far as the driver can tell.
+ */
+export type ProcessRole = "game" | "page" | "gpu" | "browser" | "other";

package/ts/RunInfo.ts

@@ -8,6 +8,7 @@ import type { Measure } from "./Measure";
 import type { Release } from "./Release";
 import type { Target } from "./Target";
 import type { TierReport } from "./TierReport";
+import type { Timeline } from "./Timeline";
 import type { ToolBuild } from "./ToolBuild";
 
 /**
@@ -47,4 +48,9 @@ measures: Array<Measure>,
  * Lab rule findings, such as the host contract checks. Sorted by rule id, then by the
  * finding's canonical JSON.
  */
-findings: Array<Finding>, tier: TierReport, };
+findings: Array<Finding>, tier: TierReport, 
+/**
+ * The memory of each browser process through the browser run, with the run's steps. Null
+ * when the driver read none, such as on a machine without a sampler.
+ */
+timeline?: Timeline | null, };

package/ts/RunMark.ts

@@ -1,6 +1,6 @@
 // This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
 
 /**
- * The steps of a run.
+ * The steps of a run. They sort in the order they are declared.
  */
-export type RunMark = "navigated" | "idle" | "activated" | "deactivated" | "frame_document";
+export type RunMark = "navigated" | "idle" | "activated" | "deactivated" | "frame_document" | "purged" | "killed" | "over_memory_limit";

package/ts/Timeline.ts

@@ -0,0 +1,21 @@
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { TimelineMark } from "./TimelineMark";
+import type { TimelineMethod } from "./TimelineMethod";
+import type { TimelineProcess } from "./TimelineProcess";
+
+/**
+ * The memory of each browser process through one run.
+ */
+export type Timeline = { method: TimelineMethod, 
+/**
+ * The time between samples that the sampler asked for. A busy machine can make it longer.
+ */
+every_ms: number, 
+/**
+ * The run's steps, on the samples' clock. Sorted by time, then step.
+ */
+marks: Array<TimelineMark>, 
+/**
+ * Every process the sampler saw. Sorted by pid.
+ */
+processes: Array<TimelineProcess>, };

package/ts/TimelineMark.ts

@@ -0,0 +1,11 @@
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { RunMark } from "./RunMark";
+
+/**
+ * One step of the run, on the timeline's clock.
+ */
+export type TimelineMark = { mark: RunMark, 
+/**
+ * Since the navigation, on the driver's clock.
+ */
+t_ms: number, };

package/ts/TimelineMethod.ts

@@ -0,0 +1,6 @@
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+/**
+ * How a timeline's samples were read.
+ */
+export type TimelineMethod = "proc" | "xctrace" | "sysmontap";

package/ts/TimelineProcess.ts

@@ -0,0 +1,22 @@
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { MemorySample } from "./MemorySample";
+import type { ProcessRole } from "./ProcessRole";
+
+/**
+ * One process of the browser, and its memory through the run.
+ */
+export type TimelineProcess = { 
+/**
+ * The OS process id. It only tells processes apart within this run.
+ */
+pid: number, role: ProcessRole, 
+/**
+ * What the browser calls the process, such as "renderer", "gpu-process" or
+ * "utility:network.mojom.NetworkService", or its name, such as
+ * "com.apple.WebKit.WebContent".
+ */
+kind: string, 
+/**
+ * Sorted by time.
+ */
+samples: Array<MemorySample>, };

package/ts/index.ts

@@ -1,6 +1,7 @@
 // Generated by dyno-schema. Do not edit this file manually.
 export type * from "./AssetChange";
 export type * from "./AssetChangeKind";
+export type * from "./AssignedRole";
 export type * from "./AudioState";
 export type * from "./BrowserEngine";
 export type * from "./BudgetId";
@@ -53,10 +54,13 @@ export type * from "./MeasureId";
 export type * from "./MeasureItem";
 export type * from "./MeasureStatus";
 export type * from "./MeasureValue";
+export type * from "./MemorySample";
 export type * from "./MessageDirection";
 export type * from "./Method";
 export type * from "./OsName";
 export type * from "./ProbeEvent";
+export type * from "./ProcessMemory";
+export type * from "./ProcessRole";
 export type * from "./ProfileRef";
 export type * from "./Quantity";
 export type * from "./RelPath";
@@ -78,6 +82,10 @@ export type * from "./Status";
 export type * from "./Target";
 export type * from "./Tier";
 export type * from "./TierReport";
+export type * from "./Timeline";
+export type * from "./TimelineMark";
+export type * from "./TimelineMethod";
+export type * from "./TimelineProcess";
 export type * from "./ToolBuild";
 export type * from "./Uncertainty";
 export type * from "./UncertaintyKind";