# zemeng5208/personalagent architecture

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

- Interactive diagram: https://gitdiagram.com/zemeng5208/personalagent
- Repository: https://github.com/zemeng5208/personalagent

## Overview

PersonalAgent is a Windows-oriented persistent personal assistant, entered through a floating orb, with proactive prompts and bounded computer actions. Its intended path runs from desktop interaction through the local Runtime, which retains authorization and real execution/readback/evidence responsibilities; AgentArts is the competition orchestration target but README reports no production adapter or end-to-end evidence yet. The graph preserves documented memory, connectors, productivity, voice, and repair capabilities. Several links are omitted because the sampled excerpts do not establish their runtime wiring.

Main entry points: [`apps/runtime/src/application/runtime-application.ts`](https://github.com/zemeng5208/personalagent/blob/main/apps/runtime/src/application/runtime-application.ts) (Runtime Application), [`packages/connectors`](https://github.com/zemeng5208/personalagent/tree/main/packages/connectors) (Platform Connectors), [`apps/desktop/electron/main.js`](https://github.com/zemeng5208/personalagent/blob/main/apps/desktop/electron/main.js) (Electron Main), [`apps/runtime/src/application/windows-host-adapter.ts`](https://github.com/zemeng5208/personalagent/blob/main/apps/runtime/src/application/windows-host-adapter.ts) (Windows Host Adapter)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_desktop["Desktop Experience"]
  node_orb["Floating Orb<br/>[orb.js]"]
  node_renderer["Desktop Renderer<br/>[renderer.js]"]
  node_electron["Electron Main<br/>[main.js]"]
  node_electron_runtime["Desktop Runtime Bridge<br/>[runtime.js]"]
end

subgraph group_runtime["Local Runtime"]
  node_runtime_app["Runtime Application"]
  node_authorization[("Authorization Store")]
  node_host_adapter["Windows Host Adapter"]
  node_evidence["Scoped Evidence Reader<br/>[evidence-reader.ts]"]
  node_fact_host["Competition Fact Host"]
end

subgraph group_intelligence["Agent Cognition"]
  node_agentarts["AgentArts Runtime<br/>[agentarts.ts]"]
  node_cognition["Cognition<br/>[index.ts]"]
  node_coordination["Coordination<br/>[index.ts]"]
  node_memory[("Memory Feed<br/>[feed.ts]")]
  node_notifications["Notification Service<br/>[service.ts]"]
  node_productivity["Todo Service<br/>[service.ts]"]
end

subgraph group_integrations["Platform Capabilities"]
  node_connectors["Platform Connectors"]
  node_feeds["Feed Connector<br/>[service.ts]"]
  node_mail["Mail Connector<br/>[service.ts]"]
  node_calendar["Calendar Connector<br/>[service.ts]"]
  node_weather["Weather Connector<br/>[service.ts]"]
  node_research["Research Connector<br/>[service.ts]"]
  node_voice["Voice Sessions<br/>[voice-session.ts]"]
  node_repair["Workspace Patch Preview<br/>[patch-preview.ts]"]
end

node_user(("User"))
node_agentarts_cloud["AgentArts Platform"]
node_windows["Windows Host"]

node_user -->|"interacts"| node_orb
node_orb -->|"presents"| node_renderer
node_electron -->|"registers"| node_electron_runtime
node_electron -->|"reads approvals"| node_authorization
node_electron -->|"calls queries"| node_runtime_app
node_runtime_app -->|"authorizes"| node_authorization
node_runtime_app -->|"dispatches host tasks"| node_host_adapter
node_runtime_app -->|"reads evidence"| node_evidence
node_runtime_app -->|"projects facts"| node_fact_host
node_agentarts -.->|"orchestrates"| node_agentarts_cloud
node_host_adapter -.->|"executes"| node_windows
node_cognition -->|"coordinates"| node_coordination
node_cognition -.->|"uses memory"| node_memory
node_notifications -.->|"supports reminders"| node_productivity
node_feeds -->|"provides feed input"| node_connectors
node_mail -->|"provides mail actions"| node_connectors
node_calendar -->|"provides calendar actions"| node_connectors
node_weather -->|"provides forecasts"| node_connectors
node_research -->|"provides research"| node_connectors
node_voice -.->|"supports voice input"| node_renderer
node_repair -.->|"previews patches"| node_host_adapter

click node_orb "https://github.com/zemeng5208/personalagent/blob/main/apps/desktop/src/features/orb/orb.js"
click node_renderer "https://github.com/zemeng5208/personalagent/blob/main/apps/desktop/src/app/renderer.js"
click node_electron "https://github.com/zemeng5208/personalagent/blob/main/apps/desktop/electron/main.js"
click node_electron_runtime "https://github.com/zemeng5208/personalagent/blob/main/apps/desktop/electron/runtime.js"
click node_runtime_app "https://github.com/zemeng5208/personalagent/blob/main/apps/runtime/src/application/runtime-application.ts"
click node_authorization "https://github.com/zemeng5208/personalagent/blob/main/apps/runtime/src/authorization-store.ts"
click node_host_adapter "https://github.com/zemeng5208/personalagent/blob/main/apps/runtime/src/application/windows-host-adapter.ts"
click node_evidence "https://github.com/zemeng5208/personalagent/blob/main/apps/runtime/src/application/evidence-reader.ts"
click node_fact_host "https://github.com/zemeng5208/personalagent/blob/main/apps/runtime/src/application/competition-fact-host.ts"
click node_agentarts "https://github.com/zemeng5208/personalagent/blob/main/apps/runtime/src/application/agentarts.ts"
click node_cognition "https://github.com/zemeng5208/personalagent/blob/main/packages/cognition/src/index.ts"
click node_coordination "https://github.com/zemeng5208/personalagent/blob/main/packages/coordination/src/index.ts"
click node_memory "https://github.com/zemeng5208/personalagent/blob/main/packages/memory/src/feed.ts"
click node_notifications "https://github.com/zemeng5208/personalagent/blob/main/packages/notifications/src/service.ts"
click node_productivity "https://github.com/zemeng5208/personalagent/blob/main/packages/productivity/src/service.ts"
click node_connectors "https://github.com/zemeng5208/personalagent/tree/main/packages/connectors"
click node_feeds "https://github.com/zemeng5208/personalagent/blob/main/packages/connectors/feeds/src/service.ts"
click node_mail "https://github.com/zemeng5208/personalagent/blob/main/packages/connectors/mail/src/service.ts"
click node_calendar "https://github.com/zemeng5208/personalagent/blob/main/packages/connectors/calendar/src/service.ts"
click node_weather "https://github.com/zemeng5208/personalagent/blob/main/packages/connectors/weather/src/service.ts"
click node_research "https://github.com/zemeng5208/personalagent/blob/main/packages/connectors/research/src/service.ts"
click node_voice "https://github.com/zemeng5208/personalagent/blob/main/packages/voice/src/voice-session.ts"
click node_repair "https://github.com/zemeng5208/personalagent/blob/main/packages/coding-tools/src/patch-preview.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_orb,node_renderer,node_electron,node_electron_runtime,node_user toneBlue
class node_runtime_app,node_authorization,node_host_adapter,node_evidence,node_fact_host toneAmber
class node_agentarts,node_cognition,node_coordination,node_memory,node_notifications,node_productivity toneMint
class node_connectors,node_feeds,node_mail,node_calendar,node_weather,node_research,node_voice,node_repair toneRose
class node_agentarts_cloud,node_windows toneIndigo
```

## Components

### Desktop Experience

- [Floating Orb](https://github.com/zemeng5208/personalagent/blob/main/apps/desktop/src/features/orb/orb.js): `apps/desktop/src/features/orb/orb.js`
- [Desktop Renderer](https://github.com/zemeng5208/personalagent/blob/main/apps/desktop/src/app/renderer.js): `apps/desktop/src/app/renderer.js`
- [Electron Main](https://github.com/zemeng5208/personalagent/blob/main/apps/desktop/electron/main.js): `apps/desktop/electron/main.js`
- [Desktop Runtime Bridge](https://github.com/zemeng5208/personalagent/blob/main/apps/desktop/electron/runtime.js): `apps/desktop/electron/runtime.js`

### Local Runtime

- [Runtime Application](https://github.com/zemeng5208/personalagent/blob/main/apps/runtime/src/application/runtime-application.ts): `apps/runtime/src/application/runtime-application.ts`
- [Authorization Store](https://github.com/zemeng5208/personalagent/blob/main/apps/runtime/src/authorization-store.ts): `apps/runtime/src/authorization-store.ts`
- [Windows Host Adapter](https://github.com/zemeng5208/personalagent/blob/main/apps/runtime/src/application/windows-host-adapter.ts): `apps/runtime/src/application/windows-host-adapter.ts`
- [Scoped Evidence Reader](https://github.com/zemeng5208/personalagent/blob/main/apps/runtime/src/application/evidence-reader.ts): `apps/runtime/src/application/evidence-reader.ts`
- [Competition Fact Host](https://github.com/zemeng5208/personalagent/blob/main/apps/runtime/src/application/competition-fact-host.ts): `apps/runtime/src/application/competition-fact-host.ts`

### Agent Cognition

- [AgentArts Runtime](https://github.com/zemeng5208/personalagent/blob/main/apps/runtime/src/application/agentarts.ts): `apps/runtime/src/application/agentarts.ts`
- [Cognition](https://github.com/zemeng5208/personalagent/blob/main/packages/cognition/src/index.ts): `packages/cognition/src/index.ts`
- [Coordination](https://github.com/zemeng5208/personalagent/blob/main/packages/coordination/src/index.ts): `packages/coordination/src/index.ts`
- [Memory Feed](https://github.com/zemeng5208/personalagent/blob/main/packages/memory/src/feed.ts): `packages/memory/src/feed.ts`
- [Notification Service](https://github.com/zemeng5208/personalagent/blob/main/packages/notifications/src/service.ts): `packages/notifications/src/service.ts`
- [Todo Service](https://github.com/zemeng5208/personalagent/blob/main/packages/productivity/src/service.ts): `packages/productivity/src/service.ts`

### Platform Capabilities

- [Platform Connectors](https://github.com/zemeng5208/personalagent/tree/main/packages/connectors): `packages/connectors`
- [Feed Connector](https://github.com/zemeng5208/personalagent/blob/main/packages/connectors/feeds/src/service.ts): `packages/connectors/feeds/src/service.ts`
- [Mail Connector](https://github.com/zemeng5208/personalagent/blob/main/packages/connectors/mail/src/service.ts): `packages/connectors/mail/src/service.ts`
- [Calendar Connector](https://github.com/zemeng5208/personalagent/blob/main/packages/connectors/calendar/src/service.ts): `packages/connectors/calendar/src/service.ts`
- [Weather Connector](https://github.com/zemeng5208/personalagent/blob/main/packages/connectors/weather/src/service.ts): `packages/connectors/weather/src/service.ts`
- [Research Connector](https://github.com/zemeng5208/personalagent/blob/main/packages/connectors/research/src/service.ts): `packages/connectors/research/src/service.ts`
- [Voice Sessions](https://github.com/zemeng5208/personalagent/blob/main/packages/voice/src/voice-session.ts): `packages/voice/src/voice-session.ts`
- [Workspace Patch Preview](https://github.com/zemeng5208/personalagent/blob/main/packages/coding-tools/src/patch-preview.ts): `packages/coding-tools/src/patch-preview.ts`

### Other components

- **User**
- **AgentArts Platform**
- **Windows Host**

## Connections

- User → Floating Orb: interacts
- Floating Orb → Desktop Renderer: presents
- Electron Main → Desktop Runtime Bridge: registers
- Electron Main → Authorization Store: reads approvals
- Electron Main → Runtime Application: calls queries
- Runtime Application → Authorization Store: authorizes
- Runtime Application → Windows Host Adapter: dispatches host tasks
- Runtime Application → Scoped Evidence Reader: reads evidence
- Runtime Application → Competition Fact Host: projects facts
- AgentArts Runtime → AgentArts Platform: orchestrates
- Windows Host Adapter → Windows Host: executes
- Cognition → Coordination: coordinates
- Cognition → Memory Feed: uses memory
- Notification Service → Todo Service: supports reminders
- Feed Connector → Platform Connectors: provides feed input
- Mail Connector → Platform Connectors: provides mail actions
- Calendar Connector → Platform Connectors: provides calendar actions
- Weather Connector → Platform Connectors: provides forecasts
- Research Connector → Platform Connectors: provides research
- Voice Sessions → Desktop Renderer: supports voice input
- Workspace Patch Preview → Windows Host Adapter: previews patches