Daemion docs

Changelog

All notable changes to the Daemion documentation site.


2026-03-31 — Grounding Review Pass

Fixed

  • POST /chat body params corrected to camelCase (threadId, agentId, model) matching actual server.ts
  • POST /chat status code corrected from 202 to 201
  • POST /extensions trigger field corrected to trigger_def, enabled default to false
  • PUT /extensions/:id/disk-config corrected to PATCH method
  • GET /modes auth requirement corrected (requires bearer token)
  • OTP expiry corrected from 5 to 10 minutes
  • GET /pair/refresh auth requirement corrected (requires bearer token)
  • Removed fabricated error messages (403 "cannot modify built-in", 409 "name already exists") across 12 extension type pages — replaced with actual server errors
  • Fixed event type names in FAQ (turn.delta to text-delta, turn.complete to finish)
  • Fixed src/gateway/routes.ts references (file doesn’t exist) to src/gateway/server.ts across 7 pages
  • Agent directory structure corrected to match actual ~/.daemion/agents/ layout
  • /pair/verify references corrected to /pair

2026-03-31 — Phase 3: Complete Reference + Polish

Added

  • 6 extension type pages: integration, action, widget, artifact, capability, control
  • Full setup guide: Node 22, Engram/Neo4j (optional), Tailscale, launchd/systemd
  • Architecture page: system overview diagram, gateway model, message flow, storage backends
  • 5 concept pages: extensions, turns, agents, jobs, modes
  • 6 guide pages: create-agent, create-job, build-app, remote-access, use-extensions, streaming
  • Smart 404 page with agent-friendly links to /llm.txt and /api.json
  • Pagefind search indexing (44 pages, postbuild step)
  • Fuse.js fuzzy search with typo tolerance, keyboard navigation, Cmd+K shortcut
  • Changelog (this page)

Fixed

  • CodeBlock typography isolation — article styles no longer leak into code blocks
  • Light mode polish — warm off-white backgrounds, readable callouts and gotcha blocks

2026-03-31 — Phase 2: Full API + Extending

Added

  • 7 API reference pages: Agents & Identity, Autonomous Work, Knowledge, Signals, Projects, Apps, System
  • Extending section: overview (“How do I extend Daemion?”), Your First Extension tutorial
  • 6 extension type pages: command, agent, job, app, theme, renderer
  • Error Responses reference: all status codes and error messages from server.ts
  • llms-full.txt generation — concatenated plain-text content for agent consumption
  • CI drift detection script — warns on undocumented gateway routes
  • api_endpoints frontmatter on all API pages — 38/38 routes documented
  • Writing guide (WRITING_GUIDE.md) — 13 non-negotiable facts, curl conventions, MDX escape rules, grounding protocol

Fixed

  • $TOKEN variable standardized to $DAEMION_TOKEN across all pages

2026-03-31 — Phase 1: MVP

Added

  • Astro 6 project scaffold in docs-site/ with dark-first warm amber theme
  • Three-column layout: sidebar navigation, content area, on-page TOC
  • MDX components: CodeBlock, Callout, FAQ, Gotcha, RecipeMeta, ApiEndpoint
  • Homepage with hero, quickstart cards, architecture diagram, agent callout
  • Quickstart — “How do I get Daemion running?” (Claude CLI auth, no API keys)
  • Sign-in guide — “How do I sign in?” (Claude CLI, /login)
  • Pairing guide — “How do I pair a device?” (QR, OTP, bearer token)
  • Kernel concepts — all 6 substrates, RLM-inspired context (no summaries)
  • 3 API pages: Conversations, Extensions, WebSocket
  • llm.txt generation — build-time page index for agents
  • api.json generation — 38 endpoints extracted from server.ts via regex
  • Content collection schema with Zod validation (build fails on missing frontmatter)
  • Dark/light mode toggle
  • Deployed to Vercel