Commit Graph

97 Commits

Author SHA1 Message Date
molecule-ai[bot]
89cc0dd647
docs: add external-agent-registration.md guide (synced from molecule-core) 2026-04-21 07:21:20 +00:00
molecule-ai[bot]
2b45a12c55
docs: add mcp-server-setup.md guide (synced from molecule-core) 2026-04-21 07:21:19 +00:00
molecule-ai[bot]
983ee4c57d
docs: add workspace-auth-tokens stub page for Phase 30.1 2026-04-21 07:12:37 +00:00
molecule-ai[bot]
6b3394b623
docs: add security changelog for CWE-22, CWE-78, CWE-918 fixes 2026-04-21 07:12:26 +00:00
molecule-ai[bot]
a9b46dd359
docs: fix broken /docs/guides/mcp-server-setup link to external-agent-registration 2026-04-21 07:12:12 +00:00
molecule-ai[bot]
3421801e62
docs: replace broken links /docs/mcp-server and /docs/architecture in quickstart 2026-04-21 07:12:01 +00:00
molecule-ai[bot]
ab4f02ea58
docs(blog): bootstrap-failed endpoint for platform monitoring (PR #1168)
Platform/ops angle. ~150 words. Social thread HELD — CP + Canvas parts
still pending (PR #1168 is Part 1 of 3). No user-facing UX in this release.
2026-04-21 03:49:13 +00:00
molecule-ai[bot]
30681f1856
test: no-op update 2026-04-21 03:42:55 +00:00
molecule-ai[bot]
dffcda2e46
devrel: add failed workspace EC2 console output demo script (#68)
docs/marketing/devrel/demos/failed-workspace-ec2-console-demo.md —
4-step demo for PR #1178. Shows error panel in Canvas + EC2 console
output. Includes optional AWS Console comparison. Screencast notes.
Attach to internal#7.

Co-authored-by: molecule-ai[bot] <276602405+molecule-ai[bot]@users.noreply.github.com>
2026-04-21 03:40:33 +00:00
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]
da6301c750
docs(marketing): MemoryInspectorPanel demo (molecule-core#1127) (#65)
Adds working demo for canvas Memory Inspector scope tabs,
namespace filter, and per-entry delete.

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:01:08 +00:00
molecule-ai[bot]
f9826bbade
docs(marketing): snapshot secret scrubber working demo (PR #977) (#63)
Adds working demo for snapshot_scrub.py — strip secrets from
workspace memory snapshots before hibernation serialization.

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:01:07 +00:00
molecule-ai[bot]
d0a0195029
merge: PR #60
Issue: #1176

Source: PR #1105

Co-authored-by: molecule-ai[bot] <276602405+molecule-ai[bot]@users.noreply.github.com>
2026-04-21 03:00:19 +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]
a47f29f49d
docs(blog): add Chrome DevTools MCP browser automation post (#49)
Squash-merge: Chrome DevTools MCP browser automation post (#1120). SEO-approved. Acceptance: published on docs.
2026-04-21 00:23:27 +00:00
molecule-ai[bot]
f746e2dad1
docs(blog): add Org-Scoped API Keys enterprise key management post (#51)
Squash-merge: org-scoped API keys enterprise key management blog post. Acceptance: published on docs.
2026-04-21 00:23:24 +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[bot]
016e301dc3
Merge pull request #48 from Molecule-AI/fix/merge-pr-39-main
merge: PR #39 workspace hibernation docs
2026-04-20 22:07:57 +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[bot]
29865bf8dc
Merge pull request #46 from Molecule-AI/fix/bare-url-in-safe-mcp-advisory
fix(docs): MDX bare URL parse error in safe-mcp-advisory.mdx
2026-04-20 21:56:23 +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
molecule-ai[bot]
2cdf0ab764
Merge pull request #29 from Molecule-AI/docs/repo-rename-molecule-core
docs(site): update molecule-monorepo → molecule-core across all docs
2026-04-20 08:48:58 -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