@qontinui/shared-types 0.2.1

package/src/generated/ExecutionRunComplete.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 { CoverageData } from './CoverageData';
+import type { ExecutionStats } from './ExecutionStats';
+import type { RunStatus } from './RunStatus';
+
+/**
+ * Request payload for marking a run complete.
+ */
+export interface ExecutionRunComplete {
+  /**
+   * Coverage data, if the run executed a workflow.
+   */
+  coverage?: CoverageData | null;
+  /**
+   * ISO 8601 timestamp when the run ended.
+   */
+  endedAt: string;
+  /**
+   * Error message if the run failed.
+   */
+  errorMessage?: string | null;
+  stats: ExecutionStats;
+  status: RunStatus;
+  /**
+   * Free-form run summary.
+   */
+  summary?: string | null;
+}

package/src/generated/ExecutionRunCompleteResponse.d.ts

@@ -0,0 +1,38 @@
+/* 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 { CoverageData } from './CoverageData';
+import type { ExecutionStats } from './ExecutionStats';
+import type { RunStatus } from './RunStatus';
+
+/**
+ * Response envelope returned after completing a run.
+ */
+export interface ExecutionRunCompleteResponse {
+  /**
+   * Coverage data, if the run executed a workflow.
+   */
+  coverage?: CoverageData | null;
+  /**
+   * Total duration in seconds.
+   */
+  durationSeconds: number;
+  /**
+   * ISO 8601 timestamp when the run ended.
+   */
+  endedAt: string;
+  /**
+   * Associated run ID.
+   */
+  runId: string;
+  /**
+   * ISO 8601 timestamp when the run started.
+   */
+  startedAt: string;
+  stats: ExecutionStats;
+  status: RunStatus;
+}

package/src/generated/ExecutionRunCreate.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 { RunType } from './RunType';
+import type { RunnerMetadata } from './RunnerMetadata';
+import type { WorkflowMetadata } from './WorkflowMetadata';
+
+/**
+ * Request payload for creating a new execution run.
+ */
+export interface ExecutionRunCreate {
+  /**
+   * Run configuration bag (opaque to this layer).
+   */
+  configuration?: {
+    [k: string]: unknown;
+  } | null;
+  /**
+   * Optional free-form description.
+   */
+  description?: string | null;
+  /**
+   * Owning project ID.
+   */
+  projectId: string;
+  /**
+   * Human-readable run name.
+   */
+  runName: string;
+  runType: RunType;
+  runnerMetadata: RunnerMetadata;
+  /**
+   * Workflow metadata, if the run executes a workflow.
+   */
+  workflowMetadata?: WorkflowMetadata | null;
+}

package/src/generated/ExecutionRunDetail.d.ts

@@ -0,0 +1,76 @@
+/* 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 { CoverageData } from './CoverageData';
+import type { ExecutionStats } from './ExecutionStats';
+import type { RunStatus } from './RunStatus';
+import type { RunType } from './RunType';
+import type { RunnerMetadata } from './RunnerMetadata';
+import type { WorkflowMetadata } from './WorkflowMetadata';
+
+/**
+ * Detailed execution run information (superset of [`ExecutionRunResponse`]).
+ *
+ * Python models this via inheritance; here all fields are inlined because Rust
+ * has no inheritance and the wire form is a flat object.
+ */
+export interface ExecutionRunDetail {
+  /**
+   * Configuration snapshot captured at run start.
+   */
+  configuration?: {
+    [k: string]: unknown;
+  };
+  /**
+   * Coverage data, if applicable.
+   */
+  coverage?: CoverageData | null;
+  /**
+   * ISO 8601 timestamp when the record was created.
+   */
+  createdAt: string;
+  /**
+   * Run description.
+   */
+  description?: string | null;
+  /**
+   * Total duration in seconds, if the run has ended.
+   */
+  durationSeconds?: number | null;
+  /**
+   * ISO 8601 timestamp when the run ended, if it has ended.
+   */
+  endedAt?: string | null;
+  /**
+   * Owning project ID.
+   */
+  projectId: string;
+  /**
+   * Assigned run identifier.
+   */
+  runId: string;
+  /**
+   * Human-readable run name.
+   */
+  runName: string;
+  runType: RunType;
+  runnerMetadata: RunnerMetadata;
+  /**
+   * ISO 8601 timestamp when the run started.
+   */
+  startedAt: string;
+  stats: ExecutionStats;
+  status: RunStatus;
+  /**
+   * ISO 8601 timestamp when the record was last updated.
+   */
+  updatedAt?: string | null;
+  /**
+   * Workflow metadata, if applicable.
+   */
+  workflowMetadata?: WorkflowMetadata | null;
+}

package/src/generated/ExecutionRunListResponse.d.ts

@@ -0,0 +1,22 @@
+/* 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 { ExecutionRunResponse } from './ExecutionRunResponse';
+import type { Pagination } from './Pagination';
+import type { RunStatus } from './RunStatus';
+import type { RunType } from './RunType';
+
+/**
+ * Paginated list of execution runs.
+ */
+export interface ExecutionRunListResponse {
+  pagination: Pagination;
+  /**
+   * Page of matching runs.
+   */
+  runs: ExecutionRunResponse[];
+}

package/src/generated/ExecutionRunResponse.d.ts

@@ -0,0 +1,41 @@
+/* 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 { RunStatus } from './RunStatus';
+import type { RunType } from './RunType';
+
+/**
+ * Response envelope returned when a run is created or fetched.
+ */
+export interface ExecutionRunResponse {
+  /**
+   * Total duration in seconds, if the run has ended.
+   */
+  durationSeconds?: number | null;
+  /**
+   * ISO 8601 timestamp when the run ended, if it has ended.
+   */
+  endedAt?: string | null;
+  /**
+   * Owning project ID.
+   */
+  projectId: string;
+  /**
+   * Assigned run identifier.
+   */
+  runId: string;
+  /**
+   * Human-readable run name.
+   */
+  runName: string;
+  runType: RunType;
+  /**
+   * ISO 8601 timestamp when the run started.
+   */
+  startedAt: string;
+  status: RunStatus;
+}

package/src/generated/ExecutionScreenshotCreate.d.ts

@@ -0,0 +1,59 @@
+/* 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 { ScreenshotAnnotation } from './ScreenshotAnnotation';
+import type { ScreenshotAnnotationShape } from './ScreenshotAnnotationShape';
+import type { ScreenshotType } from './ScreenshotType';
+
+/**
+ * Request payload describing a screenshot being uploaded.
+ */
+export interface ExecutionScreenshotCreate {
+  /**
+   * Sequence number of the associated action, if any.
+   */
+  actionSequenceNumber?: number | null;
+  /**
+   * IDs of states active when the screenshot was taken.
+   */
+  activeStates?: string[] | null;
+  /**
+   * Overlaid annotations.
+   */
+  annotations?: ScreenshotAnnotation[] | null;
+  /**
+   * Image height in pixels.
+   */
+  height: number;
+  /**
+   * Opaque additional metadata.
+   */
+  metadata?: {
+    [k: string]: unknown;
+  } | null;
+  /**
+   * Client-generated screenshot identifier.
+   */
+  screenshotId: string;
+  screenshotType: ScreenshotType;
+  /**
+   * Sequence number of the screenshot within the run.
+   */
+  sequenceNumber: number;
+  /**
+   * State ID active when the screenshot was taken.
+   */
+  state?: string | null;
+  /**
+   * ISO 8601 timestamp when the screenshot was taken.
+   */
+  timestamp: string;
+  /**
+   * Image width in pixels.
+   */
+  width: number;
+}

package/src/generated/ExecutionScreenshotResponse.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`.
+ */
+
+/**
+ * Response envelope returned after uploading a screenshot.
+ */
+export interface ExecutionScreenshotResponse {
+  /**
+   * File size in bytes.
+   */
+  fileSizeBytes: number;
+  /**
+   * URL to the full-size image.
+   */
+  imageUrl: string;
+  /**
+   * Associated run ID.
+   */
+  runId: string;
+  /**
+   * Assigned screenshot identifier.
+   */
+  screenshotId: string;
+  /**
+   * URL to a thumbnail image, if generated.
+   */
+  thumbnailUrl?: string | null;
+  /**
+   * ISO 8601 timestamp when the image was uploaded.
+   */
+  uploadedAt: string;
+}

package/src/generated/ExecutionStats.d.ts

@@ -0,0 +1,56 @@
+/* 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`.
+ */
+
+/**
+ * Aggregate execution statistics for a completed run.
+ */
+export interface ExecutionStats {
+  /**
+   * Mean per-action duration, in milliseconds.
+   */
+  avgActionDurationMs?: number | null;
+  /**
+   * Number of actions with [`ActionStatus::Failed`].
+   */
+  failedActions: number;
+  /**
+   * Number of actions that used an LLM.
+   */
+  llmActionCount?: number | null;
+  /**
+   * Number of actions with [`ActionStatus::Skipped`].
+   */
+  skippedActions: number;
+  /**
+   * Number of actions with [`ActionStatus::Success`].
+   */
+  successfulActions: number;
+  /**
+   * Number of actions with [`ActionStatus::Timeout`].
+   */
+  timeoutActions: number;
+  /**
+   * Total number of actions executed.
+   */
+  totalActions: number;
+  /**
+   * Aggregate estimated cost in USD across all LLM actions.
+   */
+  totalCostUsd?: number | null;
+  /**
+   * Sum of all action durations, in milliseconds.
+   */
+  totalDurationMs: number;
+  /**
+   * Aggregate input tokens across all LLM actions.
+   */
+  totalTokensInput?: number | null;
+  /**
+   * Aggregate output tokens across all LLM actions.
+   */
+  totalTokensOutput?: number | null;
+}

package/src/generated/ExecutionStep.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`.
+ */
+
+/**
+ * A single step in an AI Builder execution sequence.
+ *
+ * This is the **legacy step shape** persisted in `ai_workflows.json`. It
+ * carries fields for every step flavour (`workflow`, `state`, `playwright`,
+ * `prompt`, `action`, `screenshot`) as optional branches. Steps that don't
+ * apply to the given `step_type` have their branch fields set to `None`.
+ */
+export interface ExecutionStep {
+  /**
+   * For action steps: the action type (`"click"`, `"double_click"`,
+   * `"right_click"`).
+   */
+  actionType?: string | null;
+  /**
+   * Unique identifier for this step.
+   */
+  id: string;
+  /**
+   * Display name for the step.
+   */
+  name: string;
+  /**
+   * For playwright steps: the script content.
+   */
+  playwrightScriptContent?: string | null;
+  /**
+   * For playwright steps: the script ID.
+   */
+  playwrightScriptId?: string | null;
+  /**
+   * For playwright steps: the target URL.
+   */
+  playwrightTargetUrl?: string | null;
+  /**
+   * For prompt steps: the actual prompt content.
+   */
+  promptContent?: string | null;
+  /**
+   * For prompt steps: the prompt ID from the library.
+   */
+  promptId?: string | null;
+  /**
+   * Delay in seconds before taking screenshot (default 0).
+   */
+  screenshotDelay?: number | null;
+  /**
+   * Monitor for screenshot capture (number for specific monitor, `"all"`
+   * for all monitors).
+   */
+  screenshotMonitor?: {
+    [k: string]: unknown;
+  };
+  /**
+   * Whether to capture a screenshot after this step.
+   */
+  takeScreenshot?: boolean;
+  /**
+   * For action steps: the target image ID.
+   */
+  targetImageId?: string | null;
+  /**
+   * For action steps: the target image name (for display).
+   */
+  targetImageName?: string | null;
+  /**
+   * Type of step: `"workflow"`, `"state"`, `"playwright"`, `"prompt"`,
+   * `"action"`, or `"screenshot"`.
+   */
+  type: string;
+}

package/src/generated/ExecutionTreeResponse.d.ts

@@ -0,0 +1,42 @@
+/* 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 { DisplayNode } from './DisplayNode';
+import type { MatchLocation } from './MatchLocation';
+import type { NodeMetadata } from './NodeMetadata';
+import type { NodeStatus } from './NodeStatus';
+import type { NodeType } from './NodeType';
+import type { Outcome } from './Outcome';
+import type { RuntimeData } from './RuntimeData';
+import type { StateContext } from './StateContext';
+import type { TimingInfo } from './TimingInfo';
+import type { TopMatch } from './TopMatch';
+
+/**
+ * Full execution tree reconstructed from events.
+ */
+export interface ExecutionTreeResponse {
+  durationMs?: number | null;
+  /**
+   * Initial active states when the workflow started.
+   */
+  initialStateIds: string[];
+  rootNodes: DisplayNode[];
+  /**
+   * Run UUID as string.
+   */
+  runId: string;
+  /**
+   * Mapping of state IDs to display names.
+   */
+  stateNameMap: {
+    [k: string]: string;
+  };
+  status: NodeStatus;
+  totalEvents: number;
+  workflowName?: string | null;
+}

package/src/generated/ExecutionTrendDataPoint.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`.
+ */
+
+/**
+ * Single data point in an execution-trend time series.
+ */
+export interface ExecutionTrendDataPoint {
+  /**
+   * Mean run duration in seconds.
+   */
+  avgDurationSeconds: number;
+  /**
+   * Period label in `YYYY-MM-DD` format.
+   */
+  date: string;
+  /**
+   * Issues detected in the period.
+   */
+  issuesCount: number;
+  /**
+   * Number of runs in the period.
+   */
+  runsCount: number;
+  /**
+   * Success rate as a percentage.
+   */
+  successRate: number;
+  /**
+   * Total actions executed in the period.
+   */
+  totalActions: number;
+}

package/src/generated/ExecutionTrendResponse.d.ts

@@ -0,0 +1,46 @@
+/* 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 { ExecutionTrendDataPoint } from './ExecutionTrendDataPoint';
+import type { RunType } from './RunType';
+
+/**
+ * Response envelope for the execution-trend analytics endpoint.
+ */
+export interface ExecutionTrendResponse {
+  /**
+   * Trend data points.
+   */
+  dataPoints: ExecutionTrendDataPoint[];
+  /**
+   * End date of the reporting window.
+   */
+  endDate: string;
+  /**
+   * Granularity label (`"daily"`, `"weekly"`, `"monthly"`).
+   */
+  granularity: string;
+  /**
+   * Overall statistics computed over the full window. Shape is
+   * intentionally opaque (`dict[str, Any]` in Python).
+   */
+  overallStats?: {
+    [k: string]: unknown;
+  };
+  /**
+   * Project the trend was computed for.
+   */
+  projectId: string;
+  /**
+   * Run type filter, if applied.
+   */
+  runType?: RunType | null;
+  /**
+   * Start date of the reporting window.
+   */
+  startDate: string;
+}

package/src/generated/ExitCheckResult.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`.
+ */
+
+/**
+ * Result of evaluating whether the loop should exit.
+ */
+export interface ExitCheckResult {
+  /**
+   * Human-readable reason for the decision.
+   */
+  reason: string;
+  /**
+   * Whether the loop should stop after this iteration.
+   */
+  shouldExit: boolean;
+}

package/src/generated/ExitStrategy.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`.
+ */
+
+/**
+ * How to evaluate whether the loop should exit.
+ */
+export type ExitStrategy =
+  | {
+      type: "reflection";
+      [k: string]: unknown;
+    }
+  | {
+      type: "workflow_verification";
+      [k: string]: unknown;
+    }
+  | {
+      type: "fixed_iterations";
+      [k: string]: unknown;
+    }
+  | {
+      type: "diagnostic_evaluation";
+      [k: string]: unknown;
+    };

package/src/generated/ExportResult.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`.
+ */
+
+/**
+ * Result from the export pipeline.
+ *
+ * Tracks what was exported and any errors that occurred.
+ * Mirrors `rag.models.ExportResult`.
+ */
+export interface ExportResult {
+  errors: string[];
+  export_path: string;
+  /**
+   * ISO 8601 UTC timestamp (`Z` suffix).
+   */
+  export_timestamp?: string | null;
+  exported_count: number;
+  failed_count: number;
+  /**
+   * `"json"`, `"csv"`, `"parquet"`, etc.
+   */
+  format: string;
+  skipped_count: number;
+  success: boolean;
+  warnings: string[];
+}