Architecture overview

┌────────────────────────────────────────────────────────────────────┐
│  AgentsKitOS                                                       │
│  ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ ┌────────────┐ │
│  │  os-desktop  │ │   os-cli     │ │   os-flow    │ │ os-triggers│ │
│  │  (Tauri 2)   │ │              │ │  (DAG/HITL)  │ │            │ │
│  └──────┬───────┘ └──────┬───────┘ └──────┬───────┘ └─────┬──────┘ │
│         │                │                │               │        │
│  ┌──────┴────────────────┴────────────────┴───────────────┴──────┐ │
│  │  @agentskit/os-core (Zod contracts, event bus, principal/cap, │ │
│  │  errors, workspace model, plugin manifest)                    │ │
│  └──────────────────────────────┬────────────────────────────────┘ │
│  ┌──────────────┐ ┌─────────────┴──┐ ┌──────────────┐ ┌──────────┐ │
│  │  os-security │ │ os-marketplace │ │ os-mcp-bridge│ │ os-cloud │ │
│  │  (vault++)   │ │  + os-plugins  │ │  (publish +  │ │  -sync   │ │
│  │              │ │                │ │   consume)   │ │          │ │
│  └──────────────┘ └────────────────┘ └──────────────┘ └──────────┘ │
└────────────────────────────────┬───────────────────────────────────┘
                                 │ peerDependency
┌────────────────────────────────┴───────────────────────────────────┐
│  AgentsKit (upstream)                                              │
│  core · runtime · adapters · memory · tools · skills · rag         │
│  observability · sandbox · eval · cli · ink · react · vue · svelte │
└────────────────────────────────────────────────────────────────────┘

agentskit-os.config.ts       # Zod-validated, defineConfig() helper
workspace.yaml               # workspace declaration
agentskit-os.lock            # byte-reproducible lockfile (RFC-0002)
.agentskitos/                # runtime dir
  sqlite/                    # checkpoints, traces
  vault/                     # encrypted secrets
  traces/                    # span exports