How superagents-lab/jev-search works
Jev Search turns a plain-language request into source and time choices, searches multiple web and vertical engines, then streams ranked, deduplicated results with relevance scores and editable filters. The browser submits through /api/ask; the server pipeline coordinates interpretation, search lanes, freshness handling, ranking, and merging. Search1API and configurable Jev providers are external services. The README documents provider and PWA capabilities; some implementation details are unsampled, so those links are shown only where documented or evidenced by the source index.
Main entry points: pipeline.ts Search pipeline · search.tsx Search page · use-ask.ts Stream consumer · ask.ts Ask endpoint
Components 23
Search experience
- Home page
src/routes/index.tsx - Search page
src/routes/search.tsx - Query entry
src/components/search-box.tsx - Editable filters
src/components/filters.tsx - Stream consumer
src/lib/use-ask.ts - Ranked results
src/components/results.tsx - Search progress
src/components/working.tsx - Offline app shell
public/sw.js
Request workflow
- Ask endpoint
src/routes/api/ask.ts - Request validation
src/lib/validate.ts - Search pipeline
src/lib/pipeline.ts - Query candidates
src/lib/candidates.ts - Source definitions
src/lib/sources.ts
Jev judgment
- Provider selection
src/lib/judge-config.ts - Intent and ranking
src/lib/typesafe.ts
Search and results
- Search1API client
src/lib/search1api.ts - Search cache
src/lib/cache.ts - Freshness handling
src/lib/freshness.ts - URL result merging
src/lib/merge.ts - Ranking and clusters
src/lib/rank.ts
Other components
- Search user
- Jev provider services
- Search1API service
Connections 23
- Search user → Home page: opens
src/routes/index.tsx - Home page → Query entry: renders
src/routes/index.tsx - Query entry → Search page: navigates
src/components/search-box.tsx - Search page → Stream consumer: starts search
src/routes/search.tsx - Search page → Editable filters: renders
src/routes/search.tsx - Search page → Ranked results: renders
src/routes/search.tsx - Search page → Search progress: renders
src/routes/search.tsx - Stream consumer → Ask endpoint: posts and reads stream
src/lib/use-ask.ts - Ask endpoint → Request validation: validates request
src/routes/api/ask.ts - Ask endpoint → Search pipeline: runs
src/routes/api/ask.ts - Search pipeline → Query candidates: builds candidates
src/lib/pipeline.ts - Search pipeline → Source definitions: selects lanes
src/lib/pipeline.ts - Search pipeline → Intent and ranking: interprets and reranks
src/lib/pipeline.ts - Intent and ranking → Jev provider services: calls provider
README.md - Search pipeline → Search cache: checks cache
src/lib/pipeline.ts - Search pipeline → Search1API client: runs search lanes
src/lib/pipeline.ts - Search1API client → Search1API service: requests results
src/lib/search1api.ts - Search pipeline → Freshness handling: filters stale results
src/lib/pipeline.ts - Search pipeline → Ranking and clusters: uses ranked items
src/lib/pipeline.ts - Search pipeline → URL result merging: merges results
src/lib/pipeline.ts - Stream consumer → Ranked results: supplies streamed state
src/routes/search.tsx - Search user → Offline app shell: installs app
README.md - Provider selection → Intent and ranking: configures providers
src/lib/judge-config.ts