feat(ai): implement unified prompt management UX/UI (ADR-037)
- Add context config endpoints (GET/PUT /api/ai/prompts/:type/:version/context-config) - Add execution profile endpoints (CRUD /api/ai/execution-profiles) - Add sandbox RAG Prep endpoint (POST /api/ai/admin/sandbox/rag-prep) - Create Prompt Management UI with multi-type support - Add ContextConfigEditor, PromptEditor, RuntimeParametersPanel components - Add SandboxTabs for 3-step workflow (OCR, Extract, RAG Prep) - Add database deltas for ai_execution_profiles and additional prompt types - Update quickstart.md with production backend URLs - Add comprehensive test coverage for new features
This commit is contained in:
@@ -0,0 +1,102 @@
|
||||
// File: frontend/contracts/frontend-types.ts
|
||||
// Change Log:
|
||||
// - 2026-06-14: Created frontend contract types from specifications (conforming to task T010)
|
||||
|
||||
export type PromptType = 'ocr_extraction' | 'rag_query_prompt' | 'rag_prep_prompt' | 'classification_prompt';
|
||||
|
||||
export interface ContextConfig {
|
||||
filter: {
|
||||
projectId: string | null;
|
||||
contractId: string | null;
|
||||
};
|
||||
pageSize: number;
|
||||
language: string;
|
||||
outputLanguage: string;
|
||||
}
|
||||
|
||||
export interface PromptVersion {
|
||||
id: string;
|
||||
promptType: PromptType;
|
||||
versionNumber: number;
|
||||
template: string;
|
||||
contextConfig: ContextConfig | null;
|
||||
isActive: boolean;
|
||||
manualNote: string | null;
|
||||
createdAt: string;
|
||||
}
|
||||
|
||||
export interface RuntimeParameters {
|
||||
temperature: number;
|
||||
topP: number;
|
||||
repeatPenalty: number;
|
||||
maxTokens: number;
|
||||
ctxSize: number;
|
||||
keepAlive: number;
|
||||
}
|
||||
|
||||
export interface ExecutionProfile {
|
||||
id: string;
|
||||
profileName: string;
|
||||
temperature: number;
|
||||
topP: number;
|
||||
repeatPenalty: number;
|
||||
maxTokens: number;
|
||||
ctxSize: number;
|
||||
keepAlive: number;
|
||||
isDefault: boolean;
|
||||
}
|
||||
|
||||
export type SandboxJobType = 'ocr' | 'ai-extract' | 'rag-prep';
|
||||
export type SandboxJobStatus = 'pending' | 'processing' | 'completed' | 'failed';
|
||||
|
||||
export interface SandboxJobResult {
|
||||
ocrText?: string;
|
||||
extractedMetadata?: Record<string, unknown>;
|
||||
ragChunks?: Array<{
|
||||
text: string;
|
||||
summary: string;
|
||||
}>;
|
||||
ragVectors?: number[][];
|
||||
error?: string | null;
|
||||
}
|
||||
|
||||
export interface SandboxJob {
|
||||
jobId: string;
|
||||
jobType: SandboxJobType;
|
||||
status: SandboxJobStatus;
|
||||
result: SandboxJobResult;
|
||||
createdAt: string;
|
||||
completedAt?: string;
|
||||
}
|
||||
|
||||
export interface CreatePromptDto {
|
||||
template: string;
|
||||
contextConfig: ContextConfig;
|
||||
manualNote?: string;
|
||||
}
|
||||
|
||||
export interface UpdateContextConfigDto {
|
||||
filter: {
|
||||
projectId: string | null;
|
||||
contractId: string | null;
|
||||
};
|
||||
pageSize: number;
|
||||
language: string;
|
||||
outputLanguage: string;
|
||||
}
|
||||
|
||||
export const PLACEHOLDER_REQUIREMENTS: Record<PromptType, string[]> = {
|
||||
ocr_extraction: ['{{ocr_text}}', '{{master_data_context}}'],
|
||||
rag_query_prompt: ['{{query}}', '{{context}}'],
|
||||
rag_prep_prompt: ['{{text}}'],
|
||||
classification_prompt: ['{{document_text}}'],
|
||||
};
|
||||
|
||||
export const RUNTIME_PARAMETER_CONSTRAINTS = {
|
||||
temperature: { min: 0.0, max: 1.0, default: 0.7 },
|
||||
topP: { min: 0.0, max: 1.0, default: 0.9 },
|
||||
repeatPenalty: { min: 1.0, max: 2.0, default: 1.0 },
|
||||
maxTokens: { min: 1, max: 8192, default: 2048 },
|
||||
ctxSize: { min: 1, max: 16384, default: 4096 },
|
||||
keepAlive: { min: 0, max: 3600, default: 300 },
|
||||
};
|
||||
Reference in New Issue
Block a user