@qontinui/shared-types 0.2.1

package/src/generated/RunPromptRequest.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`.
+ */
+
+/**
+ * Request body for the runner's `run_prompt` endpoint.
+ */
+export interface RunPromptRequest {
+  /**
+   * Prompt content (the actual text sent to the AI).
+   */
+  content: string;
+  /**
+   * Optional free-form context string appended to the prompt.
+   */
+  context?: string | null;
+  /**
+   * Display-only version of the prompt (shown in the UI).
+   */
+  displayPrompt?: string | null;
+  /**
+   * Attached image paths.
+   */
+  imagePaths?: string[] | null;
+  /**
+   * Optional cap on AI sessions.
+   */
+  maxSessions?: number | null;
+  /**
+   * Cap on trace screenshots to include.
+   */
+  maxTraceScreenshots?: number | null;
+  /**
+   * Cap on video frames to extract for the prompt.
+   */
+  maxVideoFrames?: number | null;
+  /**
+   * Display name for the task.
+   */
+  name: string;
+  /**
+   * Hard timeout in seconds.
+   */
+  timeoutSeconds?: number | null;
+  /**
+   * Optional path to a trace file.
+   */
+  tracePath?: string | null;
+  /**
+   * Attached video paths.
+   */
+  videoPaths?: string[] | null;
+}

package/src/generated/RunPromptResponse.d.ts

@@ -0,0 +1,50 @@
+/* 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 { RunPromptResponseData } from './RunPromptResponseData';
+
+/**
+ * Response from the runner's `run_prompt` endpoint.
+ */
+export interface RunPromptResponse {
+  /**
+   * Structured data payload from a synchronous prompt run.
+   */
+  data?: RunPromptResponseData | null;
+  /**
+   * Error message if the call failed.
+   */
+  error?: string | null;
+  /**
+   * Path to the log file for the session.
+   */
+  logFile?: string | null;
+  /**
+   * Immediate output if the call ran synchronously.
+   */
+  output?: string | null;
+  /**
+   * OS process ID of the spawned AI session, if any.
+   */
+  pid?: number | null;
+  /**
+   * ID of the created AI session, if any.
+   */
+  sessionId?: string | null;
+  /**
+   * Path to the state file tracking the session.
+   */
+  stateFile?: string | null;
+  /**
+   * Whether the prompt was accepted and started successfully.
+   */
+  success: boolean;
+  /**
+   * ID of the created task run, if any.
+   */
+  taskRunId?: string | null;
+}

package/src/generated/RunPromptResponseData.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`.
+ */
+
+/**
+ * Inline `data` payload on a [`RunPromptResponse`].
+ */
+export interface RunPromptResponseData {
+  /**
+   * AI output text.
+   */
+  output?: string | null;
+  /**
+   * Final response text.
+   */
+  response?: string | null;
+}

package/src/generated/RunStatus.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 an execution run.
+ */
+export type RunStatus = "pending" | "running" | "completed" | "failed" | "timeout" | "cancelled" | "paused";

package/src/generated/RunType.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 execution run being reported.
+ */
+export type RunType = "qa_test" | "integration_test" | "live_automation" | "recording" | "debug";

package/src/generated/Runner.d.ts

@@ -0,0 +1,81 @@
+/* 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 { RunnerCrash } from './RunnerCrash';
+import type { RunnerStatus } from './RunnerStatus';
+import type { RunnerUiError } from './RunnerUiError';
+
+/**
+ * Canonical runner entity. One row per registered runner; the same shape is
+ * served to every consumer (mobile, web, runner UI).
+ *
+ * Replaces the prior split between `runners` (fleet/heartbeat),
+ * `runner_connections` (transient WS sessions), and per-consumer projection
+ * types like `RunnerConnection` / `ServerRunner` / `RegisteredRunner` /
+ * `WebIntegrationStatus`.
+ */
+export interface Runner {
+  /**
+   * Free-form capability tags advertised by the runner
+   * (e.g., `["python", "playwright", "vision"]`).
+   */
+  capabilities: string[];
+  /**
+   * ISO 8601 timestamp when the runner was first registered.
+   */
+  createdAt: string;
+  derivedStatus: RunnerStatus;
+  /**
+   * Reported hostname of the machine the runner is running on.
+   */
+  hostname?: string | null;
+  /**
+   * Runner identifier (UUID as a string).
+   */
+  id: string;
+  /**
+   * Reported network address the runner is reachable on.
+   */
+  ipAddress?: string | null;
+  /**
+   * ISO 8601 timestamp of the most recent heartbeat received from the
+   * runner, if any.
+   */
+  lastHeartbeat?: string | null;
+  /**
+   * Human-readable runner name.
+   */
+  name: string;
+  /**
+   * Operating system identifier (e.g., `"windows"`, `"macos"`, `"linux"`).
+   */
+  os?: string | null;
+  /**
+   * Operating system version string.
+   */
+  osVersion?: string | null;
+  /**
+   * Reported port the runner's HTTP API is listening on.
+   */
+  port?: number | null;
+  /**
+   * Most recently captured crash dump metadata, if any.
+   */
+  recentCrash?: RunnerCrash | null;
+  /**
+   * Most recently reported structured UI error, if any.
+   */
+  uiError?: RunnerUiError | null;
+  /**
+   * Owning user identifier (UUID as a string).
+   */
+  userId: string;
+  /**
+   * Whether the server currently holds an open WebSocket from the runner.
+   */
+  wsConnected: boolean;
+}

package/src/generated/RunnerCrash.d.ts

@@ -0,0 +1,32 @@
+/* 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`.
+ */
+
+/**
+ * Most recent crash dump metadata, if any.
+ */
+export interface RunnerCrash {
+  /**
+   * Path to the crash dump file on disk.
+   */
+  filePath: string;
+  /**
+   * Source location (file/line) where the panic originated.
+   */
+  panicLocation: string;
+  /**
+   * Panic message captured from the runner process.
+   */
+  panicMessage: string;
+  /**
+   * ISO 8601 timestamp when the crash was reported.
+   */
+  reportedAt: string;
+  /**
+   * Name of the thread that panicked.
+   */
+  thread: string;
+}

package/src/generated/RunnerMetadata.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`.
+ */
+
+/**
+ * Information about the runner environment that produced the run.
+ */
+export interface RunnerMetadata {
+  /**
+   * CPU description.
+   */
+  cpuInfo?: string | null;
+  /**
+   * Arbitrary additional runner context.
+   */
+  extra?: {
+    [k: string]: unknown;
+  } | null;
+  /**
+   * Host machine name.
+   */
+  hostname: string;
+  /**
+   * Installed system memory in megabytes.
+   */
+  memoryMb?: number | null;
+  /**
+   * Operating system identifier (e.g., `"windows"`, `"macos"`, `"linux"`).
+   */
+  os: string;
+  /**
+   * Semantic version of the runner binary.
+   */
+  runnerVersion: string;
+  /**
+   * Screen resolution as a free-form string (e.g., `"1920x1080"`).
+   */
+  screenResolution?: string | null;
+}

package/src/generated/RunnerStatus.d.ts

@@ -0,0 +1,12 @@
+/* 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`.
+ */
+
+/**
+ * Health/availability state of a runner, computed server-side from the
+ * WebSocket-presence and heartbeat-freshness signals.
+ */
+export type RunnerStatus = "healthy" | "degraded" | "offline" | "starting" | "errored";

package/src/generated/RunnerUiError.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`.
+ */
+
+/**
+ * Structured error reported by the runner that the UI surfaces verbatim.
+ */
+export interface RunnerUiError {
+  /**
+   * Optional long-form detail (stack trace, stderr, etc.).
+   */
+  detail?: string | null;
+  /**
+   * Error category (e.g., `"build_failed"`, `"port_conflict"`).
+   */
+  kind: string;
+  /**
+   * Short, user-facing error message.
+   */
+  message: string;
+  /**
+   * ISO 8601 timestamp when the error was reported.
+   */
+  reportedAt: string;
+}

package/src/generated/RuntimeData.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 { MatchLocation } from './MatchLocation';
+import type { TopMatch } from './TopMatch';
+
+/**
+ * Runtime execution data captured during action execution.
+ *
+ * Different fields are populated depending on the action type. All fields
+ * are optional; the wire schema allows additional runtime fields via a
+ * `flatten`-d map.
+ */
+export interface RuntimeData {
+  alreadyAtTarget?: boolean | null;
+  branchTaken?: string | null;
+  button?: string | null;
+  characterCount?: number | null;
+  clickedAt?: MatchLocation | null;
+  conditionPassed?: boolean | null;
+  confidence?: number | null;
+  dimensions?: MatchLocation | null;
+  found?: boolean | null;
+  imageId?: string | null;
+  location?: MatchLocation | null;
+  matchMethod?: string | null;
+  sourceStates?: string[] | null;
+  targetStates?: string[] | null;
+  targetType?: string | null;
+  targetsReached?: string[] | null;
+  topMatches?: TopMatch[] | null;
+  transitionsExecuted?: string[] | null;
+  typedText?: string | null;
+  workflowName?: string | null;
+  workflowStatus?: string | null;
+}

package/src/generated/SaveWorkflowArtifactStep.d.ts

@@ -0,0 +1,80 @@
+/* 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 { RetrySpec } from './RetrySpec';
+import type { VerificationCategoryKind } from './VerificationCategoryKind';
+
+/**
+ * Read a generated workflow JSON file and save it to the database.
+ *
+ * Wire tag: `"save_workflow_artifact"`.
+ */
+export interface SaveWorkflowArtifactStep {
+  /**
+   * When `true`, also creates a `PipelineArtifact` from the artifact directory.
+   */
+  artifactCapturePrompts?: boolean | null;
+  /**
+   * Path to the workflow JSON file to save.
+   */
+  artifactInputPath?: string | null;
+  /**
+   * Acceptance criterion IDs verified by this step.
+   */
+  criterionIds?: string[];
+  /**
+   * IDs of other steps that must complete first.
+   */
+  dependsOn?: string[];
+  /**
+   * Extractions published to subsequent steps.
+   */
+  extract?: {
+    [k: string]: string;
+  };
+  /**
+   * If `Some(true)`, a console-error signal from the UI fails this step.
+   */
+  failOnConsoleErrors?: boolean | null;
+  /**
+   * Unique identifier for the step.
+   */
+  id: string;
+  /**
+   * Named input bindings evaluated at step entry.
+   */
+  inputs?: {
+    [k: string]: string;
+  };
+  /**
+   * Display name for the step.
+   */
+  name: string;
+  /**
+   * Whether this step is required (default: `true` on consumer side).
+   */
+  required?: boolean | null;
+  /**
+   * Per-step retry configuration.
+   */
+  retry?: RetrySpec | null;
+  /**
+   * Provenance of this step when generated from a skill template.
+   *
+   * Typed as `serde_json::Value` here to avoid pulling the `skill`
+   * dependency chain into this module; the TS side re-imports the typed
+   * `SkillOrigin` after regeneration.
+   */
+  skillOrigin?: {
+    [k: string]: unknown;
+  };
+  /**
+   * Verification depth category.
+   */
+  verificationCategory?: VerificationCategoryKind | null;
+  [k: string]: unknown;
+}

package/src/generated/ScheduleConditions.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`.
+ */
+
+import type { IdleCondition } from './IdleCondition';
+import type { RepositoryInactiveCondition } from './RepositoryInactiveCondition';
+import type { RepositoryWatch } from './RepositoryWatch';
+
+/**
+ * Conditions that must ALL be met before task execution.
+ */
+export interface ScheduleConditions {
+  /**
+   * Require the runner to be idle.
+   */
+  requireIdle?: IdleCondition | null;
+  /**
+   * Require repository file inactivity across one or more paths.
+   */
+  requireRepoInactive?: RepositoryInactiveCondition | null;
+  /**
+   * Maximum time to wait for conditions (minutes). `None` = wait
+   * indefinitely.
+   */
+  timeoutMinutes?: number | null;
+}

package/src/generated/ScheduleExpression.d.ts

@@ -0,0 +1,39 @@
+/* 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 { ConditionScheduleConfig } from './ConditionScheduleConfig';
+
+/**
+ * How a task should be scheduled.
+ *
+ * Serialized with the external tag `type` and payload under `value` so that
+ * `Once("...")`, `Cron("...")`, and `Interval(60)` round-trip as
+ * `{ "type": "Once", "value": "..." }` etc. The `Condition` variant wraps a
+ * [`ConditionScheduleConfig`] rather than a scalar, but uses the same
+ * `{ type, value }` envelope.
+ */
+export type ScheduleExpression =
+  | {
+      type: "Once";
+      value: string;
+      [k: string]: unknown;
+    }
+  | {
+      type: "Cron";
+      value: string;
+      [k: string]: unknown;
+    }
+  | {
+      type: "Interval";
+      value: number;
+      [k: string]: unknown;
+    }
+  | {
+      type: "Condition";
+      value: ConditionScheduleConfig;
+      [k: string]: unknown;
+    };

package/src/generated/ScheduledTask.d.ts

@@ -0,0 +1,104 @@
+/* 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 { CatchUpPolicy } from './CatchUpPolicy';
+import type { ConditionScheduleConfig } from './ConditionScheduleConfig';
+import type { ConditionStatus } from './ConditionStatus';
+import type { IdleCondition } from './IdleCondition';
+import type { McpConnectionRef } from './McpConnectionRef';
+import type { RepositoryInactiveCondition } from './RepositoryInactiveCondition';
+import type { RepositoryWatch } from './RepositoryWatch';
+import type { ScheduleConditions } from './ScheduleConditions';
+import type { ScheduleExpression } from './ScheduleExpression';
+import type { ScheduledTaskStatus } from './ScheduledTaskStatus';
+import type { ScheduledTaskType } from './ScheduledTaskType';
+import type { TaskExecutionRecord } from './TaskExecutionRecord';
+
+/**
+ * A scheduled task definition — the full persisted frame, including computed
+ * fields (`last_run`, `next_run`) and condition-evaluation state
+ * (`conditions`, `condition_status`).
+ */
+export interface ScheduledTask {
+  /**
+   * Automatically trigger auto-fix when this task fails.
+   */
+  autoFixOnFailure: boolean;
+  /**
+   * Slots within this number of seconds of "now" are not treated as
+   * missed (the normal scheduler will pick them up). Default 300s.
+   */
+  catchUpGraceSeconds: number;
+  /**
+   * Catch-up policy applied when the runner restarts after missing one
+   * or more scheduled slots.
+   */
+  catchUpPolicy?: CatchUpPolicy & string;
+  /**
+   * Present while the task is waiting for its conditions to be met.
+   */
+  conditionStatus?: ConditionStatus | null;
+  /**
+   * Optional conditions that must be met before execution.
+   */
+  conditions?: ScheduleConditions | null;
+  /**
+   * Number of consecutive launch failures since the task last started
+   * successfully. Drives exponential backoff. Reset to 0 on the next
+   * successful launch.
+   */
+  consecutiveLaunchFailures: number;
+  /**
+   * ISO 8601 timestamp of creation.
+   */
+  createdAt: string;
+  /**
+   * Optional human-readable description.
+   */
+  description?: string | null;
+  /**
+   * Whether the task is enabled and eligible to run.
+   */
+  enabled: boolean;
+  /**
+   * Unique identifier (UUID v4 string).
+   */
+  id: string;
+  /**
+   * Record of the most recent execution.
+   */
+  lastRun?: TaskExecutionRecord | null;
+  /**
+   * **Base** backoff in seconds for launch failures (not the current
+   * accumulated backoff). The runner computes the effective delay as
+   * `min(base * 2^(consecutive_launch_failures - 1), 86400)`.
+   * Default 60s.
+   */
+  launchFailureBackoffSeconds: number;
+  /**
+   * ISO 8601 timestamp of last modification.
+   */
+  modifiedAt: string;
+  /**
+   * Display name for the task.
+   */
+  name: string;
+  /**
+   * Next scheduled run time (ISO 8601), computed by the runner.
+   */
+  nextRun?: string | null;
+  schedule: ScheduleExpression;
+  /**
+   * Skip future runs once the task has succeeded at least once.
+   */
+  skipIfCompleted: boolean;
+  /**
+   * Free-form description of success criteria, for human reference.
+   */
+  successCriteria?: string | null;
+  task: ScheduledTaskType;
+}

package/src/generated/ScheduledTaskStatus.d.ts

@@ -0,0 +1,19 @@
+/* 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 scheduled task execution.
+ */
+export type ScheduledTaskStatus =
+  | "pending"
+  | "running"
+  | "completed"
+  | "failed"
+  | "launch_failed"
+  | "skipped"
+  | "cancelled"
+  | "missed_runner_down";