Commit Graph

11 Commits

Author SHA1 Message Date
e9d81f3b1c docs(api-ref): molecule-audit-ledger — HMAC chain, /audit endpoint, CLI (PR #651)
Add Audit Ledger section to api-reference.mdx:
- GET /workspaces/:id/audit with all query params (agent_id, session_id,
  from/to RFC 3339, limit cap 500, offset)
- Response shape including chain_valid tri-state (true/false/null)
- AUDIT_LEDGER_SALT callout (platform + workspace envs must match)
- LedgerHooks Python usage snippet for workspace templates
- molecule_audit.verify CLI exit codes

Pairs with monorepo PR #651 (feat: molecule-audit-ledger — EU AI Act
Art. 12/13 compliance, HMAC-SHA256-chained agent event log).

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-04-17 18:46:28 +00:00
molecule-ai[bot]
dadb6d41cd
Merge pull request #6 from Molecule-AI/docs/fix-auth-701
docs(api-ref): PATCH auth + templates AdminAuth + validation — PR #701 breaking changes
2026-04-17 12:48:54 +00:00
molecule-ai[bot]
5b0190a788
docs(api-ref): auth + validation breaking changes from PR #701
Updates content/docs/api-reference.mdx:
- Add breaking-changes Callout (PATCH auth, templates AdminAuth, UUID validation)
- PATCH /workspaces/🆔 remove old field-level authz caveat; add full validation
  constraints (name ≤255, role ≤1000, model/runtime ≤100, no newlines/YAML-special)
- GET /templates: None → AdminAuth
- GET /org/templates: None → AdminAuth

Source PR: Molecule-AI/molecule-core#701

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-04-17 12:44:10 +00:00
molecule-ai[bot]
0a4b8119c4
docs: add Google ADK runtime adapter documentation (#4)
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>
2026-04-17 00:36:27 +00:00
Hongming Wang
e2a772d561
Merge pull request #3 from Molecule-AI/feat/external-agents-tokens-mcp
docs: comprehensive content for all 15 pages
2026-04-16 10:11:54 -07:00
Hongming Wang
a620e5a7a3 docs: comprehensive content for all 15 documentation pages
Previously 7 pages were stubs ("Coming soon"). Now all 15 have full content:

- index.mdx: SaaS subdomain table, runtime adapters, MCP/SDK links
- quickstart.mdx: 3 setup options (dev-start.sh, docker-compose, manual), SaaS alternative
- concepts.mdx: added external agents, Lark channel, tokens, MCP integration
- architecture.mdx: system diagram, 4 components, infra services, health detection, deployment modes
- api-reference.mdx: all 80+ routes across 19 categories with auth requirements
- channels.mdx: Telegram, Slack, Lark/Feishu adapters with config examples
- plugins.mdx: two-axis model, 12 built-in plugins, install safeguards
- schedules.mdx: cron syntax, concurrency handling, supervision, org template examples
- org-template.mdx: YAML structure, defaults layer, plugin UNION, template registry
- self-hosting.mdx: dev-start.sh, docker-compose, env vars, production deployment
- observability.mdx: activity logs, Langfuse, Prometheus, liveness, WebSocket events
- troubleshooting.mdx: 10 common issues with fixes

Build verified: 19/19 static pages generated.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-04-16 10:05:12 -07:00
Hongming Wang
ebb56f9b8c
Merge pull request #1 from Molecule-AI/feat/external-agents-tokens-mcp
feat: External Agents, Token Management, MCP Server docs
2026-04-16 09:31:12 -07:00
Hongming Wang
85602bd386
Merge pull request #2 from Molecule-AI/chore/credentials-gitignore
chore: gitignore credentials
2026-04-16 09:26:15 -07:00
rabbitblood
8cdc85ba67 chore: gitignore credentials for docs
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>
2026-04-16 09:19:24 -07:00
Hongming Wang
4f5bdc3f79 feat: add External Agents, Token Management, MCP Server docs
New pages:
- external-agents.mdx — step-by-step remote agent registration guide
  with Python (Flask) and Node.js (Express) working examples
- tokens.mdx — create, list, revoke workspace bearer tokens
- mcp-server.mdx — 87-tool reference with API route mapping

Framework upgrade (fumadocs v15.8 had a build crash "a.map is not a
function" in DocsLayout page tree formatter — unfixable without upgrade):
- fumadocs-core/ui: 15.8 → 16.7
- fumadocs-mdx: 11.10 → 14.3
- next: 15.5 → 16.2
- react/react-dom: 19.0 → 19.2

Migration: RootProvider import path, source import path, search route
stubbed (full-text search TBD after fumadocs v16 search API stabilizes).

Build: 19/19 static pages generated successfully.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-04-16 09:14:45 -07:00
rabbitblood
7cdc0bc9b4 init: scaffold doc.moleculesai.app with Fumadocs + Next.js 15
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.
2026-04-14 21:01:17 -07:00