File size: 2,894 Bytes
4244db2
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
from __future__ import annotations

from typing import Any, Literal

from pydantic import BaseModel, Field


class CitationModel(BaseModel):
	chunk_id: str
	document_name: str
	section_heading: str = ""


class IngestStartResponse(BaseModel):
	job_id: str
	message: str


class IngestStatusResponse(BaseModel):
	job_id: str
	status: str
	progress: float
	detail: str
	started_at: float
	completed_at: float | None


class GraphResultModel(BaseModel):
	eligible: bool
	missing_prereqs: list[str] = Field(default_factory=list)
	missing_coreqs: list[str] = Field(default_factory=list)
	grade_issues: list[str] = Field(default_factory=list)
	gpa_issues: list[str] = Field(default_factory=list)
	prereq_path: list[str] = Field(default_factory=list)
	either_or_options: list[list[str]] = Field(default_factory=list)


class PrereqQueryResponse(BaseModel):
	decision: Literal["Eligible", "Not eligible", "Need more info"]
	answer: str
	evidence: str
	citations: list[CitationModel] = Field(default_factory=list)
	next_step: str
	clarifying_questions: list[str] = Field(default_factory=list)
	graph_result: GraphResultModel
	assumptions: list[str] = Field(default_factory=list)
	trace_id: str


class PlanCourseModel(BaseModel):
	course_code: str
	course_name: str
	credits: int
	justification: str
	citation: CitationModel


class PlanQueryResponse(BaseModel):
	plan: list[PlanCourseModel] = Field(default_factory=list)
	total_credits: int = 0
	citations: list[CitationModel] = Field(default_factory=list)
	clarifying_questions: list[str] = Field(default_factory=list)
	assumptions: list[str] = Field(default_factory=list)
	risks: list[str] = Field(default_factory=list)
	trace_id: str


class AskQueryResponse(BaseModel):
	answer: str
	citations: list[CitationModel] = Field(default_factory=list)
	clarifying_questions: list[str] = Field(default_factory=list)
	abstained: bool
	trace_id: str


class GraphCourseResponse(BaseModel):
	course_code: str
	course_name: str
	credits: int
	prerequisites: list[str] = Field(default_factory=list)
	enables: list[str] = Field(default_factory=list)
	full_prereq_chain: list[str] = Field(default_factory=list)
	node_attributes: dict[str, Any] = Field(default_factory=dict)


class GraphAllResponse(BaseModel):
	nodes: list[dict[str, Any]] = Field(default_factory=list)
	edges: list[dict[str, Any]] = Field(default_factory=list)
	metadata: dict[str, Any] = Field(default_factory=dict)


class HealthResponse(BaseModel):
	status: Literal["ok", "degraded"]
	chroma_document_count: int
	graph_nodes: int
	graph_edges: int
	uptime_seconds: float


class MetricsResponse(BaseModel):
	total_requests: int
	prereq_requests: int
	plan_requests: int
	abstentions: int
	verifier_rewrites: int
	citation_hits: int
	avg_latency_ms: float
	avg_chunks_retrieved: float