# noelchesco5/wire architecture

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

- Interactive diagram: https://gitdiagram.com/noelchesco5/wire
- Repository: https://github.com/noelchesco5/wire

## Overview

DeepSeek Harness is a plugin-oriented agent harness with Web and Desktop entry points. The documented user workflow is launching `dsh web`, which starts the Web UI and opens it for local use; the repository also contains session, workspace, terminal, scheduling, and plugin-management subsystems. The graph includes major subsystems visible in the tree and indexed source references. Some implementation paths are unsampled, so relationships not established by the README or source index are omitted.

Main entry points: [`packages/api/session-controller/src/client/sessions/manager.ts`](https://github.com/noelchesco5/wire/blob/master/packages/api/session-controller/src/client/sessions/manager.ts) (Session manager), [`packages/api/session-controller/src/client/sessions/session.ts`](https://github.com/noelchesco5/wire/blob/master/packages/api/session-controller/src/client/sessions/session.ts) (Session instance), [`apps/desktop/src/main.ts`](https://github.com/noelchesco5/wire/blob/master/apps/desktop/src/main.ts) (Desktop application), [`apps/cli/src/bin.ts`](https://github.com/noelchesco5/wire/blob/master/apps/cli/src/bin.ts) (CLI)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Entry and runtime"]
  node_cli["CLI<br/>[bin.ts]"]
  node_web["Web application<br/>[main.ts]"]
  node_desktop["Desktop application<br/>[main.ts]"]
  node_desktop_runtime["Desktop runtime<br/>[runtime-tree.ts]"]
  node_boot["Application boot<br/>[index.ts]"]
end

subgraph group_plugins["Plugins and extensions"]
  node_plugin_manager["Plugin manager<br/>[operations.ts]"]
  node_plugin_ui["Plugin manager UI"]
  node_mods_engine["Mods engine<br/>[engine.ts]"]
end

subgraph group_sessions["Sessions and persistence"]
  node_session_api["Session API<br/>[index.ts]"]
  node_session_manager["Session manager<br/>[manager.ts]"]
  node_session_instance["Session instance<br/>[session.ts]"]
  node_session_projection["Session projection"]
  node_session_notifier["Session notifier<br/>[notifier.ts]"]
  node_persistence_contract["Persistence contract"]
  node_jsonl_storage[("JSONL storage<br/>[storage.ts]")]
end

subgraph group_interfaces["Client interfaces"]
  node_sdk_server["SDK server<br/>[server.ts]"]
  node_sdk_client["SDK client<br/>[client.ts]"]
  node_gateway["API gateway<br/>[stream-server.ts]"]
end

subgraph group_operations["Inspection and scheduling"]
  node_inspector_host["Inspector host<br/>[controller.ts]"]
  node_inspector_queries["Inspector queries<br/>[query-router.ts]"]
  node_schedule_storage[("Schedule storage<br/>[storage.ts]")]
end

node_user(("Harness user"))

node_user -->|"launches"| node_cli
node_cli -->|"starts Web UI"| node_web
node_desktop -->|"reads runtime"| node_desktop_runtime
node_desktop -->|"prepares profile"| node_boot
node_plugin_ui -->|"manages plugins"| node_plugin_manager
node_session_manager -->|"loads projections"| node_session_projection
node_session_manager -->|"notifies changes"| node_session_notifier
node_session_manager -->|"creates instances"| node_session_instance
node_session_instance -->|"updates projections"| node_session_projection
node_session_instance -->|"uses notifier"| node_session_notifier
node_jsonl_storage -->|"materializes batches"| node_persistence_contract
node_inspector_host -.->|"starts worker"| node_inspector_queries

click node_cli "https://github.com/noelchesco5/wire/blob/master/apps/cli/src/bin.ts"
click node_web "https://github.com/noelchesco5/wire/blob/master/apps/web/src/main.ts"
click node_desktop "https://github.com/noelchesco5/wire/blob/master/apps/desktop/src/main.ts"
click node_desktop_runtime "https://github.com/noelchesco5/wire/blob/master/apps/desktop/src/runtime-tree.ts"
click node_boot "https://github.com/noelchesco5/wire/blob/master/packages/boot/app-boot/src/index.ts"
click node_plugin_manager "https://github.com/noelchesco5/wire/blob/master/packages/boot/plugin-manager/src/operations.ts"
click node_plugin_ui "https://github.com/noelchesco5/wire/blob/master/packages/client/ui-plugin-manager/src/client/PluginManagerPage.tsx"
click node_mods_engine "https://github.com/noelchesco5/wire/blob/master/packages/experimental/claude-code-mods/src/engine.ts"
click node_session_api "https://github.com/noelchesco5/wire/blob/master/packages/api/session-controller/src/index.ts"
click node_session_manager "https://github.com/noelchesco5/wire/blob/master/packages/api/session-controller/src/client/sessions/manager.ts"
click node_session_instance "https://github.com/noelchesco5/wire/blob/master/packages/api/session-controller/src/client/sessions/session.ts"
click node_session_projection "https://github.com/noelchesco5/wire/blob/master/packages/api/session-controller/src/client/sessions/projection-store.ts"
click node_session_notifier "https://github.com/noelchesco5/wire/blob/master/packages/api/session-controller/src/client/sessions/notifier.ts"
click node_persistence_contract "https://github.com/noelchesco5/wire/blob/master/packages/session/session-persistence/src/storage-contract.ts"
click node_jsonl_storage "https://github.com/noelchesco5/wire/blob/master/packages/session/session-persistence-jsonl/src/storage.ts"
click node_sdk_server "https://github.com/noelchesco5/wire/blob/master/packages/sdk/server/src/server.ts"
click node_sdk_client "https://github.com/noelchesco5/wire/blob/master/packages/sdk/client/src/client.ts"
click node_gateway "https://github.com/noelchesco5/wire/blob/master/packages/api/gateway/src/stream-server.ts"
click node_inspector_host "https://github.com/noelchesco5/wire/blob/master/packages/experimental/inspector/src/host/bridge/controller.ts"
click node_inspector_queries "https://github.com/noelchesco5/wire/blob/master/packages/experimental/inspector/src/worker/inspection/query-router.ts"
click node_schedule_storage "https://github.com/noelchesco5/wire/blob/master/packages/schedule/schedule/src/storage.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_cli,node_web,node_desktop,node_desktop_runtime,node_boot,node_user toneBlue
class node_plugin_manager,node_plugin_ui,node_mods_engine toneAmber
class node_session_api,node_session_manager,node_session_instance,node_session_projection,node_session_notifier,node_persistence_contract,node_jsonl_storage toneMint
class node_sdk_server,node_sdk_client,node_gateway toneRose
class node_inspector_host,node_inspector_queries,node_schedule_storage toneIndigo
```

## Components

### Entry and runtime

- [CLI](https://github.com/noelchesco5/wire/blob/master/apps/cli/src/bin.ts): `apps/cli/src/bin.ts`
- [Web application](https://github.com/noelchesco5/wire/blob/master/apps/web/src/main.ts): `apps/web/src/main.ts`
- [Desktop application](https://github.com/noelchesco5/wire/blob/master/apps/desktop/src/main.ts): `apps/desktop/src/main.ts`
- [Desktop runtime](https://github.com/noelchesco5/wire/blob/master/apps/desktop/src/runtime-tree.ts): `apps/desktop/src/runtime-tree.ts`
- [Application boot](https://github.com/noelchesco5/wire/blob/master/packages/boot/app-boot/src/index.ts): `packages/boot/app-boot/src/index.ts`

### Plugins and extensions

- [Plugin manager](https://github.com/noelchesco5/wire/blob/master/packages/boot/plugin-manager/src/operations.ts): `packages/boot/plugin-manager/src/operations.ts`
- [Plugin manager UI](https://github.com/noelchesco5/wire/blob/master/packages/client/ui-plugin-manager/src/client/PluginManagerPage.tsx): `packages/client/ui-plugin-manager/src/client/PluginManagerPage.tsx`
- [Mods engine](https://github.com/noelchesco5/wire/blob/master/packages/experimental/claude-code-mods/src/engine.ts): `packages/experimental/claude-code-mods/src/engine.ts`

### Sessions and persistence

- [Session API](https://github.com/noelchesco5/wire/blob/master/packages/api/session-controller/src/index.ts): `packages/api/session-controller/src/index.ts`
- [Session manager](https://github.com/noelchesco5/wire/blob/master/packages/api/session-controller/src/client/sessions/manager.ts): `packages/api/session-controller/src/client/sessions/manager.ts`
- [Session instance](https://github.com/noelchesco5/wire/blob/master/packages/api/session-controller/src/client/sessions/session.ts): `packages/api/session-controller/src/client/sessions/session.ts`
- [Session projection](https://github.com/noelchesco5/wire/blob/master/packages/api/session-controller/src/client/sessions/projection-store.ts): `packages/api/session-controller/src/client/sessions/projection-store.ts`
- [Session notifier](https://github.com/noelchesco5/wire/blob/master/packages/api/session-controller/src/client/sessions/notifier.ts): `packages/api/session-controller/src/client/sessions/notifier.ts`
- [Persistence contract](https://github.com/noelchesco5/wire/blob/master/packages/session/session-persistence/src/storage-contract.ts): `packages/session/session-persistence/src/storage-contract.ts`
- [JSONL storage](https://github.com/noelchesco5/wire/blob/master/packages/session/session-persistence-jsonl/src/storage.ts): `packages/session/session-persistence-jsonl/src/storage.ts`

### Client interfaces

- [SDK server](https://github.com/noelchesco5/wire/blob/master/packages/sdk/server/src/server.ts): `packages/sdk/server/src/server.ts`
- [SDK client](https://github.com/noelchesco5/wire/blob/master/packages/sdk/client/src/client.ts): `packages/sdk/client/src/client.ts`
- [API gateway](https://github.com/noelchesco5/wire/blob/master/packages/api/gateway/src/stream-server.ts): `packages/api/gateway/src/stream-server.ts`

### Inspection and scheduling

- [Inspector host](https://github.com/noelchesco5/wire/blob/master/packages/experimental/inspector/src/host/bridge/controller.ts): `packages/experimental/inspector/src/host/bridge/controller.ts`
- [Inspector queries](https://github.com/noelchesco5/wire/blob/master/packages/experimental/inspector/src/worker/inspection/query-router.ts): `packages/experimental/inspector/src/worker/inspection/query-router.ts`
- [Schedule storage](https://github.com/noelchesco5/wire/blob/master/packages/schedule/schedule/src/storage.ts): `packages/schedule/schedule/src/storage.ts`

### Other components

- **Harness user**

## Connections

- Harness user → CLI: launches (evidence: `README.md`)
- CLI → Web application: starts Web UI (evidence: `README.md`)
- Desktop application → Desktop runtime: reads runtime (evidence: `apps/desktop/src/runtime-tree.ts`)
- Desktop application → Application boot: prepares profile
- Plugin manager UI → Plugin manager: manages plugins (evidence: `packages/client/ui-plugin-manager/src/client/PluginManagerPage.tsx`)
- Session manager → Session projection: loads projections (evidence: `packages/api/session-controller/src/client/sessions/manager.ts`)
- Session manager → Session notifier: notifies changes (evidence: `packages/api/session-controller/src/client/sessions/manager.ts`)
- Session manager → Session instance: creates instances (evidence: `packages/api/session-controller/src/client/sessions/manager.ts`)
- Session instance → Session projection: updates projections (evidence: `packages/api/session-controller/src/client/sessions/session.ts`)
- Session instance → Session notifier: uses notifier (evidence: `packages/api/session-controller/src/client/sessions/session.ts`)
- JSONL storage → Persistence contract: materializes batches (evidence: `packages/session/session-persistence-jsonl/src/storage.ts`)
- Inspector host → Inspector queries: starts worker
