ThiaQ Scenario Planner

Reference planner and judge helpers for customer-owned ThiaQ adapters.

The package is opt-in. Product adapters still own product semantics, auth, fixtures, canvas drivers, and final success criteria. This package provides a deterministic heuristic loop that can be used as a starter implementation or as a fallback behind product-specific scenario code.

import { defineThiaQAdapter } from "@thiaq/adapter-contract";
import {
  createCanvasSupportPlanner,
  runScenarioWithPlanner,
} from "@thiaq/scenario-planner";

const planner = createCanvasSupportPlanner({
  productHints: {
    preferredControlNames: ["New", "Create", "Import", "Share"],
  },
  canvas: {
    requireDriverForCanvasGoals: true,
    terms: ["canvas", "diagram", "shape", "connector"],
  },
});

export default defineThiaQAdapter({
  id: "my-product",
  capabilities: {
    capabilities: ["scenario"],
    jobTypes: ["scenario"],
  },
  runScenario: (context, job) => runScenarioWithPlanner(context, job, planner),
});

For canvas-heavy products, pass canvas hints and add product-specific planner steps where the generic planner reports a driver_needed coverage gap.