PR #784 added pgvector-backed semantic search to GET /workspaces/:id/memories.
When ?q= is supplied and an embedding function is configured, results are
ordered by cosine similarity and include a similarity_score field.
Documents the query parameter, response shape, and graceful FTS fallback
so callers know the endpoint is backwards-compatible.
Pairs with monorepo PR #784 (feat: pgvector semantic search, closes#776).
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Workspace config.yaml now supports a `role` field which drives
AGENTS.md generation at startup (PR #763). Every workspace publishes
an AAIF-standard /workspace/AGENTS.md so peers can discover name,
role, description, A2A endpoint, and MCP tools.
- Expand Workspaces section with AGENTS.md auto-generation details
- Add table of AGENTS.md sections and their config.yaml sources
- Add role field to all workspaces in the org definition example
- Document fallback (role → description) and non-fatal startup behaviour
Pairs with monorepo PRs #763 and #794.
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Adds content/docs/workspace-config.mdx covering:
- Config tab overview (how to open, form vs raw YAML mode)
- Claude Settings panel: gating condition, where to find it in the UI
- Effort levels table: low / medium / high / xhigh (extended thinking) / max
with descriptions, use-case guidance, cost/latency/quality tradeoffs
- Task budget: token ceiling, 20k minimum, when it applies, sizing guidance
- config.yaml reference with three annotated examples
- Beta header note: task-budgets-2026-03-13 added automatically by executor
- Executor wiring callout: config stored today, executor wiring ships next release
Updates meta.json: adds workspace-config after concepts in the nav.
Closes#608 (docs portion)
Source PRs: molecule-monorepo#639 (effort + task_budget UI), #654 (max level)
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Inserts a hands-on ## Quickstart section between Secrets and Basic usage
in content/docs/google-adk.mdx. Covers workspace creation via REST API,
ready-state polling, first A2A task, multi-turn session state demo, and
Vertex AI alternative. Explains context_id → InMemorySessionService mapping
and google: model prefix stripping — gaps not covered by the reference docs.
Pairs with: Molecule-AI/molecule-monorepo#569 (docs/devrel-feat-550)
Existing docs: Docs PR #4 (google-adk.mdx reference page, already merged)
Source PR: Molecule-AI/molecule-core#550
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Pre-draft docs for the google-adk workspace adapter (issue #542, PR #550).
Covers installation, secrets, config reference, A2A compatibility, plugin
support, and troubleshooting. Also adds google-adk to the runtimes table
in architecture.mdx and the runtime list in concepts.mdx.
Closes#542
Co-authored-by: Molecule AI Documentation Specialist <documentation-specialist@agents.moleculesai.app>
Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
Adds standard credential gitignore (.env / *.pem / .secrets/ / .auth_token).
Per-CEO directive 2026-04-16: every plugin and template repo should
gitignore credentials so self-hosters can't accidentally commit real
tokens to public repos.
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Customer-facing documentation site for Molecule AI. Built with Fumadocs
(open-source MIT, Next.js 15 App Router native, Tailwind v4, MDX) so we
own the deployment and aesthetic and can grow into custom doc components
for our agent-canvas flows.
## Why Fumadocs (over Mintlify, Nextra, Docusaurus)
- Open source, no vendor lock-in (vs Mintlify SaaS subscription)
- Built on Next.js 15 App Router — matches our existing canvas stack
- Less opinionated than Nextra; can grow into custom doc components
- React/Tailwind first; team already on this stack
- Ships search, dark mode, Shiki highlighting, MDX out of the box
## Initial structure
- app/ — Next.js App Router (home + docs + search route)
- content/docs/ — MDX source (3 hand-written + 9 stub pages)
- lib/source.ts — Fumadocs loader bound to the MDX content
- mdx-components.tsx — default + future custom MDX renderers
- source.config.ts — MDX compile config
## Hand-written launch content
- index.mdx — landing / what you can build / how it works
- quickstart.mdx — clone repo → docker compose → import template → talk to PM
- concepts.mdx — the five primitives: workspaces / plugins / channels / schedules / canvas
## Stub pages (Documentation Specialist agent fills these in on cron)
- org-template, plugins, channels, schedules
- architecture, api-reference, self-hosting
- observability, troubleshooting
## Ownership
The Documentation Specialist agent in the molecule-dev org template will
own this repo end-to-end:
- Watches PRs landing in the platform monorepo
- Auto-opens docs PRs when public APIs / templates / plugins / channels change
- Runs daily cron to backfill stubs and refresh stale pages
Manual edits welcome. Agent picks up on next cron tick.
