# taikaikaikai-pixel/dsh-tap architecture

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

- Interactive diagram: https://gitdiagram.com/taikaikaikai-pixel/dsh-tap
- Repository: https://github.com/taikaikaikai-pixel/dsh-tap
- Video tour (about a minute): https://gitdiagram.com/taikaikaikai-pixel/dsh-tap/video

## Overview

dsh-tap is a local dsh plugin that registers upstream model providers, tools, and settings. The main workflow is selecting a provider/model in dsh, routing chat through the plugin’s local bridge or translation gateway, and forwarding the request with locally managed credentials; usage is then metered. Separate branches provide provider login and model discovery, generic OpenAI-compatible presets, and CodeBuddy search, fetch, and image generation. The graph combines README-described capabilities with shown imports and calls; unsampled settings-card wiring is represented only where documented.

Main entry points: [`index.js`](https://github.com/taikaikaikai-pixel/dsh-tap/blob/main/index.js) (Plugin entry), [`providers/codebuddy/index.js`](https://github.com/taikaikaikai-pixel/dsh-tap/blob/main/providers/codebuddy/index.js) (CodeBuddy adapter), [`providers/qoder/index.js`](https://github.com/taikaikaikai-pixel/dsh-tap/blob/main/providers/qoder/index.js) (Qoder adapter), [`core/usage-meter.js`](https://github.com/taikaikaikai-pixel/dsh-tap/blob/main/core/usage-meter.js) (Usage meter)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_integration["Plugin integration"]
  node_plugin["Plugin entry<br/>[index.js]"]
  node_hostconfig["Host config<br/>[host-config.js]"]
  node_localcreds["Credential scan<br/>[local-scan.js]"]
end

subgraph group_core["Core services"]
  node_json[("JSON store<br/>[json-store.js]")]
  node_rotation["Key rotation<br/>[rotation.js]"]
  node_bridge["Stream bridge<br/>[bridge.js]"]
  node_meter[("Usage meter<br/>[usage-meter.js]")]
end

subgraph group_codebuddy["CodeBuddy"]
  node_cbprovider["CodeBuddy adapter<br/>[index.js]"]
  node_cboauth["CodeBuddy OAuth<br/>[oauth.js]"]
  node_cbcatalog["CodeBuddy catalog<br/>[catalog.js]"]
  node_cbtools["CodeBuddy tools<br/>[agenttool.js]"]
  node_cbimages["Image generation<br/>[images.js]"]
end

subgraph group_translated["Translated providers"]
  node_trae["Trae adapter<br/>[index.js]"]
  node_traeoauth["Trae OAuth<br/>[oauth.js]"]
  node_traecatalog["Trae catalog<br/>[catalog.js]"]
  node_traegateway["Trae gateway<br/>[gateway.js]"]
  node_qoder["Qoder adapter<br/>[index.js]"]
  node_qoderoauth["Qoder OAuth<br/>[oauth.js]"]
  node_qodercosy["COSY runtime<br/>[cosy.js]"]
  node_qodercatalog["Qoder catalog<br/>[catalog.js]"]
  node_qodergateway["Qoder gateway<br/>[gateway.js]"]
  node_pairing["Tool pairing<br/>[tool-pairing.js]"]
end

subgraph group_generic["Generic providers"]
  node_opencompat["OpenAI-compatible base<br/>[openai-compat.js]"]
  node_presets["Provider presets<br/>[index.js]"]
end

node_user(("dsh user"))
node_host["dsh host"]
node_upstreams(("Model upstreams"))

node_user -->|"uses"| node_host
node_host -->|"loads plugin"| node_plugin
node_plugin -->|"routes config"| node_hostconfig
node_plugin -->|"scans credentials"| node_localcreds
node_plugin -->|"reads and writes"| node_json
node_plugin -->|"uses rotation"| node_rotation
node_plugin -->|"records usage"| node_meter
node_plugin -->|"routes chat"| node_bridge
node_plugin -->|"registers"| node_cbprovider
node_plugin -->|"registers"| node_trae
node_plugin -->|"registers"| node_qoder
node_plugin -->|"registers presets"| node_presets
node_cbprovider -->|"creates"| node_cboauth
node_cbprovider -->|"creates"| node_cbcatalog
node_cbprovider -->|"creates"| node_cbtools
node_cbprovider -->|"creates"| node_cbimages
node_cbprovider -->|"rotates keys"| node_rotation
node_cbprovider -->|"meters images"| node_meter
node_cbprovider -->|"forwards requests"| node_upstreams
node_bridge -->|"proxies requests"| node_upstreams
node_bridge -->|"records usage"| node_meter
node_trae -->|"creates"| node_traeoauth
node_trae -->|"syncs catalog"| node_traecatalog
node_trae -->|"creates gateway"| node_traegateway
node_traegateway -->|"translates requests"| node_upstreams
node_traegateway -->|"repairs tool calls"| node_pairing
node_traegateway -->|"meters usage"| node_meter
node_qoder -->|"creates"| node_qoderoauth
node_qoder -->|"creates runtime"| node_qodercosy
node_qoder -->|"fetches catalog"| node_qodercatalog
node_qoder -->|"creates gateway"| node_qodergateway
node_qodergateway -->|"repairs tool calls"| node_pairing
node_qodergateway -->|"translates requests"| node_upstreams
node_qodergateway -->|"meters usage"| node_meter
node_presets -->|"uses shared base"| node_opencompat
node_opencompat -->|"validates and catalogs"| node_upstreams
node_plugin -->|"updates settings"| node_host

click node_plugin "https://github.com/taikaikaikai-pixel/dsh-tap/blob/main/index.js"
click node_hostconfig "https://github.com/taikaikaikai-pixel/dsh-tap/blob/main/host-config.js"
click node_localcreds "https://github.com/taikaikaikai-pixel/dsh-tap/blob/main/local-scan.js"
click node_json "https://github.com/taikaikaikai-pixel/dsh-tap/blob/main/core/json-store.js"
click node_rotation "https://github.com/taikaikaikai-pixel/dsh-tap/blob/main/core/rotation.js"
click node_bridge "https://github.com/taikaikaikai-pixel/dsh-tap/blob/main/core/bridge.js"
click node_meter "https://github.com/taikaikaikai-pixel/dsh-tap/blob/main/core/usage-meter.js"
click node_cbprovider "https://github.com/taikaikaikai-pixel/dsh-tap/blob/main/providers/codebuddy/index.js"
click node_cboauth "https://github.com/taikaikaikai-pixel/dsh-tap/blob/main/providers/codebuddy/oauth.js"
click node_cbcatalog "https://github.com/taikaikaikai-pixel/dsh-tap/blob/main/providers/codebuddy/catalog.js"
click node_cbtools "https://github.com/taikaikaikai-pixel/dsh-tap/blob/main/providers/codebuddy/agenttool.js"
click node_cbimages "https://github.com/taikaikaikai-pixel/dsh-tap/blob/main/providers/codebuddy/images.js"
click node_trae "https://github.com/taikaikaikai-pixel/dsh-tap/blob/main/providers/trae/index.js"
click node_traeoauth "https://github.com/taikaikaikai-pixel/dsh-tap/blob/main/providers/trae/oauth.js"
click node_traecatalog "https://github.com/taikaikaikai-pixel/dsh-tap/blob/main/providers/trae/catalog.js"
click node_traegateway "https://github.com/taikaikaikai-pixel/dsh-tap/blob/main/providers/trae/gateway.js"
click node_qoder "https://github.com/taikaikaikai-pixel/dsh-tap/blob/main/providers/qoder/index.js"
click node_qoderoauth "https://github.com/taikaikaikai-pixel/dsh-tap/blob/main/providers/qoder/oauth.js"
click node_qodercosy "https://github.com/taikaikaikai-pixel/dsh-tap/blob/main/providers/qoder/cosy.js"
click node_qodercatalog "https://github.com/taikaikaikai-pixel/dsh-tap/blob/main/providers/qoder/catalog.js"
click node_qodergateway "https://github.com/taikaikaikai-pixel/dsh-tap/blob/main/providers/qoder/gateway.js"
click node_pairing "https://github.com/taikaikaikai-pixel/dsh-tap/blob/main/providers/tool-pairing.js"
click node_opencompat "https://github.com/taikaikaikai-pixel/dsh-tap/blob/main/providers/openai-compat.js"
click node_presets "https://github.com/taikaikaikai-pixel/dsh-tap/blob/main/providers/ark/index.js"

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_plugin,node_hostconfig,node_localcreds,node_user toneBlue
class node_json,node_rotation,node_bridge,node_meter toneAmber
class node_cbprovider,node_cboauth,node_cbcatalog,node_cbtools,node_cbimages toneMint
class node_trae,node_traeoauth,node_traecatalog,node_traegateway,node_qoder,node_qoderoauth,node_qodercosy,node_qodercatalog,node_qodergateway,node_pairing toneRose
class node_opencompat,node_presets,node_host,node_upstreams toneIndigo
```

## Components

### Plugin integration

- [Plugin entry](https://github.com/taikaikaikai-pixel/dsh-tap/blob/main/index.js): `index.js`
- [Host config](https://github.com/taikaikaikai-pixel/dsh-tap/blob/main/host-config.js): `host-config.js`
- [Credential scan](https://github.com/taikaikaikai-pixel/dsh-tap/blob/main/local-scan.js): `local-scan.js`

### Core services

- [JSON store](https://github.com/taikaikaikai-pixel/dsh-tap/blob/main/core/json-store.js): `core/json-store.js`
- [Key rotation](https://github.com/taikaikaikai-pixel/dsh-tap/blob/main/core/rotation.js): `core/rotation.js`
- [Stream bridge](https://github.com/taikaikaikai-pixel/dsh-tap/blob/main/core/bridge.js): `core/bridge.js`
- [Usage meter](https://github.com/taikaikaikai-pixel/dsh-tap/blob/main/core/usage-meter.js): `core/usage-meter.js`

### CodeBuddy

- [CodeBuddy adapter](https://github.com/taikaikaikai-pixel/dsh-tap/blob/main/providers/codebuddy/index.js): `providers/codebuddy/index.js`
- [CodeBuddy OAuth](https://github.com/taikaikaikai-pixel/dsh-tap/blob/main/providers/codebuddy/oauth.js): `providers/codebuddy/oauth.js`
- [CodeBuddy catalog](https://github.com/taikaikaikai-pixel/dsh-tap/blob/main/providers/codebuddy/catalog.js): `providers/codebuddy/catalog.js`
- [CodeBuddy tools](https://github.com/taikaikaikai-pixel/dsh-tap/blob/main/providers/codebuddy/agenttool.js): `providers/codebuddy/agenttool.js`
- [Image generation](https://github.com/taikaikaikai-pixel/dsh-tap/blob/main/providers/codebuddy/images.js): `providers/codebuddy/images.js`

### Translated providers

- [Trae adapter](https://github.com/taikaikaikai-pixel/dsh-tap/blob/main/providers/trae/index.js): `providers/trae/index.js`
- [Trae OAuth](https://github.com/taikaikaikai-pixel/dsh-tap/blob/main/providers/trae/oauth.js): `providers/trae/oauth.js`
- [Trae catalog](https://github.com/taikaikaikai-pixel/dsh-tap/blob/main/providers/trae/catalog.js): `providers/trae/catalog.js`
- [Trae gateway](https://github.com/taikaikaikai-pixel/dsh-tap/blob/main/providers/trae/gateway.js): `providers/trae/gateway.js`
- [Qoder adapter](https://github.com/taikaikaikai-pixel/dsh-tap/blob/main/providers/qoder/index.js): `providers/qoder/index.js`
- [Qoder OAuth](https://github.com/taikaikaikai-pixel/dsh-tap/blob/main/providers/qoder/oauth.js): `providers/qoder/oauth.js`
- [COSY runtime](https://github.com/taikaikaikai-pixel/dsh-tap/blob/main/providers/qoder/cosy.js): `providers/qoder/cosy.js`
- [Qoder catalog](https://github.com/taikaikaikai-pixel/dsh-tap/blob/main/providers/qoder/catalog.js): `providers/qoder/catalog.js`
- [Qoder gateway](https://github.com/taikaikaikai-pixel/dsh-tap/blob/main/providers/qoder/gateway.js): `providers/qoder/gateway.js`
- [Tool pairing](https://github.com/taikaikaikai-pixel/dsh-tap/blob/main/providers/tool-pairing.js): `providers/tool-pairing.js`

### Generic providers

- [OpenAI-compatible base](https://github.com/taikaikaikai-pixel/dsh-tap/blob/main/providers/openai-compat.js): `providers/openai-compat.js`
- [Provider presets](https://github.com/taikaikaikai-pixel/dsh-tap/blob/main/providers/ark/index.js): `providers/ark/index.js`

### Other components

- **dsh user**
- **dsh host**
- **Model upstreams**

## Connections

- dsh user → dsh host: uses
- dsh host → Plugin entry: loads plugin
- Plugin entry → Host config: routes config (evidence: `index.js`)
- Plugin entry → Credential scan: scans credentials (evidence: `index.js`)
- Plugin entry → JSON store: reads and writes (evidence: `index.js`)
- Plugin entry → Key rotation: uses rotation (evidence: `index.js`)
- Plugin entry → Usage meter: records usage (evidence: `index.js`)
- Plugin entry → Stream bridge: routes chat (evidence: `index.js`)
- Plugin entry → CodeBuddy adapter: registers (evidence: `index.js`)
- Plugin entry → Trae adapter: registers (evidence: `index.js`)
- Plugin entry → Qoder adapter: registers (evidence: `index.js`)
- Plugin entry → Provider presets: registers presets (evidence: `index.js`)
- CodeBuddy adapter → CodeBuddy OAuth: creates (evidence: `providers/codebuddy/index.js`)
- CodeBuddy adapter → CodeBuddy catalog: creates (evidence: `providers/codebuddy/index.js`)
- CodeBuddy adapter → CodeBuddy tools: creates (evidence: `providers/codebuddy/index.js`)
- CodeBuddy adapter → Image generation: creates (evidence: `providers/codebuddy/index.js`)
- CodeBuddy adapter → Key rotation: rotates keys (evidence: `providers/codebuddy/index.js`)
- CodeBuddy adapter → Usage meter: meters images (evidence: `providers/codebuddy/index.js`)
- CodeBuddy adapter → Model upstreams: forwards requests
- Stream bridge → Model upstreams: proxies requests
- Stream bridge → Usage meter: records usage (evidence: `core/bridge.js`)
- Trae adapter → Trae OAuth: creates (evidence: `providers/trae/index.js`)
- Trae adapter → Trae catalog: syncs catalog (evidence: `providers/trae/index.js`)
- Trae adapter → Trae gateway: creates gateway (evidence: `providers/trae/index.js`)
- Trae gateway → Model upstreams: translates requests
- Trae gateway → Tool pairing: repairs tool calls (evidence: `providers/trae/gateway.js`)
- Trae gateway → Usage meter: meters usage
- Qoder adapter → Qoder OAuth: creates (evidence: `providers/qoder/index.js`)
- Qoder adapter → COSY runtime: creates runtime (evidence: `providers/qoder/index.js`)
- Qoder adapter → Qoder catalog: fetches catalog (evidence: `providers/qoder/index.js`)
- Qoder adapter → Qoder gateway: creates gateway (evidence: `providers/qoder/index.js`)
- Qoder gateway → Tool pairing: repairs tool calls (evidence: `providers/qoder/gateway.js`)
- Qoder gateway → Model upstreams: translates requests
- Qoder gateway → Usage meter: meters usage
- Provider presets → OpenAI-compatible base: uses shared base (evidence: `providers/ark/index.js`)
- OpenAI-compatible base → Model upstreams: validates and catalogs (evidence: `providers/openai-compat.js`)
- Plugin entry → dsh host: updates settings
