Synaro

Synaro docs

AI task engine

Clarification, orchestration, Moonshot/Kimi integration, and task statuses.

AI work is asynchronous. The app calls the ai-orchestration-service, which may ask follow-up questions, then runs ANALYZING → GENERATING → APPLYING before marking DONE or FAILED.

Flow

  1. User sends a prompt from AI chat (optionally after voice capture)
  2. App may call /api/projects/[id]/ai-clarify for structured questions
  3. Submission creates a task polled via /api/ai-tasks/[taskId]
  4. Orchestrator reads the workspace via environment-service and writes file patches
  5. UI shows progress, resulting paths, and errors inline in the thread

Configuration

Set KIMI_API_KEY (Moonshot) in the orchestration service environment. Without a valid key, tasks fail with authentication errors from the provider.