@qontinui/shared-types 1.0.0 → 2.0.0

package/dist/rag.d.cts

@@ -1,7 +1,7 @@
 /* eslint-disable */
 /**
  * This file was automatically generated.
- * DO NOT MODIFY IT BY HAND. Regenerate with `just generate-types` or
+ * DO NOT MODIFY IT BY HAND. Regenerate with
  * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
  */
 
@@ -14,7 +14,7 @@ type JobStatus =
 /* eslint-disable */
 /**
  * This file was automatically generated.
- * DO NOT MODIFY IT BY HAND. Regenerate with `just generate-types` or
+ * DO NOT MODIFY IT BY HAND. Regenerate with
  * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
  */
 
@@ -27,7 +27,7 @@ type RagProcessingStatus =
 /* eslint-disable */
 /**
  * This file was automatically generated.
- * DO NOT MODIFY IT BY HAND. Regenerate with `just generate-types` or
+ * DO NOT MODIFY IT BY HAND. Regenerate with
  * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
  */
 
@@ -48,7 +48,7 @@ interface ComputeTextEmbeddingRequest {
 /* eslint-disable */
 /**
  * This file was automatically generated.
- * DO NOT MODIFY IT BY HAND. Regenerate with `just generate-types` or
+ * DO NOT MODIFY IT BY HAND. Regenerate with
  * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
  */
 
@@ -81,7 +81,7 @@ interface ComputeTextEmbeddingResponse {
 /* eslint-disable */
 /**
  * This file was automatically generated.
- * DO NOT MODIFY IT BY HAND. Regenerate with `just generate-types` or
+ * DO NOT MODIFY IT BY HAND. Regenerate with
  * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
  */
 
@@ -106,7 +106,7 @@ interface ComputeEmbeddingRequest {
 /* eslint-disable */
 /**
  * This file was automatically generated.
- * DO NOT MODIFY IT BY HAND. Regenerate with `just generate-types` or
+ * DO NOT MODIFY IT BY HAND. Regenerate with
  * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
  */
 
@@ -145,7 +145,7 @@ interface ComputeEmbeddingResponse {
 /* eslint-disable */
 /**
  * This file was automatically generated.
- * DO NOT MODIFY IT BY HAND. Regenerate with `just generate-types` or
+ * DO NOT MODIFY IT BY HAND. Regenerate with
  * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
  */
 
@@ -173,7 +173,7 @@ interface BatchComputeEmbeddingRequest {
 /* eslint-disable */
 /**
  * This file was automatically generated.
- * DO NOT MODIFY IT BY HAND. Regenerate with `just generate-types` or
+ * DO NOT MODIFY IT BY HAND. Regenerate with
  * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
  */
 
@@ -197,7 +197,7 @@ interface BatchEmbeddingResult {
 /* eslint-disable */
 /**
  * This file was automatically generated.
- * DO NOT MODIFY IT BY HAND. Regenerate with `just generate-types` or
+ * DO NOT MODIFY IT BY HAND. Regenerate with
  * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
  */
 
@@ -221,7 +221,7 @@ interface BatchComputeEmbeddingResponse {
 /* eslint-disable */
 /**
  * This file was automatically generated.
- * DO NOT MODIFY IT BY HAND. Regenerate with `just generate-types` or
+ * DO NOT MODIFY IT BY HAND. Regenerate with
  * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
  */
 
@@ -251,7 +251,7 @@ interface EmbeddingResultItem {
 /* eslint-disable */
 /**
  * This file was automatically generated.
- * DO NOT MODIFY IT BY HAND. Regenerate with `just generate-types` or
+ * DO NOT MODIFY IT BY HAND. Regenerate with
  * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
  */
 
@@ -271,7 +271,7 @@ interface EmbeddingResultsRequest {
 /* eslint-disable */
 /**
  * This file was automatically generated.
- * DO NOT MODIFY IT BY HAND. Regenerate with `just generate-types` or
+ * DO NOT MODIFY IT BY HAND. Regenerate with
  * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
  */
 
@@ -289,7 +289,7 @@ interface EmbeddingResultsResponse {
 /* eslint-disable */
 /**
  * This file was automatically generated.
- * DO NOT MODIFY IT BY HAND. Regenerate with `just generate-types` or
+ * DO NOT MODIFY IT BY HAND. Regenerate with
  * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
  */
 
@@ -317,7 +317,7 @@ interface RagProgressEvent {
 /* eslint-disable */
 /**
  * This file was automatically generated.
- * DO NOT MODIFY IT BY HAND. Regenerate with `just generate-types` or
+ * DO NOT MODIFY IT BY HAND. Regenerate with
  * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
  */
 
@@ -343,7 +343,7 @@ interface RagCompletionEvent {
 /* eslint-disable */
 /**
  * This file was automatically generated.
- * DO NOT MODIFY IT BY HAND. Regenerate with `just generate-types` or
+ * DO NOT MODIFY IT BY HAND. Regenerate with
  * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
  */
 
@@ -374,7 +374,7 @@ interface JobSummary {
 /* eslint-disable */
 /**
  * This file was automatically generated.
- * DO NOT MODIFY IT BY HAND. Regenerate with `just generate-types` or
+ * DO NOT MODIFY IT BY HAND. Regenerate with
  * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
  */
 
@@ -400,7 +400,7 @@ interface RAGDashboardStats {
 /* eslint-disable */
 /**
  * This file was automatically generated.
- * DO NOT MODIFY IT BY HAND. Regenerate with `just generate-types` or
+ * DO NOT MODIFY IT BY HAND. Regenerate with
  * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
  */
 
@@ -450,7 +450,7 @@ interface EmbeddingItem {
 /* eslint-disable */
 /**
  * This file was automatically generated.
- * DO NOT MODIFY IT BY HAND. Regenerate with `just generate-types` or
+ * DO NOT MODIFY IT BY HAND. Regenerate with
  * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
  */
 
@@ -473,7 +473,7 @@ interface EmbeddingListResponse {
 /* eslint-disable */
 /**
  * This file was automatically generated.
- * DO NOT MODIFY IT BY HAND. Regenerate with `just generate-types` or
+ * DO NOT MODIFY IT BY HAND. Regenerate with
  * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
  */
 
@@ -505,7 +505,7 @@ interface JobItem {
 /* eslint-disable */
 /**
  * This file was automatically generated.
- * DO NOT MODIFY IT BY HAND. Regenerate with `just generate-types` or
+ * DO NOT MODIFY IT BY HAND. Regenerate with
  * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
  */
 
@@ -525,7 +525,7 @@ interface JobListResponse {
 /* eslint-disable */
 /**
  * This file was automatically generated.
- * DO NOT MODIFY IT BY HAND. Regenerate with `just generate-types` or
+ * DO NOT MODIFY IT BY HAND. Regenerate with
  * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
  */
 
@@ -552,7 +552,7 @@ interface SemanticSearchRequest {
 /* eslint-disable */
 /**
  * This file was automatically generated.
- * DO NOT MODIFY IT BY HAND. Regenerate with `just generate-types` or
+ * DO NOT MODIFY IT BY HAND. Regenerate with
  * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
  */
 
@@ -572,7 +572,7 @@ interface SearchResultItem {
 /* eslint-disable */
 /**
  * This file was automatically generated.
- * DO NOT MODIFY IT BY HAND. Regenerate with `just generate-types` or
+ * DO NOT MODIFY IT BY HAND. Regenerate with
  * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
  */
 
@@ -593,7 +593,7 @@ interface SemanticSearchResponse {
 /* eslint-disable */
 /**
  * This file was automatically generated.
- * DO NOT MODIFY IT BY HAND. Regenerate with `just generate-types` or
+ * DO NOT MODIFY IT BY HAND. Regenerate with
  * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
  */
 
@@ -612,7 +612,7 @@ interface StateFilterItem {
 /* eslint-disable */
 /**
  * This file was automatically generated.
- * DO NOT MODIFY IT BY HAND. Regenerate with `just generate-types` or
+ * DO NOT MODIFY IT BY HAND. Regenerate with
  * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
  */
 

package/dist/rag.d.ts

@@ -1,7 +1,7 @@
 /* eslint-disable */
 /**
  * This file was automatically generated.
- * DO NOT MODIFY IT BY HAND. Regenerate with `just generate-types` or
+ * DO NOT MODIFY IT BY HAND. Regenerate with
  * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
  */
 
@@ -14,7 +14,7 @@ type JobStatus =
 /* eslint-disable */
 /**
  * This file was automatically generated.
- * DO NOT MODIFY IT BY HAND. Regenerate with `just generate-types` or
+ * DO NOT MODIFY IT BY HAND. Regenerate with
  * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
  */
 
@@ -27,7 +27,7 @@ type RagProcessingStatus =
 /* eslint-disable */
 /**
  * This file was automatically generated.
- * DO NOT MODIFY IT BY HAND. Regenerate with `just generate-types` or
+ * DO NOT MODIFY IT BY HAND. Regenerate with
  * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
  */
 
@@ -48,7 +48,7 @@ interface ComputeTextEmbeddingRequest {
 /* eslint-disable */
 /**
  * This file was automatically generated.
- * DO NOT MODIFY IT BY HAND. Regenerate with `just generate-types` or
+ * DO NOT MODIFY IT BY HAND. Regenerate with
  * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
  */
 
@@ -81,7 +81,7 @@ interface ComputeTextEmbeddingResponse {
 /* eslint-disable */
 /**
  * This file was automatically generated.
- * DO NOT MODIFY IT BY HAND. Regenerate with `just generate-types` or
+ * DO NOT MODIFY IT BY HAND. Regenerate with
  * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
  */
 
@@ -106,7 +106,7 @@ interface ComputeEmbeddingRequest {
 /* eslint-disable */
 /**
  * This file was automatically generated.
- * DO NOT MODIFY IT BY HAND. Regenerate with `just generate-types` or
+ * DO NOT MODIFY IT BY HAND. Regenerate with
  * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
  */
 
@@ -145,7 +145,7 @@ interface ComputeEmbeddingResponse {
 /* eslint-disable */
 /**
  * This file was automatically generated.
- * DO NOT MODIFY IT BY HAND. Regenerate with `just generate-types` or
+ * DO NOT MODIFY IT BY HAND. Regenerate with
  * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
  */
 
@@ -173,7 +173,7 @@ interface BatchComputeEmbeddingRequest {
 /* eslint-disable */
 /**
  * This file was automatically generated.
- * DO NOT MODIFY IT BY HAND. Regenerate with `just generate-types` or
+ * DO NOT MODIFY IT BY HAND. Regenerate with
  * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
  */
 
@@ -197,7 +197,7 @@ interface BatchEmbeddingResult {
 /* eslint-disable */
 /**
  * This file was automatically generated.
- * DO NOT MODIFY IT BY HAND. Regenerate with `just generate-types` or
+ * DO NOT MODIFY IT BY HAND. Regenerate with
  * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
  */
 
@@ -221,7 +221,7 @@ interface BatchComputeEmbeddingResponse {
 /* eslint-disable */
 /**
  * This file was automatically generated.
- * DO NOT MODIFY IT BY HAND. Regenerate with `just generate-types` or
+ * DO NOT MODIFY IT BY HAND. Regenerate with
  * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
  */
 
@@ -251,7 +251,7 @@ interface EmbeddingResultItem {
 /* eslint-disable */
 /**
  * This file was automatically generated.
- * DO NOT MODIFY IT BY HAND. Regenerate with `just generate-types` or
+ * DO NOT MODIFY IT BY HAND. Regenerate with
  * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
  */
 
@@ -271,7 +271,7 @@ interface EmbeddingResultsRequest {
 /* eslint-disable */
 /**
  * This file was automatically generated.
- * DO NOT MODIFY IT BY HAND. Regenerate with `just generate-types` or
+ * DO NOT MODIFY IT BY HAND. Regenerate with
  * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
  */
 
@@ -289,7 +289,7 @@ interface EmbeddingResultsResponse {
 /* eslint-disable */
 /**
  * This file was automatically generated.
- * DO NOT MODIFY IT BY HAND. Regenerate with `just generate-types` or
+ * DO NOT MODIFY IT BY HAND. Regenerate with
  * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
  */
 
@@ -317,7 +317,7 @@ interface RagProgressEvent {
 /* eslint-disable */
 /**
  * This file was automatically generated.
- * DO NOT MODIFY IT BY HAND. Regenerate with `just generate-types` or
+ * DO NOT MODIFY IT BY HAND. Regenerate with
  * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
  */
 
@@ -343,7 +343,7 @@ interface RagCompletionEvent {
 /* eslint-disable */
 /**
  * This file was automatically generated.
- * DO NOT MODIFY IT BY HAND. Regenerate with `just generate-types` or
+ * DO NOT MODIFY IT BY HAND. Regenerate with
  * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
  */
 
@@ -374,7 +374,7 @@ interface JobSummary {
 /* eslint-disable */
 /**
  * This file was automatically generated.
- * DO NOT MODIFY IT BY HAND. Regenerate with `just generate-types` or
+ * DO NOT MODIFY IT BY HAND. Regenerate with
  * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
  */
 
@@ -400,7 +400,7 @@ interface RAGDashboardStats {
 /* eslint-disable */
 /**
  * This file was automatically generated.
- * DO NOT MODIFY IT BY HAND. Regenerate with `just generate-types` or
+ * DO NOT MODIFY IT BY HAND. Regenerate with
  * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
  */
 
@@ -450,7 +450,7 @@ interface EmbeddingItem {
 /* eslint-disable */
 /**
  * This file was automatically generated.
- * DO NOT MODIFY IT BY HAND. Regenerate with `just generate-types` or
+ * DO NOT MODIFY IT BY HAND. Regenerate with
  * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
  */
 
@@ -473,7 +473,7 @@ interface EmbeddingListResponse {
 /* eslint-disable */
 /**
  * This file was automatically generated.
- * DO NOT MODIFY IT BY HAND. Regenerate with `just generate-types` or
+ * DO NOT MODIFY IT BY HAND. Regenerate with
  * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
  */
 
@@ -505,7 +505,7 @@ interface JobItem {
 /* eslint-disable */
 /**
  * This file was automatically generated.
- * DO NOT MODIFY IT BY HAND. Regenerate with `just generate-types` or
+ * DO NOT MODIFY IT BY HAND. Regenerate with
  * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
  */
 
@@ -525,7 +525,7 @@ interface JobListResponse {
 /* eslint-disable */
 /**
  * This file was automatically generated.
- * DO NOT MODIFY IT BY HAND. Regenerate with `just generate-types` or
+ * DO NOT MODIFY IT BY HAND. Regenerate with
  * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
  */
 
@@ -552,7 +552,7 @@ interface SemanticSearchRequest {
 /* eslint-disable */
 /**
  * This file was automatically generated.
- * DO NOT MODIFY IT BY HAND. Regenerate with `just generate-types` or
+ * DO NOT MODIFY IT BY HAND. Regenerate with
  * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
  */
 
@@ -572,7 +572,7 @@ interface SearchResultItem {
 /* eslint-disable */
 /**
  * This file was automatically generated.
- * DO NOT MODIFY IT BY HAND. Regenerate with `just generate-types` or
+ * DO NOT MODIFY IT BY HAND. Regenerate with
  * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
  */
 
@@ -593,7 +593,7 @@ interface SemanticSearchResponse {
 /* eslint-disable */
 /**
  * This file was automatically generated.
- * DO NOT MODIFY IT BY HAND. Regenerate with `just generate-types` or
+ * DO NOT MODIFY IT BY HAND. Regenerate with
  * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
  */
 
@@ -612,7 +612,7 @@ interface StateFilterItem {
 /* eslint-disable */
 /**
  * This file was automatically generated.
- * DO NOT MODIFY IT BY HAND. Regenerate with `just generate-types` or
+ * DO NOT MODIFY IT BY HAND. Regenerate with
  * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
  */
 

package/dist/runner.d.cts

@@ -1,7 +1,7 @@
 /* eslint-disable */
 /**
  * This file was automatically generated.
- * DO NOT MODIFY IT BY HAND. Regenerate with `just generate-types` or
+ * DO NOT MODIFY IT BY HAND. Regenerate with
  * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
  */
 
@@ -34,7 +34,74 @@ interface RunnerCrash {
 /* eslint-disable */
 /**
  * This file was automatically generated.
- * DO NOT MODIFY IT BY HAND. Regenerate with `just generate-types` or
+ * DO NOT MODIFY IT BY HAND. Regenerate with
+ * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
+ */
+
+/**
+ * Which role a runner instance plays on its machine.
+ *
+ * Every runner instance on one box presents the SAME machine `device_id`, so
+ * the role is what separates the canonical instance from the supervisor-spawned
+ * ones sharing its row. Reported by the runner in `runner_info` as the
+ * top-level `instanceRole`.
+ */
+type RunnerInstanceRole = "primary" | "secondary";
+
+/* eslint-disable */
+/**
+ * This file was automatically generated.
+ * DO NOT MODIFY IT BY HAND. Regenerate with
+ * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
+ */
+
+
+
+/**
+ * One live runner instance under a [`Runner`] (machine) row.
+ *
+ * A machine can host several runner instances at once — the primary on
+ * `:9876` and supervisor-spawned secondaries on `:9877-9899` — all presenting
+ * the one machine `device_id`, so they share a single [`Runner`] row. One
+ * entry per currently connected instance lets a consumer address `:9876` and
+ * `:9877` on the same box separately rather than seeing only whichever
+ * instance wrote the row's `port` last (plan
+ * `2026-09-20-runner-selector-drives-a-transport-not-a-target`, reading A0.2
+ * and Phase 6).
+ */
+interface RunnerInstance {
+  /**
+   * ISO 8601 timestamp when this instance's current WebSocket connection
+   * was established.
+   */
+  connectedAt: string;
+  /**
+   * Per-instance key, reported by the runner as `instanceKey`. Built from
+   * namespaced sources so no source can spell another's key: `"primary"`
+   * for the primary; `"runner:<id>"` for a supervisor-spawned secondary
+   * (supervisor-assigned ids are unique, and a named runner's id is reused
+   * across its restarts); `"name:<name>"` for a secondary carrying only an
+   * instance name; `"port:<port>"` for a nameless one (stable only while it
+   * keeps that port). NOT guaranteed unique: two processes that each believe
+   * themselves the primary both report `"primary"`, so a consumer must treat
+   * two live instances with the same key as a conflict, never as one
+   * overwriting the other.
+   */
+  instanceKey: string;
+  /**
+   * Whether this instance is the machine's primary or a secondary.
+   */
+  instanceRole: RunnerInstanceRole;
+  /**
+   * Port this instance's HTTP API is listening on, if reported.
+   */
+  port?: number | null;
+}
+
+/* eslint-disable */
+/**
+ * This file was automatically generated.
+ * DO NOT MODIFY IT BY HAND. Regenerate with
  * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
  */
 
@@ -48,7 +115,7 @@ type RunnerStatus =
 /* eslint-disable */
 /**
  * This file was automatically generated.
- * DO NOT MODIFY IT BY HAND. Regenerate with `just generate-types` or
+ * DO NOT MODIFY IT BY HAND. Regenerate with
  * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
  */
 
@@ -77,7 +144,7 @@ interface RunnerUiError {
 /* eslint-disable */
 /**
  * This file was automatically generated.
- * DO NOT MODIFY IT BY HAND. Regenerate with `just generate-types` or
+ * DO NOT MODIFY IT BY HAND. Regenerate with
  * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
  */
 
@@ -115,6 +182,13 @@ interface Runner {
    * Runner identifier (UUID as a string).
    */
   id: string;
+  /**
+   * Currently connected runner instances on this machine, one entry per
+   * instance (see [`RunnerInstance`]). Empty when none is connected — and
+   * when the serving backend predates per-instance rows and omits the
+   * field, so absence deserializes to an empty list rather than failing.
+   */
+  instances: RunnerInstance[];
   /**
    * Reported network address the runner is reachable on.
    */

package/dist/runner.d.ts

@@ -1,7 +1,7 @@
 /* eslint-disable */
 /**
  * This file was automatically generated.
- * DO NOT MODIFY IT BY HAND. Regenerate with `just generate-types` or
+ * DO NOT MODIFY IT BY HAND. Regenerate with
  * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
  */
 
@@ -34,7 +34,74 @@ interface RunnerCrash {
 /* eslint-disable */
 /**
  * This file was automatically generated.
- * DO NOT MODIFY IT BY HAND. Regenerate with `just generate-types` or
+ * DO NOT MODIFY IT BY HAND. Regenerate with
+ * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
+ */
+
+/**
+ * Which role a runner instance plays on its machine.
+ *
+ * Every runner instance on one box presents the SAME machine `device_id`, so
+ * the role is what separates the canonical instance from the supervisor-spawned
+ * ones sharing its row. Reported by the runner in `runner_info` as the
+ * top-level `instanceRole`.
+ */
+type RunnerInstanceRole = "primary" | "secondary";
+
+/* eslint-disable */
+/**
+ * This file was automatically generated.
+ * DO NOT MODIFY IT BY HAND. Regenerate with
+ * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
+ */
+
+
+
+/**
+ * One live runner instance under a [`Runner`] (machine) row.
+ *
+ * A machine can host several runner instances at once — the primary on
+ * `:9876` and supervisor-spawned secondaries on `:9877-9899` — all presenting
+ * the one machine `device_id`, so they share a single [`Runner`] row. One
+ * entry per currently connected instance lets a consumer address `:9876` and
+ * `:9877` on the same box separately rather than seeing only whichever
+ * instance wrote the row's `port` last (plan
+ * `2026-09-20-runner-selector-drives-a-transport-not-a-target`, reading A0.2
+ * and Phase 6).
+ */
+interface RunnerInstance {
+  /**
+   * ISO 8601 timestamp when this instance's current WebSocket connection
+   * was established.
+   */
+  connectedAt: string;
+  /**
+   * Per-instance key, reported by the runner as `instanceKey`. Built from
+   * namespaced sources so no source can spell another's key: `"primary"`
+   * for the primary; `"runner:<id>"` for a supervisor-spawned secondary
+   * (supervisor-assigned ids are unique, and a named runner's id is reused
+   * across its restarts); `"name:<name>"` for a secondary carrying only an
+   * instance name; `"port:<port>"` for a nameless one (stable only while it
+   * keeps that port). NOT guaranteed unique: two processes that each believe
+   * themselves the primary both report `"primary"`, so a consumer must treat
+   * two live instances with the same key as a conflict, never as one
+   * overwriting the other.
+   */
+  instanceKey: string;
+  /**
+   * Whether this instance is the machine's primary or a secondary.
+   */
+  instanceRole: RunnerInstanceRole;
+  /**
+   * Port this instance's HTTP API is listening on, if reported.
+   */
+  port?: number | null;
+}
+
+/* eslint-disable */
+/**
+ * This file was automatically generated.
+ * DO NOT MODIFY IT BY HAND. Regenerate with
  * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
  */
 
@@ -48,7 +115,7 @@ type RunnerStatus =
 /* eslint-disable */
 /**
  * This file was automatically generated.
- * DO NOT MODIFY IT BY HAND. Regenerate with `just generate-types` or
+ * DO NOT MODIFY IT BY HAND. Regenerate with
  * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
  */
 
@@ -77,7 +144,7 @@ interface RunnerUiError {
 /* eslint-disable */
 /**
  * This file was automatically generated.
- * DO NOT MODIFY IT BY HAND. Regenerate with `just generate-types` or
+ * DO NOT MODIFY IT BY HAND. Regenerate with
  * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
  */
 
@@ -115,6 +182,13 @@ interface Runner {
    * Runner identifier (UUID as a string).
    */
   id: string;
+  /**
+   * Currently connected runner instances on this machine, one entry per
+   * instance (see [`RunnerInstance`]). Empty when none is connected — and
+   * when the serving backend predates per-instance rows and omits the
+   * field, so absence deserializes to an empty list rather than failing.
+   */
+  instances: RunnerInstance[];
   /**
    * Reported network address the runner is reachable on.
    */