@qontinui/shared-types 0.2.1

package/src/generated/ExtendIterationsRequest.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`.
+ */
+
+/**
+ * Request to extend iterations after the max has been reached.
+ */
+export interface ExtendIterationsRequest {
+  /**
+   * Additional iterations to add.
+   */
+  additionalIterations: number;
+  /**
+   * Optional guidance for the worker.
+   */
+  guidance?: string | null;
+}

package/src/generated/FileChange.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`.
+ */
+
+/**
+ * A file change made during the agentic phase.
+ */
+export interface FileChange {
+  /**
+   * Action performed on the file (e.g., "modified", "created", "deleted").
+   */
+  action: string;
+  /**
+   * Path of the changed file.
+   */
+  path: string;
+}

package/src/generated/Finding.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`.
+ */
+
+import type { Confidence } from './Confidence';
+
+/**
+ * A finding recorded by a worker agent.
+ */
+export interface Finding {
+  confidence: Confidence;
+  /**
+   * Description of the finding.
+   */
+  description: string;
+  /**
+   * Supporting evidence (file paths, log excerpts, etc.).
+   */
+  evidence?: string | null;
+  /**
+   * Type of finding.
+   *
+   * Valid types: `"bug"`, `"root_cause"`, `"observation"`, `"hypothesis"`,
+   * `"solution"`, `"environment"`. Note: `"environment"` findings (PATH
+   * issues, disk space, tools not installed) require user intervention and
+   * should NOT trigger automatic retries.
+   */
+  findingType: string;
+  /**
+   * Unique identifier.
+   */
+  id: string;
+  /**
+   * Related file paths.
+   */
+  relatedFiles?: string[];
+}

package/src/generated/FindingActionType.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`.
+ */
+
+/**
+ * Type of action recommended for a finding.
+ *
+ * Mirrors Python `FindingActionType(str, Enum)`.
+ */
+export type FindingActionType = "auto_fix" | "needs_user_input" | "manual" | "informational";

package/src/generated/FindingBatchCreate.d.ts

@@ -0,0 +1,27 @@
+/* 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 { FindingActionType } from './FindingActionType';
+import type { FindingCategory } from './FindingCategory';
+import type { FindingCodeContext } from './FindingCodeContext';
+import type { FindingCreate } from './FindingCreate';
+import type { FindingSeverity } from './FindingSeverity';
+import type { FindingUserInput } from './FindingUserInput';
+
+/**
+ * Request schema for batch finding creation.
+ *
+ * Allows creating multiple findings in a single request. The Python side
+ * enforces `1 <= len(findings) <= 50`; validators on the Rust side are
+ * intentionally omitted to keep this a pure wire-format layer.
+ */
+export interface FindingBatchCreate {
+  /**
+   * Findings to create (1–50 items on the Python side).
+   */
+  findings: FindingCreate[];
+}

package/src/generated/FindingCategory.d.ts

@@ -0,0 +1,25 @@
+/* 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`.
+ */
+
+/**
+ * Category of a detected finding.
+ *
+ * Determines the kind of issue or observation surfaced during analysis.
+ * Mirrors Python `FindingCategory(str, Enum)`.
+ */
+export type FindingCategory =
+  | "code_bug"
+  | "security"
+  | "performance"
+  | "todo"
+  | "enhancement"
+  | "config_issue"
+  | "test_issue"
+  | "documentation"
+  | "runtime_issue"
+  | "already_fixed"
+  | "expected_behavior";

package/src/generated/FindingCodeContext.d.ts

@@ -0,0 +1,31 @@
+/* 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`.
+ */
+
+/**
+ * Code context for a finding.
+ *
+ * Provides location (file/line/column) and an optional snippet for findings
+ * that relate to specific code.
+ */
+export interface FindingCodeContext {
+  /**
+   * Column number where the finding was detected.
+   */
+  column?: number | null;
+  /**
+   * File path where the finding was detected.
+   */
+  file?: string | null;
+  /**
+   * Line number where the finding was detected.
+   */
+  line?: number | null;
+  /**
+   * Code snippet related to the finding (max 1000 chars on the Python side).
+   */
+  snippet?: string | null;
+}

package/src/generated/FindingCreate.d.ts

@@ -0,0 +1,52 @@
+/* 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 { FindingActionType } from './FindingActionType';
+import type { FindingCategory } from './FindingCategory';
+import type { FindingCodeContext } from './FindingCodeContext';
+import type { FindingSeverity } from './FindingSeverity';
+import type { FindingUserInput } from './FindingUserInput';
+
+/**
+ * Schema for creating a finding (Runner → Backend).
+ *
+ * Sent by the runner when an AI analysis session detects an issue or
+ * observation.
+ */
+export interface FindingCreate {
+  actionType: FindingActionType;
+  category: FindingCategory;
+  /**
+   * Code context, if the finding relates to specific code.
+   */
+  codeContext?: FindingCodeContext | null;
+  /**
+   * Detailed description of the finding.
+   */
+  description: string;
+  /**
+   * Session number where the finding was detected.
+   */
+  sessionNum: number;
+  severity: FindingSeverity;
+  /**
+   * Hash used to deduplicate findings across sessions.
+   */
+  signatureHash?: string | null;
+  /**
+   * Parent task run ID.
+   */
+  taskRunId: string;
+  /**
+   * Brief title describing the finding (max 500 chars on the Python side).
+   */
+  title: string;
+  /**
+   * User-input request, if `action_type` requires a user decision.
+   */
+  userInput?: FindingUserInput | null;
+}

package/src/generated/FindingDetail.d.ts

@@ -0,0 +1,78 @@
+/* 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 { FindingActionType } from './FindingActionType';
+import type { FindingCategory } from './FindingCategory';
+import type { FindingCodeContext } from './FindingCodeContext';
+import type { FindingSeverity } from './FindingSeverity';
+import type { FindingStatus } from './FindingStatus';
+import type { FindingUserInput } from './FindingUserInput';
+
+/**
+ * Detailed finding information (Backend → Frontend).
+ *
+ * Used when retrieving individual finding details. The `id` is a UUID v4
+ * string (see crate-level wire-format note).
+ */
+export interface FindingDetail {
+  actionType: FindingActionType;
+  category: FindingCategory;
+  /**
+   * Code context, if the finding relates to specific code.
+   */
+  codeContext?: FindingCodeContext | null;
+  /**
+   * Detailed description of the finding.
+   */
+  description: string;
+  /**
+   * ISO 8601 timestamp (UTC) when the finding was detected.
+   */
+  detectedAt: string;
+  /**
+   * Finding ID (UUID v4 string).
+   */
+  id: string;
+  /**
+   * Resolution description if resolved.
+   */
+  resolution?: string | null;
+  /**
+   * ISO 8601 timestamp (UTC) when the finding was resolved.
+   */
+  resolvedAt?: string | null;
+  /**
+   * Session number where the finding was resolved.
+   */
+  resolvedInSession?: number | null;
+  /**
+   * Session number where the finding was detected.
+   */
+  sessionNum: number;
+  severity: FindingSeverity;
+  /**
+   * Hash used to deduplicate findings across sessions.
+   */
+  signatureHash?: string | null;
+  status: FindingStatus;
+  /**
+   * Parent task run ID.
+   */
+  taskRunId: string;
+  /**
+   * Brief title describing the finding.
+   */
+  title: string;
+  /**
+   * User-input request, if `action_type` requires a user decision.
+   */
+  userInput?: FindingUserInput | null;
+  /**
+   * User's response, if input was requested.
+   */
+  userResponse?: string | null;
+}

package/src/generated/FindingListResponse.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`.
+ */
+
+import type { FindingActionType } from './FindingActionType';
+import type { FindingCategory } from './FindingCategory';
+import type { FindingCodeContext } from './FindingCodeContext';
+import type { FindingDetail } from './FindingDetail';
+import type { FindingSeverity } from './FindingSeverity';
+import type { FindingStatus } from './FindingStatus';
+import type { FindingUserInput } from './FindingUserInput';
+
+/**
+ * Response schema for a paginated finding list.
+ */
+export interface FindingListResponse {
+  /**
+   * Findings on this page.
+   */
+  findings: FindingDetail[];
+  /**
+   * Whether more items exist beyond this page.
+   */
+  hasMore: boolean;
+  /**
+   * Maximum items per page.
+   */
+  limit: number;
+  /**
+   * Number of items skipped.
+   */
+  offset: number;
+  /**
+   * Total count of findings matching the query.
+   */
+  total: number;
+}

package/src/generated/FindingOutput.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`.
+ */
+
+/**
+ * A finding reported by the AI.
+ */
+export interface FindingOutput {
+  /**
+   * Finding category.
+   */
+  category: string;
+  /**
+   * Detailed description.
+   */
+  description: string;
+  /**
+   * Whether this finding requires human input.
+   */
+  needsInput: boolean;
+  /**
+   * Whether this finding has been resolved.
+   */
+  resolved: boolean;
+  /**
+   * Severity level.
+   */
+  severity: string;
+  /**
+   * Short title describing the finding.
+   */
+  title: string;
+}

package/src/generated/FindingSeverity.d.ts

@@ -0,0 +1,14 @@
+/* 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`.
+ */
+
+/**
+ * Severity level of a finding.
+ *
+ * Lifecycle (ordered, most-severe first): `CRITICAL` → `HIGH` → `MEDIUM` →
+ * `LOW` → `INFO`. Mirrors Python `FindingSeverity(str, Enum)`.
+ */
+export type FindingSeverity = "critical" | "high" | "medium" | "low" | "info";

package/src/generated/FindingStatus.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`.
+ */
+
+/**
+ * Status of a finding.
+ *
+ * Lifecycle: `DETECTED` → `IN_PROGRESS` → (`RESOLVED` | `WONT_FIX` |
+ * `DEFERRED`). `NEEDS_INPUT` is a special state requiring user decision.
+ * Mirrors Python `FindingStatus(str, Enum)`.
+ */
+export type FindingStatus = "detected" | "in_progress" | "needs_input" | "resolved" | "wont_fix" | "deferred";

package/src/generated/FindingSummary.d.ts

@@ -0,0 +1,53 @@
+/* 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`.
+ */
+
+/**
+ * Summary statistics for findings in a task run.
+ *
+ * Aggregated counts grouped along each axis (category, severity, status)
+ * plus roll-up counts for UI dashboards.
+ */
+export interface FindingSummary {
+  /**
+   * Count of findings by category.
+   */
+  byCategory?: {
+    [k: string]: number;
+  };
+  /**
+   * Count of findings by severity.
+   */
+  bySeverity?: {
+    [k: string]: number;
+  };
+  /**
+   * Count of findings by status.
+   */
+  byStatus?: {
+    [k: string]: number;
+  };
+  /**
+   * Number of findings awaiting user input.
+   */
+  needsInputCount: number;
+  /**
+   * Number of unresolved findings.
+   */
+  outstandingCount: number;
+  /**
+   * Number of resolved findings.
+   */
+  resolvedCount: number;
+  /**
+   * Task run ID.
+   */
+  taskRunId: string;
+  /**
+   * Total number of findings.
+   */
+  total: number;
+}

package/src/generated/FindingUpdate.d.ts

@@ -0,0 +1,33 @@
+/* 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 { FindingStatus } from './FindingStatus';
+
+/**
+ * Schema for updating a finding.
+ *
+ * Used to update status, record a resolution, or capture a user response.
+ * All fields are optional; only those supplied are applied.
+ */
+export interface FindingUpdate {
+  /**
+   * Resolution description.
+   */
+  resolution?: string | null;
+  /**
+   * Session number where the finding was resolved.
+   */
+  resolvedInSession?: number | null;
+  /**
+   * New status for the finding.
+   */
+  status?: FindingStatus | null;
+  /**
+   * User's response to a finding requiring input.
+   */
+  userResponse?: string | null;
+}

package/src/generated/FindingUserInput.d.ts

@@ -0,0 +1,27 @@
+/* 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`.
+ */
+
+/**
+ * User-input request attached to a finding.
+ *
+ * Defines the question to pose and the expected input format when a finding
+ * requires a user decision.
+ */
+export interface FindingUserInput {
+  /**
+   * Type of input expected — typically `"text"` or `"choice"`.
+   */
+  inputType: string;
+  /**
+   * Options for choice-type input.
+   */
+  options?: string[] | null;
+  /**
+   * Question to present to the user.
+   */
+  question: string;
+}

package/src/generated/FindingsSummary.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 { TaskRunFinding } from './TaskRunFinding';
+import type { TaskRunFindingActionType } from './TaskRunFindingActionType';
+import type { TaskRunFindingCategory } from './TaskRunFindingCategory';
+import type { TaskRunFindingSeverity } from './TaskRunFindingSeverity';
+import type { TaskRunFindingStatus } from './TaskRunFindingStatus';
+
+/**
+ * Compact findings summary including the most recent findings.
+ *
+ * The TS type `TaskRunFindingResponse` is a type alias for `TaskRunFinding`;
+ * in Rust we use `TaskRunFinding` directly.
+ */
+export interface FindingsSummary {
+  /**
+   * Count by category.
+   */
+  byCategory: {
+    [k: string]: number;
+  };
+  /**
+   * Count by severity.
+   */
+  bySeverity: {
+    [k: string]: number;
+  };
+  /**
+   * Count by status.
+   */
+  byStatus: {
+    [k: string]: number;
+  };
+  /**
+   * Most recent findings.
+   */
+  recent: TaskRunFinding[];
+  /**
+   * Total number of findings.
+   */
+  total: number;
+}

package/src/generated/FlowEvent.d.ts

@@ -0,0 +1,66 @@
+/* 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`.
+ */
+
+/**
+ * Events emitted during flow execution for UI updates.
+ *
+ * Internally tagged with `"type"` and snake_case variant names.
+ */
+export type FlowEvent =
+  | {
+      flow_id: string;
+      flow_name: string;
+      instance_id: string;
+      type: "flow_started";
+      [k: string]: unknown;
+    }
+  | {
+      instance_id: string;
+      step_id: string;
+      step_name: string;
+      step_type: string;
+      type: "step_started";
+      [k: string]: unknown;
+    }
+  | {
+      duration_ms: number;
+      error?: string | null;
+      instance_id: string;
+      outputs: {
+        [k: string]: unknown;
+      };
+      step_id: string;
+      success: boolean;
+      type: "step_completed";
+      [k: string]: unknown;
+    }
+  | {
+      duration_ms: number;
+      error?: string | null;
+      flow_id: string;
+      instance_id: string;
+      success: boolean;
+      total_steps: number;
+      type: "flow_completed";
+      [k: string]: unknown;
+    }
+  | {
+      instance_id: string;
+      options: string[];
+      prompt: string;
+      step_id: string;
+      type: "waiting_for_input";
+      [k: string]: unknown;
+    }
+  | {
+      completed: number;
+      instance_id: string;
+      step_id: string;
+      total: number;
+      type: "parallel_progress";
+      [k: string]: unknown;
+    };