SynthLabs Generation

SynthLabs Generation

Overview

Use this skill for repeatable, backend-first SynthLabs workflows such as listing sessions, creating sessions, and calling generation routes from a healthy local instance. This skill documents existing SynthLabs HTTP routes and zorai workflow guidance only. Do not assume dedicated zorai SynthLabs tools exist.

When to Use

Use this skill when:

• the task can stay in HTTP-driven session or generation flows,
• the operator wants scripted or repeatable dataset-generation steps,
• a healthy SynthLabs backend already exists,
• or long-running generation work should be attached to a zorai task or goal.

Do not use this skill when:

• the operator needs verifier review, data preview, settings inspection, or DEEP mode,
• provider credential entry must happen in the SynthLabs UI,
• or the task is about starting or repairing the local SynthLabs instance rather than using it.

Backend-First Workflow Rules

• Start backend-first: list or create sessions over HTTP before opening the browser.
• Prefer GET /api/sessions and POST /api/sessions for repeatable session discovery and session setup.
• Hand DEEP-mode, verifier review, data preview, and other visually inspected flows to synthlabs-ui-operator.
• Use zorai tasks or goals for long-running generation work so retries, notes, and follow-up review stay attached to the run.

Backend vs. UI Routing

• Stay in backend mode for session listing, session creation, scripted generation, and other repeatable HTTP workflows.
• Switch to synthlabs-ui-operator when the operator needs to inspect prompts, review generated rows, enter provider credentials, use DEEP mode, or confirm output visually.
• If a direct AI route call would require inventing or reverse-engineering key encryption, stop and use SynthLabs setup or UI instead.

Credential Boundary

• Use POST /api/ai/generate or POST /api/ai/generate/stream only when you already have a SynthLabs-compatible encrypted apiKey value.
• server/utils/keyEncryption.js decrypts apiKey with AES-256-CBC using a key derived from VITE_API_KEY_SALT or API_KEY_SALT.
• Do not post a plaintext provider key directly to the AI routes.
• If the only credential available is a plaintext provider key, route setup through synthlabs-setup or the SynthLabs UI instead of guessing the encryption format.