@qontinui/shared-types 0.2.1

package/src/generated/TaskRunFinding.d.ts

@@ -0,0 +1,100 @@
+/* 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 { TaskRunFindingActionType } from './TaskRunFindingActionType';
+import type { TaskRunFindingCategory } from './TaskRunFindingCategory';
+import type { TaskRunFindingSeverity } from './TaskRunFindingSeverity';
+import type { TaskRunFindingStatus } from './TaskRunFindingStatus';
+
+/**
+ * A finding surfaced during a task run (bug, enhancement, TODO, etc.).
+ *
+ * All nullable fields here are required-nullable on the wire (always present,
+ * possibly `null`), so they use `serde(default)` without `skip_serializing_if`.
+ */
+export interface TaskRunFinding {
+  actionType: TaskRunFindingActionType;
+  category: TaskRunFindingCategory;
+  /**
+   * Snippet of code illustrating the issue.
+   */
+  codeSnippet: string | null;
+  /**
+   * Column number where the issue was found.
+   */
+  columnNumber: number | null;
+  /**
+   * Full description.
+   */
+  description: string;
+  /**
+   * ISO 8601 timestamp when the finding was detected.
+   */
+  detectedAt: string;
+  /**
+   * Session number in which the finding was detected.
+   */
+  detectedInSession: number;
+  /**
+   * File path where the issue was found.
+   */
+  filePath: string | null;
+  /**
+   * Unique identifier (UUID v4 string).
+   */
+  id: string;
+  /**
+   * Suggested response options for the user, if input is needed.
+   */
+  inputOptions: string[] | null;
+  /**
+   * Line number where the issue was found.
+   */
+  lineNumber: number | null;
+  /**
+   * Whether this finding requires user input.
+   */
+  needsInput: boolean;
+  /**
+   * Question posed to the user, if input is needed.
+   */
+  question: string | null;
+  /**
+   * How the finding was resolved, if applicable.
+   */
+  resolution: string | null;
+  /**
+   * ISO 8601 timestamp when the finding was resolved.
+   */
+  resolvedAt: string | null;
+  /**
+   * Session number in which the finding was resolved.
+   */
+  resolvedInSession: number | null;
+  severity: TaskRunFindingSeverity;
+  /**
+   * Hash used to deduplicate findings across runs.
+   */
+  signatureHash: string | null;
+  status: TaskRunFindingStatus;
+  /**
+   * Parent task run ID.
+   */
+  taskRunId: string;
+  /**
+   * Short human-readable title.
+   */
+  title: string;
+  /**
+   * ISO 8601 timestamp when the record was last updated.
+   */
+  updatedAt: string;
+  /**
+   * The user's response, if any.
+   */
+  userResponse: string | null;
+}

package/src/generated/TaskRunFindingActionType.d.ts

@@ -0,0 +1,11 @@
+/* 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`.
+ */
+
+/**
+ * How a finding should be acted upon.
+ */
+export type TaskRunFindingActionType = "auto_fix" | "needs_user_input" | "manual" | "informational";

package/src/generated/TaskRunFindingCategory.d.ts

@@ -0,0 +1,24 @@
+/* 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 finding surfaced during a task run.
+ */
+export type TaskRunFindingCategory =
+  | "code_bug"
+  | "security"
+  | "performance"
+  | "todo"
+  | "enhancement"
+  | "config_issue"
+  | "test_issue"
+  | "documentation"
+  | "runtime_issue"
+  | "already_fixed"
+  | "expected_behavior"
+  | "data_migration"
+  | "warning";

package/src/generated/TaskRunFindingCreate.d.ts

@@ -0,0 +1,79 @@
+/* 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 { TaskRunFindingActionType } from './TaskRunFindingActionType';
+import type { TaskRunFindingCategory } from './TaskRunFindingCategory';
+import type { TaskRunFindingSeverity } from './TaskRunFindingSeverity';
+import type { TaskRunFindingStatus } from './TaskRunFindingStatus';
+
+/**
+ * Request payload for creating a finding.
+ */
+export interface TaskRunFindingCreate {
+  /**
+   * Action type (defaults server-side if omitted).
+   */
+  actionType?: TaskRunFindingActionType | null;
+  category: TaskRunFindingCategory;
+  /**
+   * Snippet of code illustrating the issue.
+   */
+  codeSnippet?: string | null;
+  /**
+   * Column number where the issue was found.
+   */
+  columnNumber?: number | null;
+  /**
+   * Full description.
+   */
+  description: string;
+  /**
+   * Session number in which the finding was detected.
+   */
+  detectedInSession: number;
+  /**
+   * File path where the issue was found.
+   */
+  filePath?: string | null;
+  /**
+   * Optional client-generated ID.
+   */
+  id?: string | null;
+  /**
+   * Suggested response options for the user.
+   */
+  inputOptions?: string[] | null;
+  /**
+   * Line number where the issue was found.
+   */
+  lineNumber?: number | null;
+  /**
+   * Whether this finding requires user input.
+   */
+  needsInput?: boolean | null;
+  /**
+   * Question to pose to the user, if input is needed.
+   */
+  question?: string | null;
+  /**
+   * Resolution text, if already resolved.
+   */
+  resolution?: string | null;
+  severity: TaskRunFindingSeverity;
+  /**
+   * Deduplication hash.
+   */
+  signatureHash?: string | null;
+  /**
+   * Initial status (defaults server-side if omitted).
+   */
+  status?: TaskRunFindingStatus | null;
+  /**
+   * Short title.
+   */
+  title: string;
+}

package/src/generated/TaskRunFindingFilters.d.ts

@@ -0,0 +1,28 @@
+/* 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 { TaskRunFindingCategory } from './TaskRunFindingCategory';
+import type { TaskRunFindingSeverity } from './TaskRunFindingSeverity';
+import type { TaskRunFindingStatus } from './TaskRunFindingStatus';
+
+/**
+ * Filter parameters for listing findings.
+ */
+export interface TaskRunFindingFilters {
+  /**
+   * Restrict to a given category.
+   */
+  category?: TaskRunFindingCategory | null;
+  /**
+   * Restrict to a given severity.
+   */
+  severity?: TaskRunFindingSeverity | null;
+  /**
+   * Restrict to a given status.
+   */
+  status?: TaskRunFindingStatus | null;
+}

package/src/generated/TaskRunFindingSeverity.d.ts

@@ -0,0 +1,11 @@
+/* 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 of a finding.
+ */
+export type TaskRunFindingSeverity = "critical" | "high" | "medium" | "low" | "info";

package/src/generated/TaskRunFindingStatus.d.ts

@@ -0,0 +1,11 @@
+/* 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`.
+ */
+
+/**
+ * Lifecycle status of a finding.
+ */
+export type TaskRunFindingStatus = "detected" | "in_progress" | "needs_input" | "resolved" | "wont_fix" | "deferred";

package/src/generated/TaskRunFindingSummary.d.ts

@@ -0,0 +1,34 @@
+/* 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`.
+ */
+
+/**
+ * Aggregated finding counts grouped along each axis.
+ */
+export interface TaskRunFindingSummary {
+  /**
+   * 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;
+  };
+  /**
+   * Total number of findings.
+   */
+  total: number;
+}

package/src/generated/TaskRunFindingUpdate.d.ts

@@ -0,0 +1,34 @@
+/* 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 { TaskRunFindingStatus } from './TaskRunFindingStatus';
+
+/**
+ * Request payload for updating a finding. All fields are optional.
+ */
+export interface TaskRunFindingUpdate {
+  /**
+   * Resolution text.
+   */
+  resolution?: string | null;
+  /**
+   * ISO 8601 timestamp of resolution.
+   */
+  resolvedAt?: string | null;
+  /**
+   * Session number in which the finding was resolved.
+   */
+  resolvedInSession?: number | null;
+  /**
+   * New lifecycle status.
+   */
+  status?: TaskRunFindingStatus | null;
+  /**
+   * User response, if the finding needed input.
+   */
+  userResponse?: string | null;
+}

package/src/generated/TaskRunFindingsListResponse.d.ts

@@ -0,0 +1,24 @@
+/* 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';
+import type { TaskRunFindingSummary } from './TaskRunFindingSummary';
+
+/**
+ * Response for `GET /task-runs/{id}/findings`.
+ */
+export interface TaskRunFindingsListResponse {
+  /**
+   * Findings for the task run.
+   */
+  findings: TaskRunFinding[];
+  summary: TaskRunFindingSummary;
+}

package/src/generated/TaskRunListResponse.d.ts

@@ -0,0 +1,21 @@
+/* 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 { Pagination } from './Pagination';
+import type { TaskRunBackend } from './TaskRunBackend';
+import type { TaskRunStatus } from './TaskRunStatus';
+
+/**
+ * Response for `GET /task-runs`.
+ */
+export interface TaskRunListResponse {
+  pagination: Pagination;
+  /**
+   * Page of matching task runs.
+   */
+  tasks: TaskRunBackend[];
+}

package/src/generated/TaskRunSession.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`.
+ */
+
+/**
+ * A single AI session within a task run.
+ */
+export interface TaskRunSession {
+  /**
+   * Duration of the session in seconds.
+   */
+  durationSeconds: number | null;
+  /**
+   * ISO 8601 timestamp when the session ended.
+   */
+  endedAt: string | null;
+  /**
+   * Unique identifier (UUID v4 string).
+   */
+  id: string;
+  /**
+   * Short summary of the session output, if stored.
+   */
+  outputSummary: string | null;
+  /**
+   * 1-based session index within the parent task run.
+   */
+  sessionNumber: number;
+  /**
+   * ISO 8601 timestamp when the session started.
+   */
+  startedAt: string;
+  /**
+   * Parent task run ID.
+   */
+  taskRunId: string;
+}

package/src/generated/TaskRunStatus.d.ts

@@ -0,0 +1,11 @@
+/* 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`.
+ */
+
+/**
+ * Lifecycle status of a task run.
+ */
+export type TaskRunStatus = "running" | "complete" | "failed" | "stopped";

package/src/generated/TaskRunUpdate.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 { TaskRunStatus } from './TaskRunStatus';
+
+/**
+ * Request payload for updating an existing task run. All fields are optional;
+ * only those supplied are applied.
+ */
+export interface TaskRunUpdate {
+  /**
+   * ISO 8601 timestamp when the task completed.
+   */
+  completedAt?: string | null;
+  /**
+   * Total duration in seconds.
+   */
+  durationSeconds?: number | null;
+  /**
+   * Error message to attach.
+   */
+  errorMessage?: string | null;
+  /**
+   * Full output log to persist.
+   */
+  fullOutput?: string | null;
+  /**
+   * Whether the full output log has been stored.
+   */
+  fullOutputStored?: boolean | null;
+  /**
+   * Updated output summary.
+   */
+  outputSummary?: string | null;
+  /**
+   * Updated session count.
+   */
+  sessionsCount?: number | null;
+  /**
+   * New lifecycle status.
+   */
+  status?: TaskRunStatus | null;
+}

package/src/generated/TaskType.d.ts

@@ -0,0 +1,11 @@
+/* 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`.
+ */
+
+/**
+ * Kind of task being tracked.
+ */
+export type TaskType = "task" | "automation" | "scheduled";

package/src/generated/TerminalExitEvent.d.ts

@@ -0,0 +1,26 @@
+/* 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`.
+ */
+
+/**
+ * Event payload emitted when a terminal process exits.
+ *
+ * Delivered over the Tauri `terminal-exit` channel and re-broadcast on the
+ * WebSocket relay. After this event fires the corresponding
+ * [`TerminalInfo::is_alive`] will be `false` and [`TerminalInfo::exit_code`]
+ * will carry the same value surfaced here.
+ */
+export interface TerminalExitEvent {
+  /**
+   * Exit code reported by the OS, or `None` if the status could not be
+   * captured (e.g., the wait call itself errored).
+   */
+  exitCode?: number | null;
+  /**
+   * ID of the terminal session that exited.
+   */
+  terminalId: string;
+}

package/src/generated/TerminalInfo.d.ts

@@ -0,0 +1,69 @@
+/* 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`.
+ */
+
+/**
+ * Information about a terminal session, returned to the frontend.
+ *
+ * Returned from the `terminal_create` and `terminal_list` Tauri commands
+ * and emitted as the payload of the `terminal-created` event. Derived
+ * fresh from the live `TerminalSession` each time — never persisted.
+ */
+export interface TerminalInfo {
+  /**
+   * Current terminal width in columns.
+   */
+  cols: number;
+  /**
+   * Unix timestamp in milliseconds when the session was created.
+   *
+   * Used as the sort key for `TerminalManager::list` so the UI shows
+   * terminals in creation order.
+   */
+  createdAt: number;
+  /**
+   * Process exit code, once the shell has exited.
+   */
+  exitCode?: number | null;
+  /**
+   * Unique session identifier (UUID v4 minted by the runner).
+   */
+  id: string;
+  /**
+   * Whether the shell process is still running.
+   */
+  isAlive: boolean;
+  /**
+   * Which terminal page this session belongs to (for multi-page support).
+   *
+   * Older wire forms without this field hydrate to `"default"` via
+   * [`default_page_id`].
+   */
+  pageId: string;
+  /**
+   * OS process ID of the spawned shell, if still known.
+   */
+  pid?: number | null;
+  /**
+   * Current terminal height in rows.
+   */
+  rows: number;
+  /**
+   * Human-readable title shown in the UI tab (e.g., "Terminal 1").
+   */
+  title: string;
+  /**
+   * Monotonic counter of all bytes ever produced by this PTY.
+   *
+   * Read by the frontend to detect missed output after a reconnect; the
+   * scrollback buffer's `start_offset` is derived from this counter.
+   */
+  totalBytesProduced: number;
+  /**
+   * Absolute working directory the shell was started in.
+   */
+  workingDir: string;
+}

package/src/generated/TerminalOutputEvent.d.ts

@@ -0,0 +1,29 @@
+/* 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`.
+ */
+
+/**
+ * Event payload emitted when a terminal produces output.
+ *
+ * Delivered over the Tauri `terminal-output` channel and re-broadcast on
+ * the WebSocket relay for remote/mobile consumers. The `data` payload is
+ * base64-encoded raw bytes because xterm.js needs raw bytes (PTY output
+ * can contain partial UTF-8 sequences that would corrupt a `String`
+ * field).
+ */
+export interface TerminalOutputEvent {
+  /**
+   * Base64-encoded bytes produced by the PTY.
+   *
+   * Raw bytes are required (not UTF-8 text) because PTY output can
+   * contain partial UTF-8 sequences that span read boundaries.
+   */
+  data: string;
+  /**
+   * ID of the terminal session producing this output.
+   */
+  terminalId: string;
+}

package/src/generated/TestType.d.ts

@@ -0,0 +1,11 @@
+/* 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`.
+ */
+
+/**
+ * Test-runner kinds surfaced by `CommandStep` when `mode = "test"`.
+ */
+export type TestType = "playwright" | "qontinui_vision" | "python" | "repository" | "custom_command";

package/src/generated/TextMatchType.d.ts

@@ -0,0 +1,11 @@
+/* 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`.
+ */
+
+/**
+ * Text-match comparison mode.
+ */
+export type TextMatchType = "EXACT" | "CONTAINS" | "STARTS_WITH" | "ENDS_WITH" | "REGEX" | "FUZZY";

package/src/generated/TextSearchOptions.d.ts

@@ -0,0 +1,30 @@
+/* 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 { OcrEngine } from './OcrEngine';
+import type { TextMatchType } from './TextMatchType';
+
+/**
+ * Text search options for OCR-based finding.
+ */
+export interface TextSearchOptions {
+  blacklistChars?: string | null;
+  caseSensitive?: boolean | null;
+  confidenceThreshold?: number | null;
+  editDistance?: number | null;
+  fuzzyThreshold?: number | null;
+  ignoreWhitespace?: boolean | null;
+  language?: string | null;
+  matchType?: TextMatchType | null;
+  normalizeUnicode?: boolean | null;
+  ocrEngine?: OcrEngine | null;
+  oemMode?: number | null;
+  preprocessing?: string[] | null;
+  psmMode?: number | null;
+  scaleFactor?: number | null;
+  whitelistChars?: string | null;
+}