@qontinui/shared-types 0.12.0 → 0.12.1

package/src/generated/CompletenessVerdict.d.ts

@@ -61,6 +61,9 @@ export interface CompletenessVerdict {
    * re-dispatches generation for.
    */
   gaps?: CoverageGap[];
+  /**
+   * Overall node counts by provenance.
+   */
   provenanceMix: ProvenanceMix;
   /**
    * Per-section breakdown.

package/src/generated/ConjunctEvaluation.d.ts

@@ -20,5 +20,8 @@ export interface ConjunctEvaluation {
    * Snapshot of `PolicyConjunct.name`.
    */
   name: string;
+  /**
+   * Pass / fail / indeterminate.
+   */
   status: PolicyStatus;
 }

package/src/generated/ConjunctRule.d.ts

@@ -50,6 +50,9 @@ export type ConjunctRule =
     }
   | {
       kind: "match_outcome_at_least";
+      /**
+       * Minimum acceptable outcome.
+       */
       outcome: MatchOutcome;
       [k: string]: unknown;
     };

package/src/generated/Constraint.d.ts

@@ -12,6 +12,9 @@ import type { ConstraintSeverity } from "./ConstraintSeverity";
  * A constraint definition.
  */
 export interface Constraint {
+  /**
+   * What to check.
+   */
   check: ConstraintCheck;
   /**
    * Why this constraint exists (shown to the AI on violation).
@@ -29,5 +32,8 @@ export interface Constraint {
    * Human-readable name.
    */
   name: string;
+  /**
+   * How severe a violation is.
+   */
   severity: ConstraintSeverity;
 }

package/src/generated/ConstraintProposal.d.ts

@@ -17,6 +17,9 @@ import type { ConstraintSeverity } from "./ConstraintSeverity";
  */
 export type ConstraintProposal =
   | {
+      /**
+       * The proposed constraint definition.
+       */
       constraint: Constraint;
       type: "new_constraint";
     }

package/src/generated/ConstraintResult.d.ts

@@ -24,6 +24,9 @@ export interface ConstraintResult {
    * Whether the constraint passed.
    */
   passed: boolean;
+  /**
+   * Severity of the constraint (for quick filtering).
+   */
   severity: ConstraintSeverity;
   /**
    * Details about the violation (empty if passed).

package/src/generated/CoverageGap.d.ts

@@ -18,13 +18,22 @@ export interface CoverageGap {
    * Free-form diagnostic detail (e.g. the verifier's near-miss explanation).
    */
   detail?: string | null;
+  /**
+   * Provenance of the gapped node — always `Observed` or `Inferred`.
+   */
   nodeProvenance: SpecProvenance;
+  /**
+   * Why it is uncovered.
+   */
   reason: GapReason;
   /**
    * Dotted ref into the spec, e.g. `"entities.Invoice.fields.amount"` or
    * `"operations.createInvoice"`.
    */
   ref: string;
+  /**
+   * Which section the gapped node belongs to.
+   */
   section: SpecSection;
   [k: string]: unknown;
 }

package/src/generated/CreateMcpServerInput.d.ts

@@ -44,5 +44,8 @@ export interface CreateMcpServerInput {
    * Override for the default `timeout_seconds = 30`.
    */
   timeoutSeconds?: number | null;
+  /**
+   * Transport selector.
+   */
   transport: McpTransport;
 }

package/src/generated/CreateScheduledTaskRequest.d.ts

@@ -50,6 +50,9 @@ export interface CreateScheduledTaskRequest {
    * Display name.
    */
   name: string;
+  /**
+   * Schedule configuration.
+   */
   schedule: ScheduleExpression;
   /**
    * Skip future runs once the task has succeeded.
@@ -59,5 +62,8 @@ export interface CreateScheduledTaskRequest {
    * Free-form success criteria description.
    */
   successCriteria?: string | null;
+  /**
+   * Task type and its per-type configuration.
+   */
   task: ScheduledTaskType;
 }

package/src/generated/DiscoveredElement.d.ts

@@ -36,6 +36,9 @@ export interface DiscoveredElement {
    * ARIA role attribute.
    */
   role?: string | null;
+  /**
+   * Current observable state.
+   */
   state: ElementState;
   /**
    * HTML tag name (e.g. `"BUTTON"`, `"INPUT"`).

package/src/generated/DiscoveredStateImage.d.ts

@@ -14,6 +14,9 @@ import type { DiscoveryBoundingBox } from "./DiscoveryBoundingBox";
  * optional pixel-level identification.
  */
 export interface DiscoveredStateImage {
+  /**
+   * Bounding box within the screenshot.
+   */
   bbox: DiscoveryBoundingBox;
   /**
    * Confidence score for this image (0.0–1.0). Defaults to `1.0`.

package/src/generated/ElementState.d.ts

@@ -53,6 +53,9 @@ export interface ElementState {
    * Whether the element currently has keyboard focus.
    */
   focused: boolean;
+  /**
+   * Bounding rectangle of the element.
+   */
   rect: ElementRect;
   /**
    * Currently selected options for `<select>` elements.

package/src/generated/EmbeddedElement.d.ts

@@ -16,6 +16,9 @@ import type { GUIElementChunk } from "./GUIElementChunk";
  * Mirrors `rag.models.EmbeddedElement`.
  */
 export interface EmbeddedElement {
+  /**
+   * The GUI element that was embedded.
+   */
   element: GUIElementChunk;
   /**
    * Model used for embedding.

package/src/generated/Entity.d.ts

@@ -13,6 +13,9 @@ import type { SpecProvenance } from "./SpecProvenance";
  * A domain entity inferred from rendered data shapes.
  */
 export interface Entity {
+  /**
+   * How this entity's existence was established.
+   */
   confidence: SpecProvenance;
   /**
    * Optional deduction strength ∈ [0,1]. Present only on `Inferred` nodes;

package/src/generated/ExecutionIssueCreate.d.ts

@@ -45,6 +45,9 @@ export interface ExecutionIssueCreate {
    * IDs of screenshots illustrating the issue.
    */
   screenshotIds?: string[] | null;
+  /**
+   * Severity.
+   */
   severity: IssueSeverity;
   /**
    * State ID active when the issue was observed.

package/src/generated/ExecutionIssueDetail.d.ts

@@ -44,6 +44,9 @@ export interface ExecutionIssueDetail {
    * Issue ID.
    */
   id: string;
+  /**
+   * Category label for the issue.
+   */
   issueType: IssueType;
   /**
    * Opaque additional metadata.
@@ -71,12 +74,21 @@ export interface ExecutionIssueDetail {
    * Full screenshot records associated with the issue.
    */
   screenshots?: ExecutionScreenshotResponse[];
+  /**
+   * Severity.
+   */
   severity: IssueSeverity;
+  /**
+   * Source that detected the issue.
+   */
   source: IssueSource;
   /**
    * State ID where the issue was observed, if any.
    */
   stateName?: string | null;
+  /**
+   * Current lifecycle status.
+   */
   status: IssueStatus;
   /**
    * Short title.

package/src/generated/ExecutionIssueListResponse.d.ts

@@ -16,6 +16,9 @@ export interface ExecutionIssueListResponse {
    * Page of matching issues.
    */
   issues: ExecutionIssueResponse[];
+  /**
+   * Pagination envelope.
+   */
   pagination: Pagination;
   /**
    * Summary keyed by severity or status. Shape is intentionally opaque.

package/src/generated/ExecutionRunComplete.d.ts

@@ -25,7 +25,13 @@ export interface ExecutionRunComplete {
    * Error message if the run failed.
    */
   errorMessage?: string | null;
+  /**
+   * Aggregate execution statistics.
+   */
   stats: ExecutionStats;
+  /**
+   * Final lifecycle status.
+   */
   status: RunStatus;
   /**
    * Free-form run summary.

package/src/generated/ExecutionRunCompleteResponse.d.ts

@@ -33,6 +33,12 @@ export interface ExecutionRunCompleteResponse {
    * ISO 8601 timestamp when the run started.
    */
   startedAt: string;
+  /**
+   * Aggregate execution statistics.
+   */
   stats: ExecutionStats;
+  /**
+   * Final lifecycle status.
+   */
   status: RunStatus;
 }

package/src/generated/ExecutionRunCreate.d.ts

@@ -31,7 +31,13 @@ export interface ExecutionRunCreate {
    * Human-readable run name.
    */
   runName: string;
+  /**
+   * Kind of run being created.
+   */
   runType: RunType;
+  /**
+   * Runner environment metadata.
+   */
   runnerMetadata: RunnerMetadata;
   /**
    * Workflow metadata, if the run executes a workflow.

package/src/generated/ExecutionRunDetail.d.ts

@@ -57,13 +57,25 @@ export interface ExecutionRunDetail {
    * Human-readable run name.
    */
   runName: string;
+  /**
+   * Kind of run.
+   */
   runType: RunType;
+  /**
+   * Runner environment metadata.
+   */
   runnerMetadata: RunnerMetadata;
   /**
    * ISO 8601 timestamp when the run started.
    */
   startedAt: string;
+  /**
+   * Aggregate execution statistics.
+   */
   stats: ExecutionStats;
+  /**
+   * Current lifecycle status.
+   */
   status: RunStatus;
   /**
    * ISO 8601 timestamp when the record was last updated.

package/src/generated/ExecutionRunListResponse.d.ts

@@ -14,6 +14,9 @@ import type { RunType } from "./RunType";
  * Paginated list of execution runs.
  */
 export interface ExecutionRunListResponse {
+  /**
+   * Pagination envelope.
+   */
   pagination: Pagination;
   /**
    * Page of matching runs.

package/src/generated/ExecutionRunResponse.d.ts

@@ -32,10 +32,16 @@ export interface ExecutionRunResponse {
    * Human-readable run name.
    */
   runName: string;
+  /**
+   * Kind of run.
+   */
   runType: RunType;
   /**
    * ISO 8601 timestamp when the run started.
    */
   startedAt: string;
+  /**
+   * Current lifecycle status.
+   */
   status: RunStatus;
 }

package/src/generated/ExecutionScreenshotCreate.d.ts

@@ -39,6 +39,9 @@ export interface ExecutionScreenshotCreate {
    * Client-generated screenshot identifier.
    */
   screenshotId: string;
+  /**
+   * Kind of screenshot.
+   */
   screenshotType: ScreenshotType;
   /**
    * Sequence number of the screenshot within the run.

package/src/generated/Finding.d.ts

@@ -11,6 +11,9 @@ import type { Confidence } from "./Confidence";
  * A finding recorded by a worker agent.
  */
 export interface Finding {
+  /**
+   * Confidence level.
+   */
   confidence: Confidence;
   /**
    * Description of the finding.

package/src/generated/FindingCreate.d.ts

@@ -18,7 +18,13 @@ import type { FindingUserInput } from "./FindingUserInput";
  * observation.
  */
 export interface FindingCreate {
+  /**
+   * Type of action for this finding.
+   */
   actionType: FindingActionType;
+  /**
+   * Category of the finding.
+   */
   category: FindingCategory;
   /**
    * Code context, if the finding relates to specific code.
@@ -32,6 +38,9 @@ export interface FindingCreate {
    * Session number where the finding was detected.
    */
   sessionNum: number;
+  /**
+   * Severity level of the finding.
+   */
   severity: FindingSeverity;
   /**
    * Hash used to deduplicate findings across sessions.

package/src/generated/FindingDetail.d.ts

@@ -19,7 +19,13 @@ import type { FindingUserInput } from "./FindingUserInput";
  * string (see crate-level wire-format note).
  */
 export interface FindingDetail {
+  /**
+   * Type of action for this finding.
+   */
   actionType: FindingActionType;
+  /**
+   * Category of the finding.
+   */
   category: FindingCategory;
   /**
    * Code context, if the finding relates to specific code.
@@ -53,11 +59,17 @@ export interface FindingDetail {
    * Session number where the finding was detected.
    */
   sessionNum: number;
+  /**
+   * Severity level of the finding.
+   */
   severity: FindingSeverity;
   /**
    * Hash used to deduplicate findings across sessions.
    */
   signatureHash?: string | null;
+  /**
+   * Current status of the finding.
+   */
   status: FindingStatus;
   /**
    * Parent task run ID.

package/src/generated/FunctionalSpec.d.ts

@@ -66,6 +66,9 @@ export interface FunctionalSpec {
    * Schema version. Currently always `"0"`. Additive-only until `"1"`.
    */
   specVersion: string;
+  /**
+   * What was observed and when.
+   */
   target: SpecTarget;
   /**
    * Section (3a) UI STATES — a literal superset of the UI Bridge IR. These are the

package/src/generated/HelperAnswer.d.ts

@@ -42,6 +42,9 @@ export interface HelperAnswer {
    * The [`HelperTask`] this answers.
    */
   taskId: string;
+  /**
+   * The verdict the helper gave.
+   */
   verdict: HelperVerdict;
   [k: string]: unknown;
 }

package/src/generated/HelperTask.d.ts

@@ -20,6 +20,9 @@ import type { HelperVerdict } from "./HelperVerdict";
  * verdict and routes it back through [`source`](HelperTask::source).
  */
 export interface HelperTask {
+  /**
+   * The set of allowed answers and preset reason codes offered to the helper.
+   */
   answerSchema: HelperAnswerSchema;
   /**
    * Application the task pertains to.
@@ -38,7 +41,13 @@ export interface HelperTask {
    * Task ID (UUID v4 string).
    */
   id: string;
+  /**
+   * Which kind of judgment is being asked for.
+   */
   kind: HelperTaskKind;
+  /**
+   * Kind-specific content (screenshot URL, compare URLs, steps, …).
+   */
   payload: HelperTaskPayload;
   /**
    * Human-readable question shown to the helper (e.g. "Does this login
@@ -49,7 +58,14 @@ export interface HelperTask {
    * Number of helper answers required before the task is `Answered`.
    */
   requiredVotes: number;
+  /**
+   * Provenance linking the task back to its originating finding / page /
+   * spec-check.
+   */
   source: HelperTaskSource;
+  /**
+   * Current lifecycle status.
+   */
   status: HelperTaskStatus;
   /**
    * Tenant that owns the task (coord tenant id).

package/src/generated/HistoricalActionResult.d.ts

@@ -16,6 +16,9 @@ export interface HistoricalActionResult {
    * Human-readable action name.
    */
   actionName: string;
+  /**
+   * Kind of action.
+   */
   actionType: ExecutionActionType;
   /**
    * Duration in milliseconds.
@@ -49,6 +52,9 @@ export interface HistoricalActionResult {
    * URL to an associated screenshot, if any.
    */
   screenshotUrl?: string | null;
+  /**
+   * Outcome.
+   */
   status: ActionStatus;
   /**
    * Target state.

package/src/generated/IrPageSpec.d.ts

@@ -19,6 +19,48 @@ import type { IrTransitionAction } from "./IrTransitionAction";
 import type { IrWaitSpec } from "./IrWaitSpec";
 import type { ProposalStatus } from "./ProposalStatus";
 
+/**
+ * API assertion: either a value-level assertion (status_code, json_path, etc.)
+ * or a schema-conformance assertion (conforms_to — Phase 2 placeholder).
+ */
+export type IrApiAssertion =
+  | {
+      expected: unknown;
+      operator?: string | null;
+      type: "status_code";
+      [k: string]: unknown;
+    }
+  | {
+      expected: unknown;
+      json_path: string;
+      operator?: string | null;
+      type: "json_path";
+      [k: string]: unknown;
+    }
+  | {
+      expected: unknown;
+      header_name: string;
+      operator?: string | null;
+      type: "header";
+      [k: string]: unknown;
+    }
+  | {
+      expected: unknown;
+      type: "body_contains";
+      [k: string]: unknown;
+    }
+  | {
+      expected: unknown;
+      operator?: string | null;
+      type: "response_time";
+      [k: string]: unknown;
+    }
+  | {
+      schema: string;
+      type: "conforms_to";
+      [k: string]: unknown;
+    };
+
 /**
  * Top-level IR page specification (formerly `IrDocument`).
  *
@@ -55,3 +97,23 @@ export interface IrPageSpec {
   version: string;
   [k: string]: unknown;
 }
+/**
+ * A single API-contract check: issue a request, validate the response.
+ */
+export interface IrApiCheck {
+  assertions: IrApiAssertion[];
+  description?: string | null;
+  effect: string;
+  id: string;
+  request: IrApiRequest;
+  [k: string]: unknown;
+}
+export interface IrApiRequest {
+  body?: unknown;
+  headers?: {
+    [k: string]: string;
+  } | null;
+  method: string;
+  path: string;
+  [k: string]: unknown;
+}

package/src/generated/IterationResult.d.ts

@@ -25,6 +25,9 @@ export interface IterationResult {
    * Diagnostic-phase result (if the diagnose phase is configured).
    */
   diagnosticResult?: DiagnosticResult | null;
+  /**
+   * Exit-check outcome for this iteration.
+   */
   exitCheck: ExitCheckResult;
   /**
    * Number of fixes proposed during reflection.

package/src/generated/LoopInstanceStatus.d.ts

@@ -24,5 +24,8 @@ export interface LoopInstanceStatus {
    * Unique identifier for this loop.
    */
   loopId: string;
+  /**
+   * The per-loop status snapshot.
+   */
   status: OrchestrationLoopStatus;
 }

package/src/generated/McpServerConfig.d.ts

@@ -69,6 +69,9 @@ export interface McpServerConfig {
    * ISO 8601 timestamp of when `cached_tools` was populated.
    */
   toolsCachedAt?: string | null;
+  /**
+   * Which transport this server uses.
+   */
   transport: McpTransport;
   /**
    * ISO 8601 last-update timestamp.

package/src/generated/McpToolInfo.d.ts

@@ -15,6 +15,9 @@ export interface McpToolInfo {
    * Tool description shown to users.
    */
   description?: string | null;
+  /**
+   * Input-argument schema. Wire field is `"inputSchema"` per MCP spec.
+   */
   inputSchema: McpToolInputSchema;
   /**
    * Tool name (the argument passed back on `tools/call`).

package/src/generated/Monitor.d.ts

@@ -28,6 +28,9 @@ export interface Monitor {
    * Display name (e.g., "DELL U2720Q").
    */
   name?: string | null;
+  /**
+   * Spatial position based on X coordinate (for UI display).
+   */
   position: MonitorPosition;
   /**
    * DPI scale factor (1.0 = 100%, 1.5 = 150%, 2.0 = 200%).

package/src/generated/MultiLoopEntry.d.ts

@@ -20,6 +20,9 @@ import type { SummarizationConfig } from "./SummarizationConfig";
  * A single entry in a multi-loop configuration.
  */
 export interface MultiLoopEntry {
+  /**
+   * The loop configuration.
+   */
   config: OrchestrationLoopConfig;
   /**
    * Human label (e.g., `"Pages 1–10"` or an app section name).

package/src/generated/NewConstraintProposal.d.ts

@@ -16,5 +16,8 @@ import type { ConstraintSeverity } from "./ConstraintSeverity";
  * enum's internal tag.
  */
 export interface NewConstraintProposal {
+  /**
+   * The proposed constraint definition.
+   */
   constraint: Constraint;
 }

package/src/generated/OrchestrationLoopStatus.d.ts

@@ -35,6 +35,9 @@ export interface OrchestrationLoopStatus {
    * Iteration cap for this run. `None` renders as `"∞"`/unlimited in the UI.
    */
   maxIterations?: number | null;
+  /**
+   * Current phase.
+   */
   phase: LoopPhase;
   /**
    * Whether the loop is currently running.

package/src/generated/OutputLine.d.ts

@@ -15,6 +15,9 @@ export interface OutputLine {
    * The line content
    */
   line: string;
+  /**
+   * Which stream this came from
+   */
   stream: OutputStream;
   /**
    * ISO 8601 timestamp