@qontinui/shared-types 0.2.1

package/src/generated/ProcessStatus.d.ts

@@ -0,0 +1,41 @@
+/* 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 { ProcessState } from './ProcessState';
+
+/**
+ * Status summary of a managed process.
+ *
+ * Derived from runtime state each time it is requested; never persisted.
+ */
+export interface ProcessStatus {
+  category: string;
+  /**
+   * Number of errors detected from this process
+   */
+  errorCount: number;
+  /**
+   * Whether this process has a build command configured
+   */
+  hasBuildCommand: boolean;
+  id: string;
+  name: string;
+  pid?: number | null;
+  /**
+   * Whether the health port is responding
+   */
+  portHealthy?: boolean | null;
+  /**
+   * Number of times this process has been restarted
+   */
+  restartCount: number;
+  state: ProcessState;
+  /**
+   * Uptime in seconds (None if not running)
+   */
+  uptimeSecs?: number | null;
+}

package/src/generated/PromptStep.d.ts

@@ -0,0 +1,92 @@
+/* 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 { PromptStepPhase } from './PromptStepPhase';
+import type { RetrySpec } from './RetrySpec';
+import type { VerificationCategoryKind } from './VerificationCategoryKind';
+
+/**
+ * AI task instructions (prompt).
+ */
+export interface PromptStep {
+  /**
+   * Prompt body.
+   */
+  content: string;
+  /**
+   * 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;
+  };
+  /**
+   * Marks this prompt as the summary step at the end of completion.
+   */
+  isSummaryStep?: boolean | null;
+  /**
+   * Model override.
+   */
+  model?: string | null;
+  /**
+   * Display name for the step.
+   */
+  name: string;
+  phase: PromptStepPhase;
+  /**
+   * Saved prompt ID (when the body is a reference).
+   */
+  promptId?: string | null;
+  /**
+   * AI provider override.
+   */
+  provider?: 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;
+  };
+  /**
+   * Verification depth category.
+   */
+  verificationCategory?: VerificationCategoryKind | null;
+  [k: string]: unknown;
+}

package/src/generated/PromptStepPhase.d.ts

@@ -0,0 +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`.
+ */
+
+/**
+ * Phases in which a [`PromptStep`] may appear.
+ *
+ * Prompt steps are the only variant that may appear in the agentic phase.
+ */
+export type PromptStepPhase = "setup" | "verification" | "agentic" | "completion";

package/src/generated/RAGDashboardStats.d.ts

@@ -0,0 +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`.
+ */
+
+import type { JobStatus } from './JobStatus';
+import type { JobSummary } from './JobSummary';
+
+/**
+ * Summary statistics for the RAG dashboard.
+ */
+export interface RAGDashboardStats {
+  /**
+   * Currently-running job, if any.
+   */
+  active_job?: JobSummary | null;
+  /**
+   * ISO 8601 UTC timestamp (`Z` suffix).
+   */
+  last_sync_at?: string | null;
+  total_embeddings: number;
+  total_patterns: number;
+  total_states: number;
+}

package/src/generated/RagCompletionEvent.d.ts

@@ -0,0 +1,25 @@
+/* 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 { EmbeddingResultItem } from './EmbeddingResultItem';
+
+/**
+ * Completion event emitted when RAG processing finishes.
+ */
+export interface RagCompletionEvent {
+  failed: number;
+  project_id: string;
+  results: EmbeddingResultItem[];
+  success: boolean;
+  successful: number;
+  total_processed: number;
+  web_sync_error?: string | null;
+  /**
+   * Whether sync to the web backend succeeded.
+   */
+  web_sync_success?: boolean | null;
+}

package/src/generated/RagProcessingStatus.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`.
+ */
+
+/**
+ * Status of RAG processing in the runner.
+ */
+export type RagProcessingStatus = "not_started" | "in_progress" | "completed" | "failed";

package/src/generated/RagProgressEvent.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`.
+ */
+
+import type { RagProcessingStatus } from './RagProcessingStatus';
+
+/**
+ * Progress event emitted during RAG processing.
+ */
+export interface RagProgressEvent {
+  elements_processed?: number | null;
+  error?: string | null;
+  /**
+   * Human-readable status message.
+   */
+  message: string;
+  /**
+   * Progress percentage (0-100).
+   */
+  percent?: number | null;
+  project_id: string;
+  status: RagProcessingStatus;
+  total_elements?: number | null;
+}

package/src/generated/ReadConfigResponse.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`.
+ */
+
+/**
+ * Response for `GET /constraints/config`.
+ */
+export interface ReadConfigResponse {
+  /**
+   * Resolved file path, if a config file was found.
+   */
+  path?: string | null;
+  /**
+   * Raw TOML content of the `constraints.toml` file (empty string if not found).
+   */
+  toml: string;
+}

package/src/generated/ReflectionFixOutput.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`.
+ */
+
+/**
+ * A reflection fix reported by the AI.
+ */
+export interface ReflectionFixOutput {
+  /**
+   * Description of the fix applied.
+   */
+  description: string;
+  /**
+   * Identifier for the error being fixed.
+   */
+  errorId: string;
+}

package/src/generated/Region.d.ts

@@ -0,0 +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 { CoordinateSystem } from './CoordinateSystem';
+
+/**
+ * Rectangular region on screen. Like [`Coordinates`], can optionally specify
+ * which coordinate system the `x`/`y` are in.
+ */
+export interface Region {
+  /**
+   * Height of the region (must be positive).
+   */
+  height: number;
+  /**
+   * Monitor index (required when `system` is `MonitorRelative`).
+   */
+  monitorIndex?: number | null;
+  /**
+   * Coordinate system. `None` defaults to `Screen`.
+   */
+  system?: CoordinateSystem | null;
+  /**
+   * Width of the region (must be positive).
+   */
+  width: number;
+  /**
+   * X coordinate of the top-left corner.
+   */
+  x: number;
+  /**
+   * Y coordinate of the top-left corner.
+   */
+  y: number;
+}

package/src/generated/RepositoryInactiveCondition.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`.
+ */
+
+import type { RepositoryWatch } from './RepositoryWatch';
+
+/**
+ * Condition that requires repositories to have no file modifications for a
+ * period. ALL configured repositories must be inactive for the overall
+ * condition to be met.
+ */
+export interface RepositoryInactiveCondition {
+  /**
+   * Whether this condition is active.
+   */
+  enabled: boolean;
+  /**
+   * List of repositories to watch. ALL must be inactive simultaneously.
+   */
+  repositories: RepositoryWatch[];
+}

package/src/generated/RepositoryWatch.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`.
+ */
+
+/**
+ * A single repository to monitor for inactivity.
+ */
+export interface RepositoryWatch {
+  /**
+   * Minutes of inactivity required before the watch is considered met.
+   */
+  inactiveMinutes: number;
+  /**
+   * Path to the repository directory.
+   */
+  path: string;
+}

package/src/generated/ResolvedInitialStates.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`.
+ */
+
+import type { InitialStateRef } from './InitialStateRef';
+import type { InitialStatesSource } from './InitialStatesSource';
+
+/**
+ * The resolved set of initial states for a run, along with the source the
+ * resolution came from.
+ */
+export interface ResolvedInitialStates {
+  source: InitialStatesSource;
+  /**
+   * Resolved initial state IDs.
+   */
+  stateIds: string[];
+  /**
+   * Display-ready references for each state (optional).
+   */
+  states?: InitialStateRef[] | null;
+  /**
+   * Workflow ID when `source == Workflow`.
+   */
+  workflowId?: string | null;
+}

package/src/generated/ResolvedInitialStatesResult.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`.
+ */
+
+import type { InitialStateRef } from './InitialStateRef';
+import type { InitialStatesSource } from './InitialStatesSource';
+
+/**
+ * Result envelope for the "resolve initial states" operation.
+ *
+ * Unlike [`ResolvedInitialStates`], this shape is non-optional: `states` and
+ * `workflowId` are always present (possibly empty), and a `success` / `error`
+ * pair is provided.
+ */
+export interface ResolvedInitialStatesResult {
+  /**
+   * Error message when resolution failed.
+   */
+  error?: string | null;
+  source: InitialStatesSource;
+  /**
+   * Resolved initial state IDs.
+   */
+  stateIds: string[];
+  /**
+   * Display-ready references for each state.
+   */
+  states: InitialStateRef[];
+  /**
+   * Whether resolution succeeded.
+   */
+  success: boolean;
+  /**
+   * Workflow ID (may be empty).
+   */
+  workflowId: string;
+}

package/src/generated/ResourceLimits.d.ts

@@ -0,0 +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`.
+ */
+
+/**
+ * Resource limits for workflow execution.
+ *
+ * When a limit is approached (within the warning threshold), the tracker
+ * emits context injection actions. When exceeded, it emits stronger actions.
+ */
+export interface ResourceLimits {
+  /**
+   * Maximum agentic phase durations summed (milliseconds).
+   */
+  maxAgenticTimeMs?: number | null;
+  /**
+   * Maximum number of unique files modified across all iterations.
+   */
+  maxFilesModified?: number | null;
+  /**
+   * Maximum wall-clock time for the entire workflow (seconds).
+   */
+  maxWallTimeSecs?: number | null;
+  /**
+   * Warning threshold as a fraction (0.0-1.0). When resource usage exceeds
+   * this fraction of the limit, a warning is injected.
+   * Default: 0.75 (warn at 75% of limit).
+   */
+  warningThreshold?: number | null;
+}

package/src/generated/RestartProcessStep.d.ts

@@ -0,0 +1,88 @@
+/* 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';
+
+/**
+ * Restart a managed process by ID or name.
+ *
+ * Wire tag: `"restart_process"`.
+ */
+export interface RestartProcessStep {
+  /**
+   * 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;
+  /**
+   * Process config ID to restart.
+   */
+  restartProcessId?: string | null;
+  /**
+   * Process name to restart (resolved to ID at runtime).
+   */
+  restartProcessName?: string | null;
+  /**
+   * Whether to wait for health port after restart (default: `true`).
+   */
+  restartWaitForHealth?: 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;
+  [k: string]: unknown;
+}

package/src/generated/RetryPolicy.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`.
+ */
+
+/**
+ * Retry policy for a step or stage.
+ */
+export interface RetryPolicy {
+  /**
+   * Whether to use exponential backoff.
+   */
+  backoff: boolean;
+  /**
+   * Number of retry attempts (`0` = no retries).
+   */
+  count: number;
+  /**
+   * Delay between retries in milliseconds.
+   */
+  delayMs: number;
+}

package/src/generated/RetrySpec.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`.
+ */
+
+/**
+ * Per-step retry configuration carried by [`BaseStepFields::retry`].
+ *
+ * Distinct from the workflow frame's `RetryPolicy` — that one also carries a
+ * `backoff` flag, this per-step form is the older, simpler shape that step
+ * DTOs inherited from the TS `BaseStep` interface.
+ */
+export interface RetrySpec {
+  /**
+   * Number of retry attempts (`0` = no retries).
+   */
+  count: number;
+  /**
+   * Delay between retries in milliseconds.
+   */
+  delayMs: number;
+}

package/src/generated/RoleCriterion.d.ts

@@ -0,0 +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`.
+ */
+
+import type { AccessibilityRole } from './AccessibilityRole';
+
+/**
+ * Role criterion for [`AccessibilitySelector`] — either a single role or a
+ * list of roles (any match).
+ */
+export type RoleCriterion = AccessibilityRole | AccessibilityRole[];

package/src/generated/RootCauseCategory.d.ts

@@ -0,0 +1,18 @@
+/* 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`.
+ */
+
+/**
+ * Root-cause classification for a diagnostic failure.
+ */
+export type RootCauseCategory =
+  | "bad_ui_rendering"
+  | "bad_ui_bridge_evaluation"
+  | "bad_verification_steps"
+  | "bad_generation_prompt"
+  | "bad_state_machine_logic"
+  | "infrastructure_issue"
+  | "unknown";

package/src/generated/RoutingRule.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`.
+ */
+
+/**
+ * A conditional routing rule that selects model/provider based on runtime
+ * context.
+ *
+ * Rules are evaluated in order; the first matching rule wins. Condition
+ * syntax: `"<variable> <op> <value>"` where:
+ * - Variables: `verification_failures`, `iteration`, `stage_index`
+ * - Operators: `>=`, `>`, `<=`, `<`, `==`, `!=`
+ */
+export interface RoutingRule {
+  /**
+   * Condition expression, e.g. `"verification_failures >= 2"`.
+   */
+  condition: string;
+  /**
+   * Max tokens override when this rule matches.
+   */
+  maxTokens?: number | null;
+  /**
+   * Model to use when this rule matches.
+   */
+  model?: string | null;
+  /**
+   * Provider to use when this rule matches.
+   */
+  provider?: string | null;
+  /**
+   * Temperature override when this rule matches.
+   */
+  temperature?: number | null;
+}