@qontinui/shared-types 0.11.0 → 0.12.1

package/src/generated/AgentCommandError.d.ts

@@ -0,0 +1,23 @@
+/* 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`.
+ */
+
+/**
+ * Failure modes for agent-command overrides. Mirrors the tagged-enum shape of
+ * [`crate::apps::AppError`], so the qontinui-web layer can surface a rejected
+ * override the same way it surfaces a rejected app registration.
+ */
+export type AgentCommandError =
+  | {
+      name: string;
+      reason: "invalid-name";
+      [k: string]: unknown;
+    }
+  | {
+      name: string;
+      reason: "reserved-name";
+      [k: string]: unknown;
+    };

package/src/generated/AgentCommandVersion.d.ts

@@ -0,0 +1,67 @@
+/* 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 immutable entry in an [`AgentCommand`]'s append-only version chain.
+ *
+ * Rows are **only ever inserted**. An edit appends the next `version_number`;
+ * a revert appends a new version whose `body` is copied from an older one and
+ * whose [`restored_from`](Self::restored_from) names that older version.
+ * Nothing in the chain is updated or deleted, so the chain is the complete
+ * edit history and "revert" is itself a recorded edit.
+ */
+export interface AgentCommandVersion {
+  /**
+   * The [`AgentCommand`] this version belongs to. Deleting the override
+   * cascades to its versions — resetting to the default discards the
+   * account's edit history along with the override.
+   */
+  agent_command_id: string;
+  /**
+   * The full markdown body as of this version.
+   */
+  body: string;
+  /**
+   * Free-text note describing what changed, supplied by the editor. Revert
+   * writes a generated one (e.g. `"Restored from version 2"`).
+   */
+  change_description?: string | null;
+  /**
+   * Content hash of [`body`](Self::body) at this version, from
+   * [`agent_command_checksum`]. Equal checksums on two versions mean the
+   * bodies are identical — which is what lets the UI show a revert as
+   * "back to v2's content" without refetching either body.
+   */
+  checksum?: string | null;
+  /**
+   * ISO 8601 (RFC 3339) creation timestamp. Versions are immutable, so
+   * there is deliberately no `updated_at`.
+   */
+  created_at: string;
+  /**
+   * User who authored this version. Attribution only.
+   */
+  created_by_user_id?: string | null;
+  /**
+   * Version-row id (UUID v4 string).
+   */
+  id: string;
+  /**
+   * Provenance for a revert: the `version_number` this version's body was
+   * copied from. `None` for an ordinary edit. Present only on versions
+   * produced by a restore, which is how the UI distinguishes "edited" from
+   * "reverted to v2" in the history list.
+   */
+  restored_from?: number | null;
+  /**
+   * Monotonic version number within this command, starting at 1. Unique per
+   * `(agent_command_id, version_number)`; the DB constraint — not
+   * application code — is what rejects a duplicate under concurrent appends.
+   */
+  version_number: number;
+  [k: string]: unknown;
+}

package/src/generated/AgenticPhaseOutput.d.ts

@@ -34,6 +34,9 @@ export interface AgenticPhaseOutput {
    * Reflection fixes (when reflection_mode is enabled).
    */
   reflectionFixes: ReflectionFixOutput[];
+  /**
+   * Overall status of the agentic phase.
+   */
   status: AgenticStatus;
   /**
    * Human-readable summary of what was done.

package/src/generated/ApiAssertion.d.ts

@@ -31,5 +31,8 @@ export interface ApiAssertion {
    * Comparison operator; defaults to `equals` on the consumer side.
    */
   operator?: ApiAssertionOperator | null;
+  /**
+   * Kind of assertion.
+   */
   type: ApiAssertionType;
 }

package/src/generated/AssertionMiss.d.ts

@@ -18,5 +18,8 @@ export interface AssertionMiss {
    * descending.
    */
   candidates?: CandidateMiss[];
+  /**
+   * Coarse-grained classification of why the match failed.
+   */
   reason: MissReason;
 }

package/src/generated/AssertionOutcome.d.ts

@@ -19,11 +19,17 @@ import type { MissReason } from "./MissReason";
  */
 export type AssertionOutcome =
   | {
+      /**
+       * The element that satisfied the assertion.
+       */
       matched: MatchedElement;
       status: "pass";
       [k: string]: unknown;
     }
   | {
+      /**
+       * Diagnostic detail.
+       */
       miss: AssertionMiss;
       status: "fail";
       [k: string]: unknown;

package/src/generated/AssertionResult.d.ts

@@ -28,6 +28,9 @@ export interface AssertionResult {
    * Snapshot of `IrAssertion.description`.
    */
   description: string;
+  /**
+   * Pass / fail discriminator + payload.
+   */
   outcome: AssertionOutcome;
   /**
    * Free-form severity string — `"critical"` / `"error"` / `"warning"`

package/src/generated/BackendProfile.d.ts

@@ -11,6 +11,9 @@ import type { ApiStyle } from "./ApiStyle";
  * Target backend stack.
  */
 export interface BackendProfile {
+  /**
+   * REST vs GraphQL.
+   */
   apiStyle: ApiStyle;
   /**
    * Backend auth strategy (e.g. `"jwt"`, `"session"`). Free-form; `None` lets

package/src/generated/CommandStep.d.ts

@@ -104,6 +104,9 @@ export interface CommandStep {
    * Display name for the step.
    */
   name: string;
+  /**
+   * Phase in which the step appears.
+   */
   phase: CommandStepPhase;
   /**
    * Repository selector for repository-targeted steps.

package/src/generated/CompletenessVerdict.d.ts

@@ -61,6 +61,9 @@ export interface CompletenessVerdict {
    * re-dispatches generation for.
    */
   gaps?: CoverageGap[];
+  /**
+   * Overall node counts by provenance.
+   */
   provenanceMix: ProvenanceMix;
   /**
    * Per-section breakdown.

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

@@ -20,5 +20,8 @@ export interface ConjunctEvaluation {
    * Snapshot of `PolicyConjunct.name`.
    */
   name: string;
+  /**
+   * Pass / fail / indeterminate.
+   */
   status: PolicyStatus;
 }

package/src/generated/ConjunctRule.d.ts

@@ -50,6 +50,9 @@ export type ConjunctRule =
     }
   | {
       kind: "match_outcome_at_least";
+      /**
+       * Minimum acceptable outcome.
+       */
       outcome: MatchOutcome;
       [k: string]: unknown;
     };

package/src/generated/Constraint.d.ts

@@ -12,6 +12,9 @@ import type { ConstraintSeverity } from "./ConstraintSeverity";
  * A constraint definition.
  */
 export interface Constraint {
+  /**
+   * What to check.
+   */
   check: ConstraintCheck;
   /**
    * Why this constraint exists (shown to the AI on violation).
@@ -29,5 +32,8 @@ export interface Constraint {
    * Human-readable name.
    */
   name: string;
+  /**
+   * How severe a violation is.
+   */
   severity: ConstraintSeverity;
 }

package/src/generated/ConstraintProposal.d.ts

@@ -17,6 +17,9 @@ import type { ConstraintSeverity } from "./ConstraintSeverity";
  */
 export type ConstraintProposal =
   | {
+      /**
+       * The proposed constraint definition.
+       */
       constraint: Constraint;
       type: "new_constraint";
     }

package/src/generated/ConstraintResult.d.ts

@@ -24,6 +24,9 @@ export interface ConstraintResult {
    * Whether the constraint passed.
    */
   passed: boolean;
+  /**
+   * Severity of the constraint (for quick filtering).
+   */
   severity: ConstraintSeverity;
   /**
    * Details about the violation (empty if passed).

package/src/generated/CoverageGap.d.ts

@@ -18,13 +18,22 @@ export interface CoverageGap {
    * Free-form diagnostic detail (e.g. the verifier's near-miss explanation).
    */
   detail?: string | null;
+  /**
+   * Provenance of the gapped node — always `Observed` or `Inferred`.
+   */
   nodeProvenance: SpecProvenance;
+  /**
+   * Why it is uncovered.
+   */
   reason: GapReason;
   /**
    * Dotted ref into the spec, e.g. `"entities.Invoice.fields.amount"` or
    * `"operations.createInvoice"`.
    */
   ref: string;
+  /**
+   * Which section the gapped node belongs to.
+   */
   section: SpecSection;
   [k: string]: unknown;
 }

package/src/generated/CreateMcpServerInput.d.ts

@@ -44,5 +44,8 @@ export interface CreateMcpServerInput {
    * Override for the default `timeout_seconds = 30`.
    */
   timeoutSeconds?: number | null;
+  /**
+   * Transport selector.
+   */
   transport: McpTransport;
 }

package/src/generated/CreateScheduledTaskRequest.d.ts

@@ -50,6 +50,9 @@ export interface CreateScheduledTaskRequest {
    * Display name.
    */
   name: string;
+  /**
+   * Schedule configuration.
+   */
   schedule: ScheduleExpression;
   /**
    * Skip future runs once the task has succeeded.
@@ -59,5 +62,8 @@ export interface CreateScheduledTaskRequest {
    * Free-form success criteria description.
    */
   successCriteria?: string | null;
+  /**
+   * Task type and its per-type configuration.
+   */
   task: ScheduledTaskType;
 }

package/src/generated/DiscoveredElement.d.ts

@@ -36,6 +36,9 @@ export interface DiscoveredElement {
    * ARIA role attribute.
    */
   role?: string | null;
+  /**
+   * Current observable state.
+   */
   state: ElementState;
   /**
    * HTML tag name (e.g. `"BUTTON"`, `"INPUT"`).

package/src/generated/DiscoveredStateImage.d.ts

@@ -14,6 +14,9 @@ import type { DiscoveryBoundingBox } from "./DiscoveryBoundingBox";
  * optional pixel-level identification.
  */
 export interface DiscoveredStateImage {
+  /**
+   * Bounding box within the screenshot.
+   */
   bbox: DiscoveryBoundingBox;
   /**
    * Confidence score for this image (0.0–1.0). Defaults to `1.0`.

package/src/generated/ElementState.d.ts

@@ -53,6 +53,9 @@ export interface ElementState {
    * Whether the element currently has keyboard focus.
    */
   focused: boolean;
+  /**
+   * Bounding rectangle of the element.
+   */
   rect: ElementRect;
   /**
    * Currently selected options for `<select>` elements.

package/src/generated/EmbeddedElement.d.ts

@@ -16,6 +16,9 @@ import type { GUIElementChunk } from "./GUIElementChunk";
  * Mirrors `rag.models.EmbeddedElement`.
  */
 export interface EmbeddedElement {
+  /**
+   * The GUI element that was embedded.
+   */
   element: GUIElementChunk;
   /**
    * Model used for embedding.

package/src/generated/Entity.d.ts

@@ -13,6 +13,9 @@ import type { SpecProvenance } from "./SpecProvenance";
  * A domain entity inferred from rendered data shapes.
  */
 export interface Entity {
+  /**
+   * How this entity's existence was established.
+   */
   confidence: SpecProvenance;
   /**
    * Optional deduction strength ∈ [0,1]. Present only on `Inferred` nodes;

package/src/generated/ExecutionIssueCreate.d.ts

@@ -45,6 +45,9 @@ export interface ExecutionIssueCreate {
    * IDs of screenshots illustrating the issue.
    */
   screenshotIds?: string[] | null;
+  /**
+   * Severity.
+   */
   severity: IssueSeverity;
   /**
    * State ID active when the issue was observed.

package/src/generated/ExecutionIssueDetail.d.ts

@@ -44,6 +44,9 @@ export interface ExecutionIssueDetail {
    * Issue ID.
    */
   id: string;
+  /**
+   * Category label for the issue.
+   */
   issueType: IssueType;
   /**
    * Opaque additional metadata.
@@ -71,12 +74,21 @@ export interface ExecutionIssueDetail {
    * Full screenshot records associated with the issue.
    */
   screenshots?: ExecutionScreenshotResponse[];
+  /**
+   * Severity.
+   */
   severity: IssueSeverity;
+  /**
+   * Source that detected the issue.
+   */
   source: IssueSource;
   /**
    * State ID where the issue was observed, if any.
    */
   stateName?: string | null;
+  /**
+   * Current lifecycle status.
+   */
   status: IssueStatus;
   /**
    * Short title.

package/src/generated/ExecutionIssueListResponse.d.ts

@@ -16,6 +16,9 @@ export interface ExecutionIssueListResponse {
    * Page of matching issues.
    */
   issues: ExecutionIssueResponse[];
+  /**
+   * Pagination envelope.
+   */
   pagination: Pagination;
   /**
    * Summary keyed by severity or status. Shape is intentionally opaque.

package/src/generated/ExecutionRunComplete.d.ts

@@ -25,7 +25,13 @@ export interface ExecutionRunComplete {
    * Error message if the run failed.
    */
   errorMessage?: string | null;
+  /**
+   * Aggregate execution statistics.
+   */
   stats: ExecutionStats;
+  /**
+   * Final lifecycle status.
+   */
   status: RunStatus;
   /**
    * Free-form run summary.

package/src/generated/ExecutionRunCompleteResponse.d.ts

@@ -33,6 +33,12 @@ export interface ExecutionRunCompleteResponse {
    * ISO 8601 timestamp when the run started.
    */
   startedAt: string;
+  /**
+   * Aggregate execution statistics.
+   */
   stats: ExecutionStats;
+  /**
+   * Final lifecycle status.
+   */
   status: RunStatus;
 }

package/src/generated/ExecutionRunCreate.d.ts

@@ -31,7 +31,13 @@ export interface ExecutionRunCreate {
    * Human-readable run name.
    */
   runName: string;
+  /**
+   * Kind of run being created.
+   */
   runType: RunType;
+  /**
+   * Runner environment metadata.
+   */
   runnerMetadata: RunnerMetadata;
   /**
    * Workflow metadata, if the run executes a workflow.

package/src/generated/ExecutionRunDetail.d.ts

@@ -57,13 +57,25 @@ export interface ExecutionRunDetail {
    * Human-readable run name.
    */
   runName: string;
+  /**
+   * Kind of run.
+   */
   runType: RunType;
+  /**
+   * Runner environment metadata.
+   */
   runnerMetadata: RunnerMetadata;
   /**
    * ISO 8601 timestamp when the run started.
    */
   startedAt: string;
+  /**
+   * Aggregate execution statistics.
+   */
   stats: ExecutionStats;
+  /**
+   * Current lifecycle status.
+   */
   status: RunStatus;
   /**
    * ISO 8601 timestamp when the record was last updated.

package/src/generated/ExecutionRunListResponse.d.ts

@@ -14,6 +14,9 @@ import type { RunType } from "./RunType";
  * Paginated list of execution runs.
  */
 export interface ExecutionRunListResponse {
+  /**
+   * Pagination envelope.
+   */
   pagination: Pagination;
   /**
    * Page of matching runs.

package/src/generated/ExecutionRunResponse.d.ts

@@ -32,10 +32,16 @@ export interface ExecutionRunResponse {
    * Human-readable run name.
    */
   runName: string;
+  /**
+   * Kind of run.
+   */
   runType: RunType;
   /**
    * ISO 8601 timestamp when the run started.
    */
   startedAt: string;
+  /**
+   * Current lifecycle status.
+   */
   status: RunStatus;
 }

package/src/generated/ExecutionScreenshotCreate.d.ts

@@ -39,6 +39,9 @@ export interface ExecutionScreenshotCreate {
    * Client-generated screenshot identifier.
    */
   screenshotId: string;
+  /**
+   * Kind of screenshot.
+   */
   screenshotType: ScreenshotType;
   /**
    * Sequence number of the screenshot within the run.

package/src/generated/Finding.d.ts

@@ -11,6 +11,9 @@ import type { Confidence } from "./Confidence";
  * A finding recorded by a worker agent.
  */
 export interface Finding {
+  /**
+   * Confidence level.
+   */
   confidence: Confidence;
   /**
    * Description of the finding.

package/src/generated/FindingCreate.d.ts

@@ -18,7 +18,13 @@ import type { FindingUserInput } from "./FindingUserInput";
  * observation.
  */
 export interface FindingCreate {
+  /**
+   * Type of action for this finding.
+   */
   actionType: FindingActionType;
+  /**
+   * Category of the finding.
+   */
   category: FindingCategory;
   /**
    * Code context, if the finding relates to specific code.
@@ -32,6 +38,9 @@ export interface FindingCreate {
    * Session number where the finding was detected.
    */
   sessionNum: number;
+  /**
+   * Severity level of the finding.
+   */
   severity: FindingSeverity;
   /**
    * Hash used to deduplicate findings across sessions.

package/src/generated/FindingDetail.d.ts

@@ -19,7 +19,13 @@ import type { FindingUserInput } from "./FindingUserInput";
  * string (see crate-level wire-format note).
  */
 export interface FindingDetail {
+  /**
+   * Type of action for this finding.
+   */
   actionType: FindingActionType;
+  /**
+   * Category of the finding.
+   */
   category: FindingCategory;
   /**
    * Code context, if the finding relates to specific code.
@@ -53,11 +59,17 @@ export interface FindingDetail {
    * Session number where the finding was detected.
    */
   sessionNum: number;
+  /**
+   * Severity level of the finding.
+   */
   severity: FindingSeverity;
   /**
    * Hash used to deduplicate findings across sessions.
    */
   signatureHash?: string | null;
+  /**
+   * Current status of the finding.
+   */
   status: FindingStatus;
   /**
    * Parent task run ID.

package/src/generated/FunctionalSpec.d.ts

@@ -66,6 +66,9 @@ export interface FunctionalSpec {
    * Schema version. Currently always `"0"`. Additive-only until `"1"`.
    */
   specVersion: string;
+  /**
+   * What was observed and when.
+   */
   target: SpecTarget;
   /**
    * Section (3a) UI STATES — a literal superset of the UI Bridge IR. These are the

package/src/generated/HelperAnswer.d.ts

@@ -42,6 +42,9 @@ export interface HelperAnswer {
    * The [`HelperTask`] this answers.
    */
   taskId: string;
+  /**
+   * The verdict the helper gave.
+   */
   verdict: HelperVerdict;
   [k: string]: unknown;
 }