@qontinui/shared-types 0.2.1

package/src/generated/VisualComparisonResult.d.ts

@@ -0,0 +1,40 @@
+/* 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`.
+ */
+
+/**
+ * Result of visual comparison of a screenshot against a baseline.
+ */
+export interface VisualComparisonResult {
+  /**
+   * Baseline screenshot ID, if any.
+   */
+  baselineId?: string | null;
+  /**
+   * Comparison result ID.
+   */
+  comparisonId: string;
+  /**
+   * URL to a diff image, if generated.
+   */
+  diffImageUrl?: string | null;
+  /**
+   * Number of diff regions detected.
+   */
+  diffRegionCount: number;
+  /**
+   * Whether the comparison passed.
+   */
+  passed: boolean;
+  /**
+   * Similarity score in the range `[0.0, 1.0]`.
+   */
+  similarityScore: number;
+  /**
+   * Threshold used for the pass/fail decision.
+   */
+  threshold: number;
+}

package/src/generated/WaitOptions.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`.
+ */
+
+/**
+ * Wait-condition options attached to an element action request.
+ *
+ * Before executing the action the bridge can optionally wait until the
+ * target element reaches a specified visibility/enabled/focused state.
+ */
+export interface WaitOptions {
+  /**
+   * Wait until the element is enabled (or disabled if `false`).
+   */
+  enabled?: boolean | null;
+  /**
+   * Wait until the element has focus (or loses focus if `false`).
+   */
+  focused?: boolean | null;
+  /**
+   * Polling interval in milliseconds for condition checks.
+   */
+  interval?: number | null;
+  /**
+   * Maximum time to wait in milliseconds before timing out.
+   */
+  timeout?: number | null;
+  /**
+   * Wait until the element is visible (or hidden if `false`).
+   */
+  visible?: boolean | null;
+}

package/src/generated/WorkerCoordinationMessage.d.ts

@@ -0,0 +1,93 @@
+/* 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 { Confidence } from './Confidence';
+import type { Finding } from './Finding';
+
+/**
+ * Coordination message between workers.
+ *
+ * Externally tagged as `{ "type": ..., "data": { ... } }` to match the
+ * pre-extraction wire.
+ */
+export type WorkerCoordinationMessage =
+  | {
+      data: {
+        /**
+         * Paths of the modified files.
+         */
+        files: string[];
+        /**
+         * ID of the worker that modified the files.
+         */
+        worker_id: string;
+        [k: string]: unknown;
+      };
+      type: "files_modified";
+      [k: string]: unknown;
+    }
+  | {
+      data: {
+        finding: Finding;
+        /**
+         * ID of the worker that made the finding.
+         */
+        worker_id: string;
+        [k: string]: unknown;
+      };
+      type: "shared_finding";
+      [k: string]: unknown;
+    }
+  | {
+      data: {
+        /**
+         * Human-readable reason for the block.
+         */
+        reason: string;
+        /**
+         * ID of the worker being waited on.
+         */
+        waiting_for: string;
+        /**
+         * ID of the blocked worker.
+         */
+        worker_id: string;
+        [k: string]: unknown;
+      };
+      type: "blocked";
+      [k: string]: unknown;
+    }
+  | {
+      data: {
+        /**
+         * Optional domain scope for the verification.
+         */
+        domain?: string | null;
+        /**
+         * ID of the worker that is ready.
+         */
+        worker_id: string;
+        [k: string]: unknown;
+      };
+      type: "ready_for_verification";
+      [k: string]: unknown;
+    }
+  | {
+      data: {
+        /**
+         * Human-readable reason for the sync point.
+         */
+        reason: string;
+        /**
+         * IDs of the workers that should synchronize.
+         */
+        worker_ids: string[];
+        [k: string]: unknown;
+      };
+      type: "sync_point";
+      [k: string]: unknown;
+    };

package/src/generated/WorkerDomain.d.ts

@@ -0,0 +1,29 @@
+/* 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`.
+ */
+
+/**
+ * Domain assignment for a worker agent (lightweight — used inside a
+ * [`VerificationPlan`]'s `worker_domains` list).
+ */
+export interface WorkerDomain {
+  /**
+   * Files / paths this worker owns (glob patterns).
+   */
+  filePatterns?: string[];
+  /**
+   * Optional specialization label (e.g., "frontend", "tests").
+   */
+  specialization?: string | null;
+  /**
+   * Additional system-prompt text to inject for this worker.
+   */
+  systemPromptAdditions?: string | null;
+  /**
+   * Worker identifier.
+   */
+  workerId: string;
+}

package/src/generated/WorkerInstance.d.ts

@@ -0,0 +1,62 @@
+/* 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 { Confidence } from './Confidence';
+import type { Finding } from './Finding';
+import type { WorkerSignal } from './WorkerSignal';
+import type { WorkerStatus } from './WorkerStatus';
+
+/**
+ * Instance tracking for an individual worker.
+ */
+export interface WorkerInstance {
+  /**
+   * ISO 8601 timestamp when the worker completed.
+   */
+  completedAt?: string | null;
+  /**
+   * Domain this worker is assigned to (if any).
+   */
+  domain?: string | null;
+  /**
+   * Error message if the worker is in error state.
+   */
+  errorMessage?: string | null;
+  /**
+   * Findings recorded by this worker.
+   */
+  findings?: Finding[];
+  /**
+   * Current iteration for this worker.
+   */
+  iteration: number;
+  /**
+   * Last signal received from this worker.
+   */
+  lastSignal?: WorkerSignal | null;
+  /**
+   * Maximum iterations allowed for this worker.
+   */
+  maxIterations: number;
+  /**
+   * Human-readable name.
+   */
+  name: string;
+  /**
+   * ISO 8601 timestamp when the worker started.
+   */
+  startedAt?: string | null;
+  status: WorkerStatus;
+  /**
+   * Files this worker has touched.
+   */
+  touchedFiles?: string[];
+  /**
+   * Unique identifier for this worker.
+   */
+  workerId: string;
+}

package/src/generated/WorkerOutput.d.ts

@@ -0,0 +1,53 @@
+/* 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 { ConfidenceLevel } from './ConfidenceLevel';
+import type { StructuredFinding } from './StructuredFinding';
+import type { StructuredOverride } from './StructuredOverride';
+import type { StructuredSignal } from './StructuredSignal';
+
+/**
+ * Structured output from an AI worker agent.
+ */
+export interface WorkerOutput {
+  /**
+   * Confidence level in the work quality.
+   */
+  confidence?: ConfidenceLevel & string;
+  /**
+   * Criterion overrides with justifications.
+   */
+  criterionOverrides: StructuredOverride[];
+  /**
+   * Files that were modified in this iteration.
+   */
+  filesModified: string[];
+  /**
+   * Findings discovered during work.
+   */
+  findings: StructuredFinding[];
+  /**
+   * Optional suggestion for next action if work continues.
+   */
+  nextActionSuggestion?: string | null;
+  /**
+   * Optional notes for debugging or context.
+   */
+  notes?: string | null;
+  /**
+   * Optional progress estimate (0.0 to 1.0).
+   */
+  progressEstimate?: number | null;
+  /**
+   * Signals for orchestrator control flow.
+   */
+  signals: StructuredSignal[];
+  /**
+   * Summary of work performed in this iteration.
+   */
+  workSummary: string;
+}

package/src/generated/WorkerSignal.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 { Confidence } from './Confidence';
+import type { Finding } from './Finding';
+
+/**
+ * Signal emitted by a worker agent.
+ *
+ * Tagged as `{ "signal": ..., "data": ... }` rather than the more common
+ * `type`/`data` pair; this matches the pre-extraction wire.
+ */
+export type WorkerSignal =
+  | {
+      data: {
+        /**
+         * Optional reason provided by the worker.
+         */
+        reason?: string | null;
+        [k: string]: unknown;
+      };
+      signal: "work_complete";
+      [k: string]: unknown;
+    }
+  | {
+      data: {
+        /**
+         * Reason for the replan request.
+         */
+        reason: string;
+        [k: string]: unknown;
+      };
+      signal: "need_replan";
+      [k: string]: unknown;
+    }
+  | {
+      signal: "continue";
+      [k: string]: unknown;
+    }
+  | {
+      data: Finding;
+      signal: "finding";
+      [k: string]: unknown;
+    };

package/src/generated/WorkerStatus.d.ts

@@ -0,0 +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`.
+ */
+
+/**
+ * Current state of an individual worker.
+ */
+export type WorkerStatus = "idle" | "active" | "awaiting_verification" | "paused" | "completed" | "error";

package/src/generated/WorkflowArchitecture.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`.
+ */
+
+/**
+ * The workflow execution architecture to use.
+ *
+ * This is a first-class workflow architecture option, allowing direct
+ * comparison between traditional deterministic verification and agentic
+ * verification approaches. Mirrors the runner-side enum in
+ * `crate::agentic_verification`.
+ */
+export type WorkflowArchitecture = "traditional" | "agentic_verification" | "multi_agent_pipeline";

package/src/generated/WorkflowFixupMode.d.ts

@@ -0,0 +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`.
+ */
+
+/**
+ * Fixup mode for [`WorkflowFixupStep`].
+ */
+export type WorkflowFixupMode = "autofix" | "harden" | "validate_criteria";

package/src/generated/WorkflowFixupStep.d.ts

@@ -0,0 +1,85 @@
+/* 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 { WorkflowFixupMode } from './WorkflowFixupMode';
+
+/**
+ * Run deterministic Rust fixups on a workflow JSON file.
+ *
+ * Wire tag: `"workflow_fixup"`.
+ */
+export interface WorkflowFixupStep {
+  /**
+   * 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;
+  /**
+   * Path to criteria JSON file (for `validate_criteria` mode).
+   */
+  fixupCriteriaPath?: string | null;
+  /**
+   * Path to the workflow JSON file to fix (supports `{{artifact_dir}}`).
+   */
+  fixupInputPath?: string | null;
+  /**
+   * Fixup mode.
+   */
+  fixupMode?: WorkflowFixupMode | 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;
+  };
+  /**
+   * Verification depth category.
+   */
+  verificationCategory?: VerificationCategoryKind | null;
+  [k: string]: unknown;
+}

package/src/generated/WorkflowInfo.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`.
+ */
+
+/**
+ * Workflow metadata included in a UI Bridge snapshot.
+ */
+export interface WorkflowInfo {
+  /**
+   * Optional description.
+   */
+  description?: string | null;
+  /**
+   * Workflow ID.
+   */
+  id: string;
+  /**
+   * Workflow name.
+   */
+  name: string;
+  /**
+   * Number of steps in the workflow.
+   */
+  stepCount: number;
+}

package/src/generated/WorkflowMetadata.d.ts

@@ -0,0 +1,44 @@
+/* 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`.
+ */
+
+/**
+ * Information about the workflow being executed in the run.
+ */
+export interface WorkflowMetadata {
+  /**
+   * Workflow description.
+   */
+  description?: string | null;
+  /**
+   * IDs of the states that are active when the workflow starts.
+   */
+  initialStateIds?: string[] | null;
+  /**
+   * Free-form tags attached to the workflow.
+   */
+  tags?: string[] | null;
+  /**
+   * Number of states declared by the workflow.
+   */
+  totalStates?: number | null;
+  /**
+   * Number of transitions declared by the workflow.
+   */
+  totalTransitions?: number | null;
+  /**
+   * Workflow identifier.
+   */
+  workflowId: string;
+  /**
+   * Human-readable workflow name.
+   */
+  workflowName: string;
+  /**
+   * Workflow version, if tracked.
+   */
+  workflowVersion?: string | null;
+}

package/src/generated/WorkflowRefStep.d.ts

@@ -0,0 +1,94 @@
+/* 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';
+
+/**
+ * Run a saved workflow inline with input variable substitution.
+ *
+ * Wire tag: `"workflow_ref"`.
+ */
+export interface WorkflowRefStep {
+  /**
+   * 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 to inherit model overrides from the parent context (default: `true`).
+   */
+  refInheritModelOverrides?: boolean | null;
+  /**
+   * Input variables substituted into the child workflow's prompt.
+   */
+  refWorkflowInputs?: {
+    [k: string]: string;
+  } | null;
+  /**
+   * Display name of the referenced workflow (denormalized for UI).
+   */
+  refWorkflowName?: string | null;
+  /**
+   * 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;
+  /**
+   * ID of the saved workflow to run.
+   */
+  workflowId?: string | null;
+  [k: string]: unknown;
+}