@qontinui/shared-types 0.2.1

package/dist/workflow.js

@@ -0,0 +1,11 @@
+import {
+  DEFAULT_SUMMARY_PROMPT,
+  PHASE_INFO,
+  STEP_TYPES
+} from "./chunk-ZK5MJEGT.js";
+export {
+  DEFAULT_SUMMARY_PROMPT,
+  PHASE_INFO,
+  STEP_TYPES
+};
+//# sourceMappingURL=workflow.js.map

package/dist/workflow.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/package.json

@@ -0,0 +1,136 @@
+{
+  "name": "@qontinui/shared-types",
+  "version": "0.2.1",
+  "description": "Shared TypeScript types for the Qontinui ecosystem",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./workflow": {
+      "types": "./dist/workflow.d.ts",
+      "import": "./dist/workflow.js",
+      "require": "./dist/workflow.cjs"
+    },
+    "./task-run": {
+      "types": "./dist/task-run.d.ts",
+      "import": "./dist/task-run.js",
+      "require": "./dist/task-run.cjs"
+    },
+    "./execution": {
+      "types": "./dist/execution.d.ts",
+      "import": "./dist/execution.js",
+      "require": "./dist/execution.cjs"
+    },
+    "./scheduler": {
+      "types": "./dist/scheduler.d.ts",
+      "import": "./dist/scheduler.js",
+      "require": "./dist/scheduler.cjs"
+    },
+    "./runner": {
+      "types": "./dist/runner.d.ts",
+      "import": "./dist/runner.js",
+      "require": "./dist/runner.cjs"
+    },
+    "./library": {
+      "types": "./dist/library.d.ts",
+      "import": "./dist/library.js",
+      "require": "./dist/library.cjs"
+    },
+    "./chat": {
+      "types": "./dist/chat.d.ts",
+      "import": "./dist/chat.js",
+      "require": "./dist/chat.cjs"
+    },
+    "./state-machine": {
+      "types": "./dist/state-machine.d.ts",
+      "import": "./dist/state-machine.js",
+      "require": "./dist/state-machine.cjs"
+    },
+    "./constraints": {
+      "types": "./dist/constraints.d.ts",
+      "import": "./dist/constraints.js",
+      "require": "./dist/constraints.cjs"
+    },
+    "./geometry": {
+      "types": "./dist/geometry.d.ts",
+      "import": "./dist/geometry.js",
+      "require": "./dist/geometry.cjs"
+    },
+    "./tree-events": {
+      "types": "./dist/tree-events.d.ts",
+      "import": "./dist/tree-events.js",
+      "require": "./dist/tree-events.cjs"
+    },
+    "./accessibility": {
+      "types": "./dist/accessibility.d.ts",
+      "import": "./dist/accessibility.js",
+      "require": "./dist/accessibility.cjs"
+    },
+    "./config": {
+      "types": "./dist/config.d.ts",
+      "import": "./dist/config.js",
+      "require": "./dist/config.cjs"
+    },
+    "./targets": {
+      "types": "./dist/targets.d.ts",
+      "import": "./dist/targets.js",
+      "require": "./dist/targets.cjs"
+    },
+    "./rag": {
+      "types": "./dist/rag.d.ts",
+      "import": "./dist/rag.js",
+      "require": "./dist/rag.cjs"
+    },
+    "./ui-bridge-ir": {
+      "types": "./dist/ui-bridge-ir.d.ts",
+      "import": "./dist/ui-bridge-ir.js",
+      "require": "./dist/ui-bridge-ir.cjs"
+    },
+    "./ui-bridge-ir/schema": "./src/ui-bridge-ir/ir.schema.json"
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "clean": "rimraf dist",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "qontinui",
+    "types",
+    "typescript"
+  ],
+  "author": "Joshua Spinak",
+  "license": "AGPL-3.0-or-later",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/qontinui/qontinui-schemas.git",
+    "directory": "ts"
+  },
+  "devDependencies": {
+    "@types/node": "^25.6.0",
+    "json-schema-to-typescript": "^15.0.4",
+    "rimraf": "^5.0.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.3.0",
+    "vitest": "^2.1.9"
+  },
+  "overrides": {
+    "picomatch": "^4.0.4"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/src/accessibility/_api.ts

@@ -0,0 +1,17 @@
+/**
+ * Accessibility Tree Types
+ *
+ * Accessibility-tree snapshots captured from CDP, UIA, AT-SPI, or AX.
+ * Source of truth: qontinui-schemas/rust/src/accessibility.rs.
+ *
+ * The `ref` system (`@e1`, `@e2`, …) provides stable, AI-friendly
+ * identifiers for interacting with elements without re-querying the tree.
+ */
+
+export type { AccessibilityRole } from "../generated/AccessibilityRole";
+export type { AccessibilityBackend } from "../generated/AccessibilityBackend";
+export type { AccessibilityState } from "../generated/AccessibilityState";
+export type { AccessibilityBounds } from "../generated/AccessibilityBounds";
+export type { AccessibilityNode } from "../generated/AccessibilityNode";
+export type { AccessibilitySnapshot } from "../generated/AccessibilitySnapshot";
+export type { AccessibilitySelector } from "../generated/AccessibilitySelector";

package/src/accessibility/index.ts

@@ -0,0 +1 @@
+export * from "./_api";

package/src/canvas/index.ts

@@ -0,0 +1,319 @@
+/**
+ * Canvas Types
+ *
+ * Type definitions for the A2UI (Agent-to-UI) Canvas system.
+ * Canvas panels allow the AI agent to render rich, structured visual content
+ * in the dashboard during workflow execution.
+ */
+
+/**
+ * Supported canvas component types.
+ * These are validated server-side against an allowlist.
+ */
+export type CanvasComponentType =
+  | "Markdown"
+  | "CodeDiff"
+  | "Table"
+  | "FileTree"
+  | "KeyValue"
+  | "Terminal"
+  | "Alert"
+  | "Timeline"
+  | "ProgressChart"
+  | "FindingList"
+  | "Checklist"
+  | "SummaryStats"
+  | "StateTimeline"
+  | "Waterfall"
+  | "Sparkline"
+  | "WaffleChart"
+  | "PhaseTimeline"
+  | "IterationComparison"
+  | "StepDurationChart"
+  | "PhaseDistribution"
+  | "DependencyGraph"
+  | "CostBreakdown"
+  | "MissionBrief"
+  | "AcceptanceCriteria";
+
+/**
+ * A canvas panel rendered in the dashboard.
+ */
+export interface CanvasPanel {
+  panel_id: string;
+  component: CanvasComponentType;
+  title: string;
+  data: Record<string, unknown>;
+  priority?: number;
+  size?: "compact" | "normal" | "large";
+  group?: string;
+  task_run_id?: string;
+  created_at?: string;
+  updated_at?: string;
+}
+
+/**
+ * Event emitted when a canvas panel is created, updated, or deleted.
+ */
+export interface CanvasUpdateEvent {
+  action: "create" | "update" | "delete" | "clear";
+  panel_id: string;
+  panel?: CanvasPanel;
+  task_run_id?: string;
+}
+
+// ============================================================================
+// Component-specific data schemas
+// ============================================================================
+
+/** Data for Markdown component. */
+export interface MarkdownData {
+  content: string;
+}
+
+/** Data for Table component. */
+export interface TableData {
+  columns: string[];
+  rows: (string | number | boolean | null)[][];
+  sortable?: boolean;
+}
+
+/** Data for CodeDiff component. */
+export interface CodeDiffData {
+  file_path: string;
+  language?: string;
+  old_content?: string;
+  new_content?: string;
+  unified_diff?: string;
+}
+
+/** Data for KeyValue component. */
+export interface KeyValueData {
+  pairs: Array<{
+    key: string;
+    value: string | number | boolean;
+    style?: "default" | "success" | "warning" | "error";
+  }>;
+}
+
+/** Data for Alert component. */
+export interface AlertData {
+  severity: "info" | "success" | "warning" | "error";
+  message: string;
+  details?: string;
+}
+
+/** Data for Terminal component. */
+export interface TerminalData {
+  lines: string[];
+  max_lines?: number;
+}
+
+/** Data for Timeline component. */
+export interface TimelineData {
+  events: Array<{
+    timestamp?: string;
+    title: string;
+    description?: string;
+    status?: "pending" | "running" | "success" | "failed";
+  }>;
+}
+
+/** Data for FileTree component. */
+export interface FileTreeData {
+  root: string;
+  entries: Array<{
+    path: string;
+    type: "file" | "directory";
+    status?: "added" | "modified" | "deleted";
+  }>;
+}
+
+/** Data for ProgressChart component. */
+export interface ProgressChartData {
+  segments: Array<{ label: string; value: number; color?: string }>;
+  total?: number;
+}
+
+/** Data for FindingList component. */
+export interface FindingListData {
+  findings: Array<{
+    id?: string;
+    title: string;
+    description?: string;
+    severity?: "info" | "low" | "medium" | "high" | "critical";
+    location?: string;
+  }>;
+}
+
+/** Data for Checklist component. */
+export interface ChecklistData {
+  items: Array<{
+    id: string;
+    label: string;
+    checked: boolean;
+    description?: string;
+  }>;
+}
+
+/** Data for SummaryStats component. */
+export interface SummaryStatsData {
+  total: number;
+  passed: number;
+  failed: number;
+  skipped?: number;
+  label?: string;
+}
+
+/** Data for StateTimeline component. */
+export interface StateTimelineData {
+  steps: Array<{
+    name: string;
+    iterations: Array<{
+      iteration: number;
+      status: "pass" | "fail" | "skip" | "pending";
+    }>;
+  }>;
+}
+
+/** Data for Waterfall component. */
+export interface WaterfallData {
+  entries: Array<{
+    name: string;
+    start_ms: number;
+    duration_ms: number;
+    status?: "running" | "success" | "failed" | "skipped" | "pending";
+    phase?: string;
+  }>;
+  total_duration_ms: number;
+}
+
+/** Data for Sparkline component. */
+export interface SparklineData {
+  series: Array<{
+    name: string;
+    values: Array<{
+      iteration: number;
+      outcome: "pass" | "fail";
+    }>;
+  }>;
+}
+
+/** Data for WaffleChart component. */
+export interface WaffleChartData {
+  cells: Array<{
+    label: string;
+    status: "pass" | "fail" | "pending" | "running" | "skip";
+  }>;
+  columns?: number;
+}
+
+/** Data for PhaseTimeline component. */
+export interface PhaseTimelineData {
+  phases: Array<{
+    name: string;
+    duration_ms: number;
+    status: "completed" | "running" | "pending" | "failed";
+    step_count: number;
+  }>;
+  total_duration_ms: number;
+}
+
+/** Data for IterationComparison component. */
+export interface IterationComparisonData {
+  iterations: Array<{
+    iteration: number;
+    passed: number;
+    failed: number;
+    total: number;
+  }>;
+}
+
+/** Data for StepDurationChart component. */
+export interface StepDurationChartData {
+  steps: Array<{
+    name: string;
+    duration_ms: number;
+    status: "success" | "failed" | "running" | "skipped";
+    phase?: string;
+  }>;
+  max_duration_ms: number;
+}
+
+/** Data for PhaseDistribution component. */
+export interface PhaseDistributionData {
+  segments: Array<{
+    phase: string;
+    duration_ms: number;
+    percentage: number;
+    color?: string;
+  }>;
+  total_duration_ms: number;
+}
+
+/** Data for DependencyGraph component. */
+export interface DependencyGraphData {
+  nodes: Array<{
+    id: string;
+    label: string;
+    type: string;
+    phase: string;
+    is_referenced: boolean;
+    cost_category?: string;
+  }>;
+  edges: Array<{
+    source: string;
+    target: string;
+    label?: string;
+    edge_type: "explicit_depends_on" | "implicit_reference" | "setup_provides";
+  }>;
+}
+
+/** Data for MissionBrief component. */
+export interface MissionBriefData {
+  workflow_name: string;
+  prompt: string;
+  model: string;
+  reflection: boolean;
+  approval_gate: boolean;
+  stages: Array<{
+    name: string;
+    index: number;
+    max_iterations: number;
+  }>;
+  total_stages: number;
+  max_iterations: number;
+  progress: {
+    current_stage_index: number | null;
+    current_iteration: number;
+    phase: string | null;
+    activity: string | null;
+  };
+}
+
+/** Data for AcceptanceCriteria component. */
+export interface AcceptanceCriteriaData {
+  goal_summary: string;
+  criteria: Array<{
+    id: string;
+    description: string;
+    method: "command" | "ui_bridge" | "test" | "manual";
+    priority: "critical" | "important" | "optional";
+    verification_hint: string;
+    category: string;
+    status: "pending" | "running" | "passed" | "failed" | "skipped";
+    last_error?: string;
+  }>;
+  assumptions?: string[];
+}
+
+/** Data for CostBreakdown component. */
+export interface CostBreakdownData {
+  steps: Array<{
+    name: string;
+    estimated_ms: number;
+    category: string;
+    has_side_effects: boolean;
+  }>;
+  total_estimated_ms: number;
+}

package/src/chat/_api.ts

@@ -0,0 +1,23 @@
+/**
+ * AI session types shared between web and runner frontends.
+ */
+
+/** State of an AI session. */
+export type AiSessionState =
+  | "connecting"
+  | "initializing"
+  | "ready"
+  | "processing"
+  | "interrupting"
+  | "closed"
+  | "disconnected"
+  | "error"
+  | "not_found"
+  | "restoring";
+
+/** A single message in an AI conversation. */
+export interface AiMessage {
+  role: "user" | "ai" | "system";
+  content: string;
+  timestamp?: string;
+}

package/src/chat/index.ts

@@ -0,0 +1 @@
+export * from "./_api";

package/src/config/_api.ts

@@ -0,0 +1,13 @@
+/**
+ * Config Types — AI context + workflow category
+ *
+ * Source of truth: qontinui-schemas/rust/src/config.rs.
+ *
+ * Wire convention: these types predate the snake_case migration and use
+ * camelCase field aliases on the wire (`taskMentions`, `autoInclude`,
+ * `createdAt`, `modifiedAt`, `automationEnabled`). Consumers see camelCase.
+ */
+
+export type { Context } from "../generated/Context";
+export type { ContextAutoInclude } from "../generated/ContextAutoInclude";
+export type { Category } from "../generated/Category";

package/src/config/index.ts

@@ -0,0 +1 @@
+export * from "./_api";

package/src/constraints/_api.ts

@@ -0,0 +1,17 @@
+// Types generated from Rust (source of truth: qontinui-schemas/rust/src/constraints.rs).
+// Do not edit by hand — regenerate via `just generate-types` (or
+// `qontinui-runner/src-tauri/scripts/generate_types.sh`).
+export type { Constraint } from "../generated/Constraint";
+export type { ConstraintCheck } from "../generated/ConstraintCheck";
+export type { ConstraintSeverity } from "../generated/ConstraintSeverity";
+export type { ConstraintResult } from "../generated/ConstraintResult";
+export type { ConstraintViolation } from "../generated/ConstraintViolation";
+export type { ResourceLimits } from "../generated/ResourceLimits";
+export type { ConstraintProposal } from "../generated/ConstraintProposal";
+export type { NewConstraintProposal } from "../generated/NewConstraintProposal";
+export type { BuiltinOverrideProposal } from "../generated/BuiltinOverrideProposal";
+export type { ValidateConfigRequest } from "../generated/ValidateConfigRequest";
+export type { ValidateConfigResponse } from "../generated/ValidateConfigResponse";
+export type { ReadConfigResponse } from "../generated/ReadConfigResponse";
+export type { WriteConfigRequest } from "../generated/WriteConfigRequest";
+export type { WriteConfigResponse } from "../generated/WriteConfigResponse";

package/src/constraints/index.ts

@@ -0,0 +1 @@
+export * from "./_api";