# mimimaster/dsh-devin-search architecture

> Architecture diagram of the GitHub repository mimimaster/dsh-devin-search, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/mimimaster/dsh-devin-search
- Repository: https://github.com/mimimaster/dsh-devin-search

## Overview

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: [`src/index.ts`](https://github.com/mimimaster/dsh-devin-search/blob/main/src/index.ts) (Plugin Runtime), [`src/session.ts`](https://github.com/mimimaster/dsh-devin-search/blob/main/src/session.ts) (Session Manager), [`src/code-search.ts`](https://github.com/mimimaster/dsh-devin-search/blob/main/src/code-search.ts) (Code Search Tool), [`packages/pi-devin-search/src/runtime.ts`](https://github.com/mimimaster/dsh-devin-search/blob/main/packages/pi-devin-search/src/runtime.ts) (Pi Search Runtime)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["DSH Runtime"]
  node_entry["Plugin Runtime<br/>[index.ts]"]
  node_settings["Search Settings<br/>[settings.ts]"]
end

subgraph group_auth["Login and Session"]
  node_login_api["Login API<br/>[login-api.ts]"]
  node_session["Session Manager<br/>[session.ts]"]
  node_oauth["PKCE OAuth<br/>[oauth.ts]"]
  node_credential_store[("Host Credentials<br/>[session.ts]")]
  node_login_state["Login State<br/>[login-state.ts]"]
end

subgraph group_search["Search Capabilities"]
  node_web_search["Web Search<br/>[web.ts]"]
  node_code_tool["Code Search Tool<br/>[code-search.ts]"]
  node_workspace["Workspace Fence<br/>[local.ts]"]
  node_completion["Cloud Completion<br/>[completion.ts]"]
  node_wire_protocol["Cloud Protocol<br/>[protocol.ts]"]
  node_safety["Safety Utilities<br/>[safety.ts]"]
end

subgraph group_client["Native Client UI"]
  node_client["Browser Client<br/>[index.ts]"]
  node_login_card["Login Card"]
  node_login_api_client["Login API Client<br/>[login-api.ts]"]
  node_live_state["Live Login State"]
  node_search_settings_ui["Search Settings UI<br/>[SearchSettings.tsx]"]
end

subgraph group_pi["Pi Host Runtime"]
  node_pi_extension["Pi Extension<br/>[extension.ts]"]
  node_pi_runtime["Pi Search Runtime<br/>[runtime.ts]"]
  node_pi_session["Pi Session<br/>[session.ts]"]
  node_pi_store[("Pi Credential Store<br/>[store.ts]")]
  node_pi_settings[("Pi Settings Store<br/>[settings.ts]")]
end

node_host(("DSH Host"))

node_host -->|"loads plugin"| node_entry
node_entry -->|"creates"| node_session
node_entry -->|"mounts"| node_login_api
node_entry -->|"registers provider"| node_web_search
node_entry -->|"registers tool"| node_code_tool
node_entry -->|"reads switches"| node_settings
node_session -->|"runs login"| node_oauth
node_session -->|"reads and commits"| node_credential_store
node_session -.->|"projects status"| node_login_state
node_web_search -.->|"gets access"| node_session
node_code_tool -->|"gets access"| node_session
node_code_tool -->|"searches fenced files"| node_workspace
node_code_tool -.->|"requests completion"| node_completion
node_completion -->|"encodes protocol"| node_wire_protocol
node_workspace -->|"uses path checks"| node_safety
node_login_card -->|"submits code"| node_login_api_client
node_login_api_client -.->|"calls authenticated API"| node_login_api
node_login_card -->|"publishes status"| node_live_state
node_client -.->|"renders"| node_login_card
node_client -.->|"renders"| node_search_settings_ui
node_pi_extension -.->|"creates runtime"| node_pi_runtime
node_pi_runtime -->|"constructs"| node_pi_session
node_pi_runtime -->|"constructs"| node_pi_store
node_pi_runtime -->|"constructs"| node_pi_settings
node_pi_session -->|"persists grants"| node_pi_store

click node_entry "https://github.com/mimimaster/dsh-devin-search/blob/main/src/index.ts"
click node_settings "https://github.com/mimimaster/dsh-devin-search/blob/main/src/settings.ts"
click node_login_api "https://github.com/mimimaster/dsh-devin-search/blob/main/src/login-api.ts"
click node_session "https://github.com/mimimaster/dsh-devin-search/blob/main/src/session.ts"
click node_oauth "https://github.com/mimimaster/dsh-devin-search/blob/main/src/oauth.ts"
click node_credential_store "https://github.com/mimimaster/dsh-devin-search/blob/main/src/session.ts"
click node_login_state "https://github.com/mimimaster/dsh-devin-search/blob/main/src/login-state.ts"
click node_web_search "https://github.com/mimimaster/dsh-devin-search/blob/main/src/web.ts"
click node_code_tool "https://github.com/mimimaster/dsh-devin-search/blob/main/src/code-search.ts"
click node_workspace "https://github.com/mimimaster/dsh-devin-search/blob/main/src/local.ts"
click node_completion "https://github.com/mimimaster/dsh-devin-search/blob/main/src/completion.ts"
click node_wire_protocol "https://github.com/mimimaster/dsh-devin-search/blob/main/src/protocol.ts"
click node_safety "https://github.com/mimimaster/dsh-devin-search/blob/main/src/safety.ts"
click node_client "https://github.com/mimimaster/dsh-devin-search/blob/main/src/client/index.ts"
click node_login_card "https://github.com/mimimaster/dsh-devin-search/blob/main/src/client/components/DevinLoginCommandCard.tsx"
click node_login_api_client "https://github.com/mimimaster/dsh-devin-search/blob/main/src/client/login-api.ts"
click node_live_state "https://github.com/mimimaster/dsh-devin-search/blob/main/src/client/login-live-state.ts"
click node_search_settings_ui "https://github.com/mimimaster/dsh-devin-search/blob/main/src/client/components/SearchSettings.tsx"
click node_pi_extension "https://github.com/mimimaster/dsh-devin-search/blob/main/packages/pi-devin-search/src/extension.ts"
click node_pi_runtime "https://github.com/mimimaster/dsh-devin-search/blob/main/packages/pi-devin-search/src/runtime.ts"
click node_pi_session "https://github.com/mimimaster/dsh-devin-search/blob/main/packages/pi-devin-search/src/session.ts"
click node_pi_store "https://github.com/mimimaster/dsh-devin-search/blob/main/packages/pi-devin-search/src/store.ts"
click node_pi_settings "https://github.com/mimimaster/dsh-devin-search/blob/main/packages/pi-devin-search/src/settings.ts"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_entry,node_settings toneBlue
class node_login_api,node_session,node_oauth,node_credential_store,node_login_state toneAmber
class node_web_search,node_code_tool,node_workspace,node_completion,node_wire_protocol,node_safety toneMint
class node_client,node_login_card,node_login_api_client,node_live_state,node_search_settings_ui toneRose
class node_pi_extension,node_pi_runtime,node_pi_session,node_pi_store,node_pi_settings,node_host toneIndigo
```

## Components

### DSH Runtime

- [Plugin Runtime](https://github.com/mimimaster/dsh-devin-search/blob/main/src/index.ts): `src/index.ts`
- [Search Settings](https://github.com/mimimaster/dsh-devin-search/blob/main/src/settings.ts): `src/settings.ts`

### Login and Session

- [Login API](https://github.com/mimimaster/dsh-devin-search/blob/main/src/login-api.ts): `src/login-api.ts`
- [Session Manager](https://github.com/mimimaster/dsh-devin-search/blob/main/src/session.ts): `src/session.ts`
- [PKCE OAuth](https://github.com/mimimaster/dsh-devin-search/blob/main/src/oauth.ts): `src/oauth.ts`
- [Host Credentials](https://github.com/mimimaster/dsh-devin-search/blob/main/src/session.ts): `src/session.ts`
- [Login State](https://github.com/mimimaster/dsh-devin-search/blob/main/src/login-state.ts): `src/login-state.ts`

### Search Capabilities

- [Web Search](https://github.com/mimimaster/dsh-devin-search/blob/main/src/web.ts): `src/web.ts`
- [Code Search Tool](https://github.com/mimimaster/dsh-devin-search/blob/main/src/code-search.ts): `src/code-search.ts`
- [Workspace Fence](https://github.com/mimimaster/dsh-devin-search/blob/main/src/local.ts): `src/local.ts`
- [Cloud Completion](https://github.com/mimimaster/dsh-devin-search/blob/main/src/completion.ts): `src/completion.ts`
- [Cloud Protocol](https://github.com/mimimaster/dsh-devin-search/blob/main/src/protocol.ts): `src/protocol.ts`
- [Safety Utilities](https://github.com/mimimaster/dsh-devin-search/blob/main/src/safety.ts): `src/safety.ts`

### Native Client UI

- [Browser Client](https://github.com/mimimaster/dsh-devin-search/blob/main/src/client/index.ts): `src/client/index.ts`
- [Login Card](https://github.com/mimimaster/dsh-devin-search/blob/main/src/client/components/DevinLoginCommandCard.tsx): `src/client/components/DevinLoginCommandCard.tsx`
- [Login API Client](https://github.com/mimimaster/dsh-devin-search/blob/main/src/client/login-api.ts): `src/client/login-api.ts`
- [Live Login State](https://github.com/mimimaster/dsh-devin-search/blob/main/src/client/login-live-state.ts): `src/client/login-live-state.ts`
- [Search Settings UI](https://github.com/mimimaster/dsh-devin-search/blob/main/src/client/components/SearchSettings.tsx): `src/client/components/SearchSettings.tsx`

### Pi Host Runtime

- [Pi Extension](https://github.com/mimimaster/dsh-devin-search/blob/main/packages/pi-devin-search/src/extension.ts): `packages/pi-devin-search/src/extension.ts`
- [Pi Search Runtime](https://github.com/mimimaster/dsh-devin-search/blob/main/packages/pi-devin-search/src/runtime.ts): `packages/pi-devin-search/src/runtime.ts`
- [Pi Session](https://github.com/mimimaster/dsh-devin-search/blob/main/packages/pi-devin-search/src/session.ts): `packages/pi-devin-search/src/session.ts`
- [Pi Credential Store](https://github.com/mimimaster/dsh-devin-search/blob/main/packages/pi-devin-search/src/store.ts): `packages/pi-devin-search/src/store.ts`
- [Pi Settings Store](https://github.com/mimimaster/dsh-devin-search/blob/main/packages/pi-devin-search/src/settings.ts): `packages/pi-devin-search/src/settings.ts`

### Other components

- **DSH Host**

## Connections

- DSH Host → Plugin Runtime: loads plugin
- Plugin Runtime → Session Manager: creates (evidence: `src/index.ts`)
- Plugin Runtime → Login API: mounts (evidence: `src/index.ts`)
- Plugin Runtime → Web Search: registers provider (evidence: `src/index.ts`)
- Plugin Runtime → Code Search Tool: registers tool (evidence: `src/index.ts`)
- Plugin Runtime → Search Settings: reads switches (evidence: `src/index.ts`)
- Session Manager → PKCE OAuth: runs login (evidence: `src/session.ts`)
- Session Manager → Host Credentials: reads and commits (evidence: `src/session.ts`)
- Session Manager → Login State: projects status (evidence: `src/session.ts`)
- Web Search → Session Manager: gets access
- Code Search Tool → Session Manager: gets access (evidence: `src/index.ts`)
- Code Search Tool → Workspace Fence: searches fenced files (evidence: `src/code-search.ts`)
- Code Search Tool → Cloud Completion: requests completion (evidence: `src/code-search.ts`)
- Cloud Completion → Cloud Protocol: encodes protocol (evidence: `src/completion.ts`)
- Workspace Fence → Safety Utilities: uses path checks (evidence: `src/local.ts`)
- Login Card → Login API Client: submits code (evidence: `src/client/components/DevinLoginCommandCard.tsx`)
- Login API Client → Login API: calls authenticated API
- Login Card → Live Login State: publishes status (evidence: `src/client/components/DevinLoginCommandCard.tsx`)
- Browser Client → Login Card: renders
- Browser Client → Search Settings UI: renders
- Pi Extension → Pi Search Runtime: creates runtime (evidence: `packages/pi-devin-search/src/extension.ts`)
- Pi Search Runtime → Pi Session: constructs (evidence: `packages/pi-devin-search/src/runtime.ts`)
- Pi Search Runtime → Pi Credential Store: constructs (evidence: `packages/pi-devin-search/src/runtime.ts`)
- Pi Search Runtime → Pi Settings Store: constructs (evidence: `packages/pi-devin-search/src/runtime.ts`)
- Pi Session → Pi Credential Store: persists grants (evidence: `packages/pi-devin-search/src/session.ts`)
