How mimimaster/dsh-devin-search works
This repository provides a DSH plugin for Devin-backed web and code search, with shared Devin login and native controls. The main workflow is: enable a search capability, authenticate through a PKCE flow, persist a session, then invoke web search or a bounded local-workspace code search that uses Devin’s cloud completion and revalidates returned file ranges locally. The graph also shows the browser login UI and the separate pi-host runtime present in the tree. Some subsystem links are documented by the README; unsampled implementation details are not inferred.
Main entry points: index.ts Plugin Runtime · session.ts Session Manager · code-search.ts Code Search Tool · runtime.ts Pi Search Runtime
Components 24
DSH Runtime
- Plugin Runtime
src/index.ts - Search Settings
src/settings.ts
Login and Session
- Login API
src/login-api.ts - Session Manager
src/session.ts - PKCE OAuth
src/oauth.ts - Host Credentials
src/session.ts - Login State
src/login-state.ts
Search Capabilities
- Web Search
src/web.ts - Code Search Tool
src/code-search.ts - Workspace Fence
src/local.ts - Cloud Completion
src/completion.ts - Cloud Protocol
src/protocol.ts - Safety Utilities
src/safety.ts
Native Client UI
- Browser Client
src/client/index.ts - Login Card
src/client/components/DevinLoginCommandCard.tsx - Login API Client
src/client/login-api.ts - Live Login State
src/client/login-live-state.ts - Search Settings UI
src/client/components/SearchSettings.tsx
Pi Host Runtime
- Pi Extension
packages/pi-devin-search/src/extension.ts - Pi Search Runtime
packages/pi-devin-search/src/runtime.ts - Pi Session
packages/pi-devin-search/src/session.ts - Pi Credential Store
packages/pi-devin-search/src/store.ts - Pi Settings Store
packages/pi-devin-search/src/settings.ts
Other components
- DSH Host
Connections 25
- DSH Host → Plugin Runtime: loads plugin
- Plugin Runtime → Session Manager: creates
src/index.ts - Plugin Runtime → Login API: mounts
src/index.ts - Plugin Runtime → Web Search: registers provider
src/index.ts - Plugin Runtime → Code Search Tool: registers tool
src/index.ts - Plugin Runtime → Search Settings: reads switches
src/index.ts - Session Manager → PKCE OAuth: runs login
src/session.ts - Session Manager → Host Credentials: reads and commits
src/session.ts - Session Manager → Login State: projects status
src/session.ts - Web Search → Session Manager: gets access
- Code Search Tool → Session Manager: gets access
src/index.ts - Code Search Tool → Workspace Fence: searches fenced files
src/code-search.ts - Code Search Tool → Cloud Completion: requests completion
src/code-search.ts - Cloud Completion → Cloud Protocol: encodes protocol
src/completion.ts - Workspace Fence → Safety Utilities: uses path checks
src/local.ts - Login Card → Login API Client: submits code
src/client/components/DevinLoginCommandCard.tsx - Login API Client → Login API: calls authenticated API
- Login Card → Live Login State: publishes status
src/client/components/DevinLoginCommandCard.tsx - Browser Client → Login Card: renders
- Browser Client → Search Settings UI: renders
- Pi Extension → Pi Search Runtime: creates runtime
packages/pi-devin-search/src/extension.ts - Pi Search Runtime → Pi Session: constructs
packages/pi-devin-search/src/runtime.ts - Pi Search Runtime → Pi Credential Store: constructs
packages/pi-devin-search/src/runtime.ts - Pi Search Runtime → Pi Settings Store: constructs
packages/pi-devin-search/src/runtime.ts - Pi Session → Pi Credential Store: persists grants
packages/pi-devin-search/src/session.ts