@kairos.ai/studio-ui

Studio UI da KairOS-Platform — componentes React para prompt engineering, thresholds, test suites e analytics dos SaaS VilelaAI.

Complementa o @kairos.ai/runtime fornecendo a camada visual para operar agentes de IA em produção.

Instalação

npm install @kairos.ai/studio-ui
# ou
pnpm add @kairos.ai/studio-ui

Peer dependencies

O consumidor precisa instalar:

npm install react react-dom @supabase/supabase-js @tanstack/react-query

Setup do banco

Aplique o schema base (tabelas de prompts, versões, test suites, thresholds, analytics) antes de usar:

psql $DATABASE_URL -f node_modules/@kairos.ai/studio-ui/sql/setup.sql

O arquivo sql/setup.sql vai distribuído dentro do pacote.

Uso básico

import { KairosStudioUI } from '@kairos.ai/studio-ui'
import type { StudioConfig } from '@kairos.ai/studio-ui'

const config: StudioConfig = {
  productKey: 'jurixia',
  supabaseUrl: process.env.NEXT_PUBLIC_SUPABASE_URL!,
  supabaseAnonKey: process.env.NEXT_PUBLIC_SUPABASE_ANON_KEY!,
  agents: [
    { key: 'triagem', label: 'Triagem de Petição', ... },
  ],
  domains: ['civel', 'trabalhista'],
  placeholders: ['{{peticao}}', '{{parte}}'],
  edgeFunctionsUrl: 'https://<project>.functions.supabase.co',
  getAuthToken: async () => (await supabase.auth.getSession()).data.session?.access_token ?? null,
}

export default function StudioPage() {
  return <KairosStudioUI config={config} />
}

Tabs disponíveis

Todas habilitadas por padrão; desative individualmente via config.tabs:

• catalog — catálogo de agentes
• editor — edição de prompts com lint de placeholders
• playground — execução ad-hoc contra o runtime
• testSuites — CRUD, execução e histórico de suites
• thresholds — readiness checklist e validação
• history — versões, diff e publicação
• analytics — KPIs, gráficos e detalhamento

Exports adicionais

import {
  DEFAULT_EVAL_DIMENSIONS,
  lintPlaceholders,
  type StudioConfig,
  type EvalDimension,
  type AgentDefinition,
  type LintResult,
  type PromptVersion,
  type AgentThresholds,
  type FailedRule,
  type ThresholdValidationResult,
  type TestSuite,
  type TestRun,
  type TestEvaluation,
  type RegressionStatus,
} from '@kairos.ai/studio-ui'

Licença

UNLICENSED — uso restrito à VilelaAI e parceiros autorizados.