Commit Graph

75 Commits

Author SHA1 Message Date
molecule-ai[bot]
e00012be3d
docs(blog): debug failed workspaces without leaving Canvas
Content for internal#8 / PR #1178 launch coverage.
Angle: EC2 console output surfaced directly in Canvas — no more
tab-switching to AWS Console.

~180 words.
2026-04-21 03:38:29 +00:00
molecule-ai[bot]
a6d9902816
docs(blog): add audit trail API logs companion post (#54)
* docs(blog): add Chrome DevTools MCP browser automation post

Action 1 of #1120 SEO campaign.

- Covers Chrome DevTools MCP setup on Molecule AI
- Comparison table naming MCP governance layer explicitly
- AI Agent Browser Control governance section
- Python verification script + curl revocation sample
- Org API keys audit trail bridge (#1118)
- Cross-links to mcp-server-setup and org-api-keys guides
- Targets P0 keywords: MCP browser automation, AI agent browser
  control, MCP governance layer, Chrome DevTools MCP AI,
  browser automation AI agents

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

* docs(blog): add Phase 30 remote workspaces auth + fleet visibility post

Covers:
- Per-workspace bearer token auth model (Phase 30.1)
- Unified canvas fleet visibility for heterogeneous agent fleets
- Remote agent registration flow (6 steps)
- Before/after comparison table
- Enterprise use cases: CI/CD, multi-cloud, BYO-device

Awaiting: keyword research (SEO Analyst) + positioning brief (PMM)
before final sign-off.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

* docs(blog): refine Phase 30 blog SEO — keywords and frontmatter

- Title: "Remote AI Agents: Per-Workspace Auth + Fleet Visibility"
- Meta targets: remote AI agents, per-workspace auth, AI agent fleet visibility
- "AI agent fleet management" in comparison section heading
- "AI Agent Authentication at Scale" section heading

Awaiting keyword research from SEO Analyst before final sign-off.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

* docs(blog): add Org-Scoped API Keys enterprise key management post

Covers:
- ADMIN_TOKEN problem and 3 compounding risks
- Org-scoped API key features (named, revocable, sha256 hash, prefix, created_by)
- Comparison table: ADMIN_TOKEN vs org-scoped keys
- Token hierarchy (Tier 0-3)
- Mint/list/revoke curl examples
- Cross-links to Chrome DevTools MCP blog and org-api-keys guides
- Competitive note on Hermes v0.10.0 tool gateway

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

* docs(blog): add waitlist page and audit trail panel posts

- 2026-04-20-waitlist: Beta early access waitlist page — user flow,
  privacy guard (no URL prefill), dedup handling, launch-CTA framing.
  Addresses GH issue #1162.
- 2026-04-21-audit-trail-panel: Audit Trail Panel on Canvas — event-type
  badges, chain validity tamper indicator, filter bar, pagination.
  Coordinates with Phase 30 fleet visibility narrative.
  Addresses GH issue #1164.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

* docs(blog): add audit trail API logs companion post

2026-04-21-audit-trail-api-logs: Two-layer audit observability post.
- Layer 1: Canvas Audit Trail (decision events, chain_valid tamper indicator)
- Layer 2: Org API key attribution (every API call tagged with key prefix)
- How they fit together: compliance review scenario walkthrough
- Governance chain: org key → per-workspace token → Canvas Audit Trail
- CTA: start with Canvas Audit Trail, add org API keys as integrations come online

Companion TTS audio (734K, ~74s) committed separately to molecule-core/marketing/audio/.

Addresses GH issue #1164 follow-on coverage.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

---------

Co-authored-by: Molecule AI Content Marketer <content-marketer@agents.moleculesai.app>
Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-04-21 03:18:57 +00:00
molecule-ai[bot]
dae42e2214
merge: PR #59
* feat(marketing): Chrome DevTools MCP blog post

Issue: #1175

* docs(marketing): fix broken CTAs in Chrome DevTools MCP blog post

- /getting-started → /docs/quickstart (page now exists)
- MCP Marketplace link → /docs/mcp-server
- hello@molecule.ai → GitHub Discussions
- Added step-by-step Chrome startup instructions (was missing)
- Standardized on /docs/ paths for all internal links
- Fixed duplicate word 'broken, broken' in QA agent example

---------

Co-authored-by: molecule-ai[bot] <276602405+molecule-ai[bot]@users.noreply.github.com>
2026-04-21 03:00:17 +00:00
molecule-ai[bot]
86fa0e9ec3
merge: PR #58
Git for agents — versioned workspace snapshots via CF Artifacts.
Coverage: REST API endpoints, credential lifecycle, use cases.

Co-authored-by: molecule-ai[bot] <276602405+molecule-ai[bot]@users.noreply.github.com>
Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-04-21 03:00:15 +00:00
molecule-ai[bot]
01a0822065
docs: add org-api-keys setup guide
Adds content/docs/guides/org-api-keys.md — CLI/API reference for minting,
listing, revoking org-scoped API keys. Referenced by the org-scoped API
keys blog post CTAs.
2026-04-21 02:49:37 +00:00
molecule-ai[bot]
1b84ccac4f
docs: add quickstart guide + Chrome DevTools MCP setup guide
Adds two guide pages referenced by the Chrome DevTools MCP blog post:
- docs/guides/chrome-devtools-mcp-setup.md — browser automation MCP setup
- docs/quickstart.md — 5-minute agent deployment quickstart
- docs/guides/index.md — guide index

Fixes broken links in the Chrome DevTools MCP marketing blog post CTAs:
- /getting-started → /docs/quickstart
- MCP Marketplace → /docs/mcp-server
2026-04-21 02:34:41 +00:00
molecule-ai[bot]
6ff0a3bc81
docs(blog): add Discord adapter launch post (#57)
Squash-merge: Discord adapter launch blog post. Acceptance: published on docs.
2026-04-21 01:46:57 +00:00
molecule-ai[bot]
04732e3fe6
docs(blog): add waitlist page and audit trail panel posts (#53)
Squash-merge: waitlist page + audit trail panel blog posts. Acceptance: published on docs.
2026-04-21 00:23:16 +00:00
molecule-ai[bot]
b84a4af934
docs(self-hosting): add ADMIN_TOKEN production requirement page (#33)
* docs(concepts): add Memory Inspector panel (canvas PR #738)

Document the canvas Memory Inspector panel — Side Panel → Memory tab.
Covers browse (LOCAL/TEAM scopes), semantic search via ?q= param,
and key expansion. Notes polling cadence (~15s heartbeat cycle).

Pairs with molecule-core PR #738 and builds on the semantic search
docs from origin/docs/memory-semantic-search-784.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

* docs(self-hosting): add ADMIN_TOKEN production requirement page

Adds content/docs/self-hosting/admin-token.mdx explaining:
- ADMIN_TOKEN must be set in production (deadline April 22, 2026)
- Generation: openssl rand -base64 32
- What /admin/* endpoints it gates
- Fail-open risk when unset
- Verification and rotation steps

Also updates meta.json nav and adds cross-link from self-hosting.mdx.

Pairs with: monorepo PR #729 (issue #684)

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>

---------

Co-authored-by: Molecule AI Documentation Specialist <documentation-specialist@agents.moleculesai.app>
Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
Co-authored-by: Molecule AI App-FE <app-fe@agents.moleculesai.app>
2026-04-20 22:41:19 +00:00
molecule-ai[bot]
3d65f226dc
docs(security): OWASP Agentic AI Top 10 coverage report (#31)
* docs(security): add OWASP Agentic AI Top 10 coverage report

Adds content/docs/security/owasp-agentic-top-10.mdx with honest coverage:
   COVERED (5):  A01 Prompt Injection, A02 Sensitive Info Disclosure,
                   A03 Unbounded Resource Consumption, A06 Memory Poisoning,
                   A07 Cascade Hallucinations
  ⚠️ PARTIAL (3):  A04 Sandboxing Escapes, A05 Agent-Human Relationship
                   Dysfunction, A08 Overreliance
   NOT COVERED: A09 Supply Chain Vulnerabilities, A10 Improper Agency Grants

Meta.json updated to include security section with all three pages.
PR merge order note: advisory (#808) should merge before this PR.
If advisory is not yet merged, rebase to remove duplicate entries.

Deadline: April 25, 2026

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>

* fix(security): update molecule-monorepo → molecule-core in OWASP coverage

Terminology fix: repo reference updated to the correct name.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>

---------

Co-authored-by: Molecule AI Documentation Specialist <documentation-specialist@agents.moleculesai.app>
Co-authored-by: Claude Opus 4.7 <noreply@anthropic.com>
Co-authored-by: Molecule AI App-FE <app-fe@agents.moleculesai.app>
2026-04-20 22:40:14 +00:00
Molecule AI App & Docs Lead
703883b871 merge: PR #39 workspace hibernation docs
Conflict resolved in content/docs/concepts.mdx:
- Keep main's AGENTS.md auto-generation + workspace budgets section
- Add pr-39's workspace status lifecycle table + hibernation note

Both changes are additive and non-overlapping in scope.

🤖 Generated with [Claude Code](https://claude.ai/claude-code)
2026-04-20 22:07:07 +00:00
Molecule AI App & Docs Lead
e2979390b9 fix(docs): convert bare URLs to markdown links in safe-mcp-advisory.mdx
MDX parser (next-mdx-remote or nextra) treats bare URLs as syntax
errors. Convert 3 raw <url> references in the Normative references
section to proper markdown links.

Addresses Molecule-AI/docs issue #45.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-04-20 21:55:32 +00:00
molecule-ai[bot]
4af2825345
Merge pull request #41 from Molecule-AI/docs/slack-bot-api-844
docs(channels): update Slack adapter for dual-mode Bot Token / webhook
2026-04-20 08:49:33 -07:00
molecule-ai[bot]
6769630378
Merge pull request #40 from Molecule-AI/docs/opencode-mcp-bridge-800
docs(site): add OpenCode MCP Bridge integration page
2026-04-20 08:49:29 -07:00
molecule-ai[bot]
27e3c68fe3
Merge pull request #38 from Molecule-AI/docs/schedule-health-admin-671
docs(schedules): add GET /admin/schedules/health cross-org endpoint (PRs #671 #796)
2026-04-20 08:49:25 -07:00
molecule-ai[bot]
6c4630e0be
Merge pull request #37 from Molecule-AI/docs/per-workspace-token-metrics-602
docs(observability): add per-workspace token metrics section (PRs #602 #627)
2026-04-20 08:49:21 -07:00
molecule-ai[bot]
66e5ed97db
Merge pull request #36 from Molecule-AI/docs/org-plugin-governance-610
docs(plugins): add org-level plugin governance allowlist (PR #610)
2026-04-20 08:49:18 -07:00
molecule-ai[bot]
7e7461a672
Merge pull request #35 from Molecule-AI/docs/memory-inspector-738
docs(concepts): add Memory Inspector panel (canvas PR #738)
2026-04-20 08:49:15 -07:00
molecule-ai[bot]
9d6c49aa25
Merge pull request #34 from Molecule-AI/docs/hermes-native-tools-644-645
docs(hermes): native tools + structured output shipped (PRs #644 #645)
2026-04-20 08:49:12 -07:00
molecule-ai[bot]
ff5d83ecd2
Merge pull request #32 from Molecule-AI/docs/workspace-budget-limit-541
docs(concepts+api-ref): add workspace spend cap — PATCH /workspaces/:id/budget
2026-04-20 08:49:07 -07:00
molecule-ai[bot]
4b1ce68f61
Merge pull request #30 from Molecule-AI/docs/safe-mcp-advisory-2026-04-17
docs(security): SAFE-MCP advisory — Ed25519 → MCPS Tool Definition Signing, OWASP refs
2026-04-20 08:49:02 -07:00
7950730cad docs(channels): update Slack adapter for dual-mode Bot Token / webhook (#844)
PR #844 upgraded slack.go from webhook-only to dual-mode. Documents new
bot_token field, channel/username/icon_emoji config, chat:write.customize
per-agent identity, and required Slack app OAuth scopes.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-04-20 02:57:52 +00:00
fb4f86a42c docs(site): opencode MCP bridge integration page (#800)
Pairs with monorepo PRs #840 (opencode MCP bridge) and #842 (org-template +
integration guide). Adds opencode.mdx with prerequisites, opencode.json config,
token issuance, available tools, transport options, and SAFE-T1401/T1201
security notes. Adds ---Integrations--- nav section to meta.json.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-04-20 02:57:52 +00:00
02790dcef5 docs(site): opencode MCP bridge integration page (#800)
Pairs with monorepo PRs #840 (opencode MCP bridge) and #842 (org-template +
integration guide). Adds opencode.mdx with prerequisites, opencode.json config,
token issuance, available tools, transport options, and SAFE-T1401/T1201
security notes. Adds ---Integrations--- nav section to meta.json.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-04-20 02:56:51 +00:00
d11601a0db fix(security): update molecule-monorepo → molecule-core in SAFE-MCP advisory
Terminology fix: all references to the repo now use the correct name
molecule-core (was molecule-monorepo). No content changes beyond the
repo name update.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
2026-04-19 22:03:25 +00:00
fc1ced14b9 docs(concepts+api-ref): add workspace spend cap — PATCH /workspaces/:id/budget
Pairs with molecule-core PR #611 (merged 2026-04-17). Closes #541.

- concepts.mdx: Workspace budgets section (USD cents, 402 enforcement,
  fail-open, GET+PATCH /budget)
- api-reference.mdx: Budget subsection with GET+PATCH /workspaces/:id/budget,
  full JSON shape, warn/info callouts; PATCH /workspaces/:id row notes
  budget_limit is not accepted there

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
2026-04-19 12:35:30 +00:00
4341d69cd8 docs(hermes): native tools + structured output shipped (PRs #644 #645)
Mark Phase 2e as shipped — native tools=[] parameter and
response_format=json_schema now on the Anthropic native dispatch path.

- Update intro paragraph: Phase 2d is now stacked messages (#499),
  Phase 2e is tools + structured output (#644, #645)
- Replace Phase 2d roadmap callout with "remaining roadmap" (vision + streaming)
- Update capability table: native tools and response_format now  on
  Anthropic native; 📋 roadmap for Gemini native
- Add two new sections with code examples for tools=[] and response_format
- Remove "not yet shipped" language from capability table header

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-04-19 12:32:08 +00:00
e2702d02f2 docs(hermes): stacked system messages — system_blocks kwarg (PR #499)
- Add '## Advanced: stacked system messages' section (before Capability table)
  covering: usage, block ordering (persona → tools → reasoning), None/empty
  skip behaviour, system_blocks-vs-system_prompt precedence, backward compat note
- Update shipped capability table to include stacked system messages row and
  note PR #499 alongside Phase 2a/2b/2c

Pairs with monorepo PR #798 (feat(hermes): stacked system messages —
persona + tools + reasoning policy, PR #499).
⚠ Depends on docs PR #9 (hermes.mdx baseline) merging first.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-04-19 12:32:08 +00:00
2ff96935d0 docs(concepts): add Memory Inspector panel (canvas PR #738)
Document the canvas Memory Inspector panel — Side Panel → Memory tab.
Covers browse (LOCAL/TEAM scopes), semantic search via ?q= param,
and key expansion. Notes polling cadence (~15s heartbeat cycle).

Pairs with molecule-core PR #738 and builds on the semantic search
docs from origin/docs/memory-semantic-search-784.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-04-19 12:32:05 +00:00
451a2cca1a docs(security): add OWASP normative references to SAFE-MCP advisory
Sourced from Research Lead synthesis 2026-04-18 22:52 UTC.

Changes:
- G-02 long-term mitigation: replaced vague "Ed25519" with MCPS
  Tool Definition Signing (ECDSA P-256, schema hash pinning, rug pull
  protection, targeting MCPS L3 trust level)
- Added "Normative References" section citing:
  - MCP04:2025 — Software Supply Chain Attacks & Dependency Tampering
    (signed components, version pinning, SBOM/CBOM, dependency scanning)
  - MCP09:2025 — Shadow MCP Servers
    (central governance, discovery/scanning, baseline configs)
  - MCPS — Cryptographic Security Layer for MCP
    (tool definition signing, trust levels L0–L4)
- Annotated each remediation checklist item with the OWASP control
  that motivates it

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
2026-04-19 12:31:09 +00:00
b08ca85b2e docs(security): add SAFE-MCP advisory 2026-04-17
Adds content/docs/security/ section:
- security/index.mdx — section landing page
- security/safe-mcp-advisory.mdx — three HIGH findings for self-hosted ops:
  G-01: unpinned npm MCP packages
  G-02: no manifest signing
  G-03: floating plugin references

Updates meta.json with Security nav section.

Pairs with: monorepo PRs #808, #809
Deadline: April 22, 2026

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
2026-04-19 12:31:09 +00:00
a50ab173b5 docs(schedules): add GET /admin/schedules/health cross-org endpoint (PRs #671 #796)
Document the admin-only cross-org schedule health endpoint returning
last-fired, next-scheduled, consecutive-empty count, and phantom detection
status for every schedule in the org. Complements the per-workspace peer
health endpoint already documented. Pairs with molecule-core PRs #671 and
#796.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-04-19 12:31:05 +00:00
4b56da1108 docs(observability): add per-workspace token metrics section (PRs #602 #627)
Document GET /workspaces/:id/metrics — WorkspaceAuth-required endpoint
returning input/output/cache-read/cache-write token counts over rolling
1h and 30d windows. Notes the canvas WorkspaceUsage panel as the live
counterpart. Security context: endpoint auth hardened in PR #696.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-04-19 12:31:05 +00:00
55725a3806 docs(plugins): add org-level plugin governance allowlist (PR #610)
Document POST/DELETE /admin/orgs/:orgId/plugins/allowlist endpoints for
controlling which plugins workspaces in an org may load. Covers allowlist
semantics (empty = all permitted; non-empty = allowlist-only), relationship
to supply-chain pinning, and the two admin API endpoints. Adds both
endpoints to the API Reference table at the bottom of the page.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-04-19 12:31:05 +00:00
3096ecfb3b fix(docs): revert Docker network name to molecule-monorepo-net (confirmed in docker-compose.infra.yml L121)
molecule-core-net was incorrect — docker-compose.infra.yml and docker-compose.yml both
declare the network as molecule-monorepo-net (8+ references confirmed). Repo was renamed
to molecule-core but the network name was not changed.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-04-19 12:14:40 +00:00
3aa6940d27 docs(site): update molecule-monorepo → molecule-core across all docs (launch fix)
Repo was renamed Molecule-AI/molecule-monorepo → Molecule-AI/molecule-core.
Updates git clone URLs, cd commands, and Docker network name references
in quickstart.mdx, self-hosting.mdx, and architecture.mdx.

Note: molecule-core-net Docker network name updated from molecule-monorepo-net —
verify docker-compose.infra.yml network name matches before merging.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-04-19 12:14:40 +00:00
Hongming Wang
d566b84dcc
Merge pull request #28 from Molecule-AI/docs/smolagents-security-891
docs(architecture): smolagents adapter — env sanitization and safe messaging
2026-04-19 00:52:49 -07:00
Hongming Wang
1e65effe52
Merge pull request #26 from Molecule-AI/docs/default-model-opus47-743
docs(concepts): default model updated to claude-opus-4-7 (core #743)
2026-04-19 00:52:45 -07:00
Hongming Wang
c71efcbd4d
Merge pull request #25 from Molecule-AI/docs/discord-adapter-625
docs(channels): add Discord adapter (core #656, closes #625)
2026-04-19 00:52:43 -07:00
Hongming Wang
8c07966f6d
Merge pull request #24 from Molecule-AI/docs/ag-ui-sse-601
docs(api-ref): AG-UI SSE streaming endpoint (core #601)
2026-04-19 00:52:40 -07:00
Hongming Wang
54a86a3aa1
Merge pull request #22 from Molecule-AI/docs/daily-changelog-2026-04-17
docs(site): daily changelog 2026-04-17
2026-04-19 00:52:37 -07:00
Hongming Wang
a45b3c0911
Merge pull request #19 from Molecule-AI/docs/temporal-checkpoints-797-803
docs(api-ref): Temporal workflow checkpoints — step endpoints, auto-resume behavior
2026-04-19 00:52:31 -07:00
Hongming Wang
28783fe1db
Merge pull request #18 from Molecule-AI/docs/mcp-server-security-808
docs(mcp-server): pin npm version, remove -y flag — SAFE-MCP NEW-003
2026-04-19 00:52:29 -07:00
Hongming Wang
9951c1509d
Merge pull request #17 from Molecule-AI/docs/plugin-supply-chain-775
docs(plugins): plugin supply chain security — pinned refs required, SHA-256 integrity
2026-04-19 00:52:26 -07:00
Hongming Wang
b9e1ad8566
Merge pull request #15 from Molecule-AI/docs/audit-ledger-651
docs(api-ref): molecule-audit-ledger — HMAC chain, /audit endpoint, LedgerHooks, CLI
2026-04-19 00:52:23 -07:00
Hongming Wang
6830e973ba
Merge pull request #13 from Molecule-AI/docs/molecule-medo-plugin-741
docs(plugins): add molecule-medo as opt-in platform plugin
2026-04-19 00:52:19 -07:00
Hongming Wang
018ba293ea
Merge pull request #12 from Molecule-AI/docs/canvas-features-751-759
docs(canvas): A2A topology overlay and audit trail panel
2026-04-19 00:52:16 -07:00
Hongming Wang
80f41619dd
Merge pull request #11 from Molecule-AI/docs/memory-semantic-search-784
docs(api-ref): semantic memory search via ?q= param
2026-04-19 00:52:13 -07:00
Hongming Wang
5d7b2e2528
Merge pull request #10 from Molecule-AI/docs/agents-md-autogen-763
docs(concepts): AGENTS.md auto-generation and role field
2026-04-19 00:52:10 -07:00
Hongming Wang
3b126e1892
Merge pull request #9 from Molecule-AI/docs/hermes-dispatch-513
docs(site): Hermes multi-provider dispatch page
2026-04-19 00:52:08 -07:00