@qontinui/shared-types 0.12.0 → 0.12.1

package/src/generated/PolicyConjunct.d.ts

@@ -17,6 +17,13 @@ export interface PolicyConjunct {
    * Human-readable name used in `ConjunctEvaluation.name`.
    */
   name: string;
+  /**
+   * The conjunct rule.
+   */
   rule: ConjunctRule;
+  /**
+   * Filter narrowing which assertions / states this conjunct applies
+   * to.
+   */
   scope: AssertionScope;
 }

package/src/generated/PolicyEvaluation.d.ts

@@ -18,5 +18,9 @@ export interface PolicyEvaluation {
    * order.
    */
   conjunctResults: ConjunctEvaluation[];
-  overallStatus: PolicyStatus1;
+  /**
+   * Aggregate of all conjunct statuses — fails if any conjunct fails;
+   * indeterminate if any conjunct is indeterminate and none failed.
+   */
+  overallStatus: PolicyStatus;
 }

package/src/generated/ProcessStatusLite.d.ts

@@ -34,5 +34,8 @@ export interface ProcessStatusLite {
    * process declares no health port.
    */
   portHealthy?: boolean | null;
+  /**
+   * Lifecycle state as reported by the process manager.
+   */
   state: ProcessState;
 }

package/src/generated/Profile.d.ts

@@ -14,7 +14,13 @@ import type { EnforcementProfile } from "./EnforcementProfile";
  * The top-level Priorities Profile.
  */
 export interface Profile {
+  /**
+   * Architectural shape + testing bar.
+   */
   architecture: ArchitectureProfile;
+  /**
+   * Target backend stack.
+   */
   backend: BackendProfile;
   /**
    * Naming / mapping conventions, as free-form `key -> value` pairs (e.g.

package/src/generated/ProjectSnapshot.d.ts

@@ -44,6 +44,9 @@ export interface ProjectSnapshot {
    * Managed processes whose `cwd` is under the project root.
    */
   processes: ProcessStatusLite[];
+  /**
+   * The registry entry this snapshot describes.
+   */
   project: SavedProject;
   /**
    * Questions waiting on the user, from `deferred_questions`.

package/src/generated/PromptStep.d.ts

@@ -57,6 +57,9 @@ export interface PromptStep {
    * Display name for the step.
    */
   name: string;
+  /**
+   * Phase in which the step appears.
+   */
   phase: PromptStepPhase;
   /**
    * Saved prompt ID (when the body is a reference).

package/src/generated/RecommendedState.d.ts

@@ -11,6 +11,9 @@ import type { SpecCheckConfidence } from "./SpecCheckConfidence";
  * The single state the matcher recommends the caller treat as "current".
  */
 export interface RecommendedState {
+  /**
+   * Matcher confidence in the recommendation.
+   */
   confidence: SpecCheckConfidence;
   /**
    * Free-form explanation (e.g. "highest match rate among all states").

package/src/generated/ResolvedInitialStates.d.ts

@@ -13,6 +13,9 @@ import type { InitialStatesSource } from "./InitialStatesSource";
  * resolution came from.
  */
 export interface ResolvedInitialStates {
+  /**
+   * Where the resolution came from.
+   */
   source: InitialStatesSource;
   /**
    * Resolved initial state IDs.

package/src/generated/ResolvedInitialStatesResult.d.ts

@@ -20,6 +20,9 @@ export interface ResolvedInitialStatesResult {
    * Error message when resolution failed.
    */
   error?: string | null;
+  /**
+   * Where the resolution came from.
+   */
   source: InitialStatesSource;
   /**
    * Resolved initial state IDs.

package/src/generated/Runner.d.ts

@@ -28,6 +28,10 @@ export interface Runner {
    * ISO 8601 timestamp when the runner was first registered.
    */
   createdAt: string;
+  /**
+   * Computed health state derived from `ws_connected` and
+   * `last_heartbeat`. Authoritative for UI display.
+   */
   derivedStatus: RunnerStatus;
   /**
    * Reported hostname of the machine the runner is running on.

package/src/generated/ScheduledTask.d.ts

@@ -91,6 +91,9 @@ export interface ScheduledTask {
    * Next scheduled run time (ISO 8601), computed by the runner.
    */
   nextRun?: string | null;
+  /**
+   * Schedule configuration.
+   */
   schedule: ScheduleExpression;
   /**
    * Skip future runs once the task has succeeded at least once.
@@ -100,5 +103,8 @@ export interface ScheduledTask {
    * Free-form description of success criteria, for human reference.
    */
   successCriteria?: string | null;
+  /**
+   * Task type and its per-type configuration.
+   */
   task: ScheduledTaskType;
 }

package/src/generated/ScreenshotAnnotation.d.ts

@@ -23,6 +23,9 @@ export interface ScreenshotAnnotation {
    * Free-form label for the annotation.
    */
   label?: string | null;
+  /**
+   * Shape of the annotation.
+   */
   type: ScreenshotAnnotationShape;
   /**
    * Annotation width in pixels.

package/src/generated/SessionLite.d.ts

@@ -31,6 +31,9 @@ export interface SessionLite {
    * Session name — `task_runs.task_name` or the terminal's title.
    */
   name?: string | null;
+  /**
+   * Where this row came from.
+   */
   source: SessionSource;
   /**
    * `task_runs.status` ("running", "completed", …) for AI sessions;

package/src/generated/SpecApiEvent.d.ts

@@ -88,3 +88,29 @@ export type SpecApiEvent =
       type: "flywheel-proposal-demoted";
       [k: string]: unknown;
     };
+
+/**
+ * Existing `POST /spec/author` change-broadcast payload. Pre-dates the
+ * Plan 06 `SpecApiEvent` sum-type but keeps the same shape so external
+ * SSE subscribers (the runner's `use-discovered-specs.ts`) keep working.
+ */
+export interface SpecChanged {
+  /**
+   * Owning app id (multi-tenant Spec API). Subscribers filter on this
+   * to receive only their app's events. `#[serde(default)]` allows
+   * legacy emitters (pre-multi-app) to omit the field; downstream
+   * per-app routing treats empty as `qontinui-runner` for back-compat.
+   */
+  appId: string;
+  /**
+   * Epoch milliseconds the event was emitted at.
+   */
+  atMs: number;
+  /**
+   * "ir-and-projection" today; future kinds may include
+   * "projection-only" if a regen runs without an IR write.
+   */
+  kind: string;
+  pageId: string;
+  [k: string]: unknown;
+}

package/src/generated/SpecCheckResult.d.ts

@@ -29,6 +29,9 @@ import type { StateMatchResult } from "./StateMatchResult";
  * deserialize as `0`.
  */
 export interface SpecCheckResult {
+  /**
+   * App / route / bridge-version fingerprint at snapshot time. §5.8 G3.
+   */
   bridgeFingerprint: BridgeFingerprint;
   /**
    * Red/Yellow/Green classification of the overall match rate.
@@ -77,6 +80,9 @@ export interface SpecCheckResult {
    * One result per `IrState` in the spec.
    */
   stateResults: StateMatchResult[];
+  /**
+   * Aggregate summary across all evaluated states.
+   */
   summary: SpecCheckSummary;
   thresholdsUsed: ThresholdConfig;
   /**
@@ -84,3 +90,19 @@ export interface SpecCheckResult {
    */
   warnings?: string[];
 }
+/**
+ * The threshold configuration that was active at evaluation time.
+ * Immutable snapshot for audit purposes — allows historical results
+ * to be cross-checked against their contemporaneous thresholds.
+ */
+export interface ThresholdConfig {
+  /**
+   * Red threshold (0.0–1.0). Match rate < this → Red.
+   */
+  redThreshold: number;
+  /**
+   * Yellow threshold (0.0–1.0). Match rate >= this → Green.
+   * Must be > `red_threshold`.
+   */
+  yellowThreshold: number;
+}

package/src/generated/SpecCheckStepConfig.d.ts

@@ -34,5 +34,8 @@ export interface SpecCheckStepConfig {
    * Page to evaluate.
    */
   pageId: string;
+  /**
+   * Policy that determines pass / fail.
+   */
   policy: SpecCheckPolicy;
 }

package/src/generated/SpecCheckSummary.d.ts

@@ -14,6 +14,9 @@ import type { SpecCheckConfidence } from "./SpecCheckConfidence";
  * Aggregate summary across all evaluated states.
  */
 export interface SpecCheckSummary {
+  /**
+   * Top-level pass / partial / no-match verdict.
+   */
   matchOutcome: MatchOutcome;
   /**
    * Mean of per-state match rates, weighted equally.
@@ -33,5 +36,8 @@ export interface SpecCheckSummary {
    * as "current". `None` when the matcher has no preference.
    */
   recommendedState?: RecommendedState | null;
+  /**
+   * Counts of assertion failures bucketed by severity.
+   */
   severityCounts: AssertionSeverityCounts;
 }

package/src/generated/StateDiscoveryResult.d.ts

@@ -76,6 +76,9 @@ export interface StateDiscoveryResult {
    * ID of the source session (extraction, recording, …).
    */
   sourceSessionId?: string | null;
+  /**
+   * How this state machine was discovered.
+   */
   sourceType: DiscoverySourceType;
   /**
    * Number of states (statistic).

package/src/generated/StateDiscoveryResultCreate.d.ts

@@ -53,6 +53,9 @@ export interface StateDiscoveryResultCreate {
    * ID of the source session.
    */
   sourceSessionId?: string | null;
+  /**
+   * Discovery source.
+   */
   sourceType: DiscoverySourceType;
   /**
    * Discovered states.

package/src/generated/StateDiscoveryResultSummary.d.ts

@@ -45,6 +45,9 @@ export interface StateDiscoveryResultSummary {
    * ID of the project.
    */
   projectId: string;
+  /**
+   * Discovery source.
+   */
   sourceType: DiscoverySourceType;
   /**
    * Number of states.

package/src/generated/StateMachineImport.d.ts

@@ -21,5 +21,8 @@ export interface StateMachineImport {
    * Override name (uses export name when omitted).
    */
   name?: string | null;
+  /**
+   * The state machine to import.
+   */
   stateMachine: StateMachineExport;
 }

package/src/generated/SuccessCriterion.d.ts

@@ -38,6 +38,9 @@ export interface SuccessCriterion {
    * Whether this criterion must pass for task completion.
    */
   required: boolean;
+  /**
+   * Type of verification required. Serialized as `"type"` on the wire.
+   */
   type: CriterionType;
   /**
    * Configuration blob for the verification method (command args, log

package/src/generated/TaskCompletionResult.d.ts

@@ -29,6 +29,9 @@ export type TaskCompletionResult =
        */
       iterations: number;
       status: "success";
+      /**
+       * Final verification results.
+       */
       verification_results: IterationVerificationResults;
       [k: string]: unknown;
     }
@@ -44,7 +47,7 @@ export type TaskCompletionResult =
       /**
        * Last verification results (if any).
        */
-      last_results?: IterationVerificationResults1 | null;
+      last_results?: IterationVerificationResults | null;
       /**
        * Human-readable reason for the failure.
        */
@@ -80,7 +83,7 @@ export type TaskCompletionResult =
       /**
        * Last verification results (if any).
        */
-      last_results?: IterationVerificationResults1 | null;
+      last_results?: IterationVerificationResults | null;
       /**
        * The max-iteration limit that triggered the pause.
        */

package/src/generated/TaskExecutionRecord.d.ts

@@ -49,6 +49,9 @@ export interface TaskExecutionRecord {
    * ISO 8601 timestamp when execution started.
    */
   startedAt: string;
+  /**
+   * Current status of this execution.
+   */
   status: ScheduledTaskStatus;
   /**
    * Whether the task succeeded, read from the session checkpoint.

package/src/generated/TaskRun.d.ts

@@ -63,6 +63,9 @@ export interface TaskRun {
    * Number of AI sessions that have been run.
    */
   sessionsCount: number;
+  /**
+   * Current lifecycle status.
+   */
   status: TaskRunStatus;
   /**
    * AI-generated summary of the task run.
@@ -76,6 +79,9 @@ export interface TaskRun {
    * Display name of the task.
    */
   taskName: string;
+  /**
+   * Kind of task (one-off, automation, or scheduled).
+   */
   taskType: TaskType;
   /**
    * ISO 8601 timestamp when the task record was last updated.

package/src/generated/TaskRunBackend.d.ts

@@ -74,6 +74,9 @@ export interface TaskRunBackend {
    * Number of AI sessions that have been run.
    */
   sessionsCount: number;
+  /**
+   * Current lifecycle status.
+   */
   status: TaskRunStatus;
   /**
    * Display name.

package/src/generated/TaskRunBackendDetail.d.ts

@@ -45,6 +45,9 @@ export interface TaskRunBackendDetail {
    * Error message if the task failed.
    */
   errorMessage: string | null;
+  /**
+   * Aggregated counts of findings.
+   */
   findingSummary: TaskRunFindingSummary;
   /**
    * Findings surfaced during this task run.
@@ -86,6 +89,9 @@ export interface TaskRunBackendDetail {
    * Number of AI sessions that have been run.
    */
   sessionsCount: number;
+  /**
+   * Current lifecycle status.
+   */
   status: TaskRunStatus;
   /**
    * Display name.

package/src/generated/TaskRunFinding.d.ts

@@ -17,7 +17,13 @@ import type { TaskRunFindingStatus } from "./TaskRunFindingStatus";
  * possibly `null`), so they use `serde(default)` without `skip_serializing_if`.
  */
 export interface TaskRunFinding {
+  /**
+   * How the finding should be acted upon.
+   */
   actionType: TaskRunFindingActionType;
+  /**
+   * Category (bug, security, performance, etc.).
+   */
   category: TaskRunFindingCategory;
   /**
    * Snippet of code illustrating the issue.
@@ -75,11 +81,17 @@ export interface TaskRunFinding {
    * Session number in which the finding was resolved.
    */
   resolvedInSession: number | null;
+  /**
+   * Severity of the finding.
+   */
   severity: TaskRunFindingSeverity;
   /**
    * Hash used to deduplicate findings across runs.
    */
   signatureHash: string | null;
+  /**
+   * Current lifecycle status.
+   */
   status: TaskRunFindingStatus;
   /**
    * Parent task run ID.

package/src/generated/TaskRunFindingCreate.d.ts

@@ -18,6 +18,9 @@ export interface TaskRunFindingCreate {
    * Action type (defaults server-side if omitted).
    */
   actionType?: TaskRunFindingActionType | null;
+  /**
+   * Category.
+   */
   category: TaskRunFindingCategory;
   /**
    * Snippet of code illustrating the issue.
@@ -63,6 +66,9 @@ export interface TaskRunFindingCreate {
    * Resolution text, if already resolved.
    */
   resolution?: string | null;
+  /**
+   * Severity.
+   */
   severity: TaskRunFindingSeverity;
   /**
    * Deduplication hash.

package/src/generated/TaskRunFindingsListResponse.d.ts

@@ -20,5 +20,8 @@ export interface TaskRunFindingsListResponse {
    * Findings for the task run.
    */
   findings: TaskRunFinding[];
+  /**
+   * Aggregated counts of findings.
+   */
   summary: TaskRunFindingSummary;
 }

package/src/generated/TaskRunListResponse.d.ts

@@ -13,6 +13,9 @@ import type { TaskRunStatus } from "./TaskRunStatus";
  * Response for `GET /task-runs`.
  */
 export interface TaskRunListResponse {
+  /**
+   * Pagination envelope.
+   */
   pagination: Pagination;
   /**
    * Page of matching task runs.

package/src/generated/Ticket.d.ts

@@ -36,7 +36,13 @@ export interface Ticket {
    * Labels applied to the ticket by the provider.
    */
   labels?: string[];
+  /**
+   * Which provider this ticket came from.
+   */
   source: TicketSource;
+  /**
+   * Abstract lifecycle state.
+   */
   state: TicketState;
   /**
    * Ticket title / summary.

package/src/generated/TicketProviderConfig.d.ts

@@ -35,6 +35,9 @@ export interface TicketProviderConfig {
    * Poll interval in seconds. Default: 60.
    */
   pollIntervalSeconds: number;
+  /**
+   * Which provider this config targets.
+   */
   source: TicketSource;
   /**
    * Provider-specific target:

package/src/generated/TransitionAction.d.ts

@@ -77,6 +77,9 @@ export interface TransitionAction {
    * Text to type (`type` action).
    */
   text?: string | null;
+  /**
+   * The kind of action to perform.
+   */
   type: StandardActionType;
   /**
    * Keystroke delay in milliseconds (`type` action).

package/src/generated/TreeEvent.d.ts

@@ -26,7 +26,13 @@ import type { TreeNode } from "./TreeNode";
  * a sequence number for ordering.
  */
 export interface TreeEvent {
+  /**
+   * Specific tree-event variant.
+   */
   eventType: TreeEventType;
+  /**
+   * The node this event is about.
+   */
   node: TreeNode;
   /**
    * Path from root to this node (breadcrumb).

package/src/generated/TreeNode.d.ts

@@ -41,11 +41,17 @@ export interface TreeNode {
    * Display name for this node.
    */
   name: string;
+  /**
+   * Type of node (workflow / action / transition).
+   */
   nodeType: NodeType;
   /**
    * ID of parent node, `None` for root.
    */
   parentId?: string | null;
+  /**
+   * Current execution status.
+   */
   status: NodeStatus;
   /**
    * When this node was created (Unix epoch seconds).

package/src/generated/UIBridgeElement.d.ts

@@ -47,6 +47,9 @@ export interface UIBridgeElement {
    * Unique element ID within the registry.
    */
   id: string;
+  /**
+   * Identifier bundle for locating the element.
+   */
   identifier: ElementIdentifier;
   /**
    * Human-readable label for the element.
@@ -65,6 +68,9 @@ export interface UIBridgeElement {
    * Populated by the SDK's element walker. Source of truth for IrElementCriteria.role.
    */
   role?: string | null;
+  /**
+   * Current observable state.
+   */
   state: ElementState;
   /**
    * HTML tag name in lowercase. Source of truth for IrElementCriteria.tag_name.

package/src/generated/UiBridgeHttpHealthEnvelope.d.ts

@@ -26,6 +26,9 @@ import type { UiBridgeHttpHealthData } from "./UiBridgeHttpHealthData";
  * other three fields are always present.
  */
 export interface UiBridgeHttpHealthEnvelope {
+  /**
+   * Transport-diagnostics payload (typed signals + open diagnostics spread).
+   */
   data: UiBridgeHttpHealthData;
   /**
    * Always `true` on the health path.

package/src/generated/UiBridgeStep.d.ts

@@ -17,6 +17,9 @@ import type { VerificationCategoryKind } from "./VerificationCategoryKind";
  * UI Bridge SDK interaction — navigate, execute, assert, snapshot, compare.
  */
 export interface UiBridgeStep {
+  /**
+   * Action kind.
+   */
   action: UiBridgeAction;
   /**
    * Structured action plan (for `action_plan`).
@@ -76,6 +79,9 @@ export interface UiBridgeStep {
    * Display name for the step.
    */
   name: string;
+  /**
+   * Phase in which the step appears.
+   */
   phase: UiBridgeStepPhase;
   /**
    * Reference snapshot ID (for `compare` / `snapshot_assert`).

package/src/generated/UnifiedWorkflow.d.ts

@@ -215,6 +215,14 @@ export interface UnifiedWorkflow {
    * Whether this workflow is marked as a favorite for quick access.
    */
   isFavorite: boolean;
+  /**
+   * Log source selection for this workflow.
+   *
+   * - `"default"`: use the global default profile (from Settings → Log Sources)
+   * - `"ai"`: let AI automatically select relevant sources based on context
+   * - `"all"`: use all enabled log sources
+   * - `{ "profile_id": "..." }`: use a specific profile
+   */
   logSourceSelection?: LogSourceSelection;
   /**
    * Whether to automatically include a `log_watch` step before verification.

package/src/generated/VectorSearchResult.d.ts

@@ -20,6 +20,9 @@ export interface VectorSearchResult {
    * Distance metric from query.
    */
   distance: number;
+  /**
+   * The matched GUI element.
+   */
   element: GUIElementChunk;
   /**
    * Which embedding was matched: `"text"`, `"image"`, or `"hybrid"`.

package/src/generated/VerificationResult.d.ts

@@ -20,6 +20,9 @@ export interface VerificationResult {
    * The criterion that was checked.
    */
   criterionId: string;
+  /**
+   * Type of verification performed.
+   */
   criterionType: CriterionType;
   /**
    * Issues found (if failed).

package/src/generated/VerificationResultResponse.d.ts

@@ -45,6 +45,9 @@ export interface VerificationResultResponse {
    * Number of steps that passed.
    */
   passedSteps: number;
+  /**
+   * Full typed verification result payload.
+   */
   resultJson: VerificationPhaseResult;
   /**
    * Number of steps that were skipped.

package/src/generated/VerificationStepResult.d.ts

@@ -14,6 +14,9 @@ import type { VerificationStepDetails } from "./VerificationStepDetails";
  * Result of a single step within a verification phase.
  */
 export interface VerificationStepResult {
+  /**
+   * Execution config for the step.
+   */
   config: StepExecutionConfig;
   /**
    * Step duration in milliseconds.