Skip to content

#1 Persistent memory for AI coding agents based on real-world benchmarks

fix(deploy): distroless volume perms + viewer proxy + budget loop (#299, #301) (#304)

Rohit Ghumare5ea01c162cad
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 188abb1a..58bb6553 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -6,6 +6,22 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
## [Unreleased]
+## [0.9.10] — 2026-05-12
+
+Three deployment-shape fixes reported live by [@flamerged](https://github.com/flamerged) ([#299](https://github.com/rohitg00/agentmemory/issues/299), [#301](https://github.com/rohitg00/agentmemory/issues/301)): the v0.9.7 docker-compose persistence fix was incomplete because the distroless engine runs as UID 65532 but `docker volume create` initializes the named volume mountpoint as `root:root mode 755`; the viewer's port-detection JS hardcoded `'3113'` so any reverse-proxy fronting on port 80/443 returned an empty dashboard; and the `mem::context` budget loop short-circuited the entire selection on the first oversized block — pinning a large slot could starve all other context blocks even when smaller ones would have fit.
+
+### Fixed
+
+- **`docker-compose.yml` now chowns the named volume to UID 65532 before the engine starts.** The `iiidev/iii` image is distroless and runs as UID 65532; docker initializes named volumes as `root:root mode 755`; the engine has no `sh` / `chown` to self-heal at startup, so writes to `/data/state_store.db` and `/data/stream_store` returned `Permission denied (os error 13)`. The engine silently buffered in RAM, the API kept reporting `success: true`, and state evaporated on every container restart — the exact symptom v0.9.7's working-directory fix set out to solve. The compose file now ships an `iii-init` one-shot service (`busybox:1.36`, ~4 MB, exits in <100 ms) that runs `chown -R 65532:65532 /data && chmod 755 /data` once at compose-up, plus a `user: "65532:65532"` directive on the `iii-engine` service and a `depends_on.iii-init.condition: service_completed_successfully` gate so the engine never starts before the volume is owner-correct. Existing deployments that already hit the bug should run `docker compose down && docker compose up -d` after upgrading — the init container will fix the volume in place on the first run. (#301, closes [#301](https://github.com/rohitg00/agentmemory/issues/301) — thanks [@flamerged](https://github.com/flamerged) for the precise UID + mountpoint trace and the chown workaround that confirmed the fix shape)
+
+- **Viewer dashboard now works behind any reverse proxy on standard ports (80 / 443).** `src/viewer/index.html`'s port-detection JS resolved the REST base URL through `params.get('port') || window.location.port || '3113'` — when the page was served on port 80 or 443, `window.location.port` was the empty string and the fallback hardcoded `':3113'`, so every browser-side `/agentmemory/*` fetch missed the proxied origin and went to `<host>:3113` (typically loopback-only on these deployments, so unreachable from outside). The viewer rendered cleanly but every panel showed the empty "first run" state — even though `curl <proxy-host>/agentmemory/sessions` (no explicit port) returned correct data. The fix uses `window.location.origin` as the REST base when neither `?port=` nor `window.location.port` is set, and constructs the WebSocket URL from `window.location.host` (with whatever port the page was served on) so the same-origin path works for both REST and live updates. Behaviour with an explicit `?port=N` or non-default `window.location.port` is unchanged. (#299, closes [#299](https://github.com/rohitg00/agentmemory/issues/299) — thanks [@flamerged](https://github.com/flamerged) for the deployment context + the lines-927–930 trace)
+
+- **`mem::context` budget loop no longer bails the entire selection on the first oversized block.** The selection loop in `src/functions/context.ts` used `break` when `usedTokens + block.tokens > budget`, so a single oversized block at the top of the sorted list — most commonly a fat pinned slot under #288's new injection path — cut off every smaller block that would have fit. Switched to `continue`, so smaller blocks downstream of an oversized one can still slip into the remaining budget. Net effect: pinned-slot priority semantic is preserved (pinned blocks still sort first via `recency: Date.now()`), but the worst case no longer starves the entire context. Total tokens still bounded by `tokenBudget` (default 2000); only the composition under contention changes.
+
+### Changed
+
+- `@agentmemory/mcp` package version bumped from 0.9.9 → 0.9.10 to lockstep with the main package.
+
## [0.9.9] — 2026-05-11
Two field-reported regressions closed: pinned memory slots never reached SessionStart context (the `renderPinnedContext` and `listPinnedSlots` helpers shipped in v0.7 had no callers), and the MiniMax compression provider read its base URL straight off `process.env`, missing `~/.agentmemory/.env` values that the rest of agentmemory loads through the shared merged-env path.
diff --git a/docker-compose.yml b/docker-compose.yml
index bed761ea..6b117652 100644
--- a/docker-compose.yml
+++ b/docker-compose.yml
@@ -1,4 +1,18 @@
services:
+ # One-shot init container: docker creates named volumes root:root mode
+ # 755, but the iii-engine image is distroless and runs as UID 65532
+ # with no `chown` of its own. Without this, /data is unwritable, the
+ # engine silently buffers in RAM, and state evaporates on every
+ # restart — the exact symptom v0.9.7's working-directory fix set out
+ # to solve. Runs once at compose-up and exits.
+ iii-init:
+ image: busybox:1.36
+ user: "0:0"
+ volumes:
+ - iii-data:/data
+ entrypoint: ["sh", "-c", "chown -R 65532:65532 /data && chmod 755 /data"]
+ restart: "no"
+
iii-engine:
# Pinned to v0.11.2 — the last engine that runs agentmemory's current
# worker model cleanly. v0.11.6 introduces a new sandbox-everything-
@@ -10,6 +24,10 @@ services:
# Override per-shell or via .env file:
# AGENTMEMORY_III_VERSION=0.11.7 docker compose up
image: iiidev/iii:${AGENTMEMORY_III_VERSION:-0.11.2}
+ user: "65532:65532"
+ depends_on:
+ iii-init:
+ condition: service_completed_successfully
ports:
- "127.0.0.1:49134:49134"
- "127.0.0.1:3111:3111"
diff --git a/package.json b/package.json
index 3f3a90bf..4c3047d5 100644
--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
{
"name": "@agentmemory/agentmemory",
- "version": "0.9.9",
+ "version": "0.9.10",
"description": "Persistent memory for AI coding agents, powered by iii-engine's three primitives",
"type": "module",
"main": "dist/index.mjs",
diff --git a/packages/mcp/package.json b/packages/mcp/package.json
index bde9d083..e7a91f26 100644
--- a/packages/mcp/package.json
+++ b/packages/mcp/package.json
@@ -1,6 +1,6 @@
{
"name": "@agentmemory/mcp",
- "version": "0.9.9",
+ "version": "0.9.10",
"description": "Standalone MCP server for agentmemory — thin shim that re-exposes @agentmemory/agentmemory's MCP entrypoint",
"type": "module",
"bin": {
diff --git a/plugin/.claude-plugin/plugin.json b/plugin/.claude-plugin/plugin.json
index 45cb2a13..d059828e 100644
--- a/plugin/.claude-plugin/plugin.json
+++ b/plugin/.claude-plugin/plugin.json
@@ -1,6 +1,6 @@
{
"name": "agentmemory",
- "version": "0.9.9",
+ "version": "0.9.10",
"description": "Persistent memory for AI coding agents -- captures tool usage, compresses via LLM, injects context into future sessions. 12 hooks, 51 MCP tools, 4 skills, real-time viewer.",
"author": {
"name": "Rohit Ghumare",
diff --git a/src/functions/context.ts b/src/functions/context.ts
index 8a25f9b8..319de1ee 100644
--- a/src/functions/context.ts
+++ b/src/functions/context.ts
@@ -168,7 +168,7 @@ export function registerContextFunction(
usedTokens += estimateTokens(header) + estimateTokens(footer);
for (const block of blocks) {
- if (usedTokens + block.tokens > budget) break;
+ if (usedTokens + block.tokens > budget) continue;
selected.push(block.content);
usedTokens += block.tokens;
if (block.sourceIds && block.sourceIds.length > 0) {
diff --git a/src/functions/export-import.ts b/src/functions/export-import.ts
index dd2eccad..d2d07331 100644
--- a/src/functions/export-import.ts
+++ b/src/functions/export-import.ts
@@ -176,7 +176,7 @@ export function registerExportImportFunction(sdk: ISdk, kv: StateKV): void {
const strategy = data.strategy || "merge";
const importData = data.exportData;
- const supportedVersions = new Set(["0.3.0", "0.4.0", "0.5.0", "0.6.0", "0.6.1", "0.7.0", "0.7.2", "0.7.3", "0.7.4", "0.7.5", "0.7.6", "0.7.7", "0.7.9", "0.8.0", "0.8.1", "0.8.2", "0.8.3", "0.8.4", "0.8.5", "0.8.6", "0.8.7", "0.8.8", "0.8.9", "0.8.10", "0.8.11", "0.8.12", "0.8.13", "0.9.0", "0.9.1", "0.9.2", "0.9.3", "0.9.4", "0.9.5", "0.9.6", "0.9.7", "0.9.8", "0.9.9"]);
+ const supportedVersions = new Set(["0.3.0", "0.4.0", "0.5.0", "0.6.0", "0.6.1", "0.7.0", "0.7.2", "0.7.3", "0.7.4", "0.7.5", "0.7.6", "0.7.7", "0.7.9", "0.8.0", "0.8.1", "0.8.2", "0.8.3", "0.8.4", "0.8.5", "0.8.6", "0.8.7", "0.8.8", "0.8.9", "0.8.10", "0.8.11", "0.8.12", "0.8.13", "0.9.0", "0.9.1", "0.9.2", "0.9.3", "0.9.4", "0.9.5", "0.9.6", "0.9.7", "0.9.8", "0.9.9", "0.9.10"]);
if (!supportedVersions.has(importData.version)) {
return {
success: false,
diff --git a/src/types.ts b/src/types.ts
index 5285281b..e3ad63a1 100644
--- a/src/types.ts
+++ b/src/types.ts
@@ -279,7 +279,7 @@ export interface ExportPagination {
}
export interface ExportData {
- version: "0.3.0" | "0.4.0" | "0.5.0" | "0.6.0" | "0.6.1" | "0.7.0" | "0.7.2" | "0.7.3" | "0.7.4" | "0.7.5" | "0.7.6" | "0.7.7" | "0.7.9" | "0.8.0" | "0.8.1" | "0.8.2" | "0.8.3" | "0.8.4" | "0.8.5" | "0.8.6" | "0.8.7" | "0.8.8" | "0.8.9" | "0.8.10" | "0.8.11" | "0.8.12" | "0.8.13" | "0.9.0" | "0.9.1" | "0.9.2" | "0.9.3" | "0.9.4" | "0.9.5" | "0.9.6" | "0.9.7" | "0.9.8" | "0.9.9";
+ version: "0.3.0" | "0.4.0" | "0.5.0" | "0.6.0" | "0.6.1" | "0.7.0" | "0.7.2" | "0.7.3" | "0.7.4" | "0.7.5" | "0.7.6" | "0.7.7" | "0.7.9" | "0.8.0" | "0.8.1" | "0.8.2" | "0.8.3" | "0.8.4" | "0.8.5" | "0.8.6" | "0.8.7" | "0.8.8" | "0.8.9" | "0.8.10" | "0.8.11" | "0.8.12" | "0.8.13" | "0.9.0" | "0.9.1" | "0.9.2" | "0.9.3" | "0.9.4" | "0.9.5" | "0.9.6" | "0.9.7" | "0.9.8" | "0.9.9" | "0.9.10";
exportedAt: string;
sessions: Session[];
observations: Record<string, CompressedObservation[]>;
diff --git a/src/version.ts b/src/version.ts
index 14d8a926..d0e5b4af 100644
--- a/src/version.ts
+++ b/src/version.ts
@@ -1 +1 @@
-export const VERSION = "0.9.9";
+export const VERSION = "0.9.10";
diff --git a/src/viewer/index.html b/src/viewer/index.html
index 5de2f87f..17fec4ea 100644
--- a/src/viewer/index.html
+++ b/src/viewer/index.html
@@ -924,14 +924,30 @@
<script nonce="__AGENTMEMORY_VIEWER_NONCE__">
var params = new URLSearchParams(window.location.search);
- var viewerPort = params.get('port') || window.location.port || '3113';
- var iiiPort = parseInt(viewerPort);
- if (iiiPort === 3111) viewerPort = '3113';
- var REST = window.location.protocol + '//' + window.location.hostname + ':' + viewerPort;
+ var paramPort = params.get('port');
+ var locPort = window.location.port;
var wsProto = window.location.protocol === 'https:' ? 'wss:' : 'ws:';
- var wsPort = params.get('wsPort') || String(parseInt(viewerPort) - 1);
- var WS_URL = wsProto + '//' + window.location.hostname + ':' + wsPort;
- var WS_DIRECT_URL = wsProto + '//' + window.location.hostname + ':' + wsPort + '/stream/mem-live/viewer';
+ var REST, WS_URL, WS_DIRECT_URL, wsPort;
+ if (paramPort) {
+ var resolvedPort = parseInt(paramPort) === 3111 ? '3113' : paramPort;
+ REST = window.location.protocol + '//' + window.location.hostname + ':' + resolvedPort;
+ wsPort = params.get('wsPort') || String(parseInt(resolvedPort) - 1);
+ WS_URL = wsProto + '//' + window.location.hostname + ':' + wsPort;
+ WS_DIRECT_URL = WS_URL + '/stream/mem-live/viewer';
+ } else if (locPort) {
+ var resolvedPort = parseInt(locPort) === 3111 ? '3113' : locPort;
+ REST = window.location.protocol + '//' + window.location.hostname + ':' + resolvedPort;
+ wsPort = params.get('wsPort') || String(parseInt(resolvedPort) - 1);
+ WS_URL = wsProto + '//' + window.location.hostname + ':' + wsPort;
+ WS_DIRECT_URL = WS_URL + '/stream/mem-live/viewer';
+ } else {
+ REST = window.location.origin;
+ wsPort = params.get('wsPort');
+ WS_URL = wsPort
+ ? wsProto + '//' + window.location.hostname + ':' + wsPort
+ : wsProto + '//' + window.location.host;
+ WS_DIRECT_URL = WS_URL + '/stream/mem-live/viewer';
+ }
var dateEl = document.getElementById('dateline');
if (dateEl) dateEl.textContent = new Date().toLocaleDateString('en-US', { weekday: 'short', year: 'numeric', month: 'short', day: 'numeric' });
diff --git a/test/export-import.test.ts b/test/export-import.test.ts
index 249ef8d9..5e620356 100644
--- a/test/export-import.test.ts
+++ b/test/export-import.test.ts
@@ -119,7 +119,7 @@ describe("Export/Import Functions", () => {
it("export produces valid ExportData structure", async () => {
const result = (await sdk.trigger("mem::export", {})) as ExportData;
- expect(result.version).toBe("0.9.9");
+ expect(result.version).toBe("0.9.10");
expect(result.exportedAt).toBeDefined();
expect(result.sessions.length).toBe(1);
expect(result.sessions[0].id).toBe("ses_1");