docs: align Agent Memory page with current research preview capabilities

[hongyi-chen]

Summary

Aligns the Agent Memory (Research Preview) page with what customers can actually use today, per feedback from Trevor Nederlof. Some future-state features had made it into the docs from marketing materials; this removes or softens those claims so research preview customers aren't set up with wrong expectations. They can be re-added once they're actually supported / publicly documented.

A follow-up review pass verified the remaining claims on the page against the warp-server implementation (memory models, public API handlers, synthesis pipeline) and fixed three more inaccuracies.

Changes

src/content/docs/agent-platform/agent-memory/index.mdx

Original feedback items:

• Per-agent default stores: Removed "By default, each agent has its own memory store" from the Key features bullet and the Memory stores section. Stores are now described as attachable to agents and shareable, without claiming a per-agent default.
• API accessibility: Removed the "Fully accessible via API" key feature bullet and the "Oz API and SDK" related-pages link. The store/memory CRUD endpoints aren't in the published OpenAPI spec (only memory_stores attachment refs on agents/runs are).
• Traceability: Softened from "Memory retrievals are recorded so teams can inspect which memories contributed to a run's context" to memory provenance — teams can trace a memory back to its source, which matches the implementation (Memory.Source/SourceID). The Auditability bullet (memory change history) is unchanged and matches the immutable MemoryVersion model.
• Self-hosting: Removed self-hosting claims throughout — the Key features bullet, the self-hosted Oz mention in "Where Agent Memory runs", and the self-hosting related-pages link. (Code comments confirm self-hosted memories are future work.)

Review-pass fixes (verified against warp-server):

• "Named collection": Stores have a UID and optional description, not a name — dropped "named".
• "Its own store" example: Only team-owned stores can be attached to agents via the public API, so the example now says a code review agent "can use a dedicated store" instead of "its own store", and multi-store usage is scoped to teams (users have one live store).
• Instructions optionality: The API requires non-empty instructions on every attachment, so removed "Without instructions, the agent can access the store but won't know when to read from or write to it."

Additional context

• Slack feedback thread from Trevor Nederlof (June 12).
• Validation: style_lint --changed clean, internal link checker clean, npm run build passes.

Conversation: https://staging.warp.dev/conversation/9ddbc8fc-0afd-47fb-b784-71e34ae08845
Run: https://oz.staging.warp.dev/runs/019ebdd2-c6bf-7dd8-ad27-7537cfbfef4a

This PR was generated with Oz.

Co-Authored-By: Oz oz-agent@warp.dev

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
docs	Ready	Preview, Comment	Jun 12, 2026 10:06pm

[oz-for-oss]

@hongyi-chen

I'm starting a first review of this pull request.

You can view the conversation on Warp.

I completed the review and no human review was requested for this pull request.

Comment /oz-review on this pull request to retrigger a review (up to 3 times on the same pull request).

Powered by Oz

[oz-for-oss]

Overview

This PR narrows the Agent Memory research preview page to avoid unsupported claims around default per-agent stores, public API CRUD access, retrieval traceability, and self-hosting. I reviewed the attached diff against the documentation review guidance and found no commentable correctness, structure, link, or security issues.

Concerns

• No blocking concerns found. The PR removes links rather than adding new ones, and no approved spec context was available for implementation drift checks.

Verdict

Found: 0 critical, 0 important, 0 suggestions

Approve

Comment /oz-review on this pull request to retrigger a review (up to 3 times on the same pull request).

Powered by Oz