@qontinui/shared-types 0.2.1

package/src/generated/McpToolCallResult.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`.
+ */
+
+/**
+ * Result of a single `tools/call` invocation.
+ *
+ * Shape is always the same regardless of success / failure: check `success`
+ * first, then read `content` (on success) or `error` (on failure).
+ */
+export interface McpToolCallResult {
+  /**
+   * Response content (present on success). Usually a JSON object/array,
+   * but can be a primitive if the tool returned text-only content.
+   */
+  content?: {
+    [k: string]: unknown;
+  };
+  /**
+   * Wall-clock duration of the call in milliseconds.
+   */
+  durationMs: number;
+  /**
+   * Error message (present on failure).
+   */
+  error?: string | null;
+  /**
+   * Response type tag: `"json"`, `"text"`, or `"error"`.
+   */
+  responseType: string;
+  /**
+   * Whether the call succeeded.
+   */
+  success: boolean;
+}

package/src/generated/McpToolInfo.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 { McpToolInputSchema } from './McpToolInputSchema';
+
+/**
+ * Single tool exposed by an MCP server, as returned by `tools/list`.
+ */
+export interface McpToolInfo {
+  /**
+   * Tool description shown to users.
+   */
+  description?: string | null;
+  inputSchema: McpToolInputSchema;
+  /**
+   * Tool name (the argument passed back on `tools/call`).
+   */
+  name: string;
+}

package/src/generated/McpToolInputSchema.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`.
+ */
+
+/**
+ * Input-parameter schema for an MCP tool.
+ *
+ * Subset of JSON Schema — enough to render a form and validate arguments
+ * before dispatching a `tools/call`. The `properties` and `required` fields
+ * are passed through verbatim from the server.
+ */
+export interface McpToolInputSchema {
+  /**
+   * Optional human-readable description.
+   */
+  description?: string | null;
+  /**
+   * JSON-Schema-shaped property descriptors, kept as opaque JSON.
+   */
+  properties?: {
+    [k: string]: unknown;
+  };
+  /**
+   * Names of required properties.
+   */
+  required?: string[] | null;
+  /**
+   * JSON Schema `type` (typically `"object"`).
+   */
+  type: string;
+}

package/src/generated/McpTransport.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`.
+ */
+
+/**
+ * Transport type for an MCP server connection.
+ *
+ * Serialized as lowercase to match the existing DB column values
+ * (`"stdio"` / `"http"`). Defaults to `Stdio` to preserve the pre-extraction
+ * default from the runner.
+ */
+export type McpTransport = "stdio" | "http";

package/src/generated/ModelCostBreakdown.d.ts

@@ -0,0 +1,36 @@
+/* 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`.
+ */
+
+/**
+ * Cost breakdown for a single LLM model.
+ */
+export interface ModelCostBreakdown {
+  /**
+   * Number of actions that used this model.
+   */
+  actionCount: number;
+  /**
+   * Total cost in USD for this model.
+   */
+  costUsd: number;
+  /**
+   * LLM model identifier.
+   */
+  model: string;
+  /**
+   * Provider name (e.g., `"anthropic"`, `"openai"`).
+   */
+  provider?: string | null;
+  /**
+   * Total input tokens for this model.
+   */
+  tokensInput: number;
+  /**
+   * Total output tokens for this model.
+   */
+  tokensOutput: number;
+}

package/src/generated/ModelOverrideConfig.d.ts

@@ -0,0 +1,47 @@
+/* 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 { RoutingRule } from './RoutingRule';
+
+/**
+ * Per-phase model override configuration.
+ *
+ * Each phase can independently specify a provider and/or model, along with
+ * optional temperature, max_tokens, fallback config, and conditional routing
+ * rules.
+ */
+export interface ModelOverrideConfig {
+  /**
+   * Fallback model if the primary fails with a retryable error.
+   */
+  fallbackModel?: string | null;
+  /**
+   * Fallback provider if the primary fails with a retryable error.
+   */
+  fallbackProvider?: string | null;
+  /**
+   * Max output tokens override for this phase.
+   */
+  maxTokens?: number | null;
+  /**
+   * Model override for this phase.
+   */
+  model?: string | null;
+  /**
+   * Provider override for this phase.
+   */
+  provider?: string | null;
+  /**
+   * Conditional routing rules evaluated at runtime. First matching rule
+   * wins; unmatched falls back to this config's static fields.
+   */
+  routingRules?: RoutingRule[] | null;
+  /**
+   * Temperature override for this phase (`0.0`–`1.0`).
+   */
+  temperature?: number | null;
+}

package/src/generated/Monitor.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 { MonitorPosition } from './MonitorPosition';
+
+/**
+ * Standardized monitor information — a physical display with its position
+ * in the virtual desktop and metadata for UI display.
+ */
+export interface Monitor {
+  /**
+   * Monitor height in pixels.
+   */
+  height: number;
+  /**
+   * OS-assigned monitor index (hardware enumeration order).
+   */
+  index: number;
+  /**
+   * Whether this is the primary/main monitor.
+   */
+  isPrimary: boolean;
+  /**
+   * Display name (e.g., "DELL U2720Q").
+   */
+  name?: string | null;
+  position: MonitorPosition;
+  /**
+   * DPI scale factor (1.0 = 100%, 1.5 = 150%, 2.0 = 200%).
+   */
+  scaleFactor: number;
+  /**
+   * Monitor width in pixels.
+   */
+  width: number;
+  /**
+   * X position in absolute screen coordinates (can be negative).
+   */
+  x: number;
+  /**
+   * Y position in absolute screen coordinates (can be negative).
+   */
+  y: number;
+}

package/src/generated/MonitorPosition.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`.
+ */
+
+/**
+ * Spatial position of a monitor in a left-to-right layout, derived from the
+ * X coordinate. Used for human-friendly display; use `index` for
+ * programmatic operations.
+ */
+export type MonitorPosition = "left" | "center" | "right";

package/src/generated/MouseButton.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`.
+ */
+
+/**
+ * Mouse button for click actions.
+ *
+ * Serialized as a bare lowercase string.
+ */
+export type MouseButton = "left" | "right" | "middle";

package/src/generated/MultiLoopConfig.d.ts

@@ -0,0 +1,32 @@
+/* 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 { BetweenIterations } from './BetweenIterations';
+import type { BuildPhaseConfig } from './BuildPhaseConfig';
+import type { DecomposerConfig } from './DecomposerConfig';
+import type { DiagnosePhaseConfig } from './DiagnosePhaseConfig';
+import type { ExitStrategy } from './ExitStrategy';
+import type { ImplementFixesConfig } from './ImplementFixesConfig';
+import type { MultiLoopEntry } from './MultiLoopEntry';
+import type { OrchestrationLoopConfig } from './OrchestrationLoopConfig';
+import type { PipelineConfig } from './PipelineConfig';
+import type { StallDetectorConfig } from './StallDetectorConfig';
+import type { SummarizationConfig } from './SummarizationConfig';
+
+/**
+ * Configuration for launching multiple loops at once.
+ */
+export interface MultiLoopConfig {
+  /**
+   * Individual loop configurations, each targeting a different runner.
+   */
+  loops: MultiLoopEntry[];
+  /**
+   * Stop all loops if any single loop errors out.
+   */
+  stopAllOnError: boolean;
+}

package/src/generated/MultiLoopEntry.d.ts

@@ -0,0 +1,32 @@
+/* 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 { BetweenIterations } from './BetweenIterations';
+import type { BuildPhaseConfig } from './BuildPhaseConfig';
+import type { DecomposerConfig } from './DecomposerConfig';
+import type { DiagnosePhaseConfig } from './DiagnosePhaseConfig';
+import type { ExitStrategy } from './ExitStrategy';
+import type { ImplementFixesConfig } from './ImplementFixesConfig';
+import type { OrchestrationLoopConfig } from './OrchestrationLoopConfig';
+import type { PipelineConfig } from './PipelineConfig';
+import type { StallDetectorConfig } from './StallDetectorConfig';
+import type { SummarizationConfig } from './SummarizationConfig';
+
+/**
+ * A single entry in a multi-loop configuration.
+ */
+export interface MultiLoopEntry {
+  config: OrchestrationLoopConfig;
+  /**
+   * Human label (e.g., `"Pages 1–10"` or an app section name).
+   */
+  label?: string | null;
+  /**
+   * Unique identifier for this loop instance.
+   */
+  loopId: string;
+}

package/src/generated/MultiLoopStatus.d.ts

@@ -0,0 +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`.
+ */
+
+import type { DiagnosticResult } from './DiagnosticResult';
+import type { ExitCheckResult } from './ExitCheckResult';
+import type { IterationResult } from './IterationResult';
+import type { LoopInstanceStatus } from './LoopInstanceStatus';
+import type { LoopPhase } from './LoopPhase';
+import type { OrchestrationLoopStatus } from './OrchestrationLoopStatus';
+import type { RootCauseCategory } from './RootCauseCategory';
+
+/**
+ * Aggregated status across all active loops.
+ */
+export interface MultiLoopStatus {
+  /**
+   * Whether every loop has reached a terminal phase.
+   */
+  allComplete: boolean;
+  /**
+   * Whether any loop is in the `Error` phase.
+   */
+  anyError: boolean;
+  /**
+   * Per-loop status snapshots.
+   */
+  loops: LoopInstanceStatus[];
+  /**
+   * Whether the multi-loop manager is configured to abort all loops on the
+   * first error.
+   */
+  stopAllOnError: boolean;
+}

package/src/generated/NativeAccessibilityStep.d.ts

@@ -0,0 +1,121 @@
+/* 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 { A11yAction } from './A11yAction';
+import type { RetrySpec } from './RetrySpec';
+import type { VerificationCategoryKind } from './VerificationCategoryKind';
+
+/**
+ * Interact with native UI elements via the accessibility layer (UIA/AT-SPI/AX).
+ *
+ * Wire tag: `"native_accessibility"`.
+ */
+export interface NativeAccessibilityStep {
+  /**
+   * Action to perform.
+   */
+  action?: A11yAction & string;
+  /**
+   * Whether to clear existing text before typing.
+   */
+  clearFirst?: boolean | null;
+  /**
+   * 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;
+  /**
+   * Include hidden elements in `capture`.
+   */
+  includeHidden?: boolean | null;
+  /**
+   * Named input bindings evaluated at step entry.
+   */
+  inputs?: {
+    [k: string]: string;
+  };
+  /**
+   * Only include interactive elements (for `query` and `ai_context`).
+   */
+  interactiveOnly?: boolean | null;
+  /**
+   * Maximum tree depth for `capture`.
+   */
+  maxDepth?: number | null;
+  /**
+   * Maximum elements for `ai_context` action (default: 50).
+   */
+  maxElements?: number | null;
+  /**
+   * Display name for the step.
+   */
+  name: string;
+  /**
+   * Label filter for `query` action.
+   */
+  queryLabel?: string | null;
+  /**
+   * Role filter for `query` action (e.g. `"button"`, `"textbox"`).
+   */
+  queryRole?: string | null;
+  /**
+   * Element ref ID for click/type/focus (e.g. `"@e3"`).
+   */
+  refId?: 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;
+  };
+  /**
+   * Connection target: `"Desktop"`, window title, or `"pid:1234"`.
+   */
+  target?: string | null;
+  /**
+   * Text to type (for `type` action).
+   */
+  text?: string | null;
+  /**
+   * Timeout in seconds.
+   */
+  timeoutSeconds?: number | null;
+  /**
+   * Verification depth category.
+   */
+  verificationCategory?: VerificationCategoryKind | null;
+  [k: string]: unknown;
+}

package/src/generated/NavigationResult.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 navigating to one or more target states.
+ *
+ * Navigation uses multistate pathfinding to determine the optimal path.
+ * Nested `results` allow a single top-level navigation to fan out to several
+ * targets and report per-target outcomes.
+ */
+export interface NavigationResult {
+  /**
+   * States active after the navigation completed.
+   */
+  active_states: string[];
+  /**
+   * Error message when navigation failed.
+   */
+  error?: string | null;
+  /**
+   * Ordered list of state IDs visited.
+   */
+  path: string[];
+  /**
+   * Per-target sub-results for fan-out navigation.
+   */
+  results?: NavigationResult[] | null;
+  /**
+   * Whether the overall navigation succeeded.
+   */
+  success: boolean;
+  /**
+   * Target state for this navigation branch (if applicable).
+   */
+  target_state?: string | null;
+}

package/src/generated/NewConstraintProposal.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`.
+ */
+
+import type { Constraint } from './Constraint';
+import type { ConstraintCheck } from './ConstraintCheck';
+import type { ConstraintSeverity } from './ConstraintSeverity';
+
+/**
+ * A new constraint proposed by the AI during an agentic phase.
+ *
+ * Serialized with `"type": "new_constraint"` via the `ConstraintProposal`
+ * enum's internal tag.
+ */
+export interface NewConstraintProposal {
+  constraint: Constraint;
+}

package/src/generated/NextTaskInfo.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`.
+ */
+
+/**
+ * Minimal description of the next task due to run.
+ */
+export interface NextTaskInfo {
+  /**
+   * Task ID.
+   */
+  id: string;
+  /**
+   * Task display name.
+   */
+  name: string;
+  /**
+   * ISO 8601 timestamp of the next scheduled run.
+   */
+  nextRun: string;
+}

package/src/generated/NodeMetadata.d.ts

@@ -0,0 +1,47 @@
+/* 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 { MatchLocation } from './MatchLocation';
+import type { Outcome } from './Outcome';
+import type { RuntimeData } from './RuntimeData';
+import type { StateContext } from './StateContext';
+import type { TimingInfo } from './TimingInfo';
+import type { TopMatch } from './TopMatch';
+
+/**
+ * Metadata for a tree node — action configuration, runtime data, state
+ * context, and timing. All fields are optional because different node
+ * types populate different fields.
+ */
+export interface NodeMetadata {
+  /**
+   * Action configuration (JSON object — shape varies by `ActionType`).
+   */
+  config?: {
+    [k: string]: unknown;
+  } | null;
+  /**
+   * Whether this action can have child nodes.
+   */
+  isExpandable: boolean;
+  /**
+   * Whether this action is displayed inline.
+   */
+  isInline: boolean;
+  outcome?: Outcome | null;
+  runtime?: RuntimeData | null;
+  /**
+   * Screenshot reference (path or URL).
+   */
+  screenshotReference?: string | null;
+  stateContext?: StateContext | null;
+  timing?: TimingInfo | null;
+  /**
+   * Visual-debug image reference (path or URL).
+   */
+  visualDebugReference?: string | null;
+}

package/src/generated/NodeStatus.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`.
+ */
+
+/**
+ * Execution status of a tree node.
+ */
+export type NodeStatus = "pending" | "running" | "success" | "failed";

package/src/generated/NodeType.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`.
+ */
+
+/**
+ * Types of nodes in the execution tree.
+ */
+export type NodeType = "workflow" | "action" | "transition";

package/src/generated/OcrEngine.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`.
+ */
+
+/**
+ * OCR engine for text search.
+ */
+export type OcrEngine = "TESSERACT" | "EASYOCR" | "PADDLEOCR" | "NATIVE";