@qontinui/shared-types 0.2.1

package/src/generated/StateMachineStateCreate.d.ts

@@ -0,0 +1,52 @@
+/* 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 { DomainKnowledge } from './DomainKnowledge';
+
+/**
+ * Payload for creating a new state within a config.
+ */
+export interface StateMachineStateCreate {
+  /**
+   * Acceptance criteria.
+   */
+  acceptance_criteria?: string[] | null;
+  /**
+   * Initial confidence score.
+   */
+  confidence?: number | null;
+  /**
+   * Optional description.
+   */
+  description?: string | null;
+  /**
+   * Domain knowledge entries.
+   */
+  domain_knowledge?: DomainKnowledge[] | null;
+  /**
+   * Element IDs that define this state.
+   */
+  element_ids?: string[] | null;
+  /**
+   * Free-form metadata bag.
+   */
+  extra_metadata?: {
+    [k: string]: unknown;
+  } | null;
+  /**
+   * Display name.
+   */
+  name: string;
+  /**
+   * Render IDs associated with this state.
+   */
+  render_ids?: string[] | null;
+  /**
+   * Optional stable logical state ID (generated if omitted).
+   */
+  state_id?: string | null;
+}

package/src/generated/StateMachineStateUpdate.d.ts

@@ -0,0 +1,48 @@
+/* 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 { DomainKnowledge } from './DomainKnowledge';
+
+/**
+ * Payload for updating an existing state.
+ */
+export interface StateMachineStateUpdate {
+  /**
+   * New acceptance criteria.
+   */
+  acceptance_criteria?: string[] | null;
+  /**
+   * New confidence score.
+   */
+  confidence?: number | null;
+  /**
+   * New description.
+   */
+  description?: string | null;
+  /**
+   * New domain knowledge entries.
+   */
+  domain_knowledge?: DomainKnowledge[] | null;
+  /**
+   * New element ID set.
+   */
+  element_ids?: string[] | null;
+  /**
+   * New metadata bag.
+   */
+  extra_metadata?: {
+    [k: string]: unknown;
+  } | null;
+  /**
+   * New display name.
+   */
+  name?: string | null;
+  /**
+   * New render ID set.
+   */
+  render_ids?: string[] | null;
+}

package/src/generated/StateMachineTransition.d.ts

@@ -0,0 +1,75 @@
+/* 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 { MouseButton } from './MouseButton';
+import type { Point } from './Point';
+import type { ScrollDirection } from './ScrollDirection';
+import type { StandardActionType } from './StandardActionType';
+import type { TransitionAction } from './TransitionAction';
+import type { TransitionActionValue } from './TransitionActionValue';
+
+/**
+ * A transition between states, consisting of one or more actions.
+ *
+ * Transitions define the edges of the state machine graph.
+ */
+export interface StateMachineTransition {
+  /**
+   * Ordered list of actions executed as part of this transition.
+   */
+  actions: TransitionAction[];
+  /**
+   * States activated when this transition fires.
+   */
+  activate_states: string[];
+  /**
+   * Parent config ID.
+   */
+  config_id: string;
+  /**
+   * ISO 8601 timestamp of creation.
+   */
+  created_at: string;
+  /**
+   * States exited when this transition fires.
+   */
+  exit_states: string[];
+  /**
+   * Free-form metadata bag.
+   */
+  extra_metadata: {
+    [k: string]: unknown;
+  };
+  /**
+   * States this transition may be taken from.
+   */
+  from_states: string[];
+  /**
+   * Unique database identifier (UUID).
+   */
+  id: string;
+  /**
+   * Display name.
+   */
+  name: string;
+  /**
+   * Cost used by pathfinding to prefer cheaper transitions.
+   */
+  path_cost: number;
+  /**
+   * Whether source states stay visible after activation.
+   */
+  stays_visible: boolean;
+  /**
+   * Stable logical transition ID (distinct from `id`).
+   */
+  transition_id: string;
+  /**
+   * ISO 8601 timestamp of last modification.
+   */
+  updated_at: string;
+}

package/src/generated/StateMachineTransitionCreate.d.ts

@@ -0,0 +1,53 @@
+/* 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 { MouseButton } from './MouseButton';
+import type { Point } from './Point';
+import type { ScrollDirection } from './ScrollDirection';
+import type { StandardActionType } from './StandardActionType';
+import type { TransitionAction } from './TransitionAction';
+import type { TransitionActionValue } from './TransitionActionValue';
+
+/**
+ * Payload for creating a new transition.
+ */
+export interface StateMachineTransitionCreate {
+  /**
+   * Ordered list of actions executed as part of this transition.
+   */
+  actions: TransitionAction[];
+  /**
+   * States activated when this transition fires.
+   */
+  activate_states: string[];
+  /**
+   * States exited when this transition fires.
+   */
+  exit_states: string[];
+  /**
+   * Free-form metadata bag.
+   */
+  extra_metadata?: {
+    [k: string]: unknown;
+  } | null;
+  /**
+   * States this transition may be taken from.
+   */
+  from_states: string[];
+  /**
+   * Display name.
+   */
+  name: string;
+  /**
+   * Cost used by pathfinding.
+   */
+  path_cost?: number | null;
+  /**
+   * Whether source states stay visible after activation.
+   */
+  stays_visible?: boolean | null;
+}

package/src/generated/StateMachineTransitionUpdate.d.ts

@@ -0,0 +1,53 @@
+/* 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 { MouseButton } from './MouseButton';
+import type { Point } from './Point';
+import type { ScrollDirection } from './ScrollDirection';
+import type { StandardActionType } from './StandardActionType';
+import type { TransitionAction } from './TransitionAction';
+import type { TransitionActionValue } from './TransitionActionValue';
+
+/**
+ * Payload for updating an existing transition.
+ */
+export interface StateMachineTransitionUpdate {
+  /**
+   * New action list.
+   */
+  actions?: TransitionAction[] | null;
+  /**
+   * New "activate" states.
+   */
+  activate_states?: string[] | null;
+  /**
+   * New "exit" states.
+   */
+  exit_states?: string[] | null;
+  /**
+   * New metadata bag.
+   */
+  extra_metadata?: {
+    [k: string]: unknown;
+  } | null;
+  /**
+   * New "from" states.
+   */
+  from_states?: string[] | null;
+  /**
+   * New display name.
+   */
+  name?: string | null;
+  /**
+   * New path cost.
+   */
+  path_cost?: number | null;
+  /**
+   * New stays-visible flag.
+   */
+  stays_visible?: boolean | null;
+}

package/src/generated/StateNodeData.d.ts

@@ -0,0 +1,71 @@
+/* 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`.
+ */
+
+/**
+ * Data passed to a state node in the ReactFlow graph editor.
+ *
+ * Mirrors the TypeScript shape with camelCase field names. The
+ * `onStartElementDrag` callback from the TS type is a UI-layer concern and is
+ * intentionally omitted from the DTO.
+ */
+export interface StateNodeData {
+  /**
+   * Discovery confidence.
+   */
+  confidence: number;
+  /**
+   * Optional description (may be `null`).
+   */
+  description?: string | null;
+  /**
+   * Number of elements defining this state.
+   */
+  elementCount: number;
+  /**
+   * Element IDs defining this state.
+   */
+  elementIds: string[];
+  /**
+   * Optional map of element ID → base64 thumbnail image (data URL or raw
+   * base64 PNG).
+   */
+  elementThumbnails?: {
+    [k: string]: string;
+  } | null;
+  /**
+   * Incoming transition count.
+   */
+  incomingCount?: number | null;
+  /**
+   * Whether the state blocks navigation.
+   */
+  isBlocking: boolean;
+  /**
+   * Whether this node is the current drop target (drag-and-drop).
+   */
+  isDropTarget?: boolean | null;
+  /**
+   * Whether this is an initial state.
+   */
+  isInitial: boolean;
+  /**
+   * Whether the node is currently selected in the editor.
+   */
+  isSelected: boolean;
+  /**
+   * Display name.
+   */
+  name: string;
+  /**
+   * Outgoing transition count.
+   */
+  outgoingCount?: number | null;
+  /**
+   * State ID this node represents.
+   */
+  stateId: string;
+}

package/src/generated/StatesResponse.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`.
+ */
+
+import type { StateFilterItem } from './StateFilterItem';
+
+/**
+ * Response with list of states for filtering.
+ */
+export interface StatesResponse {
+  /**
+   * Total number of states.
+   */
+  count: number;
+  states: StateFilterItem[];
+}

package/src/generated/StdioConfig.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`.
+ */
+
+/**
+ * Stdio-transport configuration.
+ *
+ * **Secret surface**: `command`, `args`, and `env` must be treated as
+ * execution-critical. See module-level docs.
+ */
+export interface StdioConfig {
+  /**
+   * Command arguments.
+   */
+  args?: string[];
+  /**
+   * Command to execute (e.g. `"npx"`, `"python"`, `"/usr/local/bin/server"`).
+   */
+  command: string;
+  /**
+   * Working directory (absolute path). `None` inherits the runner's cwd.
+   */
+  cwd?: string | null;
+  /**
+   * Extra environment variables for the subprocess. **Secret surface** —
+   * frequently holds API tokens.
+   */
+  env?: {
+    [k: string]: string;
+  };
+}

package/src/generated/StepExecutionConfig.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`.
+ */
+
+/**
+ * Execution config captured for a verification step.
+ *
+ * The TypeScript type includes an index signature `[key: string]: unknown`,
+ * so extra arbitrary fields are captured in `extra` via `serde(flatten)` and
+ * passed through opaquely.
+ */
+export interface StepExecutionConfig {
+  /**
+   * Action type (e.g., click, type, wait).
+   */
+  actionType?: string | null;
+  /**
+   * Check type for verification steps.
+   */
+  checkType?: string | null;
+  /**
+   * Target image ID, if the action references an image.
+   */
+  targetImageId?: string | null;
+  /**
+   * Target image name, if the action references an image.
+   */
+  targetImageName?: string | null;
+  /**
+   * Timeout in seconds.
+   */
+  timeoutSeconds?: number | null;
+  [k: string]: unknown;
+}

package/src/generated/StructuredFinding.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 finding discovered during work.
+ */
+export interface StructuredFinding {
+  /**
+   * Finding category (e.g., "bug", "security", "performance").
+   */
+  category: string;
+  /**
+   * Detailed description.
+   */
+  description: string;
+  /**
+   * Whether this finding requires human input.
+   */
+  needsInput: boolean;
+  /**
+   * Severity level.
+   */
+  severity: string;
+  /**
+   * Short title describing the finding.
+   */
+  title: string;
+}

package/src/generated/StructuredOverride.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`.
+ */
+
+/**
+ * A criterion override with justification.
+ */
+export interface StructuredOverride {
+  /**
+   * The criterion being overridden.
+   */
+  criterion: string;
+  /**
+   * Justification for the override.
+   */
+  justification: string;
+  /**
+   * The new status.
+   */
+  status: string;
+}

package/src/generated/StructuredSignal.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`.
+ */
+
+/**
+ * A signal from the worker to the orchestrator.
+ */
+export interface StructuredSignal {
+  /**
+   * Optional message providing context for the signal.
+   */
+  message?: string | null;
+  /**
+   * Signal type (e.g., "complete", "blocked", "needs_input").
+   */
+  signalType: string;
+}

package/src/generated/SuccessCriterion.d.ts

@@ -0,0 +1,57 @@
+/* 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 { CriterionType } from './CriterionType';
+import type { VerificationMethod } from './VerificationMethod';
+
+/**
+ * A success criterion that must be met for task completion.
+ */
+export interface SuccessCriterion {
+  /**
+   * Human-readable description.
+   */
+  description: string;
+  /**
+   * Domain this criterion belongs to (for multi-worker verification).
+   */
+  domain?: string | null;
+  /**
+   * For AI-evaluated criteria: the evaluation prompt.
+   */
+  evaluationPrompt?: string | null;
+  /**
+   * Unique identifier for this criterion.
+   */
+  id: string;
+  /**
+   * Whether failure of this criterion blocks task completion.
+   * - `true` (default): failure blocks completion, worker must fix.
+   * - `false`: failure is informational, doesn't block completion.
+   */
+  isCritical: boolean;
+  /**
+   * Whether this criterion must pass for task completion.
+   */
+  required: boolean;
+  type: CriterionType;
+  /**
+   * Configuration blob for the verification method (command args, log
+   * patterns, Playwright script path, etc.).
+   */
+  verificationConfig?: {
+    [k: string]: unknown;
+  };
+  /**
+   * For deterministic criteria: the verification method to use.
+   */
+  verificationMethod?: VerificationMethod | null;
+  /**
+   * Optional weight for partial success scoring.
+   */
+  weight?: number | null;
+}

package/src/generated/SummarizationConfig.d.ts

@@ -0,0 +1,35 @@
+/* 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`.
+ */
+
+/**
+ * Configuration for the context-summarization subsystem.
+ *
+ * When the loop's rolling context approaches the token budget, older
+ * iterations are compressed into a summary to keep the prompt small.
+ */
+export interface SummarizationConfig {
+  /**
+   * Whether summarization is active.
+   */
+  enabled: boolean;
+  /**
+   * Target maximum tokens for the full loop context.
+   */
+  maxTokensBudget: number;
+  /**
+   * Number of most-recent iterations to keep verbatim (never summarized).
+   */
+  preserveLastNIterations: number;
+  /**
+   * Cap on tokens emitted by a single summarization pass.
+   */
+  summaryMaxTokens: number;
+  /**
+   * Fraction of the token budget (0.0–1.0) at which summarization triggers.
+   */
+  tokenThresholdPct: number;
+}