The open-source app everyone uses to manage agents at work
TypeScript acpxagent-orchestrationagent-skillsagentic-aiai-agentsai-engineeringai-governanceai-toolsautonomous-agentsclaudeclaude-codeclaude-skillscodexhermesllmmcpmulti-agentopenclawproject-managementworkflow-automation
docs: fix SPEC accuracy for adapters and backend
dotta4bb42005ea41
diff --git a/doc/SPEC.md b/doc/SPEC.mdindex 82315bce59..671431bbc4 100644--- a/doc/SPEC.md+++ b/doc/SPEC.md@@ -186,17 +186,21 @@ The heartbeat is a protocol, not a runtime. Paperclip defines how to initiate an### Execution Adapters-Agent configuration includes an **adapter** that defines how Paperclip invokes the agent. Initial adapters:--| Adapter | Mechanism | Example |-| -------------------- | ----------------------- | --------------------------------------------- |-| `process` | Execute a child process | `python run_agent.py --agent-id {id}` |-| `http` | Send an HTTP request | `POST https://openclaw.example.com/hook/{id}` |-| `openclaw_gateway` | OpenClaw gateway API | Managed OpenClaw agent via gateway |-| `gemini_local` | Gemini CLI process | Local Gemini CLI with sandbox and approval |-| `hermes_local` | Hermes agent process | Local Hermes agent |--The `process` and `http` adapters ship as defaults. Additional adapters have been added for specific agent runtimes (see list above), and new adapter types can be registered via the plugin system (see Plugin / Extension Architecture).+Agent configuration includes an **adapter** that defines how Paperclip invokes the agent. Built-in adapters include:++| Adapter | Mechanism | Example |+| ---------------- | -------------------------- | -------------------------------------------------- |+| `process` | Execute a child process | `python run_agent.py --agent-id {id}` |+| `http` | Send an HTTP request | `POST https://openclaw.example.com/hook/{id}` |+| `claude_local` | Local Claude Code process | Claude Code heartbeat worker |+| `codex_local` | Local Codex process | Codex CLI heartbeat worker |+| `opencode_local` | Local OpenCode process | OpenCode heartbeat worker |+| `pi_local` | Local Pi process | Pi CLI heartbeat worker |+| `cursor` | Cursor API/CLI bridge | Cursor-integrated heartbeat worker |+| `openclaw_gateway` | OpenClaw gateway API | Managed OpenClaw agent via gateway |+| `hermes_local` | Local Hermes process | Hermes agent heartbeat worker |++The `process` and `http` adapters ship as generic defaults. Additional built-in adapters cover common local coding runtimes (see list above), and new adapter types can be registered via the plugin system (see Plugin / Extension Architecture).### Adapter Interface@@ -376,7 +380,7 @@ Flow:| Layer | Technology || -------- | ------------------------------------------------------------ || Frontend | React + Vite |-| Backend | TypeScript + Hono (REST API, not tRPC — need non-TS clients) |+| Backend | TypeScript + Express (REST API, not tRPC — need non-TS clients) || Database | PostgreSQL (see [doc/DATABASE.md](./doc/DATABASE.md) for details — PGlite embedded for dev, Docker or hosted Supabase for production) || Auth | [Better Auth](https://www.better-auth.com/) |@@ -406,7 +410,7 @@ No separate "agent API" vs. "board API." Same endpoints, different authorization### Work Artifacts-Paperclip does **not** manage work artifacts (code repos, file systems, deployments, documents). That's entirely the agent's domain. Paperclip tracks tasks and costs. Where and how work gets done is outside scope.+Paperclip does **not** manage full delivery infrastructure (code repos, deployments, production runtime). It tracks task-linked artifacts (for example issue documents and attachments), while implementation and deployment remain the agent's domain.### Open Questions@@ -476,15 +480,14 @@ Each is a distinct page/route:- [ ] **Default agent** — basic Claude Code/Codex loop with Paperclip skill- [ ] **Default CEO** — strategic planning, delegation, board communication- [ ] **Paperclip skill (SKILL.md)** — teaches agents to interact with the API-- [ ] **REST API** — full API for agent interaction (Hono)+- [ ] **REST API** — full API for agent interaction (Express)- [ ] **Web UI** — React/Vite: org chart, task board, dashboard, cost views- [ ] **Agent auth** — connection string generation with URL + key + instructions- [ ] **One-command dev setup** — embedded PGlite, everything local-- [ ] **Multiple Adapter types** (HTTP Adapter, OpenClaw Adapter)+- [ ] **Multiple Adapter types** (HTTP, OpenClaw gateway, and local coding adapters)### Not V1-- Template export/import- Knowledge base - a future plugin- Advanced governance models (hiring budgets, multi-member boards)- Revenue/expense tracking beyond token costs - a future plugin