Harness engineering beginner tutorial, from 0 to 1
TypeScript agentagenticagentic-aiaiai-agentai-agentsdshdsh-pluginharnessharness-engineeringharness-frameworkllm
import { useState, useCallback } from 'react';
import { DocumentList } from './components/DocumentList';
import { QuestionPanel } from './components/QuestionPanel';
import { DocumentDetail } from './components/DocumentDetail';
import { StatusBar } from './components/StatusBar';
import { Document, AppStatus, QAResponse } from '../shared/types';
declare global {
interface Window {
knowledgeBase: {
documents: {
list: () => Promise<Document[]>;
import: (filePath: string) => Promise<Document>;
get: (id: string) => Promise<Document | null>;
delete: (id: string) => Promise<boolean>;
};
indexing: {
start: (documentId?: string) => Promise<{ status: string }>;
status: () => Promise<AppStatus>;
chunks: (documentId: string) => Promise<Array<{ id: string; content: string; index: number }>>;
};
qa: {
ask: (question: string) => Promise<QAResponse>;
history: () => Promise<Array<{ question: string; response: QAResponse }>>;
};
};
}
}
export function App() {
const [documents, setDocuments] = useState<Document[]>([]);
const [selectedDoc, setSelectedDoc] = useState<Document | null>(null);
const [appStatus, setAppStatus] = useState<AppStatus>({
documentsLoaded: 0,
indexStatus: 'idle',
lastActivity: '',
});
const [lastResponse, setLastResponse] = useState<QAResponse | null>(null);
const refreshDocuments = useCallback(async () => {
try {
const docs = await window.knowledgeBase.documents.list();
setDocuments(docs);
const status = await window.knowledgeBase.indexing.status();
setAppStatus(status);
} catch (err) {
console.error('Failed to refresh documents:', err);
}
}, []);
const handleImport = useCallback(async () => {
// In a real app this would open a file dialog.
// For the course, we'll trigger import via the dev console or init script.
console.log('Import triggered - use window.knowledgeBase.documents.import(filePath)');
}, []);
const handleSelectDocument = useCallback((doc: Document) => {
setSelectedDoc(doc);
}, []);
const handleAskQuestion = useCallback(async (question: string) => {
try {
const response = await window.knowledgeBase.qa.ask(question);
setLastResponse(response);
} catch (err) {
console.error('Q&A failed:', err);
}
}, []);
return (
<div style={{ display: 'flex', flexDirection: 'column', height: '100vh' }}>
<header style={{
padding: '12px 20px',
background: '#16213e',
borderBottom: '1px solid #0f3460',
display: 'flex',
alignItems: 'center',
justifyContent: 'space-between',
}}>
<h1 style={{ fontSize: '18px', fontWeight: 600 }}>Knowledge Base</h1>
<button
onClick={refreshDocuments}
style={{
padding: '6px 14px',
background: '#0f3460',
color: '#e0e0e0',
border: '1px solid #1a1a4e',
borderRadius: '4px',
cursor: 'pointer',
fontSize: '13px',
}}
>
Refresh
</button>
</header>
<div style={{ display: 'flex', flex: 1, overflow: 'hidden' }}>
{/* Left panel: Document list */}
<div style={{
width: '280px',
borderRight: '1px solid #0f3460',
display: 'flex',
flexDirection: 'column',
background: '#16213e',
}}>
<div style={{
padding: '10px 16px',
borderBottom: '1px solid #0f3460',
display: 'flex',
justifyContent: 'space-between',
alignItems: 'center',
}}>
<span style={{ fontSize: '13px', fontWeight: 500, color: '#a0a0c0' }}>
Documents ({documents.length})
</span>
<button
onClick={handleImport}
style={{
padding: '4px 10px',
background: '#533483',
color: '#fff',
border: 'none',
borderRadius: '3px',
cursor: 'pointer',
fontSize: '12px',
}}
>
+ Import
</button>
</div>
<DocumentList
documents={documents}
onSelect={handleSelectDocument}
selectedId={selectedDoc?.id ?? null}
/>
</div>
{/* Right panel: Document detail + Q&A */}
<div style={{ flex: 1, display: 'flex', flexDirection: 'column', overflow: 'hidden' }}>
<div style={{ flex: 1, overflow: 'auto', padding: '20px' }}>
{selectedDoc ? (
<DocumentDetail document={selectedDoc} />
) : (
<div style={{ color: '#666', textAlign: 'center', paddingTop: '40px' }}>
Select a document or ask a question to get started
</div>
)}
{lastResponse && (
<div style={{
marginTop: '16px',
padding: '16px',
background: '#1a1a3e',
borderRadius: '6px',
border: '1px solid #0f3460',
}}>
<div style={{ fontSize: '14px', lineHeight: 1.6 }}>{lastResponse.answer}</div>
{lastResponse.citations.length > 0 && (
<div style={{ marginTop: '10px', fontSize: '12px', color: '#8888bb' }}>
<strong>Citations:</strong>
{lastResponse.citations.map((c, i) => (
<div key={i} style={{ marginTop: '4px', paddingLeft: '8px', borderLeft: '2px solid #533483' }}>
{c.documentTitle} (chunk {c.chunkIndex}): {c.excerpt.substring(0, 100)}...
</div>
))}
</div>
)}
</div>
)}
</div>
<QuestionPanel onAsk={handleAskQuestion} />
</div>
</div>
<StatusBar status={appStatus} />
</div>
);
}