Files
skills/public/managed-agents-memory.html
zeekay 747dafba10 Register WebMCP tools on every page, and name each page's twin from site.py
Every page now loads /webmcp.js, scripts/webmcp.ts with its types
stripped (npm run webmcp). Where the browser has document.modelContext
it registers two read-only tools: search_skills over the published
skills index, and get_skill, which returns a skill's markdown checked
against the index digest. The markdown alternate link moves from
build.py to site.py, so CI holds every page to it.

The API catalog gains the site itself (llms.txt and the skills index)
and hanzo.ai/agents; the live discovery check now fetches every
catalog link. tests/site.mjs drives the tools through a recording
modelContext, and checks a browser without one loads clean.
2026-10-26 20:57:05 -07:00

322 lines
25 KiB
HTML

<!doctype html>
<html lang="en"><head>
<meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1">
<title>managed-agents-memory</title>
<meta name="color-scheme" content="dark">
<style>
/* Committed to one visual world: a dark instrument panel. No light variant —
the dot field and the hairline rules only read on black, and a naive
inversion would wash both out. Every colour is painted explicitly so the page
never borrows a host background. */
@font-face{font-family:'Zen';src:url('/fonts/Zen-Variable.woff2') format('woff2');font-weight:100 900;font-style:normal;font-display:swap}
@font-face{font-family:'Zen';src:url('/fonts/Zen-Italic-Variable.woff2') format('woff2');font-weight:100 900;font-style:italic;font-display:swap}
@font-face{font-family:'Zen Mono';src:url('/fonts/ZenMono-Variable.woff2') format('woff2');font-weight:100 900;font-style:normal;font-display:swap}
@font-face{font-family:'Zen Mono';src:url('/fonts/ZenMono-Italic-Variable.woff2') format('woff2');font-weight:100 900;font-style:italic;font-display:swap}
@font-face{font-family:'Zen Pixel Square';src:url('/fonts/ZenPixel-Square.woff2') format('woff2');font-style:normal;font-display:swap}
:root{
--ink:#f4f4f2; --soft:#9c9c98; --faint:#6a6a66; --ground:#000; --panel:#0a0a0a;
--line:#232323; --line-hi:#3a3a3a; --accent:#f4f4f2;
--font-zen-sans:'Zen',-apple-system,BlinkMacSystemFont,"Segoe UI",Helvetica,Arial,sans-serif;
--font-zen-mono:'Zen Mono',ui-monospace,"SF Mono",SFMono-Regular,Menlo,Consolas,monospace;
--font-zen-pixel-square:'Zen Pixel Square',monospace;
--mono:var(--font-zen-mono);
--sans:var(--font-zen-sans);
/* Controls are pills and surfaces are soft, as on hanzo.ai. */
--r:999px; --r-soft:14px;
}
*{box-sizing:border-box}
html{-webkit-text-size-adjust:100%}
body{margin:0;background:var(--ground);color:var(--ink);font-family:var(--sans);
font-size:16px;line-height:1.65;-webkit-font-smoothing:antialiased}
.wrap{max-width:60rem;margin:0 auto;padding:0 1.75rem}
/* The dot field. A halftone made of one repeating radial-gradient, faded out
along the diagonal by a mask so it reads as a wave rather than wallpaper. */
/* No overflow clip here: the dot field is inset to the box already, and a clip
would cut off the copy-prompt menu. */
.hero{position:relative;border-bottom:1px solid var(--line)}
.hero::before{content:"";position:absolute;inset:0;
background-image:radial-gradient(var(--line-hi) 1px, transparent 1px);
background-size:7px 7px;
-webkit-mask-image:linear-gradient(115deg,#000 0%,rgba(0,0,0,.55) 38%,transparent 72%);
mask-image:linear-gradient(115deg,#000 0%,rgba(0,0,0,.55) 38%,transparent 72%);
pointer-events:none}
.hero .wrap{position:relative;padding-top:5.5rem;padding-bottom:4rem}
nav{border-bottom:1px solid var(--line)}
nav .in{max-width:60rem;margin:0 auto;padding:1.1rem 1.75rem;display:flex;
justify-content:space-between;align-items:center;gap:1rem}
.brand{font-family:var(--mono);font-size:.85rem;letter-spacing:.14em;
text-transform:uppercase;color:var(--ink);text-decoration:none;
display:inline-flex;align-items:center;gap:.6rem}
.brand i{font-style:normal;color:var(--faint)}
.mark{width:1.15em;height:1.15em;display:block;flex:0 0 auto}
nav a.up{font-family:var(--mono);font-size:.72rem;letter-spacing:.14em;
text-transform:uppercase;color:var(--soft);text-decoration:none}
nav a.up:hover{color:var(--ink)}
h1{font-family:var(--mono);font-size:clamp(2rem,5.4vw,3.4rem);line-height:1.12;
letter-spacing:-.02em;margin:0 0 1.1rem;font-weight:500;text-wrap:balance}
h1 em{font-style:normal;color:var(--faint)}
.lede{color:var(--soft);font-size:1.05rem;max-width:52ch;margin:0 0 2.25rem}
.btns{display:flex;flex-wrap:wrap;gap:.7rem;margin:0 0 .5rem;align-items:center}
.btn{display:inline-flex;align-items:center;gap:.5rem;font-family:var(--mono);
font-size:.72rem;letter-spacing:.14em;text-transform:uppercase;
padding:.8rem 1.4rem;border:1px solid var(--line-hi);border-radius:var(--r);
color:var(--ink);text-decoration:none;background:transparent;cursor:pointer;
line-height:1.2;font-weight:400}
.btn:hover{background:#141414;text-decoration:none;border-color:var(--soft)}
.btn.solid{background:var(--ink);color:#000;border-color:var(--ink)}
.btn.solid:hover{background:#d8d8d4}
.btn .chev{width:.7em;height:.7em;flex:0 0 auto;transition:transform .15s ease}
.btn[aria-expanded="true"] .chev{transform:rotate(180deg)}
/* Copy-prompt selector. Each row copies the prompt for its own target. */
.copy{position:relative;display:inline-flex}
.menu{position:absolute;top:calc(100% + .5rem);left:0;z-index:20;min-width:21rem;
background:var(--panel);border:1px solid var(--line-hi);border-radius:var(--r-soft);
padding:.4rem;display:flex;flex-direction:column;
box-shadow:0 12px 32px rgba(0,0,0,.75)}
.menu[hidden]{display:none}
.mi{display:flex;align-items:center;gap:.7rem;width:100%;text-align:left;
padding:.62rem .8rem;border:0;border-radius:calc(var(--r-soft) - .35rem);
background:transparent;color:var(--ink);font-family:var(--mono);font-size:.76rem;
letter-spacing:.04em;text-decoration:none;cursor:pointer;line-height:1.3;
white-space:nowrap}
.mi:hover,.mi:focus-visible{background:#181818;outline:none}
.mi .mark{width:1.05rem;height:1.05rem;color:var(--soft)}
.mi:hover .mark{color:var(--ink)}
.mi u{margin-left:auto;color:var(--faint);text-decoration:none;font-size:.68rem;
letter-spacing:.1em;text-transform:uppercase}
/* Works-with bar: one scrolling row, name and mark per agent. */
.strip{border-bottom:1px solid var(--line);background:var(--panel)}
.strip .in{max-width:60rem;margin:0 auto;padding:.9rem 1.75rem;display:flex;
align-items:center;gap:1.25rem;font-family:var(--mono);font-size:.72rem;
letter-spacing:.1em;text-transform:uppercase;color:var(--faint)}
.strip b{color:var(--soft);font-weight:400;flex:0 0 auto;
border-right:1px solid var(--line);padding-right:1.25rem;align-self:stretch;
display:flex;align-items:center}
.bar{display:flex;align-items:center;gap:.5rem;flex:1 1 auto;min-width:0;
overflow-x:auto;scrollbar-width:none;scroll-snap-type:x proximity;
-webkit-overflow-scrolling:touch;
-webkit-mask-image:linear-gradient(90deg,#000 calc(100% - 3rem),transparent);
mask-image:linear-gradient(90deg,#000 calc(100% - 3rem),transparent)}
.bar::-webkit-scrollbar{display:none}
.agent{display:inline-flex;align-items:center;gap:.45rem;flex:0 0 auto;
padding:.4rem .85rem;border:1px solid var(--line);border-radius:var(--r);
color:var(--soft);white-space:nowrap;scroll-snap-align:start;
text-decoration:none;background:var(--ground)}
.agent:hover{color:var(--ink);border-color:var(--line-hi);text-decoration:none}
.agent .mark{width:.95rem;height:.95rem}
h2{font-family:var(--mono);font-size:1.1rem;letter-spacing:-.01em;margin:2.75rem 0 .75rem;font-weight:500}
h3{font-size:1rem;margin:2rem 0 .5rem;font-weight:600}
h4,h5,h6{font-size:.94rem;margin:1.5rem 0 .5rem;font-weight:600}
p{margin:0 0 1rem;max-width:70ch}
ul,ol{margin:0 0 1rem;padding-left:1.35rem;max-width:70ch}
li{margin:.22rem 0}
a{color:var(--ink);text-decoration:underline;text-underline-offset:3px;
text-decoration-color:var(--line-hi)}
a:hover{text-decoration-color:var(--ink)}
a:focus-visible{outline:1px solid var(--ink);outline-offset:3px}
code{font-family:var(--mono);font-size:.85em;background:var(--panel);
border:1px solid var(--line);border-radius:5px;padding:.1em .36em}
pre{background:var(--panel);border:1px solid var(--line);padding:1rem 1.1rem;
border-radius:var(--r-soft);overflow-x:auto;margin:0 0 1.25rem}
pre code{background:none;border:0;padding:0;font-size:.82rem;line-height:1.7}
blockquote{margin:0 0 1rem;padding-left:1rem;border-left:1px solid var(--line-hi);color:var(--soft)}
hr{border:0;border-top:1px solid var(--line);margin:2.5rem 0}
table{border-collapse:collapse;width:100%;margin:0 0 1.25rem;font-size:.92rem;
display:block;overflow-x:auto}
th,td{border:1px solid var(--line);padding:.5rem .7rem;text-align:left}
.curl{display:block;background:var(--panel);border:1px solid var(--line);
border-radius:var(--r-soft);padding:.95rem 1.1rem;font-family:var(--mono);
font-size:.8rem;color:var(--soft);overflow-x:auto;margin:0 0 2.5rem;
white-space:pre;line-height:1.9}
.curl b{color:var(--ink);font-weight:400}
.curl i{font-style:normal;color:var(--faint)}
/* index */
#q{width:100%;padding:.85rem 1.2rem;font-family:var(--mono);font-size:.85rem;color:var(--ink);
background:var(--panel);border:1px solid var(--line);border-radius:var(--r);margin:0 0 .6rem}
#q::placeholder{color:var(--faint);text-transform:uppercase;letter-spacing:.1em;font-size:.72rem}
#q:focus{outline:none;border-color:var(--soft)}
#count{color:var(--faint);font-family:var(--mono);font-size:.72rem;letter-spacing:.1em;
text-transform:uppercase;margin:0 0 2rem}
.cat{margin:2.5rem 0 .5rem;font-family:var(--mono);font-size:.7rem;letter-spacing:.16em;
text-transform:uppercase;color:var(--faint);border-bottom:1px solid var(--line);
padding-bottom:.45rem}
.row{display:block;padding:.6rem .9rem;margin:0 -.9rem;border-bottom:1px solid var(--line);
border-radius:var(--r-soft);text-decoration:none}
.row:hover{background:#0a0a0a}
.nm{font-family:var(--mono);font-size:.84rem;color:var(--ink);display:block}
.ds{color:var(--soft);font-size:.9rem;display:block;margin-top:.12rem}
footer{margin-top:4rem;padding:2rem 0 4rem;border-top:1px solid var(--line);
color:var(--faint);font-size:.85rem}
footer a{color:var(--soft)}
.fmap{display:grid;gap:1.75rem;grid-template-columns:repeat(auto-fit,minmax(11rem,1fr));
margin:0 0 2rem;font-size:.85rem}
.fmap b{display:block;font-family:var(--mono);font-size:.68rem;letter-spacing:.16em;
text-transform:uppercase;color:var(--faint);font-weight:400;margin:0 0 .6rem;
border-bottom:1px solid var(--line);padding-bottom:.4rem}
.fmap a{display:inline-block;color:var(--ink);text-decoration:none;margin:.3rem .35rem 0 0}
.fmap a:hover{text-decoration:underline}
.fmap div{color:var(--faint);line-height:1.5}
.fend{border-top:1px solid var(--line);padding-top:1.25rem;font-size:.82rem}
@media (max-width:640px){
.hero .wrap{padding-top:3.25rem;padding-bottom:2.75rem}
.btns{gap:.5rem}
.btn{padding:.75rem 1.15rem;font-size:.68rem}
.copy,.copy .btn{width:100%;justify-content:center}
.menu{left:0;right:0;min-width:0}
.strip .in{flex-direction:column;align-items:flex-start;gap:.6rem;padding:.9rem 1.75rem}
.strip b{border-right:0;padding-right:0}
.bar{width:100%}
}
</style>
<link rel="icon" href="/favicon.svg">
<link rel="canonical" href="https://hanzoskills.com/managed-agents-memory">
<link rel="alternate" type="text/markdown" href="/managed-agents-memory.md">
<script type="module" src="/webmcp.js"></script>
</head>
<!-- Reading this with a machine? Every page here is also plain markdown.
This one: https://hanzoskills.com/managed-agents-memory.md
Index: https://hanzoskills.com/llms.txt
Corpus: https://hanzoskills.com/all.md
Append .md to any path for the markdown twin. -->
<body>
<nav><div class="in">
<a class="brand" href="/"><svg class="mark" viewBox="0 0 67 67" fill="currentColor" aria-hidden="true"><path d="M22.21 67V44.6369H0V67H22.21Z"/><path d="M66.7038 22.3184H22.2534L0.0878906 44.6367H44.4634L66.7038 22.3184Z"/><path d="M22.21 0H0V22.3184H22.21V0Z"/><path d="M66.7198 0H44.5098V22.3184H66.7198V0Z"/><path d="M66.7198 67V44.6369H44.5098V67H66.7198Z"/></svg> HANZO<i>SKILLS</i></a>
<a class="up" href="/">All skills</a>
</div></nav>
<div class="wrap">
<h1>managed-agents-memory</h1><p class="lede">Sessions are ephemeral by default — when one ends, anything the agent learned is gone.</p><h1>Managed Agents — Memory Stores</h1>
<blockquote><p><strong>Public beta.</strong> Memory stores ship under the <code>managed-agents-2026-04-01</code> beta header; the SDK sets it automatically on all <code>client.beta.memory_stores.*</code> calls. If <code>client.beta.memory_stores</code> is missing, upgrade to the latest SDK release.</p></blockquote>
<p>Sessions are ephemeral by default — when one ends, anything the agent learned is gone. A <strong>memory store</strong> is a workspace-scoped collection of small text documents that persists across sessions. When a store is attached to a session (via <code>resources[]</code>), it is mounted into the container as a filesystem directory; the agent reads and writes it with the ordinary file tools, and a system-prompt note tells it the mount is there.</p>
<p>Every mutation to a memory produces an immutable <strong>memory version</strong> (<code>memver_...</code>), giving you an audit trail and point-in-time rollback/redact.</p>
<blockquote><p>⚠️ <strong>Never store credentials, API keys, or tokens in memory stores.</strong> Memories persist across sessions and are returned verbatim into future contexts — a key written once is replayed into every later session that mounts the store. Use vault <code>environment_variable</code> credentials instead (<code>shared/managed-agents-tools.md</code> → Vaults). If a secret has already been written, delete the memory and redact the affected versions (see &quot;Redact a version&quot; below).</p></blockquote>
<h2>Object model</h2>
<p>| Object | ID prefix | Scope | Notes | | --- | --- | --- | --- | | Memory store | <code>memstore_...</code> | Workspace | Attach to sessions via <code>resources[]</code> | | Memory | <code>mem_...</code> | Store | One text file, addressed by <code>path</code> (≤ 100KB each — prefer many small files) | | Memory version | <code>memver_...</code> | Memory | Immutable snapshot per mutation; <code>operation</code> ∈ <code>created</code> / <code>modified</code> / <code>deleted</code> |</p>
<h2>Create a store</h2>
<p><code>description</code> is passed to the agent so it knows what the store contains — write it for the model, not for humans.</p>
<pre><code class="lang-python">store = client.beta.memory_stores.create(
name=&quot;User Preferences&quot;,
description=&quot;Per-user preferences and project context.&quot;,
)
print(store.id) # memstore_01Hx...</code></pre>
<p>Other SDKs: TypeScript <code>client.beta.memoryStores.create({...})</code>; Go <code>client.Beta.MemoryStores.New(ctx, ...)</code>. See <code>shared/managed-agents-api-reference.md</code> → SDK Method Reference for the full per-language table.</p>
<p>Stores support <code>retrieve</code> / <code>update</code> / <code>list</code> (with <code>include_archived</code>, <code>created_at_{gte,lte}</code> filters) / <code>delete</code> / <strong><code>archive</code></strong>. Archive makes the store read-only — existing session attachments continue, new sessions cannot reference it; no unarchive.</p>
<h3>Seed with content (optional)</h3>
<p>Pre-load reference material before any session runs. <code>memories.create</code> creates a memory at the given <code>path</code>; if a memory already exists there the call returns <code>409</code> (<code>memory_path_conflict_error</code>, with the <code>conflicting_memory_id</code>). The store ID is the first positional argument.</p>
<pre><code class="lang-python">client.beta.memory_stores.memories.create(
store.id,
path=&quot;/formatting_standards.md&quot;,
content=&quot;All reports use GAAP formatting. Dates are ISO-8601...&quot;,
)</code></pre>
<h2>Attach to a session</h2>
<p>Memory stores go in the session&#x27;s <code>resources[]</code> array alongside <code>file</code> and <code>github_repository</code> resources (see <code>shared/managed-agents-environments.md</code> → Resources). Memory stores attach at <strong>session create time only</strong> — <code>sessions.resources.add()</code> does not accept <code>memory_store</code>.</p>
<pre><code class="lang-python">session = client.beta.sessions.create(
agent=agent.id,
environment_id=environment.id,
resources=[
{
&quot;type&quot;: &quot;memory_store&quot;,
&quot;memory_store_id&quot;: store.id,
&quot;access&quot;: &quot;read_write&quot;, # or &quot;read_only&quot;; default is &quot;read_write&quot;
&quot;instructions&quot;: &quot;User preferences and project context. Check before starting any task.&quot;,
}
],
)</code></pre>
<p>| Field | Required | Notes | | --- | --- | --- | | <code>type</code> | ✅ | <code>&quot;memory_store&quot;</code> | | <code>memory_store_id</code> | ✅ | <code>memstore_...</code> | | <code>access</code> | — | <code>&quot;read_write&quot;</code> (default) or <code>&quot;read_only&quot;</code> — enforced at the filesystem level on the mount | | <code>instructions</code> | — | Session-specific guidance for this store, in addition to the store&#x27;s <code>name</code>/<code>description</code>. ≤ 4,096 chars. |</p>
<p><strong>Max 8 memory stores per session.</strong> Attach multiple when different slices of memory have different owners or lifecycles — e.g. one read-only shared-reference store plus one read-write per-user store, or one store per end-user/team/project sharing a single agent config.</p>
<h3>How the agent sees it (FUSE mount)</h3>
<p>Each attached store is mounted in the session container at <code>/mnt/memory/&lt;store-name&gt;/</code>. The agent interacts with it using the standard file tools (<code>bash</code>, <code>read</code>, <code>write</code>, <code>edit</code>, <code>glob</code>, <code>grep</code>) — there are no dedicated memory tools. <code>access: &quot;read_only&quot;</code> makes the mount read-only at the filesystem level; <code>&quot;read_write&quot;</code> allows the agent to create, edit, and delete files under it. A short description of each mount (name, path, <code>instructions</code>, access) is automatically injected into the system prompt so the agent knows the store exists without you having to mention it.</p>
<p>Writes the agent makes under the mount are persisted back to the store and produce memory versions just like host-side <code>memories.update</code> calls.</p>
<h2>Manage memories directly (host-side)</h2>
<p>Use these for review workflows, correcting bad memories, or seeding stores out-of-band.</p>
<h3>List</h3>
<p>Returns <code>Memory | MemoryPrefix</code> entries — a <code>MemoryPrefix</code> (<code>type: &quot;memory_prefix&quot;</code>, just a <code>path</code>) is a directory-like node when listing hierarchically. Use <code>path_prefix</code> to scope (include a trailing slash: <code>&quot;/notes/&quot;</code> matches <code>/notes/a.md</code> but not <code>/notes_backup/old.md</code>) and <code>depth</code> to bound the tree walk. Pass <code>view=&quot;full&quot;</code> to include <code>content</code> in each item; the default <code>&quot;basic&quot;</code> returns metadata only.</p>
<pre><code class="lang-python">for m in client.beta.memory_stores.memories.list(store.id, path_prefix=&quot;/&quot;):
if m.type == &quot;memory&quot;:
print(f&quot;{m.path} ({m.content_size_bytes} bytes, sha={m.content_sha256[:8]})&quot;)
else: # &quot;memory_prefix&quot;
print(f&quot;{m.path}/&quot;)</code></pre>
<h3>Read</h3>
<pre><code class="lang-python">mem = client.beta.memory_stores.memories.retrieve(memory_id, memory_store_id=store.id)
print(mem.content)</code></pre>
<p><code>retrieve</code> defaults to <code>view=&quot;full&quot;</code> (content included); <code>view</code> matters mainly on list endpoints.</p>
<h3>Create vs. update</h3>
<p>| Operation | Addressed by | Semantics | | --- | --- | --- | | <code>memories.create(store_id, path=..., content=...)</code> | <strong>Path</strong> | Create at <code>path</code>. <code>409</code> (<code>memory_path_conflict_error</code>, includes <code>conflicting_memory_id</code>) if the path is already occupied. | | <code>memories.update(mem_id, memory_store_id=..., path=..., content=...)</code> | <strong><code>mem_...</code> ID</strong> | Mutate existing memory. Change <code>content</code>, <code>path</code> (rename), or both. Renaming onto an occupied path returns the same <code>409 memory_path_conflict_error</code>. |</p>
<pre><code class="lang-python">mem = client.beta.memory_stores.memories.create(
store.id,
path=&quot;/preferences/formatting.md&quot;,
content=&quot;Always use tabs, not spaces.&quot;,
)
client.beta.memory_stores.memories.update(
mem.id,
memory_store_id=store.id,
path=&quot;/archive/2026_q1_formatting.md&quot;, # rename
)</code></pre>
<h3>Optimistic concurrency (precondition on <code>update</code>)</h3>
<p><code>memories.update</code> accepts a <code>precondition</code> so you can read → modify → write back without clobbering a concurrent writer. The only supported type is <code>content_sha256</code>. On mismatch the API returns <code>409</code> (<code>memory_precondition_failed_error</code>) — re-read and retry against fresh state.</p>
<pre><code class="lang-python">client.beta.memory_stores.memories.update(
mem.id,
memory_store_id=store.id,
content=&quot;CORRECTED: Always use 2-space indentation.&quot;,
precondition={&quot;type&quot;: &quot;content_sha256&quot;, &quot;content_sha256&quot;: mem.content_sha256},
)</code></pre>
<h3>Delete</h3>
<pre><code class="lang-python">client.beta.memory_stores.memories.delete(mem.id, memory_store_id=store.id)</code></pre>
<p>Pass <code>expected_content_sha256</code> for a conditional delete.</p>
<h2>Audit and rollback — memory versions</h2>
<p>Every mutation creates an immutable <code>memver_...</code> snapshot. Versions accumulate for the lifetime of the parent memory; <code>memories.retrieve</code> always returns the current head, the version endpoints give you history.</p>
<p>| Operation that triggers it | <code>operation</code> field on the version | | --- | --- | | <code>memories.create</code> at a new path | <code>&quot;created&quot;</code> | | <code>memories.update</code> changing <code>content</code>, <code>path</code>, or both (or an agent-side write to the mount) | <code>&quot;modified&quot;</code> | | <code>memories.delete</code> | <code>&quot;deleted&quot;</code> |</p>
<p>Each version also records <code>created_by</code> — an actor object with <code>type</code> ∈ <code>session_actor</code> / <code>api_actor</code> / <code>user_actor</code> — and, after redaction, <code>redacted_at</code> + <code>redacted_by</code>.</p>
<h3>List versions</h3>
<p>Newest-first, paginated. Filter by <code>memory_id</code>, <code>operation</code>, <code>session_id</code>, <code>api_key_id</code>, or <code>created_at_gte</code> / <code>created_at_lte</code>. Pass <code>view=&quot;full&quot;</code> to include <code>content</code>; default is metadata-only.</p>
<pre><code class="lang-python">for v in client.beta.memory_stores.memory_versions.list(store.id, memory_id=mem.id):
print(f&quot;{v.id}: {v.operation}&quot;)</code></pre>
<h3>Retrieve a version</h3>
<pre><code class="lang-python">version = client.beta.memory_stores.memory_versions.retrieve(
version_id, memory_store_id=store.id
)
print(version.content)</code></pre>
<h3>Redact a version</h3>
<p>Scrubs content from a historical version while preserving the audit trail (actor + timestamps). Clears <code>content</code>, <code>content_sha256</code>, <code>content_size_bytes</code>, and <code>path</code>; everything else stays. Use for leaked secrets, PII, or user-deletion requests.</p>
<pre><code class="lang-python">client.beta.memory_stores.memory_versions.redact(version_id, memory_store_id=store.id)</code></pre>
<h2>Endpoint reference</h2>
<p>See <code>shared/managed-agents-api-reference.md</code> → Memory Stores / Memories / Memory Versions for the full HTTP method/path tables. Raw HTTP base path:</p>
<pre><code>POST /v1/memory_stores
POST /v1/memory_stores/{memory_store_id}/archive
GET /v1/memory_stores/{memory_store_id}/memories
PATCH /v1/memory_stores/{memory_store_id}/memories/{memory_id}
GET /v1/memory_stores/{memory_store_id}/memory_versions
POST /v1/memory_stores/{memory_store_id}/memory_versions/{version_id}/redact</code></pre>
<p>For cURL examples and the CLI (<code>ant beta:memory-stores ...</code>), WebFetch the Memory URL in <code>shared/live-sources.md</code> → Managed Agents.</p>
<footer>
<div class="fmap">
<div><b>Build</b>
<a href="https://hanzo.app">hanzo.app</a> app builder
<a href="https://hanzo.codes">hanzo.codes</a> code with an agent
<a href="https://hanzoskills.com">hanzoskills.com</a> what an agent reads</div>
<div><b>Run</b>
<a href="https://console.hanzo.ai">console.hanzo.ai</a> cloud console
<a href="https://api.hanzo.ai">api.hanzo.ai</a> the API</div>
<div><b>Account</b>
<a href="https://hanzo.id">hanzo.id</a> sign in
<a href="https://pay.hanzo.ai">pay.hanzo.ai</a> top up
<a href="https://billing.hanzo.ai">billing.hanzo.ai</a> invoices and usage</div>
<div><b>Company</b>
<a href="https://hanzo.ai">hanzo.ai</a> canonical
<a href="https://hanzo.ventures">hanzo.ventures</a> ventures</div>
</div>
<div class="fend"><a href="/managed-agents-memory.md">This page as plain text</a> · <a href="/llms.txt">Index for agents</a></div>
</footer>
</div></body></html>