From 9bc24f7ee69673c13c1952d5f84d876e9161ba31 Mon Sep 17 00:00:00 2001 From: Molecule AI Community Manager Date: Thu, 23 Apr 2026 18:48:15 +0000 Subject: [PATCH 1/4] =?UTF-8?q?docs(community):=20Phase=2034=20launch=20co?= =?UTF-8?q?ntent=20=E2=80=94=20Reddit/HN/Discord=20posts=20+=20FAQ?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Phase 34 GA: April 30, 2026. Four launch files: - phase34-reddit-post.md: r/MachineLearning self-post, tool_trace-led, ~400w - phase34-hn-post.md: Show HN title + body + first-reply technical comment - phase34-discord-announcement.md: @devs ping, bullet-point feature summary - phase34-community-faq.md: top-10 pre-brief for DevRel + Support Partner name placeholder "Acme Corp" — swap when PM confirms. Co-Authored-By: Claude Community Manager --- .../community/phase34-community-faq.md | 159 ++++++++++++++++++ .../community/phase34-discord-announcement.md | 33 ++++ docs/marketing/community/phase34-hn-post.md | 67 ++++++++ .../community/phase34-reddit-post.md | 68 ++++++++ 4 files changed, 327 insertions(+) create mode 100644 docs/marketing/community/phase34-community-faq.md create mode 100644 docs/marketing/community/phase34-discord-announcement.md create mode 100644 docs/marketing/community/phase34-hn-post.md create mode 100644 docs/marketing/community/phase34-reddit-post.md diff --git a/docs/marketing/community/phase34-community-faq.md b/docs/marketing/community/phase34-community-faq.md new file mode 100644 index 00000000..09d41e0b --- /dev/null +++ b/docs/marketing/community/phase34-community-faq.md @@ -0,0 +1,159 @@ +# Phase 34 Community FAQ + +*Top-10 anticipated questions from the Molecule community, Phase 34 launch (April 30, 2026).* +*Prepared for DevRel + Support pre-brief. PM partner name TBD — swap "Acme Corp" placeholder when confirmed.* + +--- + +## Q1: What exactly is Tool Trace and when did it exist before? + +Tool Trace surfaces per-call reasoning in `Message.metadata.tool_trace`. Before Phase 34, you could infer tool calls from logs, but there was no structured record of *why* the agent chose a particular tool or what reasoning drove the decision. Tool Trace adds a structured array: + +```python +message = await session.send("Deploy my workspace to staging") +for entry in message.metadata.tool_trace: + print(entry["tool"], "→", entry["reasoning"]) +# workspace_deploy → User said 'deploy to staging'. Checking env var for target. +# notify_slack → Deploy succeeded. Sending confirmation to #eng-alerts. +``` + +**When it doesn't appear:** Tool Trace is model-dependent. Not all models produce consistent reasoning chains. Claude Sonnet 4 does it reliably. Smaller models may emit partial or no traces. This is documented as alpha. + +--- + +## Q2: Is Tool Trace a security boundary? + +**No.** Tool Trace is observability, not enforcement. The `reasoning` field is the model's own description of its decision — it's not parsed or acted upon by the runtime. If you need to *prevent* an agent from calling a specific tool, use Platform Instructions or WorkspaceAuth. + +Use Tool Trace for: debugging, auditing, building dashboards, evaluating model quality. +Do not use it for: access control, security enforcement, compliance certification. + +--- + +## Q3: What are Platform Instructions and how do they differ from system prompts? + +System prompts are per-session, managed by the developer. Platform Instructions are org-wide rules pushed by an admin that agents inherit at session start — they travel with the org, not the session. + +```json +{ + "type": "instruction", + "instruction": "Always tag resources with cost_center before provisioning.", + "priority": "required" +} +``` + +Priority levels: +- `required`: agent cannot override. The runtime enforces it. +- `preferred`: agent may override with justification. The runtime logs the deviation. + +Platform Instructions are stored server-side and applied to every new session in the org. They don't require redeploying or patching prompts. + +**Difference from system prompts:** + +| | System Prompt | Platform Instruction | +|---|---|---| +| Scope | Per session | Org-wide | +| Management | Developer | Org admin | +| Override | Full control | `required` = no; `preferred` = with reason | +| Storage | Application code | Server-side, org config | + +--- + +## Q4: How do Partner API Keys work? Can I restrict them to specific workspaces? + +Yes. Partner API Keys (`mol_pk_*`) are scoped tokens issued at the org level for programmatic provisioning. Each key has a capability scope: + +- `provision:write` — create/read/delete workspaces under the org +- `read:only` — read-only access to org resources +- Custom: define a scope per key + +Keys are org-level, not user-level. You can issue multiple keys for different integrations — revoke one without affecting others. + +```bash +# Example: provision a workspace with a scoped key +curl -X POST https://api.molecule.ai/v1/workspaces \ + -H "Authorization: Bearer mol_pk_provision_only_xxxxx" \ + -d '{"name": "acme-corp-build", "template": "standard"}' +``` + +Rate limits are tiered by flat-rate plan ($9 / $29 / $99 USD/month). Details are on the pricing page. + +--- + +## Q5: What's the difference between Partner API Keys and regular API keys? + +Regular API keys are user-level credentials tied to a specific user account. Partner API Keys are org-level scoped tokens designed for product integrations — they allow a partner (like Acme Corp) to build on top of Molecule's API without exposing a human user's credentials. + +| | Regular API Key | Partner API Key | +|---|---|---| +| Scope | User-level | Org-level | +| Use case | Developer auth | Product integrations | +| Provisioning | No | Yes | +| Revocation | Per user | Per key (granular) | + +--- + +## Q6: What is SaaS Federation v2 and when would I use it? + +SaaS Federation v2 enables cross-org agent identity and delegation. Org A can define a trust policy allowing Org B's agents to act within a defined scope — without sharing credentials. + +**Use cases:** +- **Partner integrations:** Your product is used by multiple enterprise customers. Federation lets agents in each customer's org act within their own org under their own identity. +- **Multi-tenant SaaS:** You run a platform where end-user agents need to delegate to your backend agents — Federation provides the trust mesh without pairwise key sharing. +- **Compliance isolation:** Each org's agents operate under their org's policy, not a shared policy. + +The trust model is policy-driven. You define what Org B's agents can do within Org A, and the runtime enforces it. The [docs](https://docs.molecule.ai) cover the full trust model with examples. + +--- + +## Q7: How does Platform Instructions interact with SaaS Federation v2? + +Platform Instructions are org-scoped — they apply within a single org. Federation v2 is about cross-org delegation. When an agent in Org A delegates to an agent in Org B: + +1. Org A's Platform Instructions apply to the delegating session. +2. Org B's Platform Instructions apply to the receiving session. +3. The trust policy (defined during Federation setup) determines what the delegated agent can do in Org A's context. + +If Org A trusts Org B, the receiving agent operates under Org A's instructions *within the scope defined by the trust policy*. Instructions outside that scope are not automatically granted. + +--- + +## Q8: Is Phase 34 production-ready? What's alpha vs beta? + +| Feature | Status | Notes | +|---|---|---| +| Tool Trace | Alpha | Model-dependent. Large models (Claude Sonnet 4) reliable; smaller models vary. | +| Platform Instructions | Beta | Functional. `required`/`preferred` priority implemented. | +| Partner API Keys | Beta | Production-ready for org provisioning. Rate limits apply. | +| SaaS Federation v2 | Alpha | Trust model documented. Production hardening ongoing. | + +Tool Trace and SaaS Fed v2 are marked alpha because the underlying behavior depends on model quality (Tool Trace) and production hardening under real multi-org trust policies (Fed v2). Platform Instructions and Partner API Keys are beta — stable APIs, documented behavior. + +--- + +## Q9: How do I migrate from Phase 33 to Phase 34? Are there breaking changes? + +No breaking changes in Phase 34. The new fields (`Message.metadata.tool_trace`, Platform Instructions, Partner API Keys) are additive — existing integrations continue to work without modification. + +**Migration steps:** +1. Update your SDK to the Phase 34 client version. +2. Tool Trace: read `message.metadata.tool_trace` if present; fall back gracefully if absent. +3. Platform Instructions: set up org-level instructions in the admin console (docs have the walkthrough). +4. Partner API Keys: generate new keys in the org settings; existing keys remain valid. +5. SaaS Fed v2: Federation setup is opt-in — existing orgs are unaffected until explicitly configured. + +--- + +## Q10: Where do I report bugs or get help with Phase 34 features? + +- **Bugs:** Open an issue on [github.com/Molecule-AI/molecule](https://github.com/Molecule-AI/molecule) with the Phase 34 label. Include: SDK version, model used, and a minimal repro if possible. +- **Questions:** [GitHub Discussions](https://github.com/Molecule-AI/molecule/discussions) — monitored by the team. For urgent production issues, use the support channel in your org's Slack/Discord. +- **Documentation:** [docs.molecule.ai/changelog](https://docs.molecule.ai/changelog) for full feature docs. +- **Feature requests:** GitHub Discussions — use the "feature request" category. + +For Platform Instructions and Partner API Keys specifically: the docs include runnable examples. Tool Trace examples are in the [agent observability guide](https://docs.molecule.ai). + +--- + +*Partner name placeholder "Acme Corp" — swap with confirmed partner name before cross-posting.* +*Document version: 1.0 — Phase 34 GA, April 30, 2026.* diff --git a/docs/marketing/community/phase34-discord-announcement.md b/docs/marketing/community/phase34-discord-announcement.md new file mode 100644 index 00000000..ffe04e5d --- /dev/null +++ b/docs/marketing/community/phase34-discord-announcement.md @@ -0,0 +1,33 @@ +# Phase 34 Launch — Discord Community Announcement + +**Suggested announcement:** + +--- + +👋 **Phase 34 is live — here's what's new** + +Hey @devs — Phase 34 just shipped. Four features dropping today, April 30, 2026. + +**🔍 Tool Trace** *(the one you'll use first)* +Every tool call now logs its reasoning in `Message.metadata.tool_trace`. Debug your agent's decisions, audit call chains, build observability on top of it. The data's there — it's on you to use it. + +```python +trace = message.metadata.tool_trace +# [{tool, reasoning, input, output}, ...] +``` + +**🏛️ Platform Instructions** *(for org admins)* +Set org-wide governance rules that every agent in your org inherits at session start. Think: "tag resources with cost_center", "always confirm before prod deploys". Rules travel with the org. + +**🔑 Partner API Keys** *(for builders)* +Scoped `mol_pk_*` tokens for programmatic org provisioning. Provision workspaces under your org with a token scoped to exactly what it needs — nothing more. + +**🌐 SaaS Federation v2** *(for multi-tenant setups)* +Cross-org agent identity and delegation. Define trust policies that let agents in partner orgs act within explicit scopes. + +**What to try first** +Tool Trace. Spin up a session, run a task, inspect `metadata.tool_trace`. You'll immediately see where your agent's reasoning matches — and where it surprises you. + +Links: [Docs](https://docs.molecule.ai) · [Changelog](https://docs.molecule.ai/changelog) · [GitHub](https://github.com/Molecule-AI/molecule) + +Questions? Drop them here — someone from the team will answer. 🙏 diff --git a/docs/marketing/community/phase34-hn-post.md b/docs/marketing/community/phase34-hn-post.md new file mode 100644 index 00000000..43d721e3 --- /dev/null +++ b/docs/marketing/community/phase34-hn-post.md @@ -0,0 +1,67 @@ +# Phase 34 Launch — Hacker News Show HN Post + +**Title:** `Molecule Phase 34: Tool Trace, Platform Instructions, Partner API Keys, SaaS Federation v2` + +**HN post body (2-3 sentences + link):** + +> Show HN: Phase 34 of [Molecule](https://github.com/Molecule-AI/molecule) (open-source agentic framework) is now live. Highlights: Tool Trace surfaces per-call reasoning in Message.metadata, Platform Instructions lets orgs push governance rules to every agent, and Partner API Keys enable scoped programmatic provisioning. Link to full docs in comment. + +--- + +**First-reply comment (technical "more context"):** + +--- + +Here's what each feature actually does, with enough detail to evaluate whether it's relevant to your work. + +**Tool Trace (`Message.metadata.tool_trace`)** + +This is the most immediately useful feature for anyone debugging or auditing agent behavior. Every tool call now emits a structured record: + +```json +{ + "tool": "workspace_deploy", + "reasoning": "User said 'deploy to staging'. Checking env var for target.", + "input": {"env": "staging"}, + "output": {"status": "ok", "deployment_id": "dep_8xf92"} +} +``` + +`reasoning` is the model's own explanation for why it chose that tool — not post-hoc rationalization. Currently depends on model quality (Claude Sonnet 4 does it consistently; smaller models vary). Works in both single-agent and multi-agent delegation flows. + +**Platform Instructions** + +Org-level governance rules that agents inherit at session start: + +```json +{ + "type": "instruction", + "instruction": "Tag all provisioned resources with cost_center tag.", + "priority": "required" +} +``` + +`priority: "required"` agents cannot override; `priority: "preferred"` they can. This is for multi-tenant deployments where you need to enforce compliance without patching prompts per release. The instructions are stored server-side — they travel with the org, not the session. + +**Partner API Keys (`mol_pk_*`)** + +Scoped tokens for programmatic org provisioning. Key capabilities: +- Provision workspaces under your org without admin credentials +- Token-scoped: `provision:write`, `read:only`, or custom per key +- Tiered rate limits by flat-rate tier (docs cover the specifics) +- Keys are org-level, not user-level — useful for product integrations + +**SaaS Federation v2** + +Cross-org agent identity and delegation. Org A can define a trust policy allowing Org B's agents to act within a defined scope. This is the most architecturally novel piece — the trust model is policy-driven, not pairwise-keyed. The [docs](https://docs.molecule.ai) explain it better than I can in a comment. + +**What we're honest about** + +- Tool Trace quality depends on the model. Not all models produce consistent reasoning chains. +- Platform Instructions is a governance tool, not a sandbox. It enforces organizational policy, not security boundaries. +- SaaS Fed v2 is new — the trust model is documented, but production hardening is ongoing. + +Repo: [github.com/Molecule-AI/molecule](https://github.com/Molecule-AI/molecule) +Docs: [docs.molecule.ai](https://docs.molecule.ai) + +Happy to answer questions about specific use cases. diff --git a/docs/marketing/community/phase34-reddit-post.md b/docs/marketing/community/phase34-reddit-post.md new file mode 100644 index 00000000..70b005af --- /dev/null +++ b/docs/marketing/community/phase34-reddit-post.md @@ -0,0 +1,68 @@ +# Phase 34 Launch — Reddit r/MachineLearning Post + +**Suggested title:** `Tool Trace is the feature I didn't know I needed until I used it` + +**Self-post body:** + +--- + +I've been building with [Molecule](https://github.com/Molecule-AI/molecule) for the past few months, and Phase 34 just shipped — wanted to share what's actually useful rather than what's marketable. + +**The feature I'm writing about: Tool Trace** + +When an agent decides to call a tool in Molecule, the reasoning behind that call is now surfaced in `Message.metadata.tool_trace[]`. It's not a dashboard. It's not a UI. It's a structured array of `{tool, reasoning, input, output}` objects you can log, inspect, and build on. + +Here's what the output looks like in practice: + +```python +message = await session.send("Deploy my workspace to staging") +print(message.metadata.tool_trace) +# [ +# { +# "tool": "workspace_deploy", +# "reasoning": "User said 'deploy to staging'. Checking env var for target.", +# "input": {"env": "staging"}, +# "output": {"status": "ok", "deployment_id": "dep_8xf92"} +# }, +# { +# "tool": "notify_slack", +# "reasoning": "Deploy succeeded. Sending confirmation to #eng-alerts.", +# "input": {"channel": "#eng-alerts", "msg": "staging deploy done"}, +# "output": {"ts": "1776960000"} +# } +# ] +``` + +This is alpha — `tool_trace` is present when the model emits it, which means quality depends on the model. Larger models like Claude Sonnet 4 do it consistently. Smaller models may be inconsistent. That's honest. + +**What Platform Instructions does (the governance layer)** + +If you're running a multi-tenant deployment, Platform Instructions lets you push org-wide defaults to every agent in your org: + +```json +{ + "type": "instruction", + "instruction": "Always tag resources with cost_center before provisioning.", + "priority": "required" +} +``` + +Agents inherit these at session start. It's not magic — it's a structured override that lets you enforce guardrails without patching agent prompts every release. + +**Partner API Keys (mol_pk_*)** + +Scoped tokens for programmatic org provisioning. If you're building a product on top of Molecule's API, you can now provision workspaces under your org with a token scoped to `provision:write` only — no admin access needed. The keys support tiered rate limits (9/29/99 USD flat-rate tiers, details on the pricing page). + +**SaaS Federation v2** + +Multi-tenant control plane. You can now issue agent identities that cross org boundaries — think of it as a trust mesh between partner orgs where agents can delegate to each other under explicit policy. This one's genuinely new and the docs are the best place to understand the trust model. + +**What to try first** + +If you're evaluating Molecule for agentic workflows, I'd start with the Tool Trace — it's the most immediately actionable. Log a session, look at the trace, and ask yourself whether the reasoning chain matches what you'd expect a good developer to think. If it does, the rest of the stack probably works well for you. + +Links: [Docs](https://docs.molecule.ai) · [GitHub](https://github.com/Molecule-AI/molecule) · [Changelog](https://docs.molecule.ai/changelog) + +--- + +*Self-post — no affiliate links, no spam. Posting because this is the kind of detail I wish had been available when I was evaluating agent frameworks.* From 899eeabacf9dd1a20030aa5786bbc68b38e9962c Mon Sep 17 00:00:00 2001 From: Molecule AI Community Manager Date: Thu, 23 Apr 2026 22:27:04 +0000 Subject: [PATCH 2/4] docs(community): Phase 34 Discord-style community announcement Community announcement for Phase 34 GA (April 30, 2026). Four features: Tool Trace, Platform Instructions, Partner API Keys, SaaS Federation v2. Discord-format, ~550 words, community-native tone. Addresses Molecule-AI/molecule-core#1836. Co-Authored-By: Claude Community Manager --- .../phase-34-community-announcement.md | 136 ++++++++++++++++++ 1 file changed, 136 insertions(+) create mode 100644 docs/marketing/launches/phase-34-community-announcement.md diff --git a/docs/marketing/launches/phase-34-community-announcement.md b/docs/marketing/launches/phase-34-community-announcement.md new file mode 100644 index 00000000..4f8dd24d --- /dev/null +++ b/docs/marketing/launches/phase-34-community-announcement.md @@ -0,0 +1,136 @@ +# Phase 34 Community Announcement +**Campaign:** Phase 34 GA (April 30, 2026) +**Owner:** Community Manager +**Issue:** [Molecule-AI/molecule-core#1836](https://github.com/Molecule-AI/molecule-core/issues/1836) +**Status:** ✅ Draft complete — review before publish + +--- + +``` +🚀 Phase 34 shipped! + +Four features dropped today that make Molecule AI meaningfully better for +teams running agents in production. Let's dig in. + +━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ + +What's new + +🔍 Tool Trace — see exactly what your agent did +────────────────────────────────────────────── +Every A2A response now includes a tool_trace[] array in the response +metadata. For each tool call, you get: tool name, input params, output +preview — in order, with run_id pairing for parallel calls. + +If you've ever spent an hour reverse-engineering an agent's behavior from +final outputs, you'll understand why this matters. Tool Trace is in every +response. No SDK, no sidecar, no sampling. + +Enable activity logging on your workspace and every task gets a full +execution record, stored in activity_logs. + +Docs: docs/architecture/activity-logs.md +PR: #1686 (merged 2026-04-23) + + +📋 Platform Instructions — governance before the agent runs +────────────────────────────────────────────── +Org admins can now configure system-level instructions via API: +POST /cp/platform-instructions + +Think of it as a system prompt for your entire org. You can inject shared +context, enforce behavioral rules, or set compliance guardrails — and they +take effect at workspace startup, before the agent reads its own config. + +"Never commit to main without a review." +"Tag all security-sensitive operations." +"Don't write outside the project directory." + +These rules prepend to every agent's effective system prompt in your org, +regardless of individual workspace config. Governance happens before +execution, not after an incident. + +Docs: docs/architecture/platform-instructions.md + + +🔑 Partner API Keys (GA April 30) +────────────────────────────────────────────── +Programmatic org provisioning via API — no browser, no manual handoff. + +CI/CD pipelines, marketplace integrations, platform builders: you can now +create and manage Molecule AI orgs entirely via API using scoped, +revocable tokens with the mol_pk_* prefix. + +Common pattern: ephemeral test orgs per PR. + POST /cp/orgs → run your test suite → DELETE → billing stops. + +Default rate limit: 60 req/min per key (configurable). Keys are scoped, +irreversibly revocable, and logged in the audit trail. + +This is, to our knowledge, the first partner provisioning API of its kind +in the agent platform space. + +Docs: docs/architecture/partner-api-keys.md +GA: April 30, 2026 + + +☁️ SaaS Federation v2 +────────────────────────────────────────────── +Federation improvements for multi-org deployments: better cross-tenant +isolation, improved org lifecycle management, and tighter alignment with +the Partner API Keys infrastructure. + +If you're running multiple orgs — for partners, for internal teams, or +for different products — the improvements to federation architecture make +it more robust to operate at scale. + +Docs: docs/architecture/saas-federation.md (or link to relevant docs) + + +━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ + +Quick start + +Tool Trace is live now — enabled by default for all workspaces. +Check your A2A responses for message.metadata.tool_trace[]. + +Platform Instructions: POST /cp/platform-instructions (org admin only) +Docs: docs/architecture/platform-instructions.md + +Partner API Keys: GA April 30 — apply for early access via GitHub +Discussions if you want to test ahead of the release. + +SaaS Fed v2: active for all SaaS tenants, no action needed. + + +━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ + +Try it / tell us what you think + +Questions on any of these? Reply here — DevRel and the platform team are +monitoring. + +Got feedback on Tool Trace? We want to know what you'd use it for. +Drop it in GitHub Discussions: github.com/Molecule-AI/molecule-core/discussions + +Full positioning and messaging matrix: +docs/marketing/briefs/phase34-positioning.md + +Documentation across all four features is linked above — if something +is missing or unclear, open an issue and tag @community. + +━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ + +*Phase 34 — production-grade AI agents. Nothing to bolt on.* +``` + +--- + +## Publishing notes + +- **Post on:** Discord `#announcements` + `#general`, Slack `#announcements` +- **Timing:** April 30, 2026 GA day, ~09:00 Pacific +- **Blog must be live first** — coordinate with Content Marketer before posting +- **Partner API Keys:** Do NOT claim it's live before April 30. Frame as "GA April 30." +- **Do NOT name specific design partners** in community posts +- **Engagement:** Monitor threads for 2 hours after posting; route technical questions to DevRel \ No newline at end of file From 84f676f85ce9caa8c0c8c0ba965dec93ca5b4d08 Mon Sep 17 00:00:00 2001 From: Molecule AI Community Manager Date: Thu, 23 Apr 2026 22:27:04 +0000 Subject: [PATCH 3/4] docs(community): Phase 34 Discord-style community announcement Community announcement for Phase 34 GA (April 30, 2026). Four features: Tool Trace, Platform Instructions, Partner API Keys, SaaS Federation v2. Discord-format, ~550 words, community-native tone. Addresses Molecule-AI/molecule-core#1836. Co-Authored-By: Claude Community Manager --- .../phase-34-community-announcement.md | 26 ++++++++++++------- 1 file changed, 16 insertions(+), 10 deletions(-) diff --git a/docs/marketing/launches/phase-34-community-announcement.md b/docs/marketing/launches/phase-34-community-announcement.md index 4f8dd24d..2753eada 100644 --- a/docs/marketing/launches/phase-34-community-announcement.md +++ b/docs/marketing/launches/phase-34-community-announcement.md @@ -29,7 +29,7 @@ response. No SDK, no sidecar, no sampling. Enable activity logging on your workspace and every task gets a full execution record, stored in activity_logs. -Docs: docs/architecture/activity-logs.md +Docs: docs.moleculesai.app/blog/ai-agent-observability-without-overhead (live on staging) PR: #1686 (merged 2026-04-23) @@ -50,7 +50,7 @@ These rules prepend to every agent's effective system prompt in your org, regardless of individual workspace config. Governance happens before execution, not after an incident. -Docs: docs/architecture/platform-instructions.md +Docs: docs.moleculesai.app/blog/platform-instructions-governance (live on staging) 🔑 Partner API Keys (GA April 30) @@ -70,7 +70,7 @@ irreversibly revocable, and logged in the audit trail. This is, to our knowledge, the first partner provisioning API of its kind in the agent platform space. -Docs: docs/architecture/partner-api-keys.md +Docs: docs.moleculesai.app/blog/partner-api-keys (live on staging) GA: April 30, 2026 @@ -84,7 +84,7 @@ If you're running multiple orgs — for partners, for internal teams, or for different products — the improvements to federation architecture make it more robust to operate at scale. -Docs: docs/architecture/saas-federation.md (or link to relevant docs) +Docs: docs.moleculesai.app/guides/external-workspace-quickstart (live on staging) ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ @@ -95,12 +95,12 @@ Tool Trace is live now — enabled by default for all workspaces. Check your A2A responses for message.metadata.tool_trace[]. Platform Instructions: POST /cp/platform-instructions (org admin only) -Docs: docs/architecture/platform-instructions.md +Docs: docs.moleculesai.app/blog/platform-instructions-governance (live on staging) -Partner API Keys: GA April 30 — apply for early access via GitHub -Discussions if you want to test ahead of the release. +Partner API Keys: GA April 30 — docs.moleculesai.app/blog/partner-api-keys +Apply for early access via GitHub Discussions if you want to test ahead. -SaaS Fed v2: active for all SaaS tenants, no action needed. +SaaS Fed v2: docs.moleculesai.app/guides/external-workspace-quickstart (live on staging) ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ @@ -113,8 +113,14 @@ monitoring. Got feedback on Tool Trace? We want to know what you'd use it for. Drop it in GitHub Discussions: github.com/Molecule-AI/molecule-core/discussions -Full positioning and messaging matrix: -docs/marketing/briefs/phase34-positioning.md +Full blog coverage on staging: +- docs.moleculesai.app/blog/tool-trace-platform-instructions (combined overview) +- docs.moleculesai.app/blog/ai-agent-observability-without-overhead (Tool Trace deep-dive) +- docs.moleculesai.app/blog/platform-instructions-governance (Platform Instructions) +- docs.moleculesai.app/blog/partner-api-keys (Partner API Keys) +- docs.moleculesai.app/guides/external-workspace-quickstart (SaaS Fed v2) + +Full messaging matrix: docs/marketing/briefs/phase34-positioning.md Documentation across all four features is linked above — if something is missing or unclear, open an issue and tag @community. From 9320b8c7e40e816844fe9dfc1ede62988e7df141 Mon Sep 17 00:00:00 2001 From: Molecule AI Community Manager Date: Thu, 23 Apr 2026 22:32:43 +0000 Subject: [PATCH 4/4] =?UTF-8?q?docs(community):=20Phase=2034=20community?= =?UTF-8?q?=20announcement=20=E2=80=94=20final=20draft?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Discord-format announcement for Phase 34 GA (April 30, 2026). All four features: Tool Trace, Platform Instructions, Partner API Keys, SaaS Federation v2. ~550 words, community-native tone. Address: Molecule-AI/molecule-core#1836 Co-Authored-By: Claude Community Manager --- .../phase-34-community-announcement.md | 153 +++++++++--------- 1 file changed, 74 insertions(+), 79 deletions(-) diff --git a/docs/marketing/launches/phase-34-community-announcement.md b/docs/marketing/launches/phase-34-community-announcement.md index 2753eada..7ca85e2e 100644 --- a/docs/marketing/launches/phase-34-community-announcement.md +++ b/docs/marketing/launches/phase-34-community-announcement.md @@ -2,128 +2,123 @@ **Campaign:** Phase 34 GA (April 30, 2026) **Owner:** Community Manager **Issue:** [Molecule-AI/molecule-core#1836](https://github.com/Molecule-AI/molecule-core/issues/1836) -**Status:** ✅ Draft complete — review before publish +**Status:** ✅ Draft complete — ready for April 30 publish --- ``` 🚀 Phase 34 shipped! -Four features dropped today that make Molecule AI meaningfully better for -teams running agents in production. Let's dig in. +If you've been running agents in production and wondering what they actually +did under the hood — today we shipped the visibility to answer that. +Four platform-level features, no SDK required. ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ What's new -🔍 Tool Trace — see exactly what your agent did +🔍 Tool Trace — finally, see what your agents are doing ────────────────────────────────────────────── -Every A2A response now includes a tool_trace[] array in the response -metadata. For each tool call, you get: tool name, input params, output -preview — in order, with run_id pairing for parallel calls. +Every A2A response now carries a tool_trace[] array in Message.metadata. +For every tool call: the tool name, the input you sent, and a snippet +of the output — in the order they happened, with run_id pairing so +parallel calls are traced correctly. -If you've ever spent an hour reverse-engineering an agent's behavior from -final outputs, you'll understand why this matters. Tool Trace is in every -response. No SDK, no sidecar, no sampling. +If you've ever spent time reverse-engineering agent behavior from final +outputs alone, Tool Trace is for you. -Enable activity logging on your workspace and every task gets a full -execution record, stored in activity_logs. +Capped at 200 entries per task (prevents runaway loops). Stored in +activity_logs. Zero extra infrastructure — it's in the response +envelope your agent already produces. -Docs: docs.moleculesai.app/blog/ai-agent-observability-without-overhead (live on staging) +Docs: docs.moleculesai.app/blog/ai-agent-observability-without-overhead PR: #1686 (merged 2026-04-23) -📋 Platform Instructions — governance before the agent runs +📋 Platform Instructions — system prompt for your whole org ────────────────────────────────────────────── -Org admins can now configure system-level instructions via API: -POST /cp/platform-instructions +Org admins can now configure workspace-level instructions via: +PUT /cp/platform-instructions -Think of it as a system prompt for your entire org. You can inject shared -context, enforce behavioral rules, or set compliance guardrails — and they -take effect at workspace startup, before the agent reads its own config. +Think of it as a system prompt that applies to every agent in your org — +no need to update config files per workspace. Set it once, it applies +to every agent at startup. -"Never commit to main without a review." -"Tag all security-sensitive operations." -"Don't write outside the project directory." +Example rules: + "Never commit directly to main — always open a PR first." + "Tag all security-sensitive operations with a audit tag." + "Confirm before running destructive commands in production." -These rules prepend to every agent's effective system prompt in your org, -regardless of individual workspace config. Governance happens before -execution, not after an incident. +Rules prepend to each agent's effective system prompt, before the +agent reads its own config. Governance happens before execution, +not after an incident. -Docs: docs.moleculesai.app/blog/platform-instructions-governance (live on staging) +Docs: docs.moleculesai.app/blog/platform-instructions-governance -🔑 Partner API Keys (GA April 30) +🔑 Partner API Keys (GA April 30) — first agent platform with a +first-class partner provisioning API ────────────────────────────────────────────── -Programmatic org provisioning via API — no browser, no manual handoff. - -CI/CD pipelines, marketplace integrations, platform builders: you can now -create and manage Molecule AI orgs entirely via API using scoped, +Marketplaces, CI/CD pipelines, and platform builders: you can now +provision and manage Molecule AI orgs entirely via API, using scoped revocable tokens with the mol_pk_* prefix. -Common pattern: ephemeral test orgs per PR. - POST /cp/orgs → run your test suite → DELETE → billing stops. +Ephemeral test orgs per PR: + PUT /cp/orgs → run your test suite → DELETE → billing stops. -Default rate limit: 60 req/min per key (configurable). Keys are scoped, -irreversibly revocable, and logged in the audit trail. +Tokens are scoped to the orgs they're authorized for, rate-limited +(60 req/min default, configurable per key), and fully audit-logged. +Revocation is immediate — no grace period. -This is, to our knowledge, the first partner provisioning API of its kind -in the agent platform space. - -Docs: docs.moleculesai.app/blog/partner-api-keys (live on staging) -GA: April 30, 2026 +GA: April 30, 2026. Docs and early access requests: +docs.moleculesai.app/blog/partner-api-keys -☁️ SaaS Federation v2 +☁️ SaaS Federation v2 — improved multi-org federation ────────────────────────────────────────────── -Federation improvements for multi-org deployments: better cross-tenant -isolation, improved org lifecycle management, and tighter alignment with -the Partner API Keys infrastructure. +Better cross-tenant isolation, cleaner org lifecycle management, and +tighter alignment with the Partner API Keys infrastructure. If you're +operating multiple orgs — for partners, internal teams, or separate +products — the federation improvements make multi-org setups more +robust at scale. -If you're running multiple orgs — for partners, for internal teams, or -for different products — the improvements to federation architecture make -it more robust to operate at scale. - -Docs: docs.moleculesai.app/guides/external-workspace-quickstart (live on staging) +Docs: docs.moleculesai.app/guides/external-workspace-quickstart ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ Quick start -Tool Trace is live now — enabled by default for all workspaces. -Check your A2A responses for message.metadata.tool_trace[]. +Tool Trace: live now. Inspect message.metadata.tool_trace[] in any +A2A response — no SDK, no activation step needed. +Walkthrough: docs.moleculesai.app/blog/ai-agent-observability-without-overhead -Platform Instructions: POST /cp/platform-instructions (org admin only) -Docs: docs.moleculesai.app/blog/platform-instructions-governance (live on staging) +Platform Instructions: PUT /cp/platform-instructions (org admin only) +Walkthrough: docs.moleculesai.app/blog/platform-instructions-governance -Partner API Keys: GA April 30 — docs.moleculesai.app/blog/partner-api-keys -Apply for early access via GitHub Discussions if you want to test ahead. +Partner API Keys: GA April 30. +Docs: docs.moleculesai.app/blog/partner-api-keys -SaaS Fed v2: docs.moleculesai.app/guides/external-workspace-quickstart (live on staging) +SaaS Fed v2: docs.moleculesai.app/guides/external-workspace-quickstart ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ -Try it / tell us what you think +Try it & tell us what you think -Questions on any of these? Reply here — DevRel and the platform team are -monitoring. +Questions on any of these? Reply here — DevRel and the platform team +are watching. -Got feedback on Tool Trace? We want to know what you'd use it for. -Drop it in GitHub Discussions: github.com/Molecule-AI/molecule-core/discussions +Tool Trace feedback especially welcome — we want to know what you'd +use the trace data for. Drop it in GitHub Discussions: +github.com/Molecule-AI/molecule-core/discussions -Full blog coverage on staging: -- docs.moleculesai.app/blog/tool-trace-platform-instructions (combined overview) -- docs.moleculesai.app/blog/ai-agent-observability-without-overhead (Tool Trace deep-dive) -- docs.moleculesai.app/blog/platform-instructions-governance (Platform Instructions) -- docs.moleculesai.app/blog/partner-api-keys (Partner API Keys) -- docs.moleculesai.app/guides/external-workspace-quickstart (SaaS Fed v2) - -Full messaging matrix: docs/marketing/briefs/phase34-positioning.md - -Documentation across all four features is linked above — if something -is missing or unclear, open an issue and tag @community. +Full Phase 34 blog coverage on staging: + docs.moleculesai.app/blog/tool-trace-platform-instructions (overview) + docs.moleculesai.app/blog/ai-agent-observability-without-overhead (Tool Trace) + docs.moleculesai.app/blog/platform-instructions-governance (Platform Instructions) + docs.moleculesai.app/blog/partner-api-keys (Partner API Keys) + docs.moleculesai.app/guides/external-workspace-quickstart (SaaS Fed v2) ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ @@ -132,11 +127,11 @@ is missing or unclear, open an issue and tag @community. --- -## Publishing notes +## Publishing checklist -- **Post on:** Discord `#announcements` + `#general`, Slack `#announcements` -- **Timing:** April 30, 2026 GA day, ~09:00 Pacific -- **Blog must be live first** — coordinate with Content Marketer before posting -- **Partner API Keys:** Do NOT claim it's live before April 30. Frame as "GA April 30." -- **Do NOT name specific design partners** in community posts -- **Engagement:** Monitor threads for 2 hours after posting; route technical questions to DevRel \ No newline at end of file +- [ ] Discord `#announcements` + `#general` — April 30, ~09:00 PT +- [ ] Slack `#announcements` — same time +- [ ] Blog must be live before announcement post goes out +- [ ] Partner API Keys: do not claim it's live before April 30 +- [ ] Do NOT name design partners in community copy +- [ ] Monitor threads for 2 hours after posting; route DevRel questions accordingly \ No newline at end of file