An agent request, end to end
Follow one 'ask an agent' request from the Express entry point, through route registration and system-prompt selection, to the provider call.
apps/api/src/services/courtlistener.ts93 lines · searchCourtListener L39–92
Outline 4 symbols
- CL_BASE const
- COURT_MAP const
- CourtListenerCase interface export
- searchCourtListener function export
1// CourtListener REST API v4 — https://www.courtlistener.com/api/rest/v4/
2const CL_BASE = 'https://www.courtlistener.com/api/rest/v4'
3
4// Map jurisdiction keywords → CourtListener court codes
5const COURT_MAP: Record<string, string> = {
6 scotus: 'scotus',
7 'supreme court': 'scotus',
8 '1st circuit': 'ca1',
9 '2nd circuit': 'ca2',
10 '3rd circuit': 'ca3',
11 '4th circuit': 'ca4',
12 '5th circuit': 'ca5',
13 '6th circuit': 'ca6',
14 '7th circuit': 'ca7',
15 '8th circuit': 'ca8',
16 '9th circuit': 'ca9',
17 '10th circuit': 'ca10',
18 '11th circuit': 'ca11',
19 dc: 'cadc',
20 delaware: 'deld',
21 california: 'cal',
22 'new york': 'ny',
23 texas: 'tex',
24 florida: 'fla',
25 illinois: 'ill',
26}
27
28export interface CourtListenerCase {
29 id: string
30 caseName: string
31 citation: string
32 court: string
33 dateFiled: string
34 url: string
35 snippet: string
36 precedentialStatus: string
37}
38
39export async function searchCourtListener(
40 query: string,
41 jurisdiction?: string,
42 token?: string
43): Promise<CourtListenerCase[]> {
44 const apiToken = token || process.env.COURTLISTENER_API_TOKEN
45
46 const jur = (jurisdiction || '').toLowerCase()
47 const court = Object.entries(COURT_MAP).find(([k]) => jur.includes(k))?.[1] || ''
48
49 const params = new URLSearchParams({
50 q: query,
51 type: 'o', // opinions
52 order_by: 'score desc',
53 })
54 if (court) params.set('stat_Precedential', 'on')
55 if (court) params.set('court', court)
56
57 const headers: Record<string, string> = {
58 'Accept': 'application/json',
59 }
60 if (apiToken) {
61 headers['Authorization'] = `Token ${apiToken}`
62 }
63
64 try {
65 const res = await fetch(`${CL_BASE}/search/?${params}`, { headers })
66 if (!res.ok) {
67 console.error(`CourtListener ${res.status}: ${await res.text().catch(() => '')}`)
68 return []
69 }
70 const data = await res.json() as any
71 const results: any[] = data.results || []
72
73 return results.slice(0, 5).map((r) => {
74 const citations: string[] = r.citation || r.citations || []
75 return {
76 id: String(r.id || r.cluster_id || ''),
77 caseName: r.caseName || r.case_name || 'Unknown',
78 citation: citations[0] || '',
79 court: r.court_citation_string || r.court || r.court_id || '',
80 dateFiled: r.dateFiled || r.date_filed || '',
81 url: r.absolute_url
82 ? `https://www.courtlistener.com${r.absolute_url}`
83 : `https://www.courtlistener.com/opinion/${r.cluster_id}/`,
84 snippet: r.snippet || r.opinions?.[0]?.snippet?.slice(0, 300) || '',
85 precedentialStatus: r.status || 'Published',
86 }
87 })
88 } catch (e) {
89 console.error('CourtListener fetch error:', e)
90 return []
91 }
92}
93