@possibl/rcrt-sdk 0.1.1 → 0.1.3

package/src/types/card.ts

@@ -1,298 +0,0 @@
-/**
- * JIT UI Card contract.
- *
- * The universal structure every pending-action breadcrumb carries in
- * `content.card`. Mirrors the OpenAPI schemas under
- * `#/components/schemas/Card*`. See
- * `packages/docs/concepts/05-jit-ui.md` for the mental model.
- */
-
-export type CardLayout =
-  | 'claim'
-  | 'list-feed'
-  | 'timeline'
-  | 'stat'
-  | 'chart'
-  | 'compare'
-  | 'draft'
-  | 'decision'
-  | 'rating'
-  | 'input'
-  | 'progress'
-  | 'receipt'
-  | 'connect'
-  | 'info';
-
-export type ActionStyle = 'primary' | 'secondary' | 'ghost' | 'destructive';
-
-export interface CardAction {
-  /**
-   * PATCHed as `content.status` when the user taps. Canonical values:
-   * `approved` / `rejected` / `dismissed` / `edited`. Custom ids are
-   * allowed and land in `content.user_response.status`.
-   */
-  id: string;
-  label: string;
-  style?: ActionStyle;
-  emoji?: string;
-  /** Explicit result; default when absent is `{status: id}`. */
-  result?: { status: string; user_response?: unknown };
-}
-
-export interface CardHeader {
-  title: string;
-  emoji?: string;
-  /** Lucide icon name. Fallback when emoji isn't set. */
-  icon?: string;
-  subtitle?: string;
-  /** Drives chart palette and home-feed placement. e.g. `health`, `finance`. */
-  domain_tag?: string;
-}
-
-export interface CardFooter {
-  actions?: CardAction[];
-  dismissable?: boolean;
-}
-
-// ── Chart kinds ──────────────────────────────────────────────────
-
-export type TrendDirection = 'up' | 'down' | 'flat';
-
-export type ChartSpec =
-  | {
-      kind: 'spark';
-      points: number[];
-      trend?: TrendDirection;
-    }
-  | {
-      kind: 'line';
-      series: Array<{
-        label?: string;
-        points: Array<[string, number]>;
-      }>;
-      y_target?: number;
-      y_unit?: string;
-    }
-  | {
-      kind: 'bar';
-      bars: Array<{ label: string; value: number; highlight?: boolean }>;
-      orientation?: 'h' | 'v';
-      y_unit?: string;
-    }
-  | {
-      kind: 'area';
-      points: Array<[string, number]>;
-      y_target?: number;
-      y_unit?: string;
-    }
-  | {
-      kind: 'ring';
-      value: number;
-      max: number;
-      label?: string;
-      value_label?: string;
-    }
-  | {
-      kind: 'heatmap';
-      cells: number[][];
-      x_labels?: string[];
-      y_labels?: string[];
-    }
-  | {
-      kind: 'histogram';
-      buckets: Array<{ label: string; count: number }>;
-    };
-
-// ── Rows (used by list-feed, timeline, decision, compare, claim) ──
-
-export interface TextRow {
-  kind: 'text';
-  text: string;
-  badge?: string;
-}
-
-/**
- * Flexible text row shape. Agents frequently reach for natural field
- * names like `{label, detail, meta}` when listing email-ish items.
- * Renderers should accept either shape; this SDK re-exports the
- * strict `TextRow` as the canonical type and the loose shape as a
- * helper for consumers writing their own renderers.
- */
-export interface FlexibleTextRow {
-  kind?: 'text';
-  text?: string;
-  label?: string;
-  title?: string;
-  name?: string;
-  detail?: string;
-  subtitle?: string;
-  snippet?: string;
-  description?: string;
-  meta?: string;
-  badge?: string;
-  when?: string;
-  value?: string | number;
-}
-
-export interface ClaimRow {
-  kind: 'claim';
-  claim: string;
-  confidence?: 'low' | 'med' | 'high';
-  /** Longer context shown when the user expands a "why" drawer. */
-  why?: string;
-  /** Breadcrumb id the claim derives from. */
-  source_ref?: string;
-}
-
-export interface MetricRow {
-  kind: 'metric';
-  label: string;
-  /** Formatted display value — "6h 45m", "$1,420", "42%". */
-  value: string;
-  trend?: TrendDirection;
-  target?: string;
-  spark?: ChartSpec;
-}
-
-export interface EventRow {
-  kind: 'event';
-  title: string;
-  starts_at: string;
-  duration_min?: number;
-  location?: string;
-  who?: string[];
-  emoji?: string;
-}
-
-export interface PersonRow {
-  kind: 'person';
-  name: string;
-  avatar_hint?: string;
-  relationship?: string;
-  last_touch?: string;
-  spark?: ChartSpec;
-  quick_actions?: CardAction[];
-}
-
-export interface PlaceRow {
-  kind: 'place';
-  label: string;
-  address?: string;
-  lat_lng?: [number, number];
-}
-
-export interface ToggleRow {
-  kind: 'toggle';
-  label: string;
-  enabled: boolean;
-  action_id: string;
-}
-
-export interface DraftPreviewRow {
-  kind: 'draft-preview';
-  lines: string[];
-  body?: string;
-}
-
-export interface ChartRow {
-  kind: 'chart';
-  chart: ChartSpec;
-  caption?: string;
-}
-
-export type Row =
-  | TextRow
-  | ClaimRow
-  | MetricRow
-  | EventRow
-  | PersonRow
-  | PlaceRow
-  | ToggleRow
-  | DraftPreviewRow
-  | ChartRow;
-
-// ── Layout-specific body helpers ────────────────────────────────
-
-export interface DraftPreview {
-  kind: 'email' | 'calendar-event' | 'message' | 'ritual' | 'task' | 'custom';
-  subject?: string;
-  to?: string[];
-  from?: string;
-  starts_at?: string;
-  duration_min?: number;
-  location?: string;
-  body: string;
-}
-
-export type InputSpec = {
-  id: string;
-  label: string;
-  placeholder?: string;
-  kind?: 'text' | 'textarea' | 'email' | 'url' | 'number' | 'time' | 'date';
-  default_value?: string;
-};
-
-export type RatingSpec =
-  | { kind: 'scale'; min: number; max: number; step?: number; label?: string }
-  | {
-      kind: 'emoji';
-      options: Array<{ id: string; emoji: string; label: string }>;
-    };
-
-export interface ProgressState {
-  /** 0..1, or `null` for indeterminate. */
-  pct?: number | null;
-  step?: string;
-}
-
-export interface ConnectDetails {
-  service_id: string;
-  scope_description?: string;
-  account_label?: string;
-  ask_label?: boolean;
-}
-
-export interface CompareColumn {
-  title: string;
-  subtitle?: string;
-  rows: Row[];
-  action_id?: string;
-}
-
-export interface CardBody {
-  text?: string;
-  rows?: Row[];
-  metrics?: MetricRow[];
-  chart?: ChartSpec;
-  draft?: DraftPreview;
-  inputs?: InputSpec[];
-  rating?: RatingSpec;
-  progress?: ProgressState;
-  connect?: ConnectDetails;
-  columns?: CompareColumn[];
-}
-
-export interface Card {
-  layout: CardLayout;
-  header: CardHeader;
-  body?: CardBody;
-  footer?: CardFooter;
-  /** Default `chat`. `home` → goes on the Awaiting-you feed. */
-  target?: 'chat' | 'home' | 'both';
-  entity_refs?: string[];
-  /**
-   * Optional explicit dedupe key. Without one, the server applies an
-   * implicit `(layout, service_id, title)` key for `connect` cards
-   * and `(layout, title)` otherwise.
-   */
-  dedupe_key?: string;
-}
-
-// ── Resolution ───────────────────────────────────────────────────
-
-export type CanonicalStatus = 'pending' | 'approved' | 'rejected' | 'dismissed' | 'edited';
-
-export interface ResolveRequest {
-  status: CanonicalStatus | string;
-  user_response?: unknown;
-}