Add interview-first sparkle-pills chat chaining and deterministic plan response

[Codex]

Canonical issue

Linked by system automation.

Outcome

This PR adds an interview-first path for “sparkle pills” requests so the system asks clarifying questions before proposing a workflow. When required answers are provided, it returns a deterministic, action-oriented plan without invoking model providers.

Scope

• Included:
• Sparkle intent gate: detects sparkle-pill requests in chat input and routes them through a dedicated chaining contract.
• Interview-first response: returns requiresInterview: true plus targeted clarifying questions when required fields are missing.
• Deterministic plan response: returns provider: "sparkle-pills-planner" and a structured operational plan once interview fields are complete.
• Contract documentation: adds CHAINING.md with request/response schema and runtime behavior.
• Focused API coverage: adds tests for both interview-first and completed-interview plan paths.
• Example snippet:

{
  "query": "Build me a system for using sparkle pills",
  "sparkleInterview": {
    "useCase": "Manage weekday focus sessions",
    "trigger": "Start each weekday at 08:30",
    "tools": ["Google Calendar", "Slack"],
    "constraints": "No notifications after 21:00",
    "successSignal": "5 sessions completed per week"
  }
}

• Explicitly excluded:
• Changes to non-sparkle chat routing behavior.
• Any new external integrations, deployment workflows, or dependency updates.

Risk

• Risk level: low
• Failure mode:
  Sparkle detection could match unintended prompts and return interview payloads instead of normal chat output.
• Rollback:
  Revert the sparkle branch in apps/web/src/app/api/chat/route.ts and remove apps/web/src/lib/sparkle-pills.ts.

Verification

List exact automated and manual checks, tied to the current head SHA.

• Focused tests
• Required CI
• Review threads resolved

Production evidence

Not applicable for production behavior claims in this PR description; change is API-path scoped and documented by route contract (CHAINING.md).

Agent handoff

• One canonical issue is linked
• No competing PR implements the same issue
• Acceptance criteria are satisfied
• Required checks pass on the current head
• Human decision is requested only for product, security, irreversible infrastructure, or production approval

Security dependency evidence

• Advisory: Not applicable (no advisory-driven dependency change)
• Package and versions: Not applicable
• Validation: Not applicable
• Rollback: Not applicable

• Fixes [Agent] #2429

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated
v0-uvai	Ready	Preview, v0	Oct 15, 2026 7:04am UTC

[coderabbitai]

Important

Review skipped

Bot user detected.

To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

• Configuration used: Repository: groupthinking/EventRelay/.coderabbit.yaml
• Review profile: ASSERTIVE
• Plan: Advanced
• Run ID: 4b467169-7e12-4742-891e-19a7d8d4aba1

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

• Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[github-actions]

🔍 PR Validation

⚠️ PR title should follow conventional commits format

[Copilot]

🟡 Changes recommended

Client integration is incomplete, planning ignores video grounding, and required tools can be silently discarded.

3 open findings

• Planner ignores verified Video Pack grounding and allows unbound plans · New
• Chat clients fail to render and preserve the sparkle interview flow · New
• Planner silently drops integrations beyond the eighth · New

What changed in this PR

Adds an interview-first sparkle-pills branch to UVAI’s chat API, returning a deterministic plan without model calls once required answers are supplied.

Changes:

• Detect sparkle intent and request interview answers.
• Generate plans from completed interviews.
• Document the API contract and add focused route tests.

File	Description
CHAINING.md	Documents interview and plan payloads.
apps/​web/​src/​lib/​sparkle-pills.ts	Implements detection, answer parsing, and planning.
apps/​web/​src/​app/​api/​chat/​route.ts	Routes sparkle requests to the new handler.
apps/​web/​src/​app/​api/​__tests__/​chat-sparkle-pills-route.test.ts	Covers interview and completed-plan responses.

🧠 Review effort: Balanced

---

💡 Configure MCP servers for context-aware, tailored reviews. Learn more in the docs.