@qontinui/shared-types 0.8.0 → 0.11.0

package/src/generated/ExecutionRunListResponse.d.ts

@@ -5,10 +5,10 @@
  * `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';
+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.

package/src/generated/ExecutionRunResponse.d.ts

@@ -5,8 +5,8 @@
  * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
  */
 
-import type { RunStatus } from './RunStatus';
-import type { RunType } from './RunType';
+import type { RunStatus } from "./RunStatus";
+import type { RunType } from "./RunType";
 
 /**
  * Response envelope returned when a run is created or fetched.

package/src/generated/ExecutionScreenshotCreate.d.ts

@@ -5,9 +5,9 @@
  * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
  */
 
-import type { ScreenshotAnnotation } from './ScreenshotAnnotation';
-import type { ScreenshotAnnotationShape } from './ScreenshotAnnotationShape';
-import type { ScreenshotType } from './ScreenshotType';
+import type { ScreenshotAnnotation } from "./ScreenshotAnnotation";
+import type { ScreenshotAnnotationShape } from "./ScreenshotAnnotationShape";
+import type { ScreenshotType } from "./ScreenshotType";
 
 /**
  * Request payload describing a screenshot being uploaded.

package/src/generated/ExecutionTreeResponse.d.ts

@@ -5,16 +5,16 @@
  * `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';
+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.

package/src/generated/ExecutionTrendResponse.d.ts

@@ -5,8 +5,8 @@
  * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
  */
 
-import type { ExecutionTrendDataPoint } from './ExecutionTrendDataPoint';
-import type { RunType } from './RunType';
+import type { ExecutionTrendDataPoint } from "./ExecutionTrendDataPoint";
+import type { RunType } from "./RunType";
 
 /**
  * Response envelope for the execution-trend analytics endpoint.

package/src/generated/Finding.d.ts

@@ -5,7 +5,7 @@
  * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
  */
 
-import type { Confidence } from './Confidence';
+import type { Confidence } from "./Confidence";
 
 /**
  * A finding recorded by a worker agent.

package/src/generated/FindingActionType.d.ts

@@ -10,4 +10,5 @@
  *
  * Mirrors Python `FindingActionType(str, Enum)`.
  */
-export type FindingActionType = "auto_fix" | "needs_user_input" | "manual" | "informational";
+export type FindingActionType =
+  "auto_fix" | "needs_user_input" | "manual" | "informational";

package/src/generated/FindingBatchCreate.d.ts

@@ -5,12 +5,12 @@
  * `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';
+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.

package/src/generated/FindingCreate.d.ts

@@ -5,11 +5,11 @@
  * `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';
+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).

package/src/generated/FindingDetail.d.ts

@@ -5,12 +5,12 @@
  * `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';
+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).

package/src/generated/FindingListResponse.d.ts

@@ -5,13 +5,13 @@
  * `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';
+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.

package/src/generated/FindingStatus.d.ts

@@ -12,4 +12,10 @@
  * `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";
+export type FindingStatus =
+  | "detected"
+  | "in_progress"
+  | "needs_input"
+  | "resolved"
+  | "wont_fix"
+  | "deferred";

package/src/generated/FindingUpdate.d.ts

@@ -5,7 +5,7 @@
  * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
  */
 
-import type { FindingStatus } from './FindingStatus';
+import type { FindingStatus } from "./FindingStatus";
 
 /**
  * Schema for updating a finding.

package/src/generated/FindingsSummary.d.ts

@@ -5,11 +5,11 @@
  * `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 { 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.

package/src/generated/FullRunnerStep.d.ts

@@ -5,41 +5,41 @@
  * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
  */
 
-import type { A11yAction } from './A11yAction';
-import type { CheckType } from './CheckType';
-import type { CodeExecutionStep } from './CodeExecutionStep';
-import type { CommandMode } from './CommandMode';
-import type { CommandStep } from './CommandStep';
-import type { CommandStepPhase } from './CommandStepPhase';
-import type { DagApprovalStep } from './DagApprovalStep';
-import type { DagCancelStep } from './DagCancelStep';
-import type { DagLoopStep } from './DagLoopStep';
-import type { ExecutePlaybookStep } from './ExecutePlaybookStep';
-import type { NativeAccessibilityStep } from './NativeAccessibilityStep';
-import type { PlaywrightExecutionMode } from './PlaywrightExecutionMode';
-import type { PromptStep } from './PromptStep';
-import type { PromptStepPhase } from './PromptStepPhase';
-import type { RestartProcessStep } from './RestartProcessStep';
-import type { RetrySpec } from './RetrySpec';
-import type { SaveWorkflowArtifactStep } from './SaveWorkflowArtifactStep';
-import type { TestType } from './TestType';
-import type { UiBridgeAction } from './UiBridgeAction';
-import type { UiBridgeAssertType } from './UiBridgeAssertType';
-import type { UiBridgeComparisonMode } from './UiBridgeComparisonMode';
-import type { UiBridgeDesignAuditStep } from './UiBridgeDesignAuditStep';
-import type { UiBridgeSeverity } from './UiBridgeSeverity';
-import type { UiBridgeStep } from './UiBridgeStep';
-import type { UiBridgeStepPhase } from './UiBridgeStepPhase';
-import type { UiBridgeVisualAssertionStep } from './UiBridgeVisualAssertionStep';
-import type { VerificationCategoryKind } from './VerificationCategoryKind';
-import type { VgaAction } from './VgaAction';
-import type { VgaAutomateStep } from './VgaAutomateStep';
-import type { VisualAssertionType } from './VisualAssertionType';
-import type { WorkflowFixupMode } from './WorkflowFixupMode';
-import type { WorkflowFixupStep } from './WorkflowFixupStep';
-import type { WorkflowRefStep } from './WorkflowRefStep';
-import type { WorkflowStep } from './WorkflowStep';
-import type { WorkflowStepPhase } from './WorkflowStepPhase';
+import type { A11yAction } from "./A11yAction";
+import type { CheckType } from "./CheckType";
+import type { CodeExecutionStep } from "./CodeExecutionStep";
+import type { CommandMode } from "./CommandMode";
+import type { CommandStep } from "./CommandStep";
+import type { CommandStepPhase } from "./CommandStepPhase";
+import type { DagApprovalStep } from "./DagApprovalStep";
+import type { DagCancelStep } from "./DagCancelStep";
+import type { DagLoopStep } from "./DagLoopStep";
+import type { ExecutePlaybookStep } from "./ExecutePlaybookStep";
+import type { NativeAccessibilityStep } from "./NativeAccessibilityStep";
+import type { PlaywrightExecutionMode } from "./PlaywrightExecutionMode";
+import type { PromptStep } from "./PromptStep";
+import type { PromptStepPhase } from "./PromptStepPhase";
+import type { RestartProcessStep } from "./RestartProcessStep";
+import type { RetrySpec } from "./RetrySpec";
+import type { SaveWorkflowArtifactStep } from "./SaveWorkflowArtifactStep";
+import type { TestType } from "./TestType";
+import type { UiBridgeAction } from "./UiBridgeAction";
+import type { UiBridgeAssertType } from "./UiBridgeAssertType";
+import type { UiBridgeComparisonMode } from "./UiBridgeComparisonMode";
+import type { UiBridgeDesignAuditStep } from "./UiBridgeDesignAuditStep";
+import type { UiBridgeSeverity } from "./UiBridgeSeverity";
+import type { UiBridgeStep } from "./UiBridgeStep";
+import type { UiBridgeStepPhase } from "./UiBridgeStepPhase";
+import type { UiBridgeVisualAssertionStep } from "./UiBridgeVisualAssertionStep";
+import type { VerificationCategoryKind } from "./VerificationCategoryKind";
+import type { VgaAction } from "./VgaAction";
+import type { VgaAutomateStep } from "./VgaAutomateStep";
+import type { VisualAssertionType } from "./VisualAssertionType";
+import type { WorkflowFixupMode } from "./WorkflowFixupMode";
+import type { WorkflowFixupStep } from "./WorkflowFixupStep";
+import type { WorkflowRefStep } from "./WorkflowRefStep";
+import type { WorkflowStep } from "./WorkflowStep";
+import type { WorkflowStepPhase } from "./WorkflowStepPhase";
 
 /**
  * Fully typed discriminated union over **all** step variants registered in

package/src/generated/FunctionalSpec.d.ts

@@ -5,30 +5,30 @@
  * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
  */
 
-import type { AssumptionEntry } from './AssumptionEntry';
-import type { AuthModel } from './AuthModel';
-import type { AuthRole } from './AuthRole';
-import type { Entity } from './Entity';
-import type { EntityField } from './EntityField';
-import type { IrAssertion } from './IrAssertion';
-import type { IrAssertionTarget } from './IrAssertionTarget';
-import type { IrCrossRef } from './IrCrossRef';
-import type { IrElementCriteria } from './IrElementCriteria';
-import type { IrMetadata } from './IrMetadata';
-import type { IrProvenance } from './IrProvenance';
-import type { IrState } from './IrState';
-import type { IrStateCondition } from './IrStateCondition';
-import type { IrTransition } from './IrTransition';
-import type { IrTransitionAction } from './IrTransitionAction';
-import type { IrWaitSpec } from './IrWaitSpec';
-import type { Operation } from './Operation';
-import type { OperationEffect } from './OperationEffect';
-import type { OperationInput } from './OperationInput';
-import type { ProposalStatus } from './ProposalStatus';
-import type { Relationship } from './Relationship';
-import type { SpecProvenance } from './SpecProvenance';
-import type { SpecTarget } from './SpecTarget';
-import type { ValidationRule } from './ValidationRule';
+import type { AssumptionEntry } from "./AssumptionEntry";
+import type { AuthModel } from "./AuthModel";
+import type { AuthRole } from "./AuthRole";
+import type { Entity } from "./Entity";
+import type { EntityField } from "./EntityField";
+import type { IrAssertion } from "./IrAssertion";
+import type { IrAssertionTarget } from "./IrAssertionTarget";
+import type { IrCrossRef } from "./IrCrossRef";
+import type { IrElementCriteria } from "./IrElementCriteria";
+import type { IrMetadata } from "./IrMetadata";
+import type { IrProvenance } from "./IrProvenance";
+import type { IrState } from "./IrState";
+import type { IrStateCondition } from "./IrStateCondition";
+import type { IrTransition } from "./IrTransition";
+import type { IrTransitionAction } from "./IrTransitionAction";
+import type { IrWaitSpec } from "./IrWaitSpec";
+import type { Operation } from "./Operation";
+import type { OperationEffect } from "./OperationEffect";
+import type { OperationInput } from "./OperationInput";
+import type { ProposalStatus } from "./ProposalStatus";
+import type { Relationship } from "./Relationship";
+import type { SpecProvenance } from "./SpecProvenance";
+import type { SpecTarget } from "./SpecTarget";
+import type { ValidationRule } from "./ValidationRule";
 
 /**
  * The v0 Functional Spec. Five sections, each node confidence- and

package/src/generated/GUIElementChunk.d.ts

@@ -5,8 +5,8 @@
  * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
  */
 
-import type { BoundingBox } from './BoundingBox';
-import type { ElementType } from './ElementType';
+import type { BoundingBox } from "./BoundingBox";
+import type { ElementType } from "./ElementType";
 
 /**
  * Complete representation of a GUI element chunk for RAG retrieval.

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/GitOpListResponse.d.ts

@@ -5,7 +5,7 @@
  * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
  */
 
-import type { GitOpRecord } from './GitOpRecord';
+import type { GitOpRecord } from "./GitOpRecord";
 
 /**
  * `GET /coord/git-ops/list` + `GET /coord/git-ops/by-session/:id`

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;
+}