@qontinui/shared-types 0.8.0 → 0.11.0

package/dist/workflow.d.ts

@@ -352,7 +352,8 @@ interface RetrySpec {
 /**
  * Test-runner kinds surfaced by `CommandStep` when `mode = "test"`.
  */
-type TestType = "playwright" | "qontinui_vision" | "python" | "repository" | "custom_command";
+type TestType =
+  "playwright" | "qontinui_vision" | "python" | "repository" | "custom_command";
 
 /* eslint-disable */
 /**
@@ -564,7 +565,8 @@ interface CommandStep {
  *
  * Prompt steps are the only variant that may appear in the agentic phase.
  */
-type PromptStepPhase = "setup" | "verification" | "agentic" | "completion";
+type PromptStepPhase =
+  "setup" | "verification" | "agentic" | "completion";
 
 /* eslint-disable */
 /**
@@ -686,7 +688,8 @@ type UiBridgeAction =
 /**
  * Kinds of assertion supported by `assert` actions.
  */
-type UiBridgeAssertType = "exists" | "text_equals" | "contains" | "visible" | "enabled";
+type UiBridgeAssertType =
+  "exists" | "text_equals" | "contains" | "visible" | "enabled";
 
 /* eslint-disable */
 /**
@@ -1141,7 +1144,8 @@ interface WorkflowStage {
  * verification approaches. Mirrors the runner-side enum in
  * `crate::agentic_verification`.
  */
-type WorkflowArchitecture = "traditional" | "agentic_verification" | "multi_agent_pipeline";
+type WorkflowArchitecture =
+  "traditional" | "agentic_verification" | "multi_agent_pipeline";
 
 /* eslint-disable */
 /**
@@ -1622,7 +1626,11 @@ type HttpMethod = "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
 /**
  * Content-Type values for an API request body.
  */
-type ApiContentType = "application/json" | "application/x-www-form-urlencoded" | "text/plain" | "none";
+type ApiContentType =
+  | "application/json"
+  | "application/x-www-form-urlencoded"
+  | "text/plain"
+  | "none";
 
 /* eslint-disable */
 /**
@@ -1634,7 +1642,8 @@ type ApiContentType = "application/json" | "application/x-www-form-urlencoded" |
 /**
  * Comparison operators supported by API assertions.
  */
-type ApiAssertionOperator = "equals" | "contains" | "matches" | "greater_than" | "less_than";
+type ApiAssertionOperator =
+  "equals" | "contains" | "matches" | "greater_than" | "less_than";
 
 /* eslint-disable */
 /**
@@ -1646,7 +1655,8 @@ type ApiAssertionOperator = "equals" | "contains" | "matches" | "greater_than" |
 /**
  * Assertion kinds supported on API responses.
  */
-type ApiAssertionType = "status_code" | "json_path" | "header" | "body_contains" | "response_time";
+type ApiAssertionType =
+  "status_code" | "json_path" | "header" | "body_contains" | "response_time";
 
 /* eslint-disable */
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qontinui/shared-types",
-  "version": "0.8.0",
+  "version": "0.11.0",
   "description": "Shared TypeScript types for the Qontinui ecosystem",
   "type": "module",
   "main": "./dist/index.js",

package/src/generated/A11yAction.d.ts

@@ -8,4 +8,5 @@
 /**
  * Accessibility action kinds.
  */
-export type A11yAction = "capture" | "click" | "type" | "focus" | "query" | "ai_context";
+export type A11yAction =
+  "capture" | "click" | "type" | "focus" | "query" | "ai_context";

package/src/generated/AccessibilityBackend.d.ts

@@ -9,4 +9,5 @@
  * Accessibility capture backend. Each variant corresponds to a platform
  * accessibility API implementation.
  */
-export type AccessibilityBackend = "auto" | "cdp" | "uia" | "atspi" | "ax" | "none";
+export type AccessibilityBackend =
+  "auto" | "cdp" | "uia" | "atspi" | "ax" | "none";

package/src/generated/AccessibilityNode.d.ts

@@ -5,9 +5,9 @@
  * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
  */
 
-import type { AccessibilityBounds } from './AccessibilityBounds';
-import type { AccessibilityRole } from './AccessibilityRole';
-import type { AccessibilityState } from './AccessibilityState';
+import type { AccessibilityBounds } from "./AccessibilityBounds";
+import type { AccessibilityRole } from "./AccessibilityRole";
+import type { AccessibilityState } from "./AccessibilityState";
 
 /**
  * A node in the accessibility tree.

package/src/generated/AccessibilitySelector.d.ts

@@ -5,9 +5,9 @@
  * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
  */
 
-import type { AccessibilityRole } from './AccessibilityRole';
-import type { AccessibilityState } from './AccessibilityState';
-import type { RoleCriterion } from './RoleCriterion';
+import type { AccessibilityRole } from "./AccessibilityRole";
+import type { AccessibilityState } from "./AccessibilityState";
+import type { RoleCriterion } from "./RoleCriterion";
 
 /**
  * Selector for finding nodes in an accessibility tree.

package/src/generated/AccessibilitySnapshot.d.ts

@@ -5,11 +5,11 @@
  * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
  */
 
-import type { AccessibilityBackend } from './AccessibilityBackend';
-import type { AccessibilityBounds } from './AccessibilityBounds';
-import type { AccessibilityNode } from './AccessibilityNode';
-import type { AccessibilityRole } from './AccessibilityRole';
-import type { AccessibilityState } from './AccessibilityState';
+import type { AccessibilityBackend } from "./AccessibilityBackend";
+import type { AccessibilityBounds } from "./AccessibilityBounds";
+import type { AccessibilityNode } from "./AccessibilityNode";
+import type { AccessibilityRole } from "./AccessibilityRole";
+import type { AccessibilityState } from "./AccessibilityState";
 
 /**
  * Complete accessibility-tree snapshot.

package/src/generated/ActionExecutionBatch.d.ts

@@ -5,12 +5,12 @@
  * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
  */
 
-import type { ActionExecutionCreate } from './ActionExecutionCreate';
-import type { ActionStatus } from './ActionStatus';
-import type { ErrorType } from './ErrorType';
-import type { ExecutionActionType } from './ExecutionActionType';
-import type { ExecutionMatchLocation } from './ExecutionMatchLocation';
-import type { LLMMetrics } from './LLMMetrics';
+import type { ActionExecutionCreate } from "./ActionExecutionCreate";
+import type { ActionStatus } from "./ActionStatus";
+import type { ErrorType } from "./ErrorType";
+import type { ExecutionActionType } from "./ExecutionActionType";
+import type { ExecutionMatchLocation } from "./ExecutionMatchLocation";
+import type { LLMMetrics } from "./LLMMetrics";
 
 /**
  * Batch wrapper for reporting multiple action executions in one request.

package/src/generated/ActionExecutionCreate.d.ts

@@ -5,11 +5,11 @@
  * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
  */
 
-import type { ActionStatus } from './ActionStatus';
-import type { ErrorType } from './ErrorType';
-import type { ExecutionActionType } from './ExecutionActionType';
-import type { ExecutionMatchLocation } from './ExecutionMatchLocation';
-import type { LLMMetrics } from './LLMMetrics';
+import type { ActionStatus } from "./ActionStatus";
+import type { ErrorType } from "./ErrorType";
+import type { ExecutionActionType } from "./ExecutionActionType";
+import type { ExecutionMatchLocation } from "./ExecutionMatchLocation";
+import type { LLMMetrics } from "./LLMMetrics";
 
 /**
  * Request payload for reporting a single action execution.

package/src/generated/ActionExecutionListResponse.d.ts

@@ -5,8 +5,8 @@
  * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
  */
 
-import type { ActionExecutionResponse } from './ActionExecutionResponse';
-import type { Pagination } from './Pagination';
+import type { ActionExecutionResponse } from "./ActionExecutionResponse";
+import type { Pagination } from "./Pagination";
 
 /**
  * Paginated list of action executions.

package/src/generated/ActionReliabilityStats.d.ts

@@ -5,7 +5,7 @@
  * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
  */
 
-import type { ExecutionActionType } from './ExecutionActionType';
+import type { ExecutionActionType } from "./ExecutionActionType";
 
 /**
  * Reliability statistics aggregated for a single action type.

package/src/generated/ActionResponse.d.ts

@@ -5,8 +5,8 @@
  * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
  */
 
-import type { ElementRect } from './ElementRect';
-import type { ElementState } from './ElementState';
+import type { ElementRect } from "./ElementRect";
+import type { ElementState } from "./ElementState";
 
 /**
  * Response from executing an action on an element or component.

package/src/generated/ActionStatus.d.ts

@@ -8,4 +8,5 @@
 /**
  * Outcome of a single action within a run.
  */
-export type ActionStatus = "success" | "failed" | "timeout" | "skipped" | "error" | "pending";
+export type ActionStatus =
+  "success" | "failed" | "timeout" | "skipped" | "error" | "pending";

package/src/generated/AgenticPhaseOutput.d.ts

@@ -5,10 +5,10 @@
  * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
  */
 
-import type { AgenticStatus } from './AgenticStatus';
-import type { FileChange } from './FileChange';
-import type { FindingOutput } from './FindingOutput';
-import type { ReflectionFixOutput } from './ReflectionFixOutput';
+import type { AgenticStatus } from "./AgenticStatus";
+import type { FileChange } from "./FileChange";
+import type { FindingOutput } from "./FindingOutput";
+import type { ReflectionFixOutput } from "./ReflectionFixOutput";
 
 /**
  * Canonical structured output from the agentic phase.

package/src/generated/AgenticStatus.d.ts

@@ -8,4 +8,5 @@
 /**
  * Status of the agentic phase execution.
  */
-export type AgenticStatus = "success" | "partial_success" | "failed" | "unfixable";
+export type AgenticStatus =
+  "success" | "partial_success" | "failed" | "unfixable";

package/src/generated/AiWorkflow.d.ts

@@ -5,7 +5,7 @@
  * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
  */
 
-import type { ExecutionStep } from './ExecutionStep';
+import type { ExecutionStep } from "./ExecutionStep";
 
 /**
  * A saved AI Builder workflow template.

package/src/generated/ApiAssertion.d.ts

@@ -5,8 +5,8 @@
  * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
  */
 
-import type { ApiAssertionOperator } from './ApiAssertionOperator';
-import type { ApiAssertionType } from './ApiAssertionType';
+import type { ApiAssertionOperator } from "./ApiAssertionOperator";
+import type { ApiAssertionType } from "./ApiAssertionType";
 
 /**
  * A single assertion evaluated against an API response.

package/src/generated/ApiAssertionOperator.d.ts

@@ -8,4 +8,5 @@
 /**
  * Comparison operators supported by API assertions.
  */
-export type ApiAssertionOperator = "equals" | "contains" | "matches" | "greater_than" | "less_than";
+export type ApiAssertionOperator =
+  "equals" | "contains" | "matches" | "greater_than" | "less_than";

package/src/generated/ApiAssertionType.d.ts

@@ -8,4 +8,5 @@
 /**
  * Assertion kinds supported on API responses.
  */
-export type ApiAssertionType = "status_code" | "json_path" | "header" | "body_contains" | "response_time";
+export type ApiAssertionType =
+  "status_code" | "json_path" | "header" | "body_contains" | "response_time";

package/src/generated/ApiContentType.d.ts

@@ -8,4 +8,8 @@
 /**
  * Content-Type values for an API request body.
  */
-export type ApiContentType = "application/json" | "application/x-www-form-urlencoded" | "text/plain" | "none";
+export type ApiContentType =
+  | "application/json"
+  | "application/x-www-form-urlencoded"
+  | "text/plain"
+  | "none";

package/src/generated/App.d.ts

@@ -7,10 +7,44 @@
 
 export interface App {
   appId: string;
+  /**
+   * Whether this app requires authentication before spec checks.
+   * If true, workflows will auto-inject an auth setup step.
+   */
+  authRequired: boolean;
+  /**
+   * Build command to run after pulling updated source (P3 auto-fresh).
+   * Ignored if `update_strategy` is "pull_only". Optional; if None,
+   * the auto-fresh engine skips build and goes straight to start_command.
+   */
+  buildCommand?: string | null;
   createdAtMs: number;
   displayName: string;
   lastSeenAtMs: number;
+  /**
+   * Red threshold for spec match rates (0.0–1.0). Match rates below this are Red (fail).
+   * Must be less than `yellow_threshold`. Defaults to 0.5.
+   */
+  redThreshold: number;
   repoRoot: string;
+  /**
+   * Start command to run after a successful build (P3 auto-fresh).
+   * Restarts the deployed instance and updates app_deploy_state.
+   * Ignored if `update_strategy` is "pull_only". Optional.
+   */
+  startCommand?: string | null;
   uiBridgeUrl: string;
+  /**
+   * Auto-fresh update strategy: "pull_only" (pull code, no restart) or
+   * "pull_build" (pull, run build_command, run start_command). Used by the
+   * runner's P3 auto-fresh engine to decide what actions to take when
+   * pulling updated source code. Defaults to "pull_only".
+   */
+  updateStrategy: string;
+  /**
+   * Yellow threshold for spec match rates (0.0–1.0). Match rates >= this are Green (pass),
+   * below are Yellow (warn). Must be greater than `red_threshold`. Defaults to 0.8.
+   */
+  yellowThreshold: number;
   [k: string]: unknown;
 }

package/src/generated/AppError.d.ts

@@ -30,4 +30,9 @@ export type AppError =
       appId: string;
       reason: "already-registered";
       [k: string]: unknown;
+    }
+  | {
+      reason: "invalid-update-strategy";
+      updateStrategy: string;
+      [k: string]: unknown;
     };

package/src/generated/AppEvent.d.ts

@@ -5,8 +5,8 @@
  * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
  */
 
-import type { CanvasPanel } from './CanvasPanel';
-import type { FlowEvent } from './FlowEvent';
+import type { CanvasPanel } from "./CanvasPanel";
+import type { FlowEvent } from "./FlowEvent";
 
 /**
  * Unified application events for frontend communication.

package/src/generated/AppListResponse.d.ts

@@ -5,7 +5,7 @@
  * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
  */
 
-import type { App } from './App';
+import type { App } from "./App";
 
 export interface AppListResponse {
   apps: App[];

package/src/generated/AssertionMiss.d.ts

@@ -5,9 +5,9 @@
  * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
  */
 
-import type { CandidateMiss } from './CandidateMiss';
-import type { FieldDiff } from './FieldDiff';
-import type { MissReason } from './MissReason';
+import type { CandidateMiss } from "./CandidateMiss";
+import type { FieldDiff } from "./FieldDiff";
+import type { MissReason } from "./MissReason";
 
 /**
  * Top-level miss diagnostic for a failed assertion.

package/src/generated/AssertionOutcome.d.ts

@@ -5,11 +5,11 @@
  * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
  */
 
-import type { AssertionMiss } from './AssertionMiss';
-import type { CandidateMiss } from './CandidateMiss';
-import type { FieldDiff } from './FieldDiff';
-import type { MatchedElement } from './MatchedElement';
-import type { MissReason } from './MissReason';
+import type { AssertionMiss } from "./AssertionMiss";
+import type { CandidateMiss } from "./CandidateMiss";
+import type { FieldDiff } from "./FieldDiff";
+import type { MatchedElement } from "./MatchedElement";
+import type { MissReason } from "./MissReason";
 
 /**
  * Internally-tagged on `status` — `{ "status": "pass", "matched": {...} }`

package/src/generated/AssertionResult.d.ts

@@ -5,12 +5,12 @@
  * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
  */
 
-import type { AssertionMiss } from './AssertionMiss';
-import type { AssertionOutcome } from './AssertionOutcome';
-import type { CandidateMiss } from './CandidateMiss';
-import type { FieldDiff } from './FieldDiff';
-import type { MatchedElement } from './MatchedElement';
-import type { MissReason } from './MissReason';
+import type { AssertionMiss } from "./AssertionMiss";
+import type { AssertionOutcome } from "./AssertionOutcome";
+import type { CandidateMiss } from "./CandidateMiss";
+import type { FieldDiff } from "./FieldDiff";
+import type { MatchedElement } from "./MatchedElement";
+import type { MissReason } from "./MissReason";
 
 /**
  * Per-assertion evaluation result wrapper.

package/src/generated/AuthModel.d.ts

@@ -5,8 +5,8 @@
  * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
  */
 
-import type { AuthRole } from './AuthRole';
-import type { SpecProvenance } from './SpecProvenance';
+import type { AuthRole } from "./AuthRole";
+import type { SpecProvenance } from "./SpecProvenance";
 
 /**
  * The auth / permission model inferred from login flows + gated routes.

package/src/generated/AuthRole.d.ts

@@ -5,7 +5,7 @@
  * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
  */
 
-import type { SpecProvenance } from './SpecProvenance';
+import type { SpecProvenance } from "./SpecProvenance";
 
 /**
  * A role surfaced by the auth model (e.g. inferred from nav items only some

package/src/generated/AvailableTransitionsResult.d.ts

@@ -5,7 +5,7 @@
  * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
  */
 
-import type { TransitionInfo } from './TransitionInfo';
+import type { TransitionInfo } from "./TransitionInfo";
 
 /**
  * Result of querying available transitions from the current state.

package/src/generated/BackendProfile.d.ts

@@ -5,7 +5,7 @@
  * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
  */
 
-import type { ApiStyle } from './ApiStyle';
+import type { ApiStyle } from "./ApiStyle";
 
 /**
  * Target backend stack.

package/src/generated/BaseStepFields.d.ts

@@ -5,8 +5,8 @@
  * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
  */
 
-import type { RetrySpec } from './RetrySpec';
-import type { VerificationCategoryKind } from './VerificationCategoryKind';
+import type { RetrySpec } from "./RetrySpec";
+import type { VerificationCategoryKind } from "./VerificationCategoryKind";
 
 /**
  * Shared fields common to every canonical step variant.

package/src/generated/BatchComputeEmbeddingResponse.d.ts

@@ -5,7 +5,7 @@
  * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
  */
 
-import type { BatchEmbeddingResult } from './BatchEmbeddingResult';
+import type { BatchEmbeddingResult } from "./BatchEmbeddingResult";
 
 /**
  * Response with batch-computed embeddings.

package/src/generated/CandidateMiss.d.ts

@@ -5,7 +5,7 @@
  * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
  */
 
-import type { FieldDiff } from './FieldDiff';
+import type { FieldDiff } from "./FieldDiff";
 
 /**
  * A near-match candidate — an element that scored above the cut-off but

package/src/generated/CanonicalStep.d.ts

@@ -5,24 +5,24 @@
  * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
  */
 
-import type { CheckType } from './CheckType';
-import type { CommandMode } from './CommandMode';
-import type { CommandStep } from './CommandStep';
-import type { CommandStepPhase } from './CommandStepPhase';
-import type { PlaywrightExecutionMode } from './PlaywrightExecutionMode';
-import type { PromptStep } from './PromptStep';
-import type { PromptStepPhase } from './PromptStepPhase';
-import type { RetrySpec } from './RetrySpec';
-import type { TestType } from './TestType';
-import type { UiBridgeAction } from './UiBridgeAction';
-import type { UiBridgeAssertType } from './UiBridgeAssertType';
-import type { UiBridgeComparisonMode } from './UiBridgeComparisonMode';
-import type { UiBridgeSeverity } from './UiBridgeSeverity';
-import type { UiBridgeStep } from './UiBridgeStep';
-import type { UiBridgeStepPhase } from './UiBridgeStepPhase';
-import type { VerificationCategoryKind } from './VerificationCategoryKind';
-import type { WorkflowStep } from './WorkflowStep';
-import type { WorkflowStepPhase } from './WorkflowStepPhase';
+import type { CheckType } from "./CheckType";
+import type { CommandMode } from "./CommandMode";
+import type { CommandStep } from "./CommandStep";
+import type { CommandStepPhase } from "./CommandStepPhase";
+import type { PlaywrightExecutionMode } from "./PlaywrightExecutionMode";
+import type { PromptStep } from "./PromptStep";
+import type { PromptStepPhase } from "./PromptStepPhase";
+import type { RetrySpec } from "./RetrySpec";
+import type { TestType } from "./TestType";
+import type { UiBridgeAction } from "./UiBridgeAction";
+import type { UiBridgeAssertType } from "./UiBridgeAssertType";
+import type { UiBridgeComparisonMode } from "./UiBridgeComparisonMode";
+import type { UiBridgeSeverity } from "./UiBridgeSeverity";
+import type { UiBridgeStep } from "./UiBridgeStep";
+import type { UiBridgeStepPhase } from "./UiBridgeStepPhase";
+import type { VerificationCategoryKind } from "./VerificationCategoryKind";
+import type { WorkflowStep } from "./WorkflowStep";
+import type { WorkflowStepPhase } from "./WorkflowStepPhase";
 
 /**
  * Discriminated union over the four canonical step variants.

package/src/generated/CodeExecutionStep.d.ts

@@ -5,8 +5,8 @@
  * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
  */
 
-import type { RetrySpec } from './RetrySpec';
-import type { VerificationCategoryKind } from './VerificationCategoryKind';
+import type { RetrySpec } from "./RetrySpec";
+import type { VerificationCategoryKind } from "./VerificationCategoryKind";
 
 /**
  * Execute inline Python code or a Python file in an optional sandbox.

package/src/generated/CommandStep.d.ts

@@ -5,13 +5,13 @@
  * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
  */
 
-import type { CheckType } from './CheckType';
-import type { CommandMode } from './CommandMode';
-import type { CommandStepPhase } from './CommandStepPhase';
-import type { PlaywrightExecutionMode } from './PlaywrightExecutionMode';
-import type { RetrySpec } from './RetrySpec';
-import type { TestType } from './TestType';
-import type { VerificationCategoryKind } from './VerificationCategoryKind';
+import type { CheckType } from "./CheckType";
+import type { CommandMode } from "./CommandMode";
+import type { CommandStepPhase } from "./CommandStepPhase";
+import type { PlaywrightExecutionMode } from "./PlaywrightExecutionMode";
+import type { RetrySpec } from "./RetrySpec";
+import type { TestType } from "./TestType";
+import type { VerificationCategoryKind } from "./VerificationCategoryKind";
 
 /**
  * Shell commands, checks, check groups, and tests.