@qontinui/shared-types 0.12.0 → 0.13.0

package/dist/state-machine.d.ts

@@ -178,6 +178,9 @@ interface TransitionAction {
    * Text to type (`type` action).
    */
   text?: string | null;
+  /**
+   * The kind of action to perform.
+   */
   type: StandardActionType;
   /**
    * Keystroke delay in milliseconds (`type` action).
@@ -1034,6 +1037,9 @@ interface InitialStateRef {
  * resolution came from.
  */
 interface ResolvedInitialStates {
+  /**
+   * Where the resolution came from.
+   */
   source: InitialStatesSource;
   /**
    * Resolved initial state IDs.
@@ -1070,6 +1076,9 @@ interface ResolvedInitialStatesResult {
    * Error message when resolution failed.
    */
   error?: string | null;
+  /**
+   * Where the resolution came from.
+   */
   source: InitialStatesSource;
   /**
    * Resolved initial state IDs.

package/dist/task-run.d.cts

@@ -88,6 +88,9 @@ interface TaskRun {
    * Number of AI sessions that have been run.
    */
   sessionsCount: number;
+  /**
+   * Current lifecycle status.
+   */
   status: TaskRunStatus;
   /**
    * AI-generated summary of the task run.
@@ -101,6 +104,9 @@ 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.
@@ -188,6 +194,9 @@ interface TaskRunBackend {
    * Number of AI sessions that have been run.
    */
   sessionsCount: number;
+  /**
+   * Current lifecycle status.
+   */
   status: TaskRunStatus;
   /**
    * Display name.
@@ -256,7 +265,13 @@ interface TaskRunSession {
  * possibly `null`), so they use `serde(default)` without `skip_serializing_if`.
  */
 interface TaskRunFinding {
+  /**
+   * How the finding should be acted upon.
+   */
   actionType: TaskRunFindingActionType;
+  /**
+   * Category (bug, security, performance, etc.).
+   */
   category: TaskRunFindingCategory;
   /**
    * Snippet of code illustrating the issue.
@@ -314,11 +329,17 @@ 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.
@@ -413,6 +434,9 @@ interface TaskRunBackendDetail {
    * Error message if the task failed.
    */
   errorMessage: string | null;
+  /**
+   * Aggregated counts of findings.
+   */
   findingSummary: TaskRunFindingSummary;
   /**
    * Findings surfaced during this task run.
@@ -454,6 +478,9 @@ interface TaskRunBackendDetail {
    * Number of AI sessions that have been run.
    */
   sessionsCount: number;
+  /**
+   * Current lifecycle status.
+   */
   status: TaskRunStatus;
   /**
    * Display name.
@@ -594,6 +621,9 @@ interface TaskRunFindingCreate {
    * Action type (defaults server-side if omitted).
    */
   actionType?: TaskRunFindingActionType | null;
+  /**
+   * Category.
+   */
   category: TaskRunFindingCategory;
   /**
    * Snippet of code illustrating the issue.
@@ -639,6 +669,9 @@ interface TaskRunFindingCreate {
    * Resolution text, if already resolved.
    */
   resolution?: string | null;
+  /**
+   * Severity.
+   */
   severity: TaskRunFindingSeverity;
   /**
    * Deduplication hash.
@@ -978,6 +1011,9 @@ interface Pagination {
  * Response for `GET /task-runs`.
  */
 interface TaskRunListResponse {
+  /**
+   * Pagination envelope.
+   */
   pagination: Pagination;
   /**
    * Page of matching task runs.
@@ -1002,6 +1038,9 @@ interface TaskRunFindingsListResponse {
    * Findings for the task run.
    */
   findings: TaskRunFinding[];
+  /**
+   * Aggregated counts of findings.
+   */
   summary: TaskRunFindingSummary;
 }
 
@@ -1247,6 +1286,9 @@ interface StepExecutionConfig {
  * Result of a single step within a verification phase.
  */
 interface VerificationStepResult {
+  /**
+   * Execution config for the step.
+   */
   config: StepExecutionConfig;
   /**
    * Step duration in milliseconds.
@@ -1437,6 +1479,9 @@ interface VerificationResultResponse {
    * Number of steps that passed.
    */
   passedSteps: number;
+  /**
+   * Full typed verification result payload.
+   */
   resultJson: VerificationPhaseResult;
   /**
    * Number of steps that were skipped.

package/dist/task-run.d.ts

@@ -88,6 +88,9 @@ interface TaskRun {
    * Number of AI sessions that have been run.
    */
   sessionsCount: number;
+  /**
+   * Current lifecycle status.
+   */
   status: TaskRunStatus;
   /**
    * AI-generated summary of the task run.
@@ -101,6 +104,9 @@ 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.
@@ -188,6 +194,9 @@ interface TaskRunBackend {
    * Number of AI sessions that have been run.
    */
   sessionsCount: number;
+  /**
+   * Current lifecycle status.
+   */
   status: TaskRunStatus;
   /**
    * Display name.
@@ -256,7 +265,13 @@ interface TaskRunSession {
  * possibly `null`), so they use `serde(default)` without `skip_serializing_if`.
  */
 interface TaskRunFinding {
+  /**
+   * How the finding should be acted upon.
+   */
   actionType: TaskRunFindingActionType;
+  /**
+   * Category (bug, security, performance, etc.).
+   */
   category: TaskRunFindingCategory;
   /**
    * Snippet of code illustrating the issue.
@@ -314,11 +329,17 @@ 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.
@@ -413,6 +434,9 @@ interface TaskRunBackendDetail {
    * Error message if the task failed.
    */
   errorMessage: string | null;
+  /**
+   * Aggregated counts of findings.
+   */
   findingSummary: TaskRunFindingSummary;
   /**
    * Findings surfaced during this task run.
@@ -454,6 +478,9 @@ interface TaskRunBackendDetail {
    * Number of AI sessions that have been run.
    */
   sessionsCount: number;
+  /**
+   * Current lifecycle status.
+   */
   status: TaskRunStatus;
   /**
    * Display name.
@@ -594,6 +621,9 @@ interface TaskRunFindingCreate {
    * Action type (defaults server-side if omitted).
    */
   actionType?: TaskRunFindingActionType | null;
+  /**
+   * Category.
+   */
   category: TaskRunFindingCategory;
   /**
    * Snippet of code illustrating the issue.
@@ -639,6 +669,9 @@ interface TaskRunFindingCreate {
    * Resolution text, if already resolved.
    */
   resolution?: string | null;
+  /**
+   * Severity.
+   */
   severity: TaskRunFindingSeverity;
   /**
    * Deduplication hash.
@@ -978,6 +1011,9 @@ interface Pagination {
  * Response for `GET /task-runs`.
  */
 interface TaskRunListResponse {
+  /**
+   * Pagination envelope.
+   */
   pagination: Pagination;
   /**
    * Page of matching task runs.
@@ -1002,6 +1038,9 @@ interface TaskRunFindingsListResponse {
    * Findings for the task run.
    */
   findings: TaskRunFinding[];
+  /**
+   * Aggregated counts of findings.
+   */
   summary: TaskRunFindingSummary;
 }
 
@@ -1247,6 +1286,9 @@ interface StepExecutionConfig {
  * Result of a single step within a verification phase.
  */
 interface VerificationStepResult {
+  /**
+   * Execution config for the step.
+   */
   config: StepExecutionConfig;
   /**
    * Step duration in milliseconds.
@@ -1437,6 +1479,9 @@ interface VerificationResultResponse {
    * Number of steps that passed.
    */
   passedSteps: number;
+  /**
+   * Full typed verification result payload.
+   */
   resultJson: VerificationPhaseResult;
   /**
    * Number of steps that were skipped.

package/dist/tree-events.d.cts

@@ -302,11 +302,17 @@ 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).
@@ -349,7 +355,13 @@ interface PathElement {
  * a sequence number for ordering.
  */
 interface TreeEvent {
+  /**
+   * Specific tree-event variant.
+   */
   eventType: TreeEventType;
+  /**
+   * The node this event is about.
+   */
   node: TreeNode;
   /**
    * Path from root to this node (breadcrumb).

package/dist/tree-events.d.ts

@@ -302,11 +302,17 @@ 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).
@@ -349,7 +355,13 @@ interface PathElement {
  * a sequence number for ordering.
  */
 interface TreeEvent {
+  /**
+   * Specific tree-event variant.
+   */
   eventType: TreeEventType;
+  /**
+   * The node this event is about.
+   */
   node: TreeNode;
   /**
    * Path from root to this node (breadcrumb).

package/dist/workflow.d.cts

@@ -475,6 +475,9 @@ interface CommandStep {
    * Display name for the step.
    */
   name: string;
+  /**
+   * Phase in which the step appears.
+   */
   phase: CommandStepPhase;
   /**
    * Repository selector for repository-targeted steps.
@@ -625,6 +628,9 @@ 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).
@@ -743,6 +749,9 @@ type UiBridgeStepPhase = "setup" | "verification" | "completion";
  * UI Bridge SDK interaction — navigate, execute, assert, snapshot, compare.
  */
 interface UiBridgeStep {
+  /**
+   * Action kind.
+   */
   action: UiBridgeAction;
   /**
    * Structured action plan (for `action_plan`).
@@ -802,6 +811,9 @@ interface UiBridgeStep {
    * Display name for the step.
    */
   name: string;
+  /**
+   * Phase in which the step appears.
+   */
   phase: UiBridgeStepPhase;
   /**
    * Reference snapshot ID (for `compare` / `snapshot_assert`).
@@ -909,6 +921,9 @@ interface WorkflowStep {
    * Display name for the step.
    */
   name: string;
+  /**
+   * Phase in which the step appears.
+   */
   phase: WorkflowStepPhase;
   /**
    * Whether this step is required (default: `true` on consumer side).
@@ -1335,6 +1350,14 @@ 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.
@@ -1690,6 +1713,9 @@ interface ApiAssertion {
    * Comparison operator; defaults to `equals` on the consumer side.
    */
   operator?: ApiAssertionOperator | null;
+  /**
+   * Kind of assertion.
+   */
   type: ApiAssertionType;
 }
 

package/dist/workflow.d.ts

@@ -475,6 +475,9 @@ interface CommandStep {
    * Display name for the step.
    */
   name: string;
+  /**
+   * Phase in which the step appears.
+   */
   phase: CommandStepPhase;
   /**
    * Repository selector for repository-targeted steps.
@@ -625,6 +628,9 @@ 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).
@@ -743,6 +749,9 @@ type UiBridgeStepPhase = "setup" | "verification" | "completion";
  * UI Bridge SDK interaction — navigate, execute, assert, snapshot, compare.
  */
 interface UiBridgeStep {
+  /**
+   * Action kind.
+   */
   action: UiBridgeAction;
   /**
    * Structured action plan (for `action_plan`).
@@ -802,6 +811,9 @@ interface UiBridgeStep {
    * Display name for the step.
    */
   name: string;
+  /**
+   * Phase in which the step appears.
+   */
   phase: UiBridgeStepPhase;
   /**
    * Reference snapshot ID (for `compare` / `snapshot_assert`).
@@ -909,6 +921,9 @@ interface WorkflowStep {
    * Display name for the step.
    */
   name: string;
+  /**
+   * Phase in which the step appears.
+   */
   phase: WorkflowStepPhase;
   /**
    * Whether this step is required (default: `true` on consumer side).
@@ -1335,6 +1350,14 @@ 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.
@@ -1690,6 +1713,9 @@ interface ApiAssertion {
    * Comparison operator; defaults to `equals` on the consumer side.
    */
   operator?: ApiAssertionOperator | null;
+  /**
+   * Kind of assertion.
+   */
   type: ApiAssertionType;
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qontinui/shared-types",
-  "version": "0.12.0",
+  "version": "0.13.0",
   "description": "Shared TypeScript types for the Qontinui ecosystem",
   "type": "module",
   "main": "./dist/index.js",
@@ -106,11 +106,11 @@
   "scripts": {
     "build": "tsup",
     "dev": "tsup --watch",
-    "typecheck": "tsc --noEmit",
+    "typecheck": "tsc --noEmit && tsc -p tsconfig.generated.json",
     "test": "vitest run",
     "test:watch": "vitest",
     "clean": "rimraf dist",
-    "prepublishOnly": "npm run build"
+    "prepublishOnly": "npm run typecheck && npm run build"
   },
   "keywords": [
     "qontinui",

package/src/generated/AccessibilityNode.d.ts

@@ -57,6 +57,9 @@ export interface AccessibilityNode {
    * Reference ID like `@e1`, `@e2` for AI interaction.
    */
   ref: string;
+  /**
+   * Accessibility role (button, textbox, etc.).
+   */
   role: AccessibilityRole;
   /**
    * Current state flags.

package/src/generated/AccessibilitySnapshot.d.ts

@@ -18,11 +18,17 @@ import type { AccessibilityState } from "./AccessibilityState";
  * capture source and summary statistics.
  */
 export interface AccessibilitySnapshot {
+  /**
+   * Backend used for capture.
+   */
   backend: AccessibilityBackend;
   /**
    * Number of interactive nodes.
    */
   interactiveNodes: number;
+  /**
+   * Root node of the accessibility tree.
+   */
   root: AccessibilityNode;
   /**
    * Unix timestamp of capture.

package/src/generated/ActionExecutionCreate.d.ts

@@ -21,6 +21,9 @@ export interface ActionExecutionCreate {
    * Human-readable action name.
    */
   actionName: string;
+  /**
+   * Kind of action.
+   */
   actionType: ExecutionActionType;
   /**
    * IDs of states active when the action ran.
@@ -112,6 +115,9 @@ export interface ActionExecutionCreate {
    * ISO 8601 timestamp when the action started.
    */
   startedAt: string;
+  /**
+   * Outcome of the action.
+   */
   status: ActionStatus;
   /**
    * Destination state ID for state-machine actions.

package/src/generated/ActionExecutionListResponse.d.ts

@@ -16,5 +16,8 @@ export interface ActionExecutionListResponse {
    * Page of matching actions.
    */
   actions: ActionExecutionResponse[];
+  /**
+   * Pagination envelope.
+   */
   pagination: Pagination;
 }

package/src/generated/ActionReliabilityStats.d.ts

@@ -15,6 +15,9 @@ export interface ActionReliabilityStats {
    * Human-readable action name.
    */
   actionName: string;
+  /**
+   * Kind of action.
+   */
   actionType: ExecutionActionType;
   /**
    * Mean duration in milliseconds.