@qontinui/shared-types 0.2.1

package/src/generated/Ticket.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 { TicketSource } from './TicketSource';
+import type { TicketState } from './TicketState';
+
+/**
+ * A ticket fetched from an external provider.
+ *
+ * Identity is carried by `(source, external_id)` — `external_id` is the
+ * provider-specific identifier (GitHub issue number, Linear identifier, Jira
+ * key) rather than a runner-assigned UUID.
+ */
+export interface Ticket {
+  /**
+   * Assignee username / handle, if any.
+   */
+  assignee?: string | null;
+  /**
+   * Ticket body / description (Markdown for GitHub/Linear, wiki-markup on Jira).
+   */
+  body: string;
+  /**
+   * ISO 8601 timestamp when the ticket was created.
+   */
+  createdAt: string;
+  /**
+   * Provider-assigned external ID (issue number, ticket key, etc.).
+   */
+  externalId: string;
+  /**
+   * Labels applied to the ticket by the provider.
+   */
+  labels?: string[];
+  source: TicketSource;
+  state: TicketState;
+  /**
+   * Ticket title / summary.
+   */
+  title: string;
+  /**
+   * ISO 8601 timestamp when the ticket was last updated.
+   */
+  updatedAt: string;
+  /**
+   * Canonical URL to the ticket in the provider's UI.
+   */
+  url: string;
+}

package/src/generated/TicketComment.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`.
+ */
+
+/**
+ * A comment on a ticket.
+ */
+export interface TicketComment {
+  /**
+   * Comment author's username / handle.
+   */
+  author: string;
+  /**
+   * Comment body (Markdown for GitHub/Linear, wiki-markup on Jira).
+   */
+  body: string;
+  /**
+   * ISO 8601 timestamp when the comment was created.
+   */
+  createdAt: string;
+  /**
+   * Provider-assigned comment ID.
+   */
+  id: string;
+}

package/src/generated/TicketProviderConfig.d.ts

@@ -0,0 +1,55 @@
+/* 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 { TicketSource } from './TicketSource';
+
+/**
+ * Configuration for a ticket provider watcher.
+ *
+ * Persisted in `workflow_triggers.trigger_config` and
+ * `ticket_provider_configs.config_json` so that watcher processes can be
+ * reconstructed across runner restarts.
+ *
+ * **Security**: `api_token` is a secret. This struct serializes it so that
+ * the same shape works for at-rest persistence, but MCP / HTTP API
+ * responses exposing this config to end-user UIs MUST redact the token
+ * before returning. See the module-level doc for the full policy.
+ */
+export interface TicketProviderConfig {
+  /**
+   * Labels / filters that mark a ticket as "actionable" (i.e. eligible to
+   * spawn a workflow task). All listed labels must be present for a match.
+   */
+  actionableLabels?: string[];
+  /**
+   * API token for the provider. **Secret** — see security note above.
+   * Persisted in the DB so the watcher can reconstruct a provider across
+   * restarts; redact before exposing over UI-facing APIs.
+   */
+  apiToken: string;
+  /**
+   * Poll interval in seconds. Default: 60.
+   */
+  pollIntervalSeconds: number;
+  source: TicketSource;
+  /**
+   * Provider-specific target:
+   * - GitHub: `"owner/repo"`
+   * - Linear: team key (e.g. `"ENG"`)
+   * - Jira: project key
+   */
+  target: string;
+  /**
+   * Whether to update the remote ticket's state when the spawned task
+   * completes. Default: true.
+   */
+  updateOnCompletion: boolean;
+  /**
+   * ID of the workflow to spawn for matched tickets.
+   */
+  workflowId: string;
+}

package/src/generated/TicketSource.d.ts

@@ -0,0 +1,17 @@
+/* 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`.
+ */
+
+/**
+ * Which ticket provider a config / ticket refers to.
+ *
+ * Serialized as the lowercase provider tag (`"github"`, `"linear"`, `"jira"`)
+ * to match the on-the-wire tags used by the watcher config, the MCP API
+ * layer, and the runner's DB storage keys. Variants are explicitly renamed
+ * because `rename_all = "snake_case"` would emit `"git_hub"` for the
+ * `GitHub` variant, which would drift from the existing persisted rows.
+ */
+export type TicketSource = "github" | "linear" | "jira";

package/src/generated/TicketState.d.ts

@@ -0,0 +1,15 @@
+/* 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`.
+ */
+
+/**
+ * Abstract, provider-neutral ticket lifecycle state.
+ *
+ * Maps onto provider-specific states (`open` / `closed` on GitHub, workflow
+ * state types on Linear, etc.) inside the runner's provider implementations.
+ * Serialized as `snake_case`.
+ */
+export type TicketState = "open" | "in_progress" | "done" | "closed";

package/src/generated/TimingInfo.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`.
+ */
+
+/**
+ * Precise timing information for an event. Times are ISO 8601 strings (see
+ * crate-level docs for the rationale — the types crate is wire-only and
+ * doesn't depend on a chrono version).
+ */
+export interface TimingInfo {
+  durationMs?: number | null;
+  /**
+   * ISO 8601 timestamp. `None` while the event is still in flight.
+   */
+  endTime?: string | null;
+  /**
+   * ISO 8601 timestamp.
+   */
+  startTime: string;
+}

package/src/generated/TopMatch.d.ts

@@ -0,0 +1,17 @@
+/* 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';
+
+/**
+ * A single match result with confidence and location.
+ */
+export interface TopMatch {
+  confidence: number;
+  dimensions?: MatchLocation | null;
+  location: MatchLocation;
+}

package/src/generated/TransitionAction.d.ts

@@ -0,0 +1,93 @@
+/* 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 { TransitionActionValue } from './TransitionActionValue';
+
+/**
+ * A single action within a transition.
+ *
+ * Each action targets an element and performs an interaction. Most fields are
+ * only meaningful for specific action types — see the per-field docs.
+ */
+export interface TransitionAction {
+  /**
+   * Mouse button: `left`, `right`, `middle`
+   * (`click` / `doubleClick` / `rightClick`).
+   */
+  button?: MouseButton | null;
+  /**
+   * Clear before typing (`type` action).
+   */
+  clear_first?: boolean | null;
+  /**
+   * Delay in milliseconds (`wait` action).
+   */
+  delay_ms?: number | null;
+  /**
+   * Hold delay before the first move in milliseconds (`drag` action).
+   */
+  drag_hold_delay?: number | null;
+  /**
+   * Dispatch HTML5 drag events alongside mouse events (`drag` action).
+   */
+  drag_html5?: boolean | null;
+  /**
+   * Number of intermediate mousemove steps (`drag` action).
+   */
+  drag_steps?: number | null;
+  /**
+   * Drag target element ID or selector (`drag` action).
+   */
+  drag_target?: string | null;
+  /**
+   * Drag target position (e.g., `{ x, y }` stringified, or a named
+   * position) (`drag` action).
+   */
+  drag_target_position?: string | null;
+  /**
+   * Click position relative to the element
+   * (`click` / `doubleClick` / `rightClick`).
+   */
+  position?: Point | null;
+  /**
+   * Scroll amount in pixels (`scroll` action).
+   */
+  scroll_amount?: number | null;
+  /**
+   * Scroll direction (`scroll` action).
+   */
+  scroll_direction?: ScrollDirection | null;
+  /**
+   * Select by label instead of value (`select` action).
+   */
+  select_by_label?: boolean | null;
+  /**
+   * Target element ID (used by most element actions).
+   */
+  target?: string | null;
+  /**
+   * Text to type (`type` action).
+   */
+  text?: string | null;
+  type: StandardActionType;
+  /**
+   * Keystroke delay in milliseconds (`type` action).
+   */
+  type_delay?: number | null;
+  /**
+   * URL to navigate to (`navigate` action).
+   */
+  url?: string | null;
+  /**
+   * Value to select or set (`select` / `setValue` actions).
+   */
+  value?: TransitionActionValue | null;
+}

package/src/generated/TransitionActionValue.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`.
+ */
+
+/**
+ * A value for `select` / `setValue` actions: either a single string or a list
+ * of strings (for multi-select).
+ *
+ * Serialized as an untagged union matching the TS `string | string[]`.
+ */
+export type TransitionActionValue = string | string[];

package/src/generated/TransitionEdgeData.d.ts

@@ -0,0 +1,46 @@
+/* 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 { StandardActionType } from './StandardActionType';
+
+/**
+ * Data passed to a transition edge in the ReactFlow graph editor.
+ */
+export interface TransitionEdgeData {
+  /**
+   * Number of actions in this transition.
+   */
+  actionCount: number;
+  /**
+   * Distinct action types used.
+   */
+  actionTypes: StandardActionType[];
+  /**
+   * Target of the first action, for label rendering.
+   */
+  firstActionTarget?: string | null;
+  /**
+   * Whether the edge is highlighted (e.g., part of a path preview).
+   */
+  isHighlighted: boolean;
+  /**
+   * Display name.
+   */
+  name: string;
+  /**
+   * Path cost.
+   */
+  pathCost: number;
+  /**
+   * Whether source states stay visible after activation.
+   */
+  staysVisible: boolean;
+  /**
+   * Transition ID this edge represents.
+   */
+  transitionId: string;
+}

package/src/generated/TransitionExecutionResult.d.ts

@@ -0,0 +1,30 @@
+/* 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`.
+ */
+
+/**
+ * Result of executing a single state transition at runtime.
+ *
+ * Returned by the runner's Tauri commands or the qontinui Python subprocess.
+ */
+export interface TransitionExecutionResult {
+  /**
+   * States that are active after the transition.
+   */
+  active_states: string[];
+  /**
+   * Error message when execution failed.
+   */
+  error?: string | null;
+  /**
+   * Whether the transition executed successfully.
+   */
+  success: boolean;
+  /**
+   * Logical transition ID that was executed.
+   */
+  transition_id: string;
+}

package/src/generated/TransitionInfo.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`.
+ */
+
+/**
+ * Information about a single available transition from the current state.
+ */
+export interface TransitionInfo {
+  /**
+   * Source state ID.
+   */
+  from_state: string;
+  /**
+   * Transition ID.
+   */
+  id: string;
+  /**
+   * Destination state ID (`null` if the transition stays within the same
+   * state set — e.g. a self-transition or a guard-only action).
+   */
+  to_state: string | null;
+  /**
+   * Names of workflows attached to this transition.
+   */
+  workflows: string[];
+}

package/src/generated/TransitionTriggerType.d.ts

@@ -0,0 +1,13 @@
+/* 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`.
+ */
+
+/**
+ * Type of action that triggers a state transition.
+ *
+ * Mirrors Python `TransitionTriggerType(str, Enum)`.
+ */
+export type TransitionTriggerType = "click" | "type" | "scroll" | "hover" | "custom";

package/src/generated/TreeEvent.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 { 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 { PathElement } from './PathElement';
+import type { RuntimeData } from './RuntimeData';
+import type { StateContext } from './StateContext';
+import type { TimingInfo } from './TimingInfo';
+import type { TopMatch } from './TopMatch';
+import type { TreeEventType } from './TreeEventType';
+import type { TreeNode } from './TreeNode';
+
+/**
+ * A tree event emitted during execution.
+ *
+ * Primary event type for execution logging. Carries the event type, the
+ * affected node with full metadata, the path from root to this node, and
+ * a sequence number for ordering.
+ */
+export interface TreeEvent {
+  eventType: TreeEventType;
+  node: TreeNode;
+  /**
+   * Path from root to this node (breadcrumb).
+   */
+  path: PathElement[];
+  /**
+   * Sequence number for ordering.
+   */
+  sequence: number;
+  /**
+   * When this event was emitted (Unix epoch seconds).
+   */
+  timestamp: number;
+  /**
+   * Event type identifier — always `"tree_event"` on the wire.
+   */
+  type: string;
+}

package/src/generated/TreeEventCreate.d.ts

@@ -0,0 +1,30 @@
+/* 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 { NodeMetadata } from './NodeMetadata';
+import type { NodeStatus } from './NodeStatus';
+import type { NodeType } from './NodeType';
+import type { Outcome } from './Outcome';
+import type { PathElement } from './PathElement';
+import type { RuntimeData } from './RuntimeData';
+import type { StateContext } from './StateContext';
+import type { TimingInfo } from './TimingInfo';
+import type { TopMatch } from './TopMatch';
+import type { TreeEventType } from './TreeEventType';
+import type { TreeNode } from './TreeNode';
+
+/**
+ * Request to store a tree event.
+ */
+export interface TreeEventCreate {
+  eventType: TreeEventType;
+  node: TreeNode;
+  path: PathElement[];
+  sequence: number;
+  timestamp: number;
+}

package/src/generated/TreeEventListResponse.d.ts

@@ -0,0 +1,30 @@
+/* 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 { NodeMetadata } from './NodeMetadata';
+import type { NodeStatus } from './NodeStatus';
+import type { NodeType } from './NodeType';
+import type { Outcome } from './Outcome';
+import type { PathElement } from './PathElement';
+import type { RuntimeData } from './RuntimeData';
+import type { StateContext } from './StateContext';
+import type { TimingInfo } from './TimingInfo';
+import type { TopMatch } from './TopMatch';
+import type { TreeEventResponse } from './TreeEventResponse';
+import type { TreeEventType } from './TreeEventType';
+
+/**
+ * Paginated list of tree events.
+ */
+export interface TreeEventListResponse {
+  events: TreeEventResponse[];
+  hasMore: boolean;
+  limit: number;
+  offset: number;
+  total: number;
+}

package/src/generated/TreeEventResponse.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 { 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 { PathElement } from './PathElement';
+import type { RuntimeData } from './RuntimeData';
+import type { StateContext } from './StateContext';
+import type { TimingInfo } from './TimingInfo';
+import type { TopMatch } from './TopMatch';
+import type { TreeEventType } from './TreeEventType';
+
+/**
+ * Response for a stored tree event.
+ */
+export interface TreeEventResponse {
+  /**
+   * ISO 8601 timestamp.
+   */
+  createdAt: string;
+  errorMessage?: string | null;
+  eventTimestamp: number;
+  eventType: TreeEventType;
+  /**
+   * UUID as string (wire-format — see crate-level docs).
+   */
+  id: string;
+  metadata?: NodeMetadata | null;
+  nodeId: string;
+  nodeName: string;
+  nodeType: NodeType;
+  parentNodeId?: string | null;
+  path: PathElement[];
+  /**
+   * Run UUID as string.
+   */
+  runId: string;
+  sequence: number;
+  status: NodeStatus;
+}

package/src/generated/TreeEventType.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`.
+ */
+
+/**
+ * Types of tree events emitted during execution.
+ */
+export type TreeEventType =
+  | "workflow_started"
+  | "workflow_completed"
+  | "workflow_failed"
+  | "action_started"
+  | "action_completed"
+  | "action_failed"
+  | "transition_started"
+  | "transition_completed"
+  | "transition_failed";

package/src/generated/TreeNode.d.ts

@@ -0,0 +1,54 @@
+/* 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 { 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';
+
+/**
+ * A node in the execution tree — a single workflow, action, or transition
+ * in the execution hierarchy.
+ */
+export interface TreeNode {
+  /**
+   * Duration in seconds.
+   */
+  duration?: number | null;
+  /**
+   * When this node completed (Unix epoch seconds).
+   */
+  endTimestamp?: number | null;
+  /**
+   * Error message if `status == Failed`.
+   */
+  error?: string | null;
+  /**
+   * Unique identifier for this node.
+   */
+  id: string;
+  metadata?: NodeMetadata & {};
+  /**
+   * Display name for this node.
+   */
+  name: string;
+  nodeType: NodeType;
+  /**
+   * ID of parent node, `None` for root.
+   */
+  parentId?: string | null;
+  status: NodeStatus;
+  /**
+   * When this node was created (Unix epoch seconds).
+   */
+  timestamp: number;
+}