Memory
DocuClear Sphere Browser API - HTML-First Design (HATEOAS for LLMs) Goal: LLM navigates website via links/forms only - no API, no SDK, no MCP. User provides URL → page opens with links like "Recall", "Remember", etc. LLM "clicks" link → returns page with results. Pure browser navigation. Key design principles: 1. Semantic HTML: <button>, <a href>, <form>, <label>, <nav>, <main>, <article>, <section> 2. Server-rendered: All content in initial HTML response - no JavaScript required 3. Descriptive link text: "Search memories by query" not "Click here" 4. Consistent navigation: Same <nav> structure on every page 5. Clear next steps: Every results page includes "What would you like to do next?" with links back to main actions 6. No JavaScript required: Optional enhancement (HTMX, Alpine.js) but core functionality works with plain HTML forms Implementation stack: - Cloudflare Worker: Serves HTML pages, calls MikeSecondBrain tools, renders results - HTML templates: Server-side rendering (no client-side JS framework needed) - Forms: Standard <form action="/recall" method="GET"> - LLM fills and submits - Auth: Query param (?token=xxx) or session cookie - no complex OAuth flow Endpoints: - / (Home) - Main navigation menu - /recall - Search form + results - /remember - Store memory form - /recent - List recent entries - /documents - Manage ingested files - /ingest - Upload document form - /memory/:id - View single memory Status: Design complete, ready for OpenCode agent implementation. Will coordinate with full REST API spec from Sphere.
Tags: browser-api, html-first, hateoas, llm-navigation, docuclear-sphere, status:canonical, opencode, volatility:durable, project:docuclear-sphere-browser-api, duplicate-candidate, kind:semantic — Source: mcp — 2026-08-16 12:31:06 UTC