@qontinui/shared-types 0.2.3 → 0.2.5

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/UiBridgeSeverity.d.ts

@@ -1,11 +1,11 @@
-/* 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`.
- */
-
-/**
- * Severity threshold for `compare` / `snapshot_assert` actions.
- */
-export type UiBridgeSeverity = "critical" | "major" | "minor" | "info";
+/* 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`.
+ */
+
+/**
+ * Severity threshold for `compare` / `snapshot_assert` actions.
+ */
+export type UiBridgeSeverity = "critical" | "major" | "minor" | "info";

package/src/generated/UiBridgeStep.d.ts

@@ -1,127 +1,127 @@
-/* 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 { RetrySpec } from './RetrySpec';
-import type { UiBridgeAction } from './UiBridgeAction';
-import type { UiBridgeAssertType } from './UiBridgeAssertType';
-import type { UiBridgeComparisonMode } from './UiBridgeComparisonMode';
-import type { UiBridgeSeverity } from './UiBridgeSeverity';
-import type { UiBridgeStepPhase } from './UiBridgeStepPhase';
-import type { VerificationCategoryKind } from './VerificationCategoryKind';
-
-/**
- * UI Bridge SDK interaction — navigate, execute, assert, snapshot, compare.
- */
-export interface UiBridgeStep {
-  action: UiBridgeAction;
-  /**
-   * Structured action plan (for `action_plan`).
-   *
-   * Typed as `serde_json::Value` here to avoid pulling the `action-plan`
-   * module into this crate; the TS side re-imports the typed `ActionPlan`
-   * after regeneration.
-   */
-  actionPlan?: {
-    [k: string]: unknown;
-  };
-  /**
-   * Assertion kind (for `assert`).
-   */
-  assertType?: UiBridgeAssertType | null;
-  /**
-   * Comparison mode (for `compare` / `snapshot_assert`).
-   */
-  comparisonMode?: UiBridgeComparisonMode | null;
-  /**
-   * Acceptance criterion IDs verified by this step.
-   */
-  criterionIds?: string[];
-  /**
-   * IDs of other steps that must complete first.
-   */
-  dependsOn?: string[];
-  /**
-   * Expected value for assertions.
-   */
-  expected?: string | null;
-  /**
-   * Extractions published to subsequent steps.
-   */
-  extract?: {
-    [k: string]: string;
-  };
-  /**
-   * If `Some(true)`, a console-error signal from the UI fails this step.
-   */
-  failOnConsoleErrors?: boolean | null;
-  /**
-   * Unique identifier for the step.
-   */
-  id: string;
-  /**
-   * Named input bindings evaluated at step entry.
-   */
-  inputs?: {
-    [k: string]: string;
-  };
-  /**
-   * Free-form instruction text (for `execute`).
-   */
-  instruction?: string | null;
-  /**
-   * Display name for the step.
-   */
-  name: string;
-  phase: UiBridgeStepPhase;
-  /**
-   * Reference snapshot ID (for `compare` / `snapshot_assert`).
-   */
-  referenceSnapshotId?: string | null;
-  /**
-   * Whether this step is required (default: `true` on consumer side).
-   */
-  required?: boolean | null;
-  /**
-   * Per-step retry configuration.
-   */
-  retry?: RetrySpec | null;
-  /**
-   * Severity threshold (for `compare` / `snapshot_assert`).
-   */
-  severityThreshold?: UiBridgeSeverity | null;
-  /**
-   * Provenance of this step when generated from a skill template.
-   *
-   * Typed as `serde_json::Value` here to avoid pulling the `skill`
-   * dependency chain into this module; the TS side re-imports the typed
-   * `SkillOrigin` after regeneration.
-   */
-  skillOrigin?: {
-    [k: string]: unknown;
-  };
-  /**
-   * Target selector or element ID.
-   */
-  target?: string | null;
-  /**
-   * Timeout in milliseconds.
-   */
-  timeoutMs?: number | null;
-  /**
-   * Snapshot target — `"control"`, `"sdk"`, or `"proxy:PORT"`.
-   */
-  uiBridgeSnapshotTarget?: string | null;
-  /**
-   * Navigation URL (for `navigate`).
-   */
-  url?: string | null;
-  /**
-   * Verification depth category.
-   */
-  verificationCategory?: VerificationCategoryKind | null;
-  [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`.
+ */
+
+import type { RetrySpec } from './RetrySpec';
+import type { UiBridgeAction } from './UiBridgeAction';
+import type { UiBridgeAssertType } from './UiBridgeAssertType';
+import type { UiBridgeComparisonMode } from './UiBridgeComparisonMode';
+import type { UiBridgeSeverity } from './UiBridgeSeverity';
+import type { UiBridgeStepPhase } from './UiBridgeStepPhase';
+import type { VerificationCategoryKind } from './VerificationCategoryKind';
+
+/**
+ * UI Bridge SDK interaction — navigate, execute, assert, snapshot, compare.
+ */
+export interface UiBridgeStep {
+  action: UiBridgeAction;
+  /**
+   * Structured action plan (for `action_plan`).
+   *
+   * Typed as `serde_json::Value` here to avoid pulling the `action-plan`
+   * module into this crate; the TS side re-imports the typed `ActionPlan`
+   * after regeneration.
+   */
+  actionPlan?: {
+    [k: string]: unknown;
+  };
+  /**
+   * Assertion kind (for `assert`).
+   */
+  assertType?: UiBridgeAssertType | null;
+  /**
+   * Comparison mode (for `compare` / `snapshot_assert`).
+   */
+  comparisonMode?: UiBridgeComparisonMode | null;
+  /**
+   * Acceptance criterion IDs verified by this step.
+   */
+  criterionIds?: string[];
+  /**
+   * IDs of other steps that must complete first.
+   */
+  dependsOn?: string[];
+  /**
+   * Expected value for assertions.
+   */
+  expected?: string | null;
+  /**
+   * Extractions published to subsequent steps.
+   */
+  extract?: {
+    [k: string]: string;
+  };
+  /**
+   * If `Some(true)`, a console-error signal from the UI fails this step.
+   */
+  failOnConsoleErrors?: boolean | null;
+  /**
+   * Unique identifier for the step.
+   */
+  id: string;
+  /**
+   * Named input bindings evaluated at step entry.
+   */
+  inputs?: {
+    [k: string]: string;
+  };
+  /**
+   * Free-form instruction text (for `execute`).
+   */
+  instruction?: string | null;
+  /**
+   * Display name for the step.
+   */
+  name: string;
+  phase: UiBridgeStepPhase;
+  /**
+   * Reference snapshot ID (for `compare` / `snapshot_assert`).
+   */
+  referenceSnapshotId?: string | null;
+  /**
+   * Whether this step is required (default: `true` on consumer side).
+   */
+  required?: boolean | null;
+  /**
+   * Per-step retry configuration.
+   */
+  retry?: RetrySpec | null;
+  /**
+   * Severity threshold (for `compare` / `snapshot_assert`).
+   */
+  severityThreshold?: UiBridgeSeverity | null;
+  /**
+   * Provenance of this step when generated from a skill template.
+   *
+   * Typed as `serde_json::Value` here to avoid pulling the `skill`
+   * dependency chain into this module; the TS side re-imports the typed
+   * `SkillOrigin` after regeneration.
+   */
+  skillOrigin?: {
+    [k: string]: unknown;
+  };
+  /**
+   * Target selector or element ID.
+   */
+  target?: string | null;
+  /**
+   * Timeout in milliseconds.
+   */
+  timeoutMs?: number | null;
+  /**
+   * Snapshot target — `"control"`, `"sdk"`, or `"proxy:PORT"`.
+   */
+  uiBridgeSnapshotTarget?: string | null;
+  /**
+   * Navigation URL (for `navigate`).
+   */
+  url?: string | null;
+  /**
+   * Verification depth category.
+   */
+  verificationCategory?: VerificationCategoryKind | null;
+  [k: string]: unknown;
+}

package/src/generated/UiBridgeStepPhase.d.ts

@@ -1,14 +1,14 @@
-/* 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`.
- */
-
-/**
- * Phases in which a [`UiBridgeStep`] may appear.
- *
- * UI-bridge interactions only run in deterministic phases — never inside
- * the agentic loop (where the AI drives steps directly via prompts).
- */
-export type UiBridgeStepPhase = "setup" | "verification" | "completion";
+/* 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`.
+ */
+
+/**
+ * Phases in which a [`UiBridgeStep`] may appear.
+ *
+ * UI-bridge interactions only run in deterministic phases — never inside
+ * the agentic loop (where the AI drives steps directly via prompts).
+ */
+export type UiBridgeStepPhase = "setup" | "verification" | "completion";

package/src/generated/UiBridgeVisualAssertionStep.d.ts

@@ -1,97 +1,97 @@
-/* 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 { RetrySpec } from './RetrySpec';
-import type { VerificationCategoryKind } from './VerificationCategoryKind';
-import type { VisualAssertionType } from './VisualAssertionType';
-
-/**
- * Assert visual properties of UI elements via the UI Bridge.
- *
- * Wire tag: `"ui_bridge_visual_assertion"`.
- */
-export interface UiBridgeVisualAssertionStep {
-  /**
-   * Acceptance criterion IDs verified by this step.
-   */
-  criterionIds?: string[];
-  /**
-   * IDs of other steps that must complete first.
-   */
-  dependsOn?: string[];
-  /**
-   * Extractions published to subsequent steps.
-   */
-  extract?: {
-    [k: string]: string;
-  };
-  /**
-   * If `Some(true)`, a console-error signal from the UI fails this step.
-   */
-  failOnConsoleErrors?: boolean | null;
-  /**
-   * Unique identifier for the step.
-   */
-  id: string;
-  /**
-   * Named input bindings evaluated at step entry.
-   */
-  inputs?: {
-    [k: string]: string;
-  };
-  /**
-   * Display name for the step.
-   */
-  name: string;
-  /**
-   * Whether this step is required (default: `true` on consumer side).
-   */
-  required?: boolean | null;
-  /**
-   * Per-step retry configuration.
-   */
-  retry?: RetrySpec | null;
-  /**
-   * Provenance of this step when generated from a skill template.
-   *
-   * Typed as `serde_json::Value` here to avoid pulling the `skill`
-   * dependency chain into this module; the TS side re-imports the typed
-   * `SkillOrigin` after regeneration.
-   */
-  skillOrigin?: {
-    [k: string]: unknown;
-  };
-  /**
-   * Timeout in seconds.
-   */
-  timeoutSeconds?: number | null;
-  /**
-   * Verification depth category.
-   */
-  verificationCategory?: VerificationCategoryKind | null;
-  /**
-   * Expected text (for text assertion) or element ID (for screenshot/highlight).
-   */
-  visualAssertionExpected?: string | null;
-  /**
-   * Options JSON for the assertion.
-   */
-  visualAssertionOptions?: {
-    [k: string]: unknown;
-  };
-  /**
-   * Element query JSON for text assertions.
-   */
-  visualAssertionQuery?: {
-    [k: string]: unknown;
-  };
-  /**
-   * Assertion type: `"text"`, `"screenshot"`, or `"highlight"`.
-   */
-  visualAssertionType?: VisualAssertionType | null;
-  [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`.
+ */
+
+import type { RetrySpec } from './RetrySpec';
+import type { VerificationCategoryKind } from './VerificationCategoryKind';
+import type { VisualAssertionType } from './VisualAssertionType';
+
+/**
+ * Assert visual properties of UI elements via the UI Bridge.
+ *
+ * Wire tag: `"ui_bridge_visual_assertion"`.
+ */
+export interface UiBridgeVisualAssertionStep {
+  /**
+   * Acceptance criterion IDs verified by this step.
+   */
+  criterionIds?: string[];
+  /**
+   * IDs of other steps that must complete first.
+   */
+  dependsOn?: string[];
+  /**
+   * Extractions published to subsequent steps.
+   */
+  extract?: {
+    [k: string]: string;
+  };
+  /**
+   * If `Some(true)`, a console-error signal from the UI fails this step.
+   */
+  failOnConsoleErrors?: boolean | null;
+  /**
+   * Unique identifier for the step.
+   */
+  id: string;
+  /**
+   * Named input bindings evaluated at step entry.
+   */
+  inputs?: {
+    [k: string]: string;
+  };
+  /**
+   * Display name for the step.
+   */
+  name: string;
+  /**
+   * Whether this step is required (default: `true` on consumer side).
+   */
+  required?: boolean | null;
+  /**
+   * Per-step retry configuration.
+   */
+  retry?: RetrySpec | null;
+  /**
+   * Provenance of this step when generated from a skill template.
+   *
+   * Typed as `serde_json::Value` here to avoid pulling the `skill`
+   * dependency chain into this module; the TS side re-imports the typed
+   * `SkillOrigin` after regeneration.
+   */
+  skillOrigin?: {
+    [k: string]: unknown;
+  };
+  /**
+   * Timeout in seconds.
+   */
+  timeoutSeconds?: number | null;
+  /**
+   * Verification depth category.
+   */
+  verificationCategory?: VerificationCategoryKind | null;
+  /**
+   * Expected text (for text assertion) or element ID (for screenshot/highlight).
+   */
+  visualAssertionExpected?: string | null;
+  /**
+   * Options JSON for the assertion.
+   */
+  visualAssertionOptions?: {
+    [k: string]: unknown;
+  };
+  /**
+   * Element query JSON for text assertions.
+   */
+  visualAssertionQuery?: {
+    [k: string]: unknown;
+  };
+  /**
+   * Assertion type: `"text"`, `"screenshot"`, or `"highlight"`.
+   */
+  visualAssertionType?: VisualAssertionType | null;
+  [k: string]: unknown;
+}