@qontinui/shared-types 0.8.1 → 0.12.0

package/src/generated/ComponentActionInfo.d.ts

@@ -13,6 +13,19 @@ export interface ComponentActionInfo {
    * Longer description of what the action does.
    */
   description?: string | null;
+  /**
+   * Safety class of this action: `read`, `write` or `destructive`.
+   *
+   * **A safety annotation, not a hint.** An autonomous walk MUST NOT fire an
+   * action annotated `destructive`; that is the same exclusion the IR already
+   * applies to `destructive` transitions when generating auto-regressions.
+   * Author-declared, because only the app author knows that a particular
+   * `click` is a delete button.
+   *
+   * Absent means **unclassified, not safe** — an action nobody has judged
+   * must be treated as unknown rather than as `read`.
+   */
+  effect?: ("read" | "write" | "destructive") | null;
   /**
    * Unique action identifier within the component.
    */
@@ -21,4 +34,24 @@ export interface ComponentActionInfo {
    * Human-readable label.
    */
   label?: string | null;
+  /**
+   * Free-form declaration of the action's parameters, author-supplied on the
+   * SDK side as `ComponentAction.paramSchema` and surfaced verbatim on
+   * `/control/components`. Conventionally a small JSON Schema subset, but the
+   * SDK does not constrain the shape, so it is carried through untyped — the
+   * same treatment `ElementActionRequest::params` gets.
+   */
+  paramSchema?: {
+    [k: string]: unknown;
+  };
+  /**
+   * Fully-resolved invocation path for this action:
+   * `/control/component/<componentId>/action/<actionId>`.
+   *
+   * **Server-annotated, not author-declared**: the SDK's
+   * `annotateComponentWithInvocationPaths` computes it when serving the
+   * component listing, so it is present on the wire but absent from anything
+   * an app author writes.
+   */
+  path?: string | null;
 }

package/src/generated/ElementState.d.ts

@@ -15,12 +15,38 @@ import type { ElementRect } from "./ElementRect";
  * visibility, interactivity, and form-control value.
  */
 export interface ElementState {
+  /**
+   * Whether the element carries `aria-disabled="true"`.
+   *
+   * See `disabled` for why this is tracked separately, and for the
+   * absent-reads-as-`false` caveat that applies identically here.
+   */
+  ariaDisabled: boolean;
   /**
    * Current checked state for checkbox/radio elements.
    */
   checked?: boolean | null;
   /**
-   * Whether the element is enabled (not disabled).
+   * Whether the element carries the native `disabled` attribute/property.
+   *
+   * Distinguished from `aria_disabled` because the two differ in effect:
+   * a natively disabled control cannot receive events at all, whereas an
+   * `aria-disabled` one is still focusable and clickable and merely
+   * announces itself as disabled.
+   *
+   * `#[serde(default)]`: absent in snapshots from SDK builds predating
+   * the split, where `enabled` is the only trustworthy signal. Absent
+   * therefore reads as `false`, which is NOT the same as "observed
+   * enabled": cross-check `enabled` before trusting it.
+   */
+  disabled: boolean;
+  /**
+   * Whether the element is enabled: the derived fold
+   * `!disabled && !ariaDisabled`.
+   *
+   * Kept as the single-signal convenience view of the two fields below.
+   * It is the ONLY interactivity signal an SDK build predating the
+   * `disabled`/`ariaDisabled` split emits, so it stays required.
    */
   enabled: boolean;
   /**

package/src/generated/GitCommitLite.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`.
+ */
+
+/**
+ * One commit in [`GitLite::last_commits`].
+ */
+export interface GitCommitLite {
+  /**
+   * Unix epoch milliseconds of the commit timestamp.
+   */
+  committedMs: number;
+  /**
+   * Abbreviated commit sha.
+   */
+  sha: string;
+  /**
+   * Commit subject line.
+   */
+  subject: string;
+}

package/src/generated/GitLite.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 { GitCommitLite } from "./GitCommitLite";
+
+/**
+ * Git state of the project root. `None` on the snapshot when the root is
+ * not a git working tree (or git is unavailable).
+ */
+export interface GitLite {
+  /**
+   * Current branch. `None` on a detached HEAD.
+   */
+  branch?: string | null;
+  /**
+   * Number of `git status --porcelain` entries (uncommitted changes).
+   */
+  dirtyCount: number;
+  /**
+   * Newest commits first.
+   */
+  lastCommits: GitCommitLite[];
+}

package/src/generated/HealthLevel.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`.
+ */
+
+/**
+ * Traffic-light level for [`HealthLite`].
+ */
+export type HealthLevel = "green" | "amber" | "red" | "unknown";

package/src/generated/HealthLite.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 { HealthLevel } from "./HealthLevel";
+
+/**
+ * One green/amber/red answer to "is it broken?", plus the plain-English
+ * reason behind it.
+ */
+export interface HealthLite {
+  /**
+   * Names of the processes driving an amber/red verdict.
+   */
+  failingProcesses: string[];
+  /**
+   * The traffic light.
+   */
+  level?: HealthLevel & string;
+  /**
+   * Why — a sentence a non-developer can read
+   * ("The website still starts up fine").
+   */
+  reason: string;
+}

package/src/generated/HelperAnswer.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 { HelperVerdict } from "./HelperVerdict";
+
+/**
+ * One helper's answer to a [`HelperTask`].
+ *
+ * The broker collects up to [`HelperTask::required_votes`] of these per task.
+ * On a 👎 [`HelperVerdict::Reject`], [`reasons`](HelperAnswer::reasons) carries
+ * the preset reason codes the helper selected from
+ * [`HelperAnswerSchema::preset_reasons`].
+ */
+export interface HelperAnswer {
+  /**
+   * ISO 8601 timestamp (UTC) when the answer was submitted.
+   */
+  createdAt: string;
+  /**
+   * Optional free-text note, when [`HelperAnswerSchema::allow_free_text`] is
+   * set.
+   */
+  freeText?: string | null;
+  /**
+   * The helper (user) who submitted the answer.
+   */
+  helperUserId: string;
+  /**
+   * Answer ID (UUID v4 string).
+   */
+  id: string;
+  /**
+   * Preset reason codes selected on a reject — drawn from
+   * [`HelperAnswerSchema::preset_reasons`]. Empty for non-reject verdicts.
+   */
+  reasons: string[];
+  /**
+   * The [`HelperTask`] this answers.
+   */
+  taskId: string;
+  verdict: HelperVerdict;
+  [k: string]: unknown;
+}

package/src/generated/HelperAnswerSchema.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 { HelperVerdict } from "./HelperVerdict";
+
+/**
+ * The answers a helper is allowed to give, plus the preset reason codes the UI
+ * offers them.
+ *
+ * Defines the choice set for a task: which [`HelperVerdict`]s are offered, the
+ * preset reason codes shown when the helper rejects, and whether free text and
+ * the 🤔 "not sure" escape hatch are available.
+ */
+export interface HelperAnswerSchema {
+  /**
+   * Whether the helper may add a free-text note alongside the verdict.
+   */
+  allowFreeText: boolean;
+  /**
+   * Whether the 🤔 [`HelperVerdict::NotSure`] option is offered. First-class
+   * by design; defaults to `true`.
+   */
+  allowNotSure: boolean;
+  /**
+   * Preset reason codes the UI surfaces as tap-to-select chips on a reject —
+   * e.g. `"text_cut_off"`, `"overlapping"`, `"wrong_color"`,
+   * `"button_missing"`. Selected codes land in [`HelperAnswer::reasons`].
+   */
+  presetReasons: string[];
+  /**
+   * The verdicts offered for this task (e.g. approve/reject/not_sure for a
+   * SpotCheck).
+   */
+  verdicts: HelperVerdict[];
+  [k: string]: unknown;
+}

package/src/generated/HelperTask.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 { HelperAnswerSchema } from "./HelperAnswerSchema";
+import type { HelperTaskKind } from "./HelperTaskKind";
+import type { HelperTaskPayload } from "./HelperTaskPayload";
+import type { HelperTaskSource } from "./HelperTaskSource";
+import type { HelperTaskStatus } from "./HelperTaskStatus";
+import type { HelperVerdict } from "./HelperVerdict";
+
+/**
+ * A human-judgment micro-task emitted by a runner for a helper to answer.
+ *
+ * The broker holds the task `Open` until [`required_votes`](HelperTask::required_votes)
+ * [`HelperAnswer`]s are collected (or it `expires_at`), then resolves the
+ * verdict and routes it back through [`source`](HelperTask::source).
+ */
+export interface HelperTask {
+  answerSchema: HelperAnswerSchema;
+  /**
+   * Application the task pertains to.
+   */
+  appId: string;
+  /**
+   * ISO 8601 timestamp (UTC) when the task was created.
+   */
+  createdAt: string;
+  /**
+   * ISO 8601 timestamp (UTC) after which the task can no longer be answered.
+   * Absent means the task does not expire.
+   */
+  expiresAt?: string | null;
+  /**
+   * Task ID (UUID v4 string).
+   */
+  id: string;
+  kind: HelperTaskKind;
+  payload: HelperTaskPayload;
+  /**
+   * Human-readable question shown to the helper (e.g. "Does this login
+   * screen look right?").
+   */
+  prompt: string;
+  /**
+   * Number of helper answers required before the task is `Answered`.
+   */
+  requiredVotes: number;
+  source: HelperTaskSource;
+  status: HelperTaskStatus;
+  /**
+   * Tenant that owns the task (coord tenant id).
+   */
+  tenantId: string;
+  [k: string]: unknown;
+}

package/src/generated/HelperTaskKind.d.ts

@@ -0,0 +1,16 @@
+/* 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 human-judgment task a helper is asked to perform.
+ *
+ * Phase 1 ships [`HelperTaskKind::SpotCheck`] only; the rest are Phase 2/3.
+ * Each kind dictates which [`HelperTaskPayload`] fields are populated and which
+ * [`HelperVerdict`]s are offered in the task's [`HelperAnswerSchema`].
+ */
+export type HelperTaskKind =
+  "spot_check" | "compare" | "walk_through" | "describe" | "sort";

package/src/generated/HelperTaskPayload.d.ts

@@ -0,0 +1,37 @@
+/* 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-specific content shown to the helper.
+ *
+ * Every field is optional; a given [`HelperTaskKind`] populates only the
+ * fields it needs. A [`HelperTaskKind::SpotCheck`] task populates only
+ * [`screenshot_url`](HelperTaskPayload::screenshot_url).
+ */
+export interface HelperTaskPayload {
+  /**
+   * Sort: the feature cards the helper groups in the card-sort exercise.
+   */
+  cards?: string[] | null;
+  /**
+   * Compare: the two presigned screenshot URLs to put side by side (A, B).
+   */
+  compareUrls?: string[] | null;
+  /**
+   * Describe: a reference to the live screen / target the helper describes.
+   */
+  liveTarget?: string | null;
+  /**
+   * SpotCheck: a coord-served / presigned URL of the screenshot to review.
+   */
+  screenshotUrl?: string | null;
+  /**
+   * WalkThrough: the ordered guided steps the helper follows live.
+   */
+  steps?: string[] | null;
+  [k: string]: unknown;
+}

package/src/generated/HelperTaskSource.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`.
+ */
+
+/**
+ * Round-trip provenance linking a task back to what produced it.
+ *
+ * Carries the originating [`crate::findings`] / page / spec-check context so a
+ * collected verdict can be folded back into the source flow. Spec-check exposes
+ * `match_rate` / classification (not a "confidence" scalar), so the rate field
+ * is named [`match_rate`](HelperTaskSource::match_rate) accordingly.
+ */
+export interface HelperTaskSource {
+  /**
+   * The finding this task was raised from, if any.
+   */
+  findingId?: string | null;
+  /**
+   * The spec-check match rate that triggered the task, if any — the
+   * `[0.0, 1.0]` structural match score, **not** a confidence scalar.
+   */
+  matchRate?: number | null;
+  /**
+   * The page / spec the screenshot was captured from, if any.
+   */
+  pageId?: string | null;
+  [k: string]: unknown;
+}

package/src/generated/HelperTaskStatus.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`.
+ */
+
+/**
+ * Lifecycle status of a helper task.
+ *
+ * Lifecycle: `OPEN` → (`ANSWERED` | `EXPIRED` | `CANCELLED`). A task becomes
+ * `ANSWERED` once [`HelperTask::required_votes`] answers are collected.
+ */
+export type HelperTaskStatus = "open" | "answered" | "expired" | "cancelled";

package/src/generated/HelperVerdict.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`.
+ */
+
+/**
+ * A verdict a helper may submit for a task.
+ *
+ * Verdict-to-kind mapping:
+ * - [`HelperTaskKind::SpotCheck`] → [`HelperVerdict::Approve`],
+ *   [`HelperVerdict::Reject`], [`HelperVerdict::NotSure`].
+ * - [`HelperTaskKind::Compare`] → [`HelperVerdict::ChoiceA`],
+ *   [`HelperVerdict::ChoiceB`], [`HelperVerdict::ChoiceSame`].
+ *
+ * `NotSure` (🤔) is a first-class outcome — never an error — so a helper is
+ * never forced into a false approve/reject.
+ */
+export type HelperVerdict =
+  "approve" | "reject" | "not_sure" | "choice_a" | "choice_b" | "choice_same";

package/src/generated/PendingQuestion.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`.
+ */
+
+/**
+ * A question an agent is blocked on, awaiting the user's answer.
+ */
+export interface PendingQuestion {
+  /**
+   * Unix epoch milliseconds the question was raised.
+   */
+  createdAtMs?: number | null;
+  /**
+   * `deferred_questions.id`.
+   */
+  id: string;
+  /**
+   * The question text, as shown to the user.
+   */
+  question: string;
+  /**
+   * Risk level the asking agent assigned ("low" | "medium" | "high").
+   */
+  riskLevel?: string | null;
+  /**
+   * The session that asked.
+   */
+  taskRunId: string;
+}

package/src/generated/ProcessStatusLite.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 { ProcessState } from "./ProcessState";
+
+/**
+ * A managed process attributed to a project, reduced to what the dashboard
+ * renders. Full detail stays in `ProcessStatus` / `ProcessConfig`.
+ */
+export interface ProcessStatusLite {
+  /**
+   * Working directory — the field that attributed this process to the
+   * project in the first place.
+   */
+  cwd: string;
+  /**
+   * Health port, when the process declares one.
+   */
+  healthPort?: number | null;
+  /**
+   * `ProcessConfig.id`.
+   */
+  id: string;
+  /**
+   * Human-readable process name ("Website").
+   */
+  name: string;
+  /**
+   * Whether the health port is currently responding. `None` when the
+   * process declares no health port.
+   */
+  portHealthy?: boolean | null;
+  state: ProcessState;
+}

package/src/generated/ProjectSnapshot.d.ts

@@ -0,0 +1,63 @@
+/* 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 { GitCommitLite } from "./GitCommitLite";
+import type { GitLite } from "./GitLite";
+import type { HealthLevel } from "./HealthLevel";
+import type { HealthLite } from "./HealthLite";
+import type { PendingQuestion } from "./PendingQuestion";
+import type { ProcessState } from "./ProcessState";
+import type { ProcessStatusLite } from "./ProcessStatusLite";
+import type { SavedProject } from "./SavedProject";
+import type { SessionLite } from "./SessionLite";
+import type { SessionSource } from "./SessionSource";
+
+/**
+ * The joined dashboard view of one project.
+ *
+ * Every field on both the grid card and the detail page is a projection of
+ * this single struct — computed server-side in one call so the page never
+ * fans out.
+ */
+export interface ProjectSnapshot {
+  /**
+   * Git state of the root, when it is a git working tree.
+   */
+  git?: GitLite | null;
+  /**
+   * The project's traffic light.
+   */
+  health?: HealthLite & {};
+  /**
+   * Unix epoch milliseconds of the newest activity of any kind.
+   */
+  lastActivityMs?: number | null;
+  /**
+   * Live terminal sessions whose `working_dir` is under the project root.
+   */
+  liveSessions: SessionLite[];
+  /**
+   * Managed processes whose `cwd` is under the project root.
+   */
+  processes: ProcessStatusLite[];
+  project: SavedProject;
+  /**
+   * Questions waiting on the user, from `deferred_questions`.
+   */
+  questions: PendingQuestion[];
+  /**
+   * Recent AI sessions, newest first, attributed via
+   * `coord.session_touched_files`.
+   */
+  recentSessions: SessionLite[];
+  /**
+   * Rolling 7-day spend attributed to this project, in USD. `None` when
+   * cost data is unavailable — distinct from `Some(0.0)`, which means
+   * "measured, and it was free".
+   */
+  spend7dUsd?: number | null;
+}

package/src/generated/RegisterAppRequest.d.ts

@@ -7,8 +7,32 @@
 
 export interface RegisterAppRequest {
   appId: string;
+  /**
+   * Whether this app requires authentication before spec checks.
+   */
+  authRequired: boolean;
+  /**
+   * Build command for "pull_build" strategy. Optional.
+   */
+  buildCommand?: string | null;
   displayName: string;
+  /**
+   * Red threshold for spec match rates. Defaults to 0.5.
+   */
+  redThreshold: number;
   repoRoot: string;
+  /**
+   * Start command to restart after build. Optional.
+   */
+  startCommand?: string | null;
   uiBridgeUrl: string;
+  /**
+   * Auto-fresh update strategy (P3 fleet-fresh engine). Defaults to "pull_only".
+   */
+  updateStrategy: string;
+  /**
+   * Yellow threshold for spec match rates. Defaults to 0.8.
+   */
+  yellowThreshold: number;
   [k: string]: unknown;
 }