prowler/ui/types/lighthouse-skills.ts

import type { LucideIcon } from "lucide-react";

export const LIGHTHOUSE_SKILL_ID = {
  CONTEXTUAL_FIX: "contextual-fix",
  TRIAGE_DECISION: "triage-decision",
  SYSTEMIC_SCOPE: "systemic-scope",
  COMPLIANCE_IMPACT: "compliance-impact",
  PROVIDER_CONNECTION_GUIDE: "provider-connection-guide",
} as const;

export type LighthouseSkillId =
  (typeof LIGHTHOUSE_SKILL_ID)[keyof typeof LIGHTHOUSE_SKILL_ID];

// Where a skill is offered: finding menus never list wizard-only skills.
export const LIGHTHOUSE_SKILL_SURFACE = {
  FINDING: "finding",
  PROVIDER_WIZARD: "provider-wizard",
} as const;

export type LighthouseSkillSurface =
  (typeof LIGHTHOUSE_SKILL_SURFACE)[keyof typeof LIGHTHOUSE_SKILL_SURFACE];

// Persisted reference stored in a user message part's `ui_skill` content field.
// It is what lets the UI render the skill card after a reload, so it carries
// the display name and version alongside the id.
export interface LighthouseSkillRef {
  skillId: string;
  name: string;
  version: number;
}

export interface LighthouseSkillDefinition {
  id: LighthouseSkillId;
  name: string;
  description: string;
  icon: LucideIcon;
  surface: LighthouseSkillSurface;
  // Full self-contained prompt authored by the DyR team: tool loading, step
  // order and report shape. There is no step plan protocol: the agent decides
  // its own flow, and the UI reports progress from real stream events.
  prompt: string;
  // Suggested follow-up skill shown on the completed state ("Next: ... →").
  nextSkillId: LighthouseSkillId | null;
  // Disabled skills render as "coming soon" and cannot be launched (e.g.
  // Compliance Impact, whose prompt is blocked on a missing MCP tool).
  enabled: boolean;
  version: number;
}