@qontinui/shared-types 0.2.4 → 0.3.0

package/src/generated/ScreenshotAnnotation.d.ts

@@ -1,39 +1,39 @@
-/* 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 { ScreenshotAnnotationShape } from './ScreenshotAnnotationShape';
-
-/**
- * Annotation overlaid on a screenshot (box, circle, arrow, or text).
- */
-export interface ScreenshotAnnotation {
-  /**
-   * CSS-style color string (e.g., `"#FF0000"`).
-   */
-  color?: string | null;
-  /**
-   * Annotation height in pixels.
-   */
-  height?: number | null;
-  /**
-   * Free-form label for the annotation.
-   */
-  label?: string | null;
-  type: ScreenshotAnnotationShape;
-  /**
-   * Annotation width in pixels.
-   */
-  width?: number | null;
-  /**
-   * X coordinate in pixels.
-   */
-  x: number;
-  /**
-   * Y coordinate in pixels.
-   */
-  y: number;
-}
+/* 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 { ScreenshotAnnotationShape } from './ScreenshotAnnotationShape';
+
+/**
+ * Annotation overlaid on a screenshot (box, circle, arrow, or text).
+ */
+export interface ScreenshotAnnotation {
+  /**
+   * CSS-style color string (e.g., `"#FF0000"`).
+   */
+  color?: string | null;
+  /**
+   * Annotation height in pixels.
+   */
+  height?: number | null;
+  /**
+   * Free-form label for the annotation.
+   */
+  label?: string | null;
+  type: ScreenshotAnnotationShape;
+  /**
+   * Annotation width in pixels.
+   */
+  width?: number | null;
+  /**
+   * X coordinate in pixels.
+   */
+  x: number;
+  /**
+   * Y coordinate in pixels.
+   */
+  y: number;
+}

package/src/generated/ScreenshotAnnotationShape.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`.
- */
-
-/**
- * Kind of shape overlaid on a screenshot annotation.
- */
-export type ScreenshotAnnotationShape = "box" | "circle" | "arrow" | "text";
+/* 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`.
+ */
+
+/**
+ * Kind of shape overlaid on a screenshot annotation.
+ */
+export type ScreenshotAnnotationShape = "box" | "circle" | "arrow" | "text";

package/src/generated/ScreenshotType.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`.
- */
-
-/**
- * Kind of screenshot captured.
- */
-export type ScreenshotType = "error" | "success" | "manual" | "periodic" | "action_result" | "state_verification";
+/* 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`.
+ */
+
+/**
+ * Kind of screenshot captured.
+ */
+export type ScreenshotType = "error" | "success" | "manual" | "periodic" | "action_result" | "state_verification";

package/src/generated/ScrollDirection.d.ts

@@ -1,13 +1,13 @@
-/* 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`.
- */
-
-/**
- * Scroll direction for the `scroll` action.
- *
- * Serialized as a bare lowercase string.
- */
-export type ScrollDirection = "up" | "down" | "left" | "right";
+/* 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`.
+ */
+
+/**
+ * Scroll direction for the `scroll` action.
+ *
+ * Serialized as a bare lowercase string.
+ */
+export type ScrollDirection = "up" | "down" | "left" | "right";

package/src/generated/SearchOptions.d.ts

@@ -1,33 +1,33 @@
-/* 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 { CoordinateSystem } from './CoordinateSystem';
-import type { Coordinates } from './Coordinates';
-import type { MatchAdjustment } from './MatchAdjustment';
-import type { MatchMethod } from './MatchMethod';
-import type { PatternOptions } from './PatternOptions';
-import type { PollingConfig } from './PollingConfig';
-import type { Region } from './Region';
-import type { SearchStrategy } from './SearchStrategy';
-
-/**
- * Search options for target finding.
- */
-export interface SearchOptions {
-  adjustment?: MatchAdjustment | null;
-  captureImage?: boolean | null;
-  maxMatches?: number | null;
-  maxMatchesToActOn?: number | null;
-  minMatches?: number | null;
-  pattern?: PatternOptions | null;
-  polling?: PollingConfig | null;
-  searchRegions?: Region[] | null;
-  searchStrategy?: SearchStrategy | null;
-  similarity?: number | null;
-  timeout?: number | null;
-  useDefinedRegion?: boolean | null;
-}
+/* 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 { CoordinateSystem } from './CoordinateSystem';
+import type { Coordinates } from './Coordinates';
+import type { MatchAdjustment } from './MatchAdjustment';
+import type { MatchMethod } from './MatchMethod';
+import type { PatternOptions } from './PatternOptions';
+import type { PollingConfig } from './PollingConfig';
+import type { Region } from './Region';
+import type { SearchStrategy } from './SearchStrategy';
+
+/**
+ * Search options for target finding.
+ */
+export interface SearchOptions {
+  adjustment?: MatchAdjustment | null;
+  captureImage?: boolean | null;
+  maxMatches?: number | null;
+  maxMatchesToActOn?: number | null;
+  minMatches?: number | null;
+  pattern?: PatternOptions | null;
+  polling?: PollingConfig | null;
+  searchRegions?: Region[] | null;
+  searchStrategy?: SearchStrategy | null;
+  similarity?: number | null;
+  timeout?: number | null;
+  useDefinedRegion?: boolean | null;
+}

package/src/generated/SearchResultItem.d.ts

@@ -1,19 +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`.
- */
-
-import type { EmbeddingItem } from './EmbeddingItem';
-
-/**
- * Single search result.
- */
-export interface SearchResultItem {
-  embedding: EmbeddingItem;
-  /**
-   * Similarity score (0-1).
-   */
-  similarity_score: number;
-}
+/* 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 { EmbeddingItem } from './EmbeddingItem';
+
+/**
+ * Single search result.
+ */
+export interface SearchResultItem {
+  embedding: EmbeddingItem;
+  /**
+   * Similarity score (0-1).
+   */
+  similarity_score: number;
+}

package/src/generated/SearchStrategy.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`.
- */
-
-/**
- * Strategy for selecting among multiple matches in a FIND action.
- *
- * Variants serialize uppercase (`"FIRST"`, `"ALL"`, `"BEST"`, `"EACH"`) to
- * match the existing Python enum and all stored action configs.
- */
-export type SearchStrategy = "FIRST" | "ALL" | "BEST" | "EACH";
+/* 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`.
+ */
+
+/**
+ * Strategy for selecting among multiple matches in a FIND action.
+ *
+ * Variants serialize uppercase (`"FIRST"`, `"ALL"`, `"BEST"`, `"EACH"`) to
+ * match the existing Python enum and all stored action configs.
+ */
+export type SearchStrategy = "FIRST" | "ALL" | "BEST" | "EACH";

package/src/generated/SemanticSearchRequest.d.ts

@@ -1,26 +1,26 @@
-/* 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`.
- */
-
-/**
- * Request for semantic search.
- */
-export interface SemanticSearchRequest {
-  /**
-   * Max results to return (1–100).
-   */
-  limit: number;
-  /**
-   * Minimum similarity threshold (0–1). CLIP text-to-image similarities
-   * typically fall in 0.15–0.35, so 0.2 is a reasonable default.
-   */
-  min_similarity: number;
-  /**
-   * Search query text (min length 1).
-   */
-  query: string;
-  state_filter?: string | null;
-}
+/* 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`.
+ */
+
+/**
+ * Request for semantic search.
+ */
+export interface SemanticSearchRequest {
+  /**
+   * Max results to return (1–100).
+   */
+  limit: number;
+  /**
+   * Minimum similarity threshold (0–1). CLIP text-to-image similarities
+   * typically fall in 0.15–0.35, so 0.2 is a reasonable default.
+   */
+  min_similarity: number;
+  /**
+   * Search query text (min length 1).
+   */
+  query: string;
+  state_filter?: string | null;
+}

package/src/generated/SemanticSearchResponse.d.ts

@@ -1,21 +1,21 @@
-/* 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 { EmbeddingItem } from './EmbeddingItem';
-import type { SearchResultItem } from './SearchResultItem';
-
-/**
- * Response from semantic search.
- */
-export interface SemanticSearchResponse {
-  /**
-   * The original search query.
-   */
-  query: string;
-  results: SearchResultItem[];
-  total_found: number;
-}
+/* 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 { EmbeddingItem } from './EmbeddingItem';
+import type { SearchResultItem } from './SearchResultItem';
+
+/**
+ * Response from semantic search.
+ */
+export interface SemanticSearchResponse {
+  /**
+   * The original search query.
+   */
+  query: string;
+  results: SearchResultItem[];
+  total_found: number;
+}

package/src/generated/SpecCheckConfidence.d.ts

@@ -0,0 +1,15 @@
+/* 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`.
+ */
+
+/**
+ * Confidence level — high / medium / low.
+ *
+ * Collides with `qontinui_types::verification::Confidence` in the
+ * cross-repo schema registry; registered as `SpecCheckConfidence` in
+ * `schema_export.rs`. See module docs.
+ */
+export type Confidence = "high" | "medium" | "low";

package/src/generated/SpecCheckPolicy.d.ts

@@ -0,0 +1,23 @@
+/* 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 { AssertionScope } from './AssertionScope';
+import type { ConjunctRule } from './ConjunctRule';
+import type { MatchOutcome } from './MatchOutcome';
+import type { PolicyConjunct } from './PolicyConjunct';
+
+/**
+ * AND-only policy — all conjuncts must hold for the policy to pass.
+ * Per §5.7 there is no OR; compose multiple steps if you need
+ * disjunction.
+ */
+export interface SpecCheckPolicy {
+  /**
+   * Conjuncts ANDed together.
+   */
+  conjuncts?: PolicyConjunct[];
+}

package/src/generated/SpecCheckResult.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`.
+ */
+
+import type { AssertionMiss } from './AssertionMiss';
+import type { AssertionOutcome } from './AssertionOutcome';
+import type { AssertionResult } from './AssertionResult';
+import type { AssertionSeverityCounts } from './AssertionSeverityCounts';
+import type { BridgeFingerprint } from './BridgeFingerprint';
+import type { CandidateMiss } from './CandidateMiss';
+import type { Confidence } from './Confidence';
+import type { FieldDiff } from './FieldDiff';
+import type { MatchOutcome } from './MatchOutcome';
+import type { MatchedElement } from './MatchedElement';
+import type { MissReason } from './MissReason';
+import type { RecommendedState } from './RecommendedState';
+import type { SpecCheckSummary } from './SpecCheckSummary';
+import type { StateMatchResult } from './StateMatchResult';
+
+/**
+ * Result of evaluating one or more page specs against a bridge snapshot.
+ *
+ * `result_schema_version` is the FIRST field per §5.15 — read-time
+ * forward migration uses it to route legacy JSONB through
+ * `result_migration`. Pre-versioned rows (written before v1 shipped)
+ * deserialize as `0`.
+ */
+export interface SpecCheckResult {
+  bridgeFingerprint: BridgeFingerprint;
+  /**
+   * ISO-8601 UTC. When the spec was hashed and the snapshot indexed.
+   */
+  evaluatedAt: string;
+  /**
+   * Page being evaluated.
+   */
+  pageId: string;
+  /**
+   * v1 = 1. Missing on the wire (pre-versioned persisted rows) → 0.
+   */
+  resultSchemaVersion: number;
+  /**
+   * Caller-minted snapshot ID. Format: `"scs_" + ULID()`. See §5.8.
+   */
+  snapshotId: string;
+  /**
+   * Hash of the spec IR document at evaluation time. `"sha256-<hex>"`.
+   */
+  specContentHash: string;
+  /**
+   * IR document `version` field (currently `"1.0"`).
+   */
+  specVersion: string;
+  /**
+   * One result per `IrState` in the spec.
+   */
+  stateResults: StateMatchResult[];
+  summary: SpecCheckSummary;
+  /**
+   * Soft signals — currently used for `Stale` from `SnapshotFetchError`.
+   */
+  warnings?: string[];
+}

package/src/generated/SpecCheckStepConfig.d.ts

@@ -0,0 +1,38 @@
+/* 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 { AssertionScope } from './AssertionScope';
+import type { ConjunctRule } from './ConjunctRule';
+import type { MatchOutcome } from './MatchOutcome';
+import type { PolicyConjunct } from './PolicyConjunct';
+import type { SpecCheckPolicy } from './SpecCheckPolicy';
+
+/**
+ * Workflow-step variant payload — the persisted shape of a
+ * `spec_check` step in a unified workflow.
+ */
+export interface SpecCheckStepConfig {
+  /**
+   * Severities that should cause the step to fail when present in
+   * `severity_counts`. Empty means "all severities count as failure".
+   */
+  failOn?: string[];
+  /**
+   * If `true`, the step fails when the target app isn't connected to
+   * the bridge.
+   */
+  failWhenNoApp: boolean;
+  /**
+   * If `true`, the step fails when no spec exists for `page_id`.
+   */
+  failWhenNoSpec: boolean;
+  /**
+   * Page to evaluate.
+   */
+  pageId: string;
+  policy: SpecCheckPolicy;
+}

package/src/generated/SpecCheckSummary.d.ts

@@ -0,0 +1,28 @@
+/* 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 { AssertionSeverityCounts } from './AssertionSeverityCounts';
+import type { Confidence } from './Confidence';
+import type { MatchOutcome } from './MatchOutcome';
+import type { RecommendedState } from './RecommendedState';
+
+/**
+ * Aggregate summary across all evaluated states.
+ */
+export interface SpecCheckSummary {
+  matchOutcome: MatchOutcome;
+  /**
+   * Mean of per-state match rates, weighted equally.
+   */
+  overallMatchRate: number;
+  /**
+   * The single state (if any) the matcher recommends the caller treat
+   * as "current". `None` when the matcher has no preference.
+   */
+  recommendedState?: RecommendedState | null;
+  severityCounts: AssertionSeverityCounts;
+}

package/src/generated/SpecValidation.d.ts

@@ -0,0 +1,27 @@
+/* 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`.
+ */
+
+/**
+ * Per-page validation summary surfaced on `GET /spec/list`. §5.12 G2.
+ */
+export interface SpecValidation {
+  /**
+   * State IDs whose distinctness signal is empty (a state with no
+   * assertions that distinguish it from any other state).
+   */
+  degenerateStateIds?: string[];
+  /**
+   * Pairs of state IDs that share an identical normalized distinctness
+   * signal. Each inner array is sorted lexicographically so the same
+   * pair always serializes the same way regardless of detection order.
+   */
+  indistinguishableStatePairs?: [string, string][];
+  /**
+   * Page identifier.
+   */
+  pageId: string;
+}

package/src/generated/StageCondition.d.ts

@@ -1,37 +1,37 @@
-/* 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`.
- */
-
-/**
- * Condition for conditional stage execution.
- *
- * When attached to a [`WorkflowStage`], the stage is skipped if the condition
- * evaluates to "should skip". All condition fields are optional and combine
- * with AND semantics — all specified conditions must be met for the stage to
- * run.
- */
-export interface StageCondition {
-  /**
-   * Run this stage only if the previous stage had this outcome.
-   *
-   * - `"passed"`: run only if previous stage verification passed
-   * - `"failed"`: run only if previous stage verification failed
-   * - `"any"`: always run regardless of previous outcome (default behavior)
-   */
-  ifPrevious?: string | null;
-  /**
-   * Skip this stage if the total number of failed stages so far is below
-   * this threshold. Useful for "recovery" stages that only run when
-   * multiple prior stages have failed.
-   */
-  minFailures?: number | null;
-  /**
-   * Run this stage only after this many loop iterations have occurred
-   * (across all stages). Useful for "escalation" stages that only kick in
-   * after initial attempts have failed.
-   */
-  minIteration?: number | null;
-}
+/* 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`.
+ */
+
+/**
+ * Condition for conditional stage execution.
+ *
+ * When attached to a [`WorkflowStage`], the stage is skipped if the condition
+ * evaluates to "should skip". All condition fields are optional and combine
+ * with AND semantics — all specified conditions must be met for the stage to
+ * run.
+ */
+export interface StageCondition {
+  /**
+   * Run this stage only if the previous stage had this outcome.
+   *
+   * - `"passed"`: run only if previous stage verification passed
+   * - `"failed"`: run only if previous stage verification failed
+   * - `"any"`: always run regardless of previous outcome (default behavior)
+   */
+  ifPrevious?: string | null;
+  /**
+   * Skip this stage if the total number of failed stages so far is below
+   * this threshold. Useful for "recovery" stages that only run when
+   * multiple prior stages have failed.
+   */
+  minFailures?: number | null;
+  /**
+   * Run this stage only after this many loop iterations have occurred
+   * (across all stages). Useful for "escalation" stages that only kick in
+   * after initial attempts have failed.
+   */
+  minIteration?: number | null;
+}