How vishaalpillay/oneclick works
OneClick turns a complaint and, when available, a Samsung SIIS article into a grounded troubleshooting plan with verified Settings deeplinks. The API routes requests into the engine pipeline; its documented stages normalize and enrich the input, segment and extract article instructions, ground and organize actions, resolve links, and compile the final goals. Requests without an article can use remembered plans or articles. The console demonstrates the workflow and can stream stage events. Source excerpts were partial, so edges between internal stages are limited to documented orchestration and capabilities.
Main entry points: run.py Pipeline runner · main.py API entrypoint · resolver.py Deeplink resolver · troubleshoot.py Troubleshoot route
Components 23
User experience
- Web console
console/app/page.tsx - Live stream client
console/lib/stream.ts
Troubleshooting engine
- API entrypoint
api/app/main.py - Troubleshoot route
api/app/routes/troubleshoot.py - Streaming route
api/app/routes/stream.py - Pipeline runner
api/app/pipeline/run.py - Normalize and slots
api/app/pipeline/normalize.py - Enrich complaint
api/app/pipeline/enrich.py - Segment article
api/app/pipeline/segment.py - Extract actions
api/app/pipeline/extract.py - Ground actions
api/app/pipeline/ground.py - Organize intents
api/app/pipeline/order.py - Compile plan
api/app/compiler/compile.py
Knowledge and resolution
- Deeplink resolver
api/app/screengraph/resolver.py - Hybrid retrieval
api/app/retrieval/fuse.py - Screen Graph
api/app/screengraph/build.py
Models and state
- Plan cache
api/app/cache/__init__.py - No-article fallback
api/app/cache/no_siis.py - SQLite cache store
api/app/cache/store.py - Model router
api/app/llm/router.py
Operations
- Metrics and traces
api/app/obs/trace.py
Other components
- User
- Model providers
Connections 26
- User → Web console: enters complaint
- Web console → Live stream client: starts live request
- Live stream client → Streaming route: streams request
- User → Troubleshoot route: submits complaint
- API entrypoint → Troubleshoot route: serves endpoint
- API entrypoint → Streaming route: serves endpoint
- Troubleshoot route → Pipeline runner: runs pipeline
- Streaming route → Pipeline runner: runs pipeline
- Pipeline runner → Plan cache: checks cached plans
- Pipeline runner → No-article fallback: looks up no-article fallback
- Plan cache → SQLite cache store: reads and writes
- No-article fallback → SQLite cache store: reads and writes
- Pipeline runner → Normalize and slots: normalizes input
- Pipeline runner → Enrich complaint: enriches complaint
- Pipeline runner → Segment article: segments article
- Pipeline runner → Extract actions: extracts instructions
- Pipeline runner → Ground actions: grounds steps
- Pipeline runner → Organize intents: orders intents
- Pipeline runner → Deeplink resolver: resolves screen links
- Pipeline runner → Compile plan: compiles goals
- Deeplink resolver → Hybrid retrieval: retrieves candidates
- Deeplink resolver → Screen Graph: checks screen paths
- Enrich complaint → Model router: requests model output
- Extract actions → Model router: requests model output
- Model router → Model providers: calls configured models
- API entrypoint → Metrics and traces: exposes observability