@agentmemory/agentmemory 0.9.29 → 0.9.30

package/docker-compose.yml

@@ -8,34 +8,60 @@ services:
   iii-init:
     image: busybox:1.36
     user: "0:0"
+    environment:
+      AGENTMEMORY_DOCKER_UID: "${AGENTMEMORY_DOCKER_UID:-65532}"
+      AGENTMEMORY_DOCKER_GID: "${AGENTMEMORY_DOCKER_GID:-65532}"
+      AGENTMEMORY_DOCKER_SKIP_CHOWN: "${AGENTMEMORY_DOCKER_SKIP_CHOWN:-0}"
     volumes:
       - "${AGENTMEMORY_DATA_DIR:-iii-data}:/data"
-    entrypoint: ["sh", "-c", "chown -R 65532:65532 /data && chmod 755 /data"]
+    entrypoint: ["sh", "-c", "if [ \"$${AGENTMEMORY_DOCKER_SKIP_CHOWN}\" = \"1\" ]; then exit 0; fi; chown -R $${AGENTMEMORY_DOCKER_UID}:$${AGENTMEMORY_DOCKER_GID} /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-
-    # via-`iii worker add` model that agentmemory hasn't been refactored
-    # for yet; the architectural mismatch surfaces as EPIPE reconnect
-    # loops and empty search after save. Bump only after agentmemory is
-    # refactored to register as a sandboxed worker.
+    # Pinned to the same release as agentmemory's iii-sdk dependency
+    # (package.json). The worker speaks this engine's wire protocol, so
+    # bump the image tag and the SDK together, never one of them alone.
+    # 0.22.x is the last line before 0.23 removes the config.yaml worker
+    # lifecycle; it keeps HTTP routes owned by the reconnecting worker.
     #
     # 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"
+    #   AGENTMEMORY_III_VERSION=0.22.1 docker compose up
+    image: iiidev/iii:${AGENTMEMORY_III_VERSION:-0.22.1}
+    user: "${AGENTMEMORY_DOCKER_UID:-65532}:${AGENTMEMORY_DOCKER_GID:-65532}"
     depends_on:
       iii-init:
         condition: service_completed_successfully
+    command: ["--config", "/app/config.yaml", "--no-update-check"]
+    environment:
+      III_TELEMETRY_ENABLED: "${III_TELEMETRY_ENABLED:-false}"
+      III_REST_PORT: "${III_REST_PORT:-3111}"
+      III_STREAM_PORT: "${III_STREAM_PORT:-3112}"
+      III_VIEWER_PORT: "${III_VIEWER_PORT:-3113}"
+      III_ENGINE_PORT: "${III_ENGINE_PORT:-49134}"
+      AGENTMEMORY_REDIS_URL: "${AGENTMEMORY_REDIS_URL:-}"
+      AGENTMEMORY_STATE_SAVE_INTERVAL_MS: "${AGENTMEMORY_STATE_SAVE_INTERVAL_MS:-2000}"
+      MALLOC_ARENA_MAX: "${MALLOC_ARENA_MAX:-2}"
+    ulimits:
+      nofile:
+        soft: 10240
+        hard: 10240
     ports:
-      - "127.0.0.1:49134:49134"
-      - "127.0.0.1:3111:3111"
-      - "127.0.0.1:3112:3112"
-      - "127.0.0.1:9464:9464"
+      - "127.0.0.1:${III_ENGINE_PORT:-49134}:${III_ENGINE_PORT:-49134}"
+      - "127.0.0.1:${III_REST_PORT:-3111}:${III_REST_PORT:-3111}"
+      - "127.0.0.1:${III_STREAM_PORT:-3112}:${III_STREAM_PORT:-3112}"
+      - "127.0.0.1:${AGENTMEMORY_METRICS_PORT:-9464}:9464"
     volumes:
       - "${AGENTMEMORY_DATA_DIR:-iii-data}:/data"
       - ./iii-config.docker.yaml:/app/config.yaml:ro
+      # The engine persists each builtin worker's seeded config block under
+      # config/ next to its config file (/app/config in the image) on first
+      # boot and treats that copy as the source of truth afterwards. Keeping
+      # it on a tmpfs means every container start re-seeds from config.yaml
+      # and the III_* env vars, the same behavior the native CLI path has.
+      - type: tmpfs
+        target: /app/config
+        tmpfs:
+          mode: 01777
     restart: unless-stopped
     logging:
       driver: json-file

package/iii-config.docker.yaml

@@ -1,18 +1,23 @@
 workers:
   - name: iii-http
     config:
-      port: 3111
+      port: ${III_REST_PORT:3111}
       host: 0.0.0.0
       default_timeout: 180000
       cors:
-        allowed_origins: ["http://localhost:3111", "http://localhost:3113", "http://127.0.0.1:3111", "http://127.0.0.1:3113"]
+        allowed_origins: ["http://localhost:${III_REST_PORT:3111}", "http://localhost:${III_VIEWER_PORT:3113}", "http://127.0.0.1:${III_REST_PORT:3111}", "http://127.0.0.1:${III_VIEWER_PORT:3113}"]
         allowed_methods: [GET, POST, PUT, DELETE, OPTIONS]
+  - name: iii-worker-manager
+    config:
+      port: ${III_ENGINE_PORT:49134}
+      host: 0.0.0.0
   - name: iii-state
     config:
       adapter:
         name: kv
         config:
           store_method: file_based
+          save_interval_ms: ${AGENTMEMORY_STATE_SAVE_INTERVAL_MS:2000}
           file_path: /data/state_store.db
   - name: iii-queue
     config:
@@ -28,26 +33,21 @@ workers:
         name: kv
   - name: iii-stream
     config:
-      port: 3112
+      port: ${III_STREAM_PORT:3112}
       host: 0.0.0.0
       adapter:
         name: kv
         config:
           store_method: file_based
+          save_interval_ms: ${AGENTMEMORY_STATE_SAVE_INTERVAL_MS:2000}
           file_path: /data/stream_store
   - name: iii-observability
     config:
       enabled: true
       service_name: agentmemory
       exporter: memory
-      # See iii-config.yaml for the rationale on 0.1 / console-off (#519).
+      # See iii-config.yaml for the rationale on 0.1 / console-off.
       sampling_ratio: 0.1
       metrics_enabled: true
       logs_enabled: true
       logs_console_output: false
-  - name: iii-exec
-    config:
-      watch:
-        - src/**/*.ts
-      exec:
-        - node dist/index.mjs

package/iii-config.yaml

@@ -13,6 +13,7 @@ workers:
         name: kv
         config:
           store_method: file_based
+          save_interval_ms: 2000
           file_path: ./data/state_store.db
   - name: iii-queue
     config:
@@ -34,6 +35,7 @@ workers:
         name: kv
         config:
           store_method: file_based
+          save_interval_ms: 2000
           file_path: ./data/stream_store
   - name: iii-observability
     config:
@@ -45,7 +47,7 @@ workers:
       # subscriber lagged" WARN, and that WARN re-enters the same
       # stream the subscriber is failing to drain — a positive
       # feedback loop that wrote 137 GB to daemon.log.new on one user
-      # in a few days (#519).
+      # in a few days.
       sampling_ratio: 0.1
       metrics_enabled: true
       logs_enabled: true

package/integrations/pi/index.ts

@@ -3,7 +3,7 @@ import { Type } from "typebox";
 import path from "node:path";
 import crypto from "node:crypto";
 import { execFileSync } from "node:child_process";
-import { createPlaintextBearerAuthGuard } from "./security.js";
+import { createPlaintextBearerAuthGuard, resolveSecret } from "./security.js";
 
 type TextBlock = { type?: string; text?: string };
 type AssistantMessage = { role?: string; content?: unknown };
@@ -96,7 +96,7 @@ async function callAgentMemory<T>(
   const method = options?.method || "POST";
   const url = `${baseUrl}/agentmemory/${pathname.replace(/^\/+/, "")}`;
   const headers: Record<string, string> = {};
-  const secret = process.env.AGENTMEMORY_SECRET;
+  const secret = resolveSecret(baseUrl, process.env.AGENTMEMORY_SECRET);
   guardPlaintextBearerAuth(baseUrl, secret);
   if (options?.body !== undefined) headers["Content-Type"] = "application/json";
   if (secret) headers.Authorization = `Bearer ${secret}`;
@@ -393,7 +393,6 @@ export default function agentmemoryExtension(pi: ExtensionAPI) {
     // /new, /resume, /fork and reloads fire this too; only quit ends the session.
     if (event.reason !== "quit") return;
     if (!lastHealthOk || !sessionId) return;
-    // session/end already fans out the summary server-side (#1203).
     await callAgentMemory("session/end", {
       body: { sessionId },
       timeoutMs: 5_000,

package/integrations/pi/security.ts

@@ -1,5 +1,57 @@
+import { readFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+
 const LOOPBACK_HOSTS = new Set(["localhost", "127.0.0.1", "::1"]);
 
+function usableSecret(value: unknown): string {
+  const trimmed = typeof value === "string" ? value.trim() : "";
+  if (!trimmed || (trimmed.startsWith("${") && trimmed.endsWith("}"))) return "";
+  return trimmed;
+}
+
+function readAgentmemoryFile(name: string): string {
+  try {
+    return readFileSync(join(homedir(), ".agentmemory", name), "utf-8");
+  } catch {
+    return "";
+  }
+}
+
+function envFileSecret(): string {
+  let found = "";
+  for (const line of readAgentmemoryFile(".env").split("\n")) {
+    const trimmed = line.trim();
+    if (trimmed.startsWith("#")) continue;
+    const eq = trimmed.indexOf("=");
+    if (eq === -1) continue;
+    if (trimmed.slice(0, eq).replace(/^export\s+/, "").trim() !== "AGENTMEMORY_SECRET") continue;
+    let value = trimmed.slice(eq + 1).trim();
+    const quote = value[0];
+    const close = quote === '"' || quote === "'" ? value.indexOf(quote, 1) : -1;
+    if (close > 0) value = value.slice(1, close);
+    else if (value.includes(" #")) value = value.slice(0, value.indexOf(" #"));
+    found = usableSecret(value);
+  }
+  return found;
+}
+
+function isLoopbackUrl(url: string): boolean {
+  try {
+    const host = new URL(url).hostname.replace(/^\[|\]$/g, "").toLowerCase();
+    return host === "localhost" || host === "::1" || /^127(?:\.\d{1,3}){3}$/.test(host);
+  } catch {
+    return false;
+  }
+}
+
+export function resolveSecret(url: string, explicit?: string): string {
+  const configured = usableSecret(explicit);
+  if (configured) return configured;
+  if (!isLoopbackUrl(url)) return "";
+  return envFileSecret() || usableSecret(readAgentmemoryFile("secret"));
+}
+
 function normalizedHostname(hostname: string): string {
   return hostname.replace(/^\[|\]$/g, "").toLowerCase();
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentmemory/agentmemory",
-  "version": "0.9.29",
+  "version": "0.9.30",
   "description": "Persistent memory for AI coding agents, powered by iii-engine's three primitives",
   "type": "module",
   "main": "dist/index.mjs",
@@ -25,9 +25,17 @@
     "test:watch": "vitest --exclude test/integration.test.ts",
     "test:integration": "vitest run test/integration.test.ts",
     "test:all": "vitest run",
+    "release:gate": "node scripts/release-gate/run.mjs",
     "skills:gen": "tsx scripts/skills/generate.ts",
+    "engine:hashes": "node scripts/engine-hashes.mjs",
     "skills:check": "tsx scripts/skills/generate.ts --check && tsx scripts/skills/check.ts",
+    "docs:sync": "tsx scripts/docs-sync.ts",
+    "docs:check": "tsx scripts/docs-sync.ts --check",
+    "plugin:pack:codex": "npm run build && node scripts/plugins/package-codex.mjs",
+    "plugin:verify:published": "node scripts/plugins/verify-published.mjs",
+    "test:plugin:live": "node scripts/plugins/test-live.mjs",
     "bench:load": "node --import tsx benchmark/load-100k.ts",
+    "bench:capture-costs": "node --import tsx benchmark/capture-costs.ts",
     "eval:longmemeval": "tsx eval/runner/longmemeval.ts",
     "eval:coding-life": "tsx eval/runner/coding-life.ts"
   },
@@ -64,8 +72,9 @@
     "@anthropic-ai/claude-agent-sdk": "^0.3.142",
     "@anthropic-ai/sdk": "^0.100.1",
     "@clack/prompts": "^1.2.0",
-    "dotenv": "^17.4.2",
-    "iii-sdk": "0.11.2",
+    "dotenv": "^18.0.3",
+    "@iii-dev/helpers": "0.22.1",
+    "iii-sdk": "0.22.1",
     "picocolors": "^1.1.1",
     "zod": "^4.0.0"
   },
@@ -75,7 +84,7 @@
     "tiny-segmenter": "^0.2.0"
   },
   "devDependencies": {
-    "@types/node": "^25.9.1",
+    "@types/node": "^26.6.2",
     "tsdown": "^0.21.10",
     "tsx": "^4.19.0",
     "typescript": "^6.0.3",

package/plugin/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "agentmemory",
-  "version": "0.9.29",
-  "description": "Persistent memory for AI coding agents -- captures tool usage, compresses via LLM, injects context into future sessions. 12 hooks, 54 MCP tools, 8 skills, real-time viewer.",
+  "version": "0.9.30",
+  "description": "Persistent memory for AI coding agents -- captures tool usage, compresses via LLM, injects context into future sessions. 12 hooks, 54 MCP tools, 17 skills, real-time viewer.",
   "author": {
     "name": "Rohit Ghumare",
     "url": "https://github.com/rohitg00"

package/plugin/.codex-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "agentmemory",
-  "version": "0.9.29",
-  "description": "Persistent memory for AI coding agents -- captures tool usage, compresses via LLM, injects context into future sessions. 6 hooks, 54 MCP tools, 8 skills, real-time viewer.",
+  "version": "0.9.30",
+  "description": "Local persistent memory for coding agents. Recall decisions, resume sessions, learn from corrections, and manage memory through 54 MCP tools and 17 skills. Optional capture through 6 Codex hooks.",
   "author": {
     "name": "Rohit Ghumare",
     "url": "https://github.com/rohitg00"
@@ -10,6 +10,28 @@
   "homepage": "https://github.com/rohitg00/agentmemory",
   "repository": "https://github.com/rohitg00/agentmemory",
   "skills": "./skills/",
-  "mcpServers": "./.mcp.json",
-  "hooks": "./hooks/hooks.codex.json"
+  "mcpServers": "./.mcp.codex.json",
+  "hooks": "./hooks/hooks.codex.json",
+  "interface": {
+    "displayName": "Agent Memory",
+    "shortDescription": "Memory across coding sessions",
+    "longDescription": "Recall past decisions, resume work, save useful context, and learn from corrections across Codex and Claude Code using one local Agent Memory daemon. Includes search, session history, lessons, graph queries, memory maintenance, export, and deletion workflows. Requires Node.js 20+ and a running Agent Memory daemon. Basic keyword recall needs no model key. Embeddings and model-based features require configuration; external providers may receive selected data when enabled. Automatic capture requires trusted, supported hooks. Designed for local Codex sessions.",
+    "developerName": "Rohit Ghumare",
+    "websiteURL": "https://github.com/rohitg00/agentmemory",
+    "supportURL": "https://github.com/rohitg00/agentmemory/issues",
+    "category": "Developer Tools",
+    "capabilities": ["Local persistent memory", "Session handoff", "Lessons and recall", "Memory management"],
+    "defaultPrompt": [
+      "Check my local Agent Memory connection and explain which features are enabled.",
+      "Recall decisions relevant to this repository, with the evidence for each.",
+      "Resume the latest session for this repository and show the recorded next step."
+    ],
+    "logo": "./assets/icon.svg",
+    "composerIcon": "./assets/icon.svg"
+  },
+  "extensions": {
+    "com.openai": {
+      "onboardingSkill": "./skills/agentmemory-config/SKILL.md"
+    }
+  }
 }

package/plugin/.devin-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "agentmemory",
-  "version": "0.9.29",
+  "version": "0.9.30",
   "description": "Persistent memory for AI coding agents. Captures sessions, recalls with hybrid BM25 + vector + graph search, and exposes 54 memory tools over MCP. Keyless by default, runs on your machine.",
   "author": {
     "name": "Rohit Ghumare",

package/plugin/.mcp.codex.json

@@ -0,0 +1,12 @@
+{
+  "mcpServers": {
+    "agentmemory": {
+      "command": "node",
+      "args": ["scripts/plugin-bridge.mjs"],
+      "cwd": ".",
+      "env_vars": ["AGENTMEMORY_URL", "AGENTMEMORY_SECRET"],
+      "startup_timeout_sec": 20,
+      "tool_timeout_sec": 30
+    }
+  }
+}

package/plugin/.mcp.copilot.json

@@ -2,13 +2,8 @@
   "mcpServers": {
     "agentmemory": {
       "type": "local",
-      "command": "npx",
-      "args": ["-y", "@agentmemory/mcp"],
-      "env": {
-        "AGENTMEMORY_URL": "${AGENTMEMORY_URL:-http://localhost:3111}",
-        "AGENTMEMORY_SECRET": "${AGENTMEMORY_SECRET:-}",
-        "AGENTMEMORY_TOOLS": "${AGENTMEMORY_TOOLS:-all}"
-      },
+      "command": "node",
+      "args": ["${COPILOT_PLUGIN_ROOT}/scripts/plugin-bridge.mjs"],
       "tools": ["*"]
     }
   }

package/plugin/.mcp.json

@@ -1,13 +1,8 @@
 {
   "mcpServers": {
     "agentmemory": {
-      "command": "npx",
-      "args": ["-y", "@agentmemory/mcp"],
-      "env": {
-        "AGENTMEMORY_URL": "${AGENTMEMORY_URL:-http://localhost:3111}",
-        "AGENTMEMORY_SECRET": "${AGENTMEMORY_SECRET:-}",
-        "AGENTMEMORY_TOOLS": "${AGENTMEMORY_TOOLS:-all}"
-      }
+      "command": "node",
+      "args": ["${CLAUDE_PLUGIN_ROOT}/scripts/plugin-bridge.mjs"]
     }
   }
 }

package/plugin/assets/icon.svg

@@ -0,0 +1,35 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64" fill="none">
+  <defs>
+    <linearGradient id="g" x1="0" y1="0" x2="1" y2="1">
+      <stop offset="0%" stop-color="#FF6B35"/>
+      <stop offset="100%" stop-color="#FF8F5E"/>
+    </linearGradient>
+  </defs>
+
+  <rect width="64" height="64" rx="14" fill="#1A1A1A"/>
+
+  <!-- 4 memory tiers -->
+  <rect x="14" y="40" width="36" height="5" rx="2.5" fill="#333" opacity="0.5"/>
+  <rect x="14" y="33" width="36" height="5" rx="2.5" fill="#444" opacity="0.6"/>
+  <rect x="14" y="26" width="36" height="5" rx="2.5" fill="#555" opacity="0.7"/>
+  <rect x="14" y="19" width="36" height="5" rx="2.5" fill="url(#g)"/>
+
+  <!-- Active nodes on hot layer -->
+  <circle cx="22" cy="21.5" r="1.8" fill="#fff"/>
+  <circle cx="32" cy="21.5" r="1.8" fill="#fff"/>
+  <circle cx="42" cy="21.5" r="1.8" fill="#fff"/>
+
+  <!-- Retrieval lines converging up -->
+  <line x1="22" y1="19" x2="32" y2="12" stroke="#FF6B35" stroke-width="1" opacity="0.7"/>
+  <line x1="32" y1="19" x2="32" y2="12" stroke="#FF6B35" stroke-width="1" opacity="0.5"/>
+  <line x1="42" y1="19" x2="32" y2="12" stroke="#FF6B35" stroke-width="1" opacity="0.7"/>
+
+  <!-- Retrieval point -->
+  <circle cx="32" cy="11" r="3" fill="url(#g)"/>
+  <circle cx="32" cy="11" r="5" fill="none" stroke="#FF6B35" stroke-width="0.8" opacity="0.3"/>
+
+  <!-- Fading dots on lower tiers -->
+  <circle cx="25" cy="28.5" r="1" fill="#888" opacity="0.4"/>
+  <circle cx="39" cy="28.5" r="1" fill="#888" opacity="0.4"/>
+  <circle cx="32" cy="35.5" r="0.8" fill="#666" opacity="0.3"/>
+</svg>

package/plugin/hooks/hooks.copilot.json

@@ -4,68 +4,68 @@
     "sessionStart": [
       {
         "type": "command",
-        "command": "node ${COPILOT_PLUGIN_ROOT}/scripts/session-start.mjs"
+        "command": "node \"${COPILOT_PLUGIN_ROOT}/scripts/session-start.mjs\""
       }
     ],
     "userPromptSubmitted": [
       {
         "type": "command",
-        "command": "node ${COPILOT_PLUGIN_ROOT}/scripts/prompt-submit.mjs"
+        "command": "node \"${COPILOT_PLUGIN_ROOT}/scripts/prompt-submit.mjs\""
       }
     ],
     "preToolUse": [
       {
         "type": "command",
         "matcher": "edit|write|create|read|view|glob|grep",
-        "command": "node ${COPILOT_PLUGIN_ROOT}/scripts/pre-tool-use.mjs"
+        "command": "node \"${COPILOT_PLUGIN_ROOT}/scripts/pre-tool-use.mjs\""
       }
     ],
     "postToolUse": [
       {
         "type": "command",
-        "command": "node ${COPILOT_PLUGIN_ROOT}/scripts/post-tool-use.mjs"
+        "command": "node \"${COPILOT_PLUGIN_ROOT}/scripts/post-tool-use.mjs\""
       }
     ],
     "postToolUseFailure": [
       {
         "type": "command",
-        "command": "node ${COPILOT_PLUGIN_ROOT}/scripts/post-tool-failure.mjs"
+        "command": "node \"${COPILOT_PLUGIN_ROOT}/scripts/post-tool-failure.mjs\""
       }
     ],
     "preCompact": [
       {
         "type": "command",
-        "command": "node ${COPILOT_PLUGIN_ROOT}/scripts/pre-compact.mjs"
+        "command": "node \"${COPILOT_PLUGIN_ROOT}/scripts/pre-compact.mjs\""
       }
     ],
     "agentStop": [
       {
         "type": "command",
-        "command": "node ${COPILOT_PLUGIN_ROOT}/scripts/stop.mjs"
+        "command": "node \"${COPILOT_PLUGIN_ROOT}/scripts/stop.mjs\""
       }
     ],
     "sessionEnd": [
       {
         "type": "command",
-        "command": "node ${COPILOT_PLUGIN_ROOT}/scripts/session-end.mjs"
+        "command": "node \"${COPILOT_PLUGIN_ROOT}/scripts/session-end.mjs\""
       }
     ],
     "subagentStart": [
       {
         "type": "command",
-        "command": "node ${COPILOT_PLUGIN_ROOT}/scripts/subagent-start.mjs"
+        "command": "node \"${COPILOT_PLUGIN_ROOT}/scripts/subagent-start.mjs\""
       }
     ],
     "subagentStop": [
       {
         "type": "command",
-        "command": "node ${COPILOT_PLUGIN_ROOT}/scripts/subagent-stop.mjs"
+        "command": "node \"${COPILOT_PLUGIN_ROOT}/scripts/subagent-stop.mjs\""
       }
     ],
     "notification": [
       {
         "type": "command",
-        "command": "node ${COPILOT_PLUGIN_ROOT}/scripts/notification.mjs"
+        "command": "node \"${COPILOT_PLUGIN_ROOT}/scripts/notification.mjs\""
       }
     ]
   }