Epic 22 — CAS AI Concierge

"CAS" scans social media platforms and aggregates public videos of relevant talents into a curated shortlist for producers. Referenced in spec "AFTER THOUGHTS #4".

⏸️ DEFERRED (decision 2026-06-20). Parked behind Epic 23 (Personal Concierge, shipped) due to external dependencies + risk: paid SerpAPI plan (per-search cost), social-scraping ToS/legal exposure, GPT-4o Vision cost per result, and the Gold tier's 48h re-check background job. Locked-in decisions for when we build it: (1) use a paid SerpAPI plan rather than raw HTML-scraping — official structured results, no markup-breakage or IP-blocks; (2) not free for any tier — CasTars Bronze/Silver/Gold is the only gate (mirrors the Epic 23 "paid service" decision; ignore the original spec's "free for top producer tier"). Revisit post-beta.

---

BE-CAS-001 — CAS AI Concierge backend

• [ ] Pending

Files:

• Create: src/services/ai/casAgent.ts — orchestration layer (LLM + scraping)
• Edit: src/graphql/schema/index.ts — add casSearch mutation
• Create: src/graphql/resolvers/cas.ts

Mutation:

casSearch(request: String!, tier: CasTier!): CASResult!

enum CasTier { BRONZE SILVER GOLD }

type CASResult {
  id:        ID!
  request:   String!
  results:   [CASCandidate!]!
  createdAt: DateTime!
}

type CASCandidate {
  name:        String!
  platform:    String!   // "INSTAGRAM" | "TIKTOK" | "YOUTUBE"
  profileUrl:  String!
  previewUrl:  String!   // thumbnail or embed
  relevance:   Float!    // 0–1 AI score
  reason:      String!   // why CAS thinks this matches
}

Implementation:

• Use GPT-4o to parse the natural language request into structured search terms (talent type, location, characteristics).
• Use SerpAPI (or equivalent) to search public Instagram/TikTok/YouTube for matching profiles/videos.
• Re-rank results with GPT-4o Vision scoring against the original request.
• Cache results (Redis, TTL 24 h) keyed by hash(request + tier).

Pricing:

• BRONZE (Quick Scan) → 5,000 CasTars: top 5 results, surface-level search.
• SILVER (Deep Dive) → 10,000 CasTars: top 15 results, broader platform coverage.
• GOLD (Priority Search) → 25,000 CasTars: top 30 results, full platform sweep + recheck every 6 h for 48 h.
• Free for top producer subscription tier (gate by plan check before CasTars deduction).

---

FE-CAS-001 — CAS AI Concierge UI

• [ ] Pending

Files:

• Create: apps/app/src/pages/cas/CASPage.tsx
• Create: apps/app/src/hooks/useCASSearch.ts
• Edit: apps/app/src/App.tsx — add /cas route (producer-only)

Description:

• Natural language search bar ("Need a fire juggler in NYC").
• Tier picker (Bronze / Silver / Gold) with CasTars cost shown. Deducted on submit.
• Loading state with animated "CAS is scouting…" indicator.
• Results grid: candidate cards (platform icon, profile link, preview thumbnail, relevance score, AI reason). "Save to Folder" button on each (ties into Epic 19).
• Search history: previous CAS searches listed with their results (cached).