@qontinui/shared-types 1.0.0 → 1.1.0

package/dist/runner.d.cts

@@ -31,6 +31,73 @@ interface RunnerCrash {
   thread: string;
 }
 
+/* eslint-disable */
+/**
+ * This file was automatically generated.
+ * DO NOT MODIFY IT BY HAND. Regenerate with `just generate-types` or
+ * `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 `just generate-types` or
+ * `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.
@@ -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

@@ -31,6 +31,73 @@ interface RunnerCrash {
   thread: string;
 }
 
+/* eslint-disable */
+/**
+ * This file was automatically generated.
+ * DO NOT MODIFY IT BY HAND. Regenerate with `just generate-types` or
+ * `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 `just generate-types` or
+ * `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.
@@ -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/tauri-events.d.cts

@@ -1132,31 +1132,6 @@ interface DevSeedFindingPayload {
   [k: string]: unknown;
 }
 
-/* eslint-disable */
-/**
- * This file was automatically generated.
- * DO NOT MODIFY IT BY HAND. Regenerate with `just generate-types` or
- * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
- */
-
-/**
- * Payload shape for the `review-approved` and `review-rejected` Tauri events
- * emitted by `commands::productivity::approve_recommendation` /
- * `reject_recommendation` after a user resolves a medium-confidence
- * recommendation card. Field names are explicit camelCase to match the
- * `serde_json::json!()` literal previously used at the emit site.
- *
- * Single struct shared by both channels: only `user_decision` differs
- * (`"approved"` vs `"rejected"`), so a tagged enum would inflate the wire
- * format without payoff.
- */
-interface RecommendationReviewDecisionPayload {
-  reviewId: string;
-  taskId: string;
-  userDecision: string;
-  [k: string]: unknown;
-}
-
 /* eslint-disable */
 /**
  * This file was automatically generated.
@@ -1270,4 +1245,4 @@ interface UiBridgeResponseEnvelope {
   [k: string]: unknown;
 }
 
-export type { AppEvent, CanvasPanel as CanvasUpdatePanel, DevSeedFindingPayload, RecommendationReviewDecisionPayload, RunnerConnectedConnection, RunnerFinding, RunnerFindingCodeContext, RunnerFindingUserInput, RunnerRelayMessage, RunnerStatusEvent, TerminalExitEvent, TerminalInfo, TerminalOutputEvent, UiBridgeRequestEnvelope, UiBridgeResponseEnvelope };
+export type { AppEvent, CanvasPanel as CanvasUpdatePanel, DevSeedFindingPayload, RunnerConnectedConnection, RunnerFinding, RunnerFindingCodeContext, RunnerFindingUserInput, RunnerRelayMessage, RunnerStatusEvent, TerminalExitEvent, TerminalInfo, TerminalOutputEvent, UiBridgeRequestEnvelope, UiBridgeResponseEnvelope };

package/dist/tauri-events.d.ts

@@ -1132,31 +1132,6 @@ interface DevSeedFindingPayload {
   [k: string]: unknown;
 }
 
-/* eslint-disable */
-/**
- * This file was automatically generated.
- * DO NOT MODIFY IT BY HAND. Regenerate with `just generate-types` or
- * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
- */
-
-/**
- * Payload shape for the `review-approved` and `review-rejected` Tauri events
- * emitted by `commands::productivity::approve_recommendation` /
- * `reject_recommendation` after a user resolves a medium-confidence
- * recommendation card. Field names are explicit camelCase to match the
- * `serde_json::json!()` literal previously used at the emit site.
- *
- * Single struct shared by both channels: only `user_decision` differs
- * (`"approved"` vs `"rejected"`), so a tagged enum would inflate the wire
- * format without payoff.
- */
-interface RecommendationReviewDecisionPayload {
-  reviewId: string;
-  taskId: string;
-  userDecision: string;
-  [k: string]: unknown;
-}
-
 /* eslint-disable */
 /**
  * This file was automatically generated.
@@ -1270,4 +1245,4 @@ interface UiBridgeResponseEnvelope {
   [k: string]: unknown;
 }
 
-export type { AppEvent, CanvasPanel as CanvasUpdatePanel, DevSeedFindingPayload, RecommendationReviewDecisionPayload, RunnerConnectedConnection, RunnerFinding, RunnerFindingCodeContext, RunnerFindingUserInput, RunnerRelayMessage, RunnerStatusEvent, TerminalExitEvent, TerminalInfo, TerminalOutputEvent, UiBridgeRequestEnvelope, UiBridgeResponseEnvelope };
+export type { AppEvent, CanvasPanel as CanvasUpdatePanel, DevSeedFindingPayload, RunnerConnectedConnection, RunnerFinding, RunnerFindingCodeContext, RunnerFindingUserInput, RunnerRelayMessage, RunnerStatusEvent, TerminalExitEvent, TerminalInfo, TerminalOutputEvent, UiBridgeRequestEnvelope, UiBridgeResponseEnvelope };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qontinui/shared-types",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "Shared TypeScript types for the Qontinui ecosystem",
   "type": "module",
   "main": "./dist/index.js",

package/src/generated/Runner.d.ts

@@ -6,6 +6,8 @@
  */
 
 import type { RunnerCrash } from "./RunnerCrash";
+import type { RunnerInstance } from "./RunnerInstance";
+import type { RunnerInstanceRole } from "./RunnerInstanceRole";
 import type { RunnerStatus } from "./RunnerStatus";
 import type { RunnerUiError } from "./RunnerUiError";
 
@@ -41,6 +43,13 @@ export 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/src/generated/RunnerInstance.d.ts

@@ -0,0 +1,49 @@
+/* eslint-disable */
+/**
+ * This file was automatically generated.
+ * DO NOT MODIFY IT BY HAND. Regenerate with `just generate-types` or
+ * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
+ */
+
+import type { RunnerInstanceRole } from "./RunnerInstanceRole";
+
+/**
+ * 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).
+ */
+export 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;
+}

package/src/generated/RunnerInstanceRole.d.ts

@@ -0,0 +1,16 @@
+/* eslint-disable */
+/**
+ * This file was automatically generated.
+ * DO NOT MODIFY IT BY HAND. Regenerate with `just generate-types` or
+ * `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`.
+ */
+export type RunnerInstanceRole = "primary" | "secondary";

package/src/generated/UIBridgeElement.d.ts

@@ -51,43 +51,30 @@ export interface UIBridgeElement {
    *
    * Absent (`None`) means the element declares none. That is deliberately
    * distinct from an empty list, which would mean "declared, and empty".
-   * ---
    *
-   * **TRANSITIONAL: this field also accepts the legacy bare-NAME form on the
-   * way in.** `["sendKeys"]` deserializes as
-   * `[ElementActionInfo { id: "sendKeys", .. }]`, with every other field —
-   * `effect` included — left `None`, i.e. UNCLASSIFIED. See
-   * [`deserialize_custom_actions`].
-   *
-   * **Why a shim exists at all**, when this workspace's rule is
-   * delete-over-deprecate. The shape change spans three repos that cannot
-   * land atomically — this crate owns the type, `ui-bridge` emits, and
-   * `qontinui-runner` parses live SDK snapshots strictly
-   * (`spec-check/src/fetch.rs`, `spec_api/spec_check.rs`) while pinning a
-   * PUBLISHED SDK. Both two-party orderings leave a window in which the
-   * fleet is broken: land this crate first and the runner rejects the names
-   * the published SDK still emits; land the SDK first and it emits objects
-   * at a runner whose type is still `Vec<String>`. Only a tolerant READER
-   * removes the window, and there is one reader against nine emitters.
-   *
-   * This is NOT here to spare a caller a breaking change — that is never a
-   * reason in this workspace.
-   *
-   * **DELETE ME, and the trigger is observable rather than intentional:**
-   * once no emitter produces names — `ui-bridge`'s eight element
-   * projections plus `qontinui-runner`'s
-   * `src/services/background-observer-service.ts` — and the runner's SDK pin
-   * has moved past that release, remove [`deserialize_custom_actions`] and
-   * this attribute, and flip
-   * `ui_bridge_element_tolerates_legacy_name_custom_actions` into a test
-   * that asserts a bare string is REJECTED. Plan
+   * **The bare-NAME form is REJECTED.** A transitional shim accepted
+   * `["sendKeys"]` here while the shape change rolled across three repos
+   * that cannot land atomically. It was deleted once its own observable
+   * trigger was met: no emitter produces names (every `ui-bridge` element
+   * projection routes through `serializeElementCustomActions`, and
+   * `qontinui-runner`'s `src/services/background-observer-service.ts` --
+   * the ninth emitter -- does too), and the runner's SDK pin moved to
+   * `@qontinui/ui-bridge` `^0.27.0`. Plan
    * `2026-09-04-effect-calculus-joins-the-component-action-registry`,
    * Design decision 4, step 5.
    *
-   * The published SCHEMA is deliberately not widened to advertise the name
-   * form: the schema states the target contract, while the reader is
-   * transitionally lenient. A producer validating against the schema is
-   * correctly told that names are not the shape to emit.
+   * The shim's deletion also required retiring the two recorded fixtures
+   * that still carried names. That was admissible because the UI Bridge has
+   * exactly one consumer -- Qontinui itself -- so "deployed apps still
+   * emitting the old wire", the reason the wire gate keeps fixtures
+   * append-only, has no instances. Both were REPLACED by captures from
+   * 0.27.0 rather than merely dropped, so the gate still parses genuine SDK
+   * output; it now parses the object form instead of the name form.
+   *
+   * Rejecting is the point, not a side effect: a name carries no `effect`,
+   * so anything still emitting one would be shipping UNCLASSIFIED actions
+   * to a consumer that must treat unclassified as unsafe. A hard parse
+   * error names that producer; silent tolerance hid it.
    */
   customActions?: ElementActionInfo[] | null;
   /**

package/src/generated/index.ts

@@ -332,7 +332,6 @@ export type { RagCompletionEvent } from './RagCompletionEvent';
 export type { RagProcessingStatus } from './RagProcessingStatus';
 export type { RagProgressEvent } from './RagProgressEvent';
 export type { ReadConfigResponse } from './ReadConfigResponse';
-export type { RecommendationReviewDecisionPayload } from './RecommendationReviewDecisionPayload';
 export type { RecommendedState } from './RecommendedState';
 export type { RecordGitOpRequest } from './RecordGitOpRequest';
 export type { ReflectionFixOutput } from './ReflectionFixOutput';
@@ -361,6 +360,8 @@ export type { RunnerCrash } from './RunnerCrash';
 export type { RunnerFinding } from './RunnerFinding';
 export type { RunnerFindingCodeContext } from './RunnerFindingCodeContext';
 export type { RunnerFindingUserInput } from './RunnerFindingUserInput';
+export type { RunnerInstance } from './RunnerInstance';
+export type { RunnerInstanceRole } from './RunnerInstanceRole';
 export type { RunnerMetadata } from './RunnerMetadata';
 export type { RunnerRelayMessage } from './RunnerRelayMessage';
 export type { RunnerStatus } from './RunnerStatus';

package/src/tauri-events/_api.ts

@@ -63,11 +63,6 @@ export type { RunnerConnectedConnection } from "../generated/RunnerConnectedConn
 //    fields so the TS listener can spread them straight into a Finding. ──
 export type { DevSeedFindingPayload } from "../generated/DevSeedFindingPayload";
 
-// ── Recommendation review decision payloads (`review-approved` /
-//    `review-rejected` from `commands/productivity.rs`). One struct
-//    covers both channels — only `userDecision` differs. ──
-export type { RecommendationReviewDecisionPayload } from "../generated/RecommendationReviewDecisionPayload";
-
 // ── Canvas panel payload carried inside AppEvent::CanvasUpdate's
 //    `data.panel` field. Wire-format mirror of the runner's `StoredPanel`
 //    (`mcp/canvas.rs`). The hand-written `CanvasPanel` in `../canvas/index.ts`

package/src/generated/RecommendationReviewDecisionPayload.d.ts

@@ -1,24 +0,0 @@
-/* eslint-disable */
-/**
- * This file was automatically generated.
- * DO NOT MODIFY IT BY HAND. Regenerate with `just generate-types` or
- * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
- */
-
-/**
- * Payload shape for the `review-approved` and `review-rejected` Tauri events
- * emitted by `commands::productivity::approve_recommendation` /
- * `reject_recommendation` after a user resolves a medium-confidence
- * recommendation card. Field names are explicit camelCase to match the
- * `serde_json::json!()` literal previously used at the emit site.
- *
- * Single struct shared by both channels: only `user_decision` differs
- * (`"approved"` vs `"rejected"`), so a tagged enum would inflate the wire
- * format without payoff.
- */
-export interface RecommendationReviewDecisionPayload {
-  reviewId: string;
-  taskId: string;
-  userDecision: string;
-  [k: string]: unknown;
-}