feat(I): I-ONB/I-UI/I-DASH frontend — SetupWizard, WorkstreamBlockRenderer, Dashboard platform section, API hooks, i18n, tsc clean, 11/11 dashboard tests

This commit is contained in:
Agent Zero
2026-08-19 01:33:23 +02:00
parent 92ac6229d2
commit 0670fdb437
6 changed files with 879 additions and 4 deletions
@@ -0,0 +1,136 @@
/**
* SetupWizard — Phase I.6 (I-ONB) setup wizard.
*
* Guides users through 4 steps: Welcome, Create first Agent,
* Create first Workflow, Enable Knowledge & Workstream.
*
* Uses lucide-react icons, Tailwind, and i18n via `t()`.
*/
import React, { useState } from 'react';
import { useTranslation } from 'react-i18next';
import {
Sparkles,
Bot,
Workflow,
BookOpen,
ChevronLeft,
ChevronRight,
X,
} from 'lucide-react';
import { Button } from '@/components/ui/Button';
import { Card } from '@/components/ui/Card';
interface SetupWizardProps {
open: boolean;
onClose: () => void;
onComplete?: () => void;
}
const STEP_ICONS = [Sparkles, Bot, Workflow, BookOpen];
/**
* Setup wizard with 4 steps. Each step shows a title, description and an
* optional action button that deep-links to the relevant setup page.
*/
export function SetupWizard({ open, onClose, onComplete }: SetupWizardProps) {
const { t } = useTranslation();
const [step, setStep] = useState(0);
if (!open) return null;
const totalSteps = 4;
const isLast = step === totalSteps - 1;
const Icon = STEP_ICONS[step];
const handleNext = () => {
if (isLast) {
onComplete?.();
onClose();
return;
}
setStep((s) => s + 1);
};
const handleBack = () => {
if (step > 0) setStep((s) => s - 1);
};
const stepKey = `setupWizard.step${step + 1}`;
return (
<div
className="fixed inset-0 z-50 flex items-center justify-center bg-secondary-900/50 p-4"
role="dialog"
aria-modal="true"
aria-label={t('setupWizard.title')}
data-testid="setup-wizard"
>
<Card className="w-full max-w-lg">
<div className="flex items-center justify-between px-6 py-4 border-b border-secondary-200">
<h2 className="text-lg font-semibold text-secondary-900">
{t('setupWizard.title')}
</h2>
<button
type="button"
onClick={onClose}
className="p-2 rounded-md text-secondary-400 hover:text-secondary-600 hover:bg-secondary-100 focus:outline-none focus-visible:ring-2 focus-visible:ring-primary-500"
aria-label={t('setupWizard.close')}
>
<X className="h-5 w-5" aria-hidden="true" />
</button>
</div>
<div className="px-6 py-6">
{/* Progress indicator */}
<div className="flex items-center gap-2 mb-6" aria-hidden="true">
{Array.from({ length: totalSteps }).map((_, i) => (
<div
key={i}
className={`h-1.5 flex-1 rounded-full transition-colors ${
i <= step ? 'bg-primary-500' : 'bg-secondary-200'
}`}
/>
))}
</div>
<div className="flex items-start gap-4">
<div className="flex-shrink-0 w-12 h-12 rounded-lg bg-primary-100 text-primary-700 flex items-center justify-center">
<Icon className="h-6 w-6" aria-hidden="true" />
</div>
<div className="flex-1 min-w-0">
<h3 className="text-lg font-semibold text-secondary-900">
{t(`${stepKey}.title`)}
</h3>
<p className="mt-1 text-sm text-secondary-600">
{t(`${stepKey}.description`)}
</p>
</div>
</div>
</div>
<div className="px-6 py-4 border-t border-secondary-200 flex items-center justify-between">
<Button
variant="ghost"
size="sm"
onClick={handleBack}
disabled={step === 0}
icon={<ChevronLeft className="h-4 w-4" />}
>
{t('setupWizard.back')}
</Button>
<Button
variant="primary"
size="sm"
onClick={handleNext}
icon={isLast ? undefined : <ChevronRight className="h-4 w-4" />}
>
{isLast ? t('setupWizard.finish') : t('setupWizard.next')}
</Button>
</div>
</Card>
</div>
);
}
export default SetupWizard;
@@ -0,0 +1,260 @@
/**
* WorkstreamBlockRenderer — Phase I.7 (I-UI) universal block renderer.
*
* Renders every workstream block type (text, entity_card, action_card,
* evidence_card, approval_card, miniapp, workflow_status, workflow_handoff,
* error) with consistent loading / error / empty states.
*
* Reuses MiniAppBlock and the MiniAppSDK building blocks.
*
* Backend: app/ai/workstream_contract.py
*/
import React from 'react';
import { useTranslation } from 'react-i18next';
import {
Link2,
AlertTriangle,
Workflow,
ArrowRight,
Loader2,
MessageSquare,
} from 'lucide-react';
import { Badge } from '@/components/ui/Badge';
import { EmptyState } from '@/components/ui/EmptyState';
import { MiniAppBlock } from '@/components/workstream/MiniAppBlock';
import {
EntityCard,
ActionButtons,
ApprovalCard,
ProgressIndicator,
DeepLink,
type ActionButtonItem,
} from '@/components/workstream/MiniAppSDK';
import type { WorkstreamBlock } from '@/api/miniapps';
interface WorkstreamBlockRendererProps {
block: WorkstreamBlock;
onApprove?: (approvalId: string) => void;
onReject?: (approvalId: string) => void;
onAction?: (action: ActionButtonItem) => void;
}
/**
* Render a single workstream block by type.
*/
export function WorkstreamBlockRenderer({
block,
onApprove,
onReject,
onAction,
}: WorkstreamBlockRendererProps) {
const { t } = useTranslation();
const meta = block.metadata ?? {};
switch (block.type) {
case 'text':
return (
<div className="text-sm whitespace-pre-wrap break-words text-secondary-800">
{block.content || String(meta.text ?? '')}
</div>
);
case 'entity_card':
return (
<EntityCard
entityType={String(meta.entity_type ?? '')}
entityId={String(meta.entity_id ?? '')}
title={String(meta.title ?? block.content)}
subtitle={String(meta.subtitle ?? '')}
url={String(meta.url ?? '')}
/>
);
case 'action_card': {
const actions: ActionButtonItem[] = Array.isArray(meta.actions)
? (meta.actions as ActionButtonItem[])
: [];
return (
<div className="border border-secondary-200 rounded-lg p-4 bg-white shadow-sm space-y-2">
<h4 className="text-sm font-semibold text-secondary-900">
{String(meta.title ?? block.content)}
</h4>
{meta.description ? (
<p className="text-sm text-secondary-600">
{String(meta.description)}
</p>
) : null}
<ActionButtons actions={actions} onAction={onAction} />
</div>
);
}
case 'evidence_card':
return (
<div className="border border-secondary-200 rounded-lg p-4 bg-white shadow-sm">
<div className="flex items-center gap-2">
<Link2 className="h-4 w-4 text-primary-500" aria-hidden="true" />
<h4 className="text-sm font-semibold text-secondary-900">
{String(meta.title ?? block.content)}
</h4>
{typeof meta.confidence === 'number' && (
<Badge variant="secondary">
{Math.round(meta.confidence * 100)}%
</Badge>
)}
</div>
{meta.snippet ? (
<p className="mt-2 text-xs text-secondary-500">
{String(meta.snippet)}
</p>
) : null}
{meta.url ? (
<div className="mt-2">
<DeepLink
href={String(meta.url)}
label={t('workstream.block.openSource')}
external
/>
</div>
) : null}
</div>
);
case 'approval_card':
return (
<ApprovalCard
approvalId={String(meta.approval_id ?? '')}
action={String(meta.action ?? block.content)}
description={String(meta.description ?? '')}
onApprove={onApprove}
onReject={onReject}
/>
);
case 'miniapp':
return <MiniAppBlock block={block} />;
case 'workflow_status':
return (
<div className="border border-secondary-200 rounded-lg p-4 bg-white shadow-sm">
<div className="flex items-center gap-2">
<Workflow className="h-4 w-4 text-primary-500" aria-hidden="true" />
<h4 className="text-sm font-semibold text-secondary-900">
{String(meta.workflow_name ?? block.content)}
</h4>
<Badge variant="info">{String(meta.status ?? '')}</Badge>
</div>
{meta.step_name ? (
<p className="mt-2 text-xs text-secondary-500">
{t('workstream.block.step')}: {String(meta.step_name)}
</p>
) : null}
{typeof meta.step_index === 'number' && (
<div className="mt-3">
<ProgressIndicator
label={t('workstream.block.progress')}
value={Math.min(100, (meta.step_index + 1) * 10)}
status="in_progress"
/>
</div>
)}
</div>
);
case 'workflow_handoff':
return (
<div className="border border-warning-200 rounded-lg p-4 bg-warning-50 shadow-sm">
<div className="flex items-center gap-2">
<ArrowRight className="h-4 w-4 text-warning-700" aria-hidden="true" />
<h4 className="text-sm font-semibold text-secondary-900">
{t('workstream.block.handoff')}: {String(meta.handoff_type ?? '')}
</h4>
</div>
{meta.description ? (
<p className="mt-2 text-xs text-secondary-600">
{String(meta.description)}
</p>
) : null}
</div>
);
case 'error':
return (
<div className="border border-danger-200 rounded-lg p-4 bg-danger-50 shadow-sm flex items-start gap-2">
<AlertTriangle
className="h-4 w-4 text-danger-600 mt-0.5"
aria-hidden="true"
/>
<div className="text-sm text-danger-700">
{block.content || String(meta.error ?? '')}
</div>
</div>
);
default:
return (
<div className="text-xs text-secondary-400 italic p-2 rounded bg-secondary-50">
{t('workstream.block.unknown', { type: block.type })}
</div>
);
}
}
interface WorkstreamBlockListProps {
blocks: WorkstreamBlock[];
isLoading?: boolean;
onApprove?: (approvalId: string) => void;
onReject?: (approvalId: string) => void;
onAction?: (action: ActionButtonItem) => void;
}
/**
* Render a list of blocks with consistent loading / empty states.
*/
export function WorkstreamBlockList({
blocks,
isLoading = false,
onApprove,
onReject,
onAction,
}: WorkstreamBlockListProps) {
const { t } = useTranslation();
if (isLoading) {
return (
<div className="flex items-center justify-center py-12">
<Loader2
className="animate-spin h-6 w-6 text-primary-500"
aria-hidden="true"
/>
</div>
);
}
if (!blocks || blocks.length === 0) {
return (
<EmptyState
icon={<MessageSquare className="h-8 w-8" aria-hidden="true" />}
title={t('workstream.empty.title')}
description={t('workstream.empty.description')}
/>
);
}
return (
<div className="space-y-3">
{blocks.map((block, idx) => (
<WorkstreamBlockRenderer
key={idx}
block={block}
onApprove={onApprove}
onReject={onReject}
onAction={onAction}
/>
))}
</div>
);
}
export default WorkstreamBlockRenderer;