@qontinui/shared-types 0.2.2 → 0.2.4

package/src/generated/CanvasPanel.d.ts

@@ -0,0 +1,35 @@
+/* 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`.
+ */
+
+/**
+ * A canvas panel rendered in the dashboard widget.
+ *
+ * Wire-format mirror of the runner's `StoredPanel` struct
+ * (`qontinui-runner/src-tauri/src/mcp/canvas.rs`). The runner emits this
+ * inside [`AppEvent::CanvasUpdate`] via the `canvas-update` Tauri channel.
+ * Field names are snake_case to match the existing TS interface in
+ * `qontinui-schemas/ts/src/canvas/index.ts`.
+ *
+ * `data` stays `serde_json::Value` because each `component` type has a
+ * different inner shape (Markdown, CodeDiff, Table, …); the per-component
+ * data schemas live in the TS module above and are intentionally not
+ * modeled as a Rust discriminated union (would balloon the schema for
+ * little gain on the Rust side).
+ */
+export interface CanvasPanel {
+  component: string;
+  created_at: string;
+  data: unknown;
+  group?: string | null;
+  panel_id: string;
+  priority: number;
+  size: string;
+  task_run_id: string;
+  title: string;
+  updated_at: string;
+  [k: string]: unknown;
+}

package/src/generated/DevSeedFindingPayload.d.ts

@@ -0,0 +1,30 @@
+/* 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 emitted on the `dev:seed-finding` Tauri event.
+ *
+ * Field names use camelCase so the TS listener (`TauriFindingsListener.ts`)
+ * can spread them directly into a `Finding` object without translation.
+ * The actual emit site is in `commands::dev_findings::dev_seed_finding`.
+ *
+ * Renamed in the schema registry to `DevSeedFindingPayload` to disambiguate
+ * from the various `Finding*` types in `qontinui_types::findings`.
+ */
+export interface DevSeedFindingPayload {
+  actionType: string;
+  actionable: boolean;
+  categoryId: string;
+  description: string;
+  detectedAt: number;
+  id: string;
+  severity: string;
+  sourceSessionId?: string | null;
+  status: string;
+  title: string;
+  [k: string]: unknown;
+}

package/src/generated/FlowEvent.d.ts

@@ -1,66 +1,86 @@
-/* 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`.
- */
-
-/**
- * Events emitted during flow execution for UI updates.
- *
- * Internally tagged with `"type"` and snake_case variant names.
- */
-export type FlowEvent =
-  | {
-      flow_id: string;
-      flow_name: string;
-      instance_id: string;
-      type: "flow_started";
-      [k: string]: unknown;
-    }
-  | {
-      instance_id: string;
-      step_id: string;
-      step_name: string;
-      step_type: string;
-      type: "step_started";
-      [k: string]: unknown;
-    }
-  | {
-      duration_ms: number;
-      error?: string | null;
-      instance_id: string;
-      outputs: {
-        [k: string]: unknown;
-      };
-      step_id: string;
-      success: boolean;
-      type: "step_completed";
-      [k: string]: unknown;
-    }
-  | {
-      duration_ms: number;
-      error?: string | null;
-      flow_id: string;
-      instance_id: string;
-      success: boolean;
-      total_steps: number;
-      type: "flow_completed";
-      [k: string]: unknown;
-    }
-  | {
-      instance_id: string;
-      options: string[];
-      prompt: string;
-      step_id: string;
-      type: "waiting_for_input";
-      [k: string]: unknown;
-    }
-  | {
-      completed: number;
-      instance_id: string;
-      step_id: string;
-      total: number;
-      type: "parallel_progress";
-      [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`.
+ */
+
+/**
+ * Events emitted during flow execution for UI updates.
+ *
+ * Internally tagged with `"type"` and snake_case variant names.
+ */
+export type FlowEvent =
+  | {
+      flow_id: string;
+      flow_name: string;
+      instance_id: string;
+      type: "flow_started";
+      [k: string]: unknown;
+    }
+  | {
+      instance_id: string;
+      step_id: string;
+      step_name: string;
+      step_type: string;
+      type: "step_started";
+      [k: string]: unknown;
+    }
+  | {
+      duration_ms: number;
+      error?: string | null;
+      instance_id: string;
+      outputs: {
+        [k: string]: unknown;
+      };
+      step_id: string;
+      success: boolean;
+      type: "step_completed";
+      [k: string]: unknown;
+    }
+  | {
+      duration_ms: number;
+      error?: string | null;
+      flow_id: string;
+      instance_id: string;
+      success: boolean;
+      total_steps: number;
+      type: "flow_completed";
+      [k: string]: unknown;
+    }
+  | {
+      instance_id: string;
+      options: string[];
+      prompt: string;
+      step_id: string;
+      type: "waiting_for_input";
+      [k: string]: unknown;
+    }
+  | {
+      completed: number;
+      instance_id: string;
+      step_id: string;
+      total: number;
+      type: "parallel_progress";
+      [k: string]: unknown;
+    }
+  | {
+      flow_id: string;
+      instance_id: string;
+      /**
+       * Step the flow was paused at (`null` if no current step).
+       */
+      step_id?: string | null;
+      type: "flow_paused";
+      [k: string]: unknown;
+    }
+  | {
+      flow_id: string;
+      instance_id: string;
+      /**
+       * Step execution will resume from (`null` if no current step).
+       */
+      step_id?: string | null;
+      type: "flow_resumed";
+      [k: string]: unknown;
+    };

package/src/generated/RecommendationReviewDecisionPayload.d.ts

@@ -0,0 +1,24 @@
+/* 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;
+}

package/src/generated/RunnerConnectedConnection.d.ts

@@ -0,0 +1,34 @@
+/* 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`.
+ */
+
+/**
+ * Wire-format runner shape carried inside `runner_connected.connection`.
+ *
+ * This is intentionally a partial Runner payload (snake_case, only the
+ * fields the Python emitter actually populates in
+ * `RunnerEventPublisher.publish_runner_connected`). It is NOT
+ * `qontinui_types::runner::Runner` — that shape requires `derived_status`,
+ * `capabilities`, `created_at` etc., which the connection payload doesn't
+ * include. Consumers reading this should refetch the canonical Runner row
+ * via REST after seeing `runner_connected`.
+ */
+export interface RunnerConnectedConnection {
+  connected_at?: string | null;
+  /**
+   * Always present as `null` on the wire when the runner is still
+   * connected. Python ships this field unconditionally.
+   */
+  disconnected_at?: string | null;
+  duration_seconds?: number | null;
+  id: string;
+  ip_address?: string | null;
+  project_id?: string | null;
+  runner_name?: string | null;
+  runner_port?: number | null;
+  ws_connected: boolean;
+  [k: string]: unknown;
+}

package/src/generated/RunnerFinding.d.ts

@@ -0,0 +1,48 @@
+/* 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 { RunnerFindingCodeContext } from './RunnerFindingCodeContext';
+import type { RunnerFindingUserInput } from './RunnerFindingUserInput';
+import type { TaskRunFindingActionType } from './TaskRunFindingActionType';
+import type { TaskRunFindingCategory } from './TaskRunFindingCategory';
+import type { TaskRunFindingSeverity } from './TaskRunFindingSeverity';
+import type { TaskRunFindingStatus } from './TaskRunFindingStatus';
+
+/**
+ * A finding detected by AI analysis (runner-local wire shape).
+ *
+ * Wire format: serialized via `#[serde(rename_all = "camelCase")]` so all
+ * snake_case Rust field names ship as camelCase on the Tauri event channels
+ * `finding_detected` and `finding_resolved`. The frontend listener in
+ * `services/TauriFindingsListener.ts` MUST read these fields by their
+ * camelCase names — reading snake_case silently evaluates to `undefined`.
+ *
+ * Renamed in the schema registry to `RunnerFinding` to disambiguate from
+ * `qontinui_types::verification::Finding`, which has a different shape
+ * (`confidence`, `findingType`, `evidence` vs this struct's flat fields).
+ */
+export interface RunnerFinding {
+  actionType: TaskRunFindingActionType;
+  categoryId: TaskRunFindingCategory;
+  codeContext?: RunnerFindingCodeContext | null;
+  description: string;
+  detectedAt: string;
+  id: string;
+  resolution?: string | null;
+  resolvedAt?: string | null;
+  resolvedInSession?: number | null;
+  sessionNum: number;
+  severity: TaskRunFindingSeverity;
+  signatureHash: string;
+  status: TaskRunFindingStatus;
+  taskRunId: string;
+  title: string;
+  updatedAt: string;
+  userInput?: RunnerFindingUserInput | null;
+  userResponse?: string | null;
+  [k: string]: unknown;
+}

package/src/generated/RunnerFindingCodeContext.d.ts

@@ -0,0 +1,20 @@
+/* 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`.
+ */
+
+/**
+ * Code context for a finding (runner-local wire shape).
+ *
+ * Renamed in the schema registry to `RunnerFindingCodeContext` to
+ * disambiguate from `qontinui_types::findings::FindingCodeContext`.
+ */
+export interface RunnerFindingCodeContext {
+  column?: number | null;
+  file?: string | null;
+  line?: number | null;
+  snippet?: string | null;
+  [k: string]: unknown;
+}

package/src/generated/RunnerFindingUserInput.d.ts

@@ -0,0 +1,19 @@
+/* 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`.
+ */
+
+/**
+ * User input request for a finding (runner-local wire shape).
+ *
+ * Renamed in the schema registry to `RunnerFindingUserInput` to
+ * disambiguate from `qontinui_types::findings::FindingUserInput`.
+ */
+export interface RunnerFindingUserInput {
+  input_type: string;
+  options?: string[] | null;
+  question: string;
+  [k: string]: unknown;
+}

package/src/generated/RunnerRelayMessage.d.ts

@@ -0,0 +1,75 @@
+/* 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`.
+ */
+
+/**
+ * Discriminated union of every WS envelope `mcp/backend_relay.rs::handle_outbound`
+ * ships to the backend after rewrapping a Tauri-side `AppEvent`.
+ *
+ * Internally tagged on `"type"` with snake_case variant names because that's
+ * what the prior `serde_json::json!` literals emitted on the wire.
+ *
+ * Wire keys are snake_case (NOT camelCase) — verified against the literal
+ * strings in `handle_outbound` lines ~605-638. Consumers that expect
+ * camelCase (e.g. some web hooks) are wrong; the relay never emitted
+ * camelCase here.
+ */
+export type RunnerRelayMessage =
+  | {
+      data: {
+        [k: string]: unknown;
+      };
+      type: "phase_completed";
+      [k: string]: unknown;
+    }
+  | {
+      data: {
+        [k: string]: unknown;
+      };
+      type: "ui_error";
+      [k: string]: unknown;
+    }
+  | {
+      data: {
+        [k: string]: unknown;
+      };
+      type: "recent_crash";
+      [k: string]: unknown;
+    }
+  | {
+      data: {
+        [k: string]: unknown;
+      };
+      type: "chat_response";
+      [k: string]: unknown;
+    }
+  | {
+      data: {
+        [k: string]: unknown;
+      };
+      type: "chat_session_state";
+      [k: string]: unknown;
+    }
+  | {
+      data: {
+        [k: string]: unknown;
+      };
+      terminal_id: {
+        [k: string]: unknown;
+      };
+      type: "terminal_output";
+      [k: string]: unknown;
+    }
+  | {
+      exit_code: {
+        [k: string]: unknown;
+      };
+      terminal_id: {
+        [k: string]: unknown;
+      };
+      type: "terminal_exit";
+      [k: string]: unknown;
+    };

package/src/generated/RunnerStatusEvent.d.ts

@@ -0,0 +1,67 @@
+/* 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 { RunnerConnectedConnection } from './RunnerConnectedConnection';
+
+/**
+ * Discriminated union of every event the Python backend pushes to the web
+ * client over the `/api/v1/runners/status` WebSocket.
+ *
+ * Internally tagged on `"type"` matching the Python wire format. Variant
+ * renames (`runner.woke` keeps the dot rather than going to snake_case)
+ * preserve the literal strings the emitter sends.
+ *
+ * Source of truth: the `publish_*` methods in
+ * `qontinui-web/backend/app/services/runner/event_publisher.py` and the
+ * `initial_state` send in `runner_status_ws.py`.
+ */
+export type RunnerStatusEvent =
+  | {
+      runners: unknown[];
+      type: "initial_state";
+      [k: string]: unknown;
+    }
+  | {
+      connection: RunnerConnectedConnection;
+      timestamp: string;
+      type: "runner_connected";
+      [k: string]: unknown;
+    }
+  | {
+      runner_id: string;
+      timestamp: string;
+      type: "runner_disconnected";
+      [k: string]: unknown;
+    }
+  | {
+      runner_id: string;
+      runner_name: string;
+      timestamp: string;
+      type: "runner_name_updated";
+      [k: string]: unknown;
+    }
+  | {
+      runner_id: string;
+      runner_port: number;
+      timestamp: string;
+      type: "runner_port_updated";
+      [k: string]: unknown;
+    }
+  | {
+      intent_id?: string | null;
+      reason?: string | null;
+      runner_id: string;
+      task_id?: string | null;
+      timestamp: string;
+      type: "runner.woke";
+      [k: string]: unknown;
+    }
+  | {
+      error: string;
+      type: "error";
+      [k: string]: unknown;
+    };

package/src/generated/UiBridgeRequestEnvelope.d.ts

@@ -0,0 +1,45 @@
+/* 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`.
+ */
+
+/**
+ * Wire envelope for `ui-bridge-request` events emitted by
+ * `mcp::ui_bridge::request::ui_bridge_request_sync` (and the long-timeout
+ * variant in `mcp::ui_bridge::screenshots::ui_bridge_capture_element_images_handler`).
+ *
+ * The runner emits an envelope whose flat shape is
+ * `{ requestId, type, ...payloadFields }` — the previous implementation built
+ * it via `serde_json::json!({ "requestId": ..., "type": ... })` plus a manual
+ * merge of an `additional_payload: Value::Object`. This struct preserves that
+ * wire shape via `#[serde(flatten)]` on `data` so byte output is identical
+ * when callers pass `Value::Object` payloads (the only shape they use today).
+ *
+ * The discriminator field is **`type`** on the wire; the Rust field is named
+ * `request_type` for ergonomics and renamed via `#[serde(rename = "type")]`.
+ * Keep this struct in sync with the TS `UIBridgeRequestPayload` envelope head
+ * in `qontinui-runner/src/hooks/ui-bridge-events/types.ts`.
+ *
+ * `request_type` is a free-form `String` — the set of valid discriminators is
+ * the 171-variant `UIBridgeRequestType` TS union, but per-payload typing is
+ * deferred indefinitely. Dispatch exhaustiveness is enforced on the React
+ * side via `AssertEqual<AllHandledTypes, UIBridgeRequestType>` plus per-hook
+ * `never` checks.
+ */
+export interface UiBridgeRequestEnvelope {
+  /**
+   * UUID generated by the runner; round-trips back inside the matching
+   * [`UiBridgeResponseEnvelope`] so the Rust dispatcher can pair responses
+   * with their pending oneshot senders.
+   */
+  requestId: string;
+  /**
+   * Wire discriminator — the runner-side request kind (e.g. `"get_elements"`,
+   * `"capture_element_images"`). Field is named `request_type` in Rust for
+   * ergonomics; serializes as `type`.
+   */
+  type: string;
+  [k: string]: unknown;
+}

package/src/generated/UiBridgeResponseEnvelope.d.ts

@@ -0,0 +1,66 @@
+/* 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`.
+ */
+
+/**
+ * Wire envelope for `ui-bridge-response` events emitted by the React
+ * frontend in response to a [`UiBridgeRequestEnvelope`].
+ *
+ * The runner-side dispatcher in
+ * `mcp::ui_bridge::request::handle_ui_bridge_response` matches `request_id`
+ * to a pending oneshot sender and forwards the inner `data` to the awaiting
+ * caller; `success`, `error`, `hint`, and `timestamp` are surfaced via
+ * `wrap_ipc_result`'s F2 two-tier envelope flattening.
+ *
+ * `data`, `error`, and `hint` are all optional. The hint sibling carries
+ * closest-match / recovery hints (set by frontend handlers like
+ * `useControlEvents` for typo recovery on element-not-found and
+ * action-not-allowed) and stays a sibling of `error` — the success/error
+ * envelope shape is unchanged.
+ */
+export interface UiBridgeResponseEnvelope {
+  /**
+   * Inner data payload on success. Frontend handlers set this to whatever
+   * shape the operation returns (e.g. an `elements` array for
+   * `get_elements`, a discovery report for `discover`, etc.).
+   */
+  data?: {
+    [k: string]: unknown;
+  };
+  /**
+   * Error message on failure. Mirrors the inner-failure path of
+   * `wrap_ipc_result`'s F2 two-tier envelope flattening.
+   */
+  error?: string | null;
+  /**
+   * Optional closest-match / recovery hint payload. Sibling field to
+   * `error` (does NOT replace the success/error envelope shape). Used by
+   * `useControlEvents` for element-not-found / action-not-allowed typo
+   * recovery and by Rust `page.rs` for eval-rejected workaround guidance.
+   */
+  hint?: {
+    [k: string]: unknown;
+  };
+  /**
+   * Echoes the request's [`UiBridgeRequestEnvelope::request_id`].
+   */
+  requestId: string;
+  /**
+   * Whether the frontend handler succeeded.
+   */
+  success: boolean;
+  /**
+   * Frontend-side timestamp (ms since Unix epoch) of when the response was
+   * produced.
+   */
+  timestamp: number;
+  /**
+   * Echoes the request's [`UiBridgeRequestEnvelope::request_type`].
+   * Serializes as `type` to match the wire.
+   */
+  type: string;
+  [k: string]: unknown;
+}

package/src/generated/index.ts

@@ -37,6 +37,7 @@ export type { BoundingBox } from './BoundingBox';
 export type { BuildPhaseConfig } from './BuildPhaseConfig';
 export type { BuiltinOverrideProposal } from './BuiltinOverrideProposal';
 export type { CanonicalStep } from './CanonicalStep';
+export type { CanvasPanel } from './CanvasPanel';
 export type { CatchUpPolicy } from './CatchUpPolicy';
 export type { Category } from './Category';
 export type { CheckIssueDetail } from './CheckIssueDetail';
@@ -79,6 +80,7 @@ export type { DagApprovalStep } from './DagApprovalStep';
 export type { DagCancelStep } from './DagCancelStep';
 export type { DagLoopStep } from './DagLoopStep';
 export type { DecomposerConfig } from './DecomposerConfig';
+export type { DevSeedFindingPayload } from './DevSeedFindingPayload';
 export type { DiagnosePhaseConfig } from './DiagnosePhaseConfig';
 export type { DiagnosticResult } from './DiagnosticResult';
 export type { DiscoveredElement } from './DiscoveredElement';
@@ -237,6 +239,7 @@ 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 { ReflectionFixOutput } from './ReflectionFixOutput';
 export type { Region } from './Region';
 export type { RepositoryInactiveCondition } from './RepositoryInactiveCondition';
@@ -256,9 +259,15 @@ export type { RunPromptResponseData } from './RunPromptResponseData';
 export type { RunStatus } from './RunStatus';
 export type { RunType } from './RunType';
 export type { Runner } from './Runner';
+export type { RunnerConnectedConnection } from './RunnerConnectedConnection';
 export type { RunnerCrash } from './RunnerCrash';
+export type { RunnerFinding } from './RunnerFinding';
+export type { RunnerFindingCodeContext } from './RunnerFindingCodeContext';
+export type { RunnerFindingUserInput } from './RunnerFindingUserInput';
 export type { RunnerMetadata } from './RunnerMetadata';
+export type { RunnerRelayMessage } from './RunnerRelayMessage';
 export type { RunnerStatus } from './RunnerStatus';
+export type { RunnerStatusEvent } from './RunnerStatusEvent';
 export type { RunnerUiError } from './RunnerUiError';
 export type { RuntimeData } from './RuntimeData';
 export type { SaveWorkflowArtifactStep } from './SaveWorkflowArtifactStep';
@@ -373,6 +382,8 @@ export type { UiBridgeAction } from './UiBridgeAction';
 export type { UiBridgeAssertType } from './UiBridgeAssertType';
 export type { UiBridgeComparisonMode } from './UiBridgeComparisonMode';
 export type { UiBridgeDesignAuditStep } from './UiBridgeDesignAuditStep';
+export type { UiBridgeRequestEnvelope } from './UiBridgeRequestEnvelope';
+export type { UiBridgeResponseEnvelope } from './UiBridgeResponseEnvelope';
 export type { UiBridgeSeverity } from './UiBridgeSeverity';
 export type { UiBridgeStep } from './UiBridgeStep';
 export type { UiBridgeStepPhase } from './UiBridgeStepPhase';