diff --git a/.cursor-plugin/plugin.json b/.cursor-plugin/plugin.json index 4cabbe100c..0c565e530b 100644 --- a/.cursor-plugin/plugin.json +++ b/.cursor-plugin/plugin.json @@ -1,6 +1,6 @@ { "name": "agentmemory", - "version": "0.9.31", + "version": "0.9.32", "description": "Persistent memory for Cursor: auto-captures sessions, prompts, and tool use via hooks, recalls with hybrid BM25 + vector + graph search, and exposes 54 memory tools over MCP. Keyless by default, runs entirely on your machine.", "author": { "name": "Rohit Ghumare", diff --git a/AGENTS.md b/AGENTS.md index a6d2961cc1..7472c1208a 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -107,7 +107,7 @@ Hook scripts in `src/hooks/` are standalone Node.js scripts (no iii-sdk import). - Test files go in `test/` with `.test.ts` extension - Follow existing patterns in `test/crystallize.test.ts` for function tests -## Current Stats (v0.9.31) +## Current Stats (v0.9.32) - 54 MCP tools visible by default; `AGENTMEMORY_TOOLS=core` selects 8 essentials - 147 REST endpoints diff --git a/CHANGELOG.md b/CHANGELOG.md index abac402cbc..f40fb9bc99 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -6,6 +6,44 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), ## [Unreleased] +## [0.9.32] — 2026-11-04 + +### Upgrade notes + +- **Breaking: an API key alone no longer turns on an outside provider.** LLM summaries, compression, consolidation and reflection run only when `AGENTMEMORY_LLM_PROVIDER` names `anthropic`, `openai`, `gemini`, `openrouter` or `minimax` and that provider's key is set. `AGENTMEMORY_ALLOW_AGENT_SDK=true` stays the other route. Cloud embeddings run only when `EMBEDDING_PROVIDER` names the provider; `EMBEDDING_PROVIDER=local` stays on-device, and unset means BM25 and graph search only. If a key is present without a choice, boot, `doctor`, `status` and the viewer name the exact line to add (#1664). +- `OPENAI_API_KEY_FOR_LLM` is removed. Set `AGENTMEMORY_LLM_PROVIDER` instead (#1664). +- **Hooks send nothing to a remote `http://` server.** A non-loopback `AGENTMEMORY_URL` must use HTTPS; captures for a plain-HTTP remote server are dropped, not spooled. The secret is sent only to loopback or HTTPS addresses (#1664). +- The PreCompact hook prints stored memory only with `AGENTMEMORY_INJECT_CONTEXT=true`, the same gate as SessionStart (#1664). +- The Claude Code plugin asks for the server URL and secret through plugin settings. The secret is kept in the system credential store. The Devin plugin no longer forwards `AGENTMEMORY_SECRET` from the environment (#1664). + +### Added + +- **iii installs itself on Windows.** A fresh `agentmemory` on win32 downloads the pinned iii zip, checks its SHA-256 and extracts it with the system `tar.exe`, falling back to PowerShell `Expand-Archive` (#1670). +- MCP tools carry `readOnlyHint` and `destructiveHint` annotations, and the plugin README states what the hooks record, where it is kept and how to delete it. Privacy policy: https://agent-memory.dev/privacy (#1664). +- `memory_lesson_save` accepts `sourceIds` (#1661). +- The MCP stdio shim records why it exits in `mcp-crash.log` in the data directory (owner-only, rotated at 1 MiB) and saves its fallback store before writing to stderr (#1662, #1674). + +### Fixed + +- **Worker Compose starts on native Windows.** Worker commands, the worker PATH and project ownership checks with `\\?\` and 8.3 paths are fixed; `agentmemory stop` waits long enough for every worker (#1641). The launcher retries a slow `iii --version` probe and never waits on a hidden install prompt (#1658). `doctor` does not prompt without a terminal or with `CI` set (#1671). `status` and `stop` output no longer include iii SDK debug lines (#1672). +- **Boot no longer races the state worker.** agentmemory waits up to 120 s for the state worker to register before boot reads, and the keyword rebuild keeps retrying, so a slow start no longer leaves vector recovery paused or the keyword index empty until restart (#1627 by @cbsincool, #1626 by @Tyxiel, #1660). +- A stale Worker Compose PID reused by an unrelated process after a reboot no longer causes a start crash loop (#1622 by @pei711). +- The Docker image keeps the optional dependencies that local embeddings need (#1651 by @mothieras). +- Slot tools are hidden and return 503 when `AGENTMEMORY_SLOTS` is off (#1659). +- Search: CJK queries recall core observations again (#1553 by @akushonkamen); scoped smart-search fills short pages from a deeper window (#1669 by @dmazhukov); project-filtered recall excludes unscoped memories (#1647 by @reevesc88); search responses keep the original memory type (#1646 by @reevesc88). +- An OpenAI reply cut off at `max_tokens` fails over instead of being stored as the result (#1495 by @Rex57). +- Orphaned index generations are reclaimed (#1256 by @inix-x), and the MCP graph stats resource reads a bounded snapshot instead of listing the whole graph (#1260 by @inix-x). +- Facet tags are removed when lessons are deleted or observations forgotten (#1642 by @xh123637). The session sweep skips rows without an id (#1645 by @dmazhukov). Hook truncation keeps surrogate pairs whole (#1598 by @dmazhukov). +- The Hermes project git probe no longer inherits the worker's stdin, which could hang on Windows (#1663). The Cline CLI MCP configuration uses its native settings path (#1633). +- A superseded memory gets a strictly later `updatedAt`, so mesh sync carries the change to peers (#1665 by @egantz). +- pi includes recalled lessons in search and can read a full lesson by ID, scoped to its project (#1605 by @YeChenglin8888). +- `npm run build` works under the Windows `cmd.exe` shell (#1362 by @mattamundson). +- `.env.example` names the Agent SDK route and documents `MAX_OBS_PER_SESSION` as a hard per-session cap (#1675, from #1503 by @Rex57). + +### Known issues + +- On Windows, `agentmemory stop` takes about 60 s and each start opens empty console windows for the engine and workers. Both come from iii (iii-hq/iii#2430). + ## [0.9.31] — 2026-10-25 ### Upgrade notes @@ -297,6 +335,8 @@ Wave release closing several breaking regressions reported against v0.9.26, plus - `/agentmemory:forget` skill still calls `memory_governance_delete` which only touches `KV.memories` and never observations ([#833](https://github.com/rohitg00/agentmemory/issues/833)). Skill rewrite + new `memory_forget` MCP tool tracked separately. - `crypto.randomUUID()` global-only on Node <19 ([#715](https://github.com/rohitg00/agentmemory/issues/715)). Drop-in import fix tracked. +[0.9.32]: https://github.com/rohitg00/agentmemory/compare/v0.9.31...v0.9.32 +[0.9.32]: https://github.com/rohitg00/agentmemory/compare/v0.9.31...v0.9.32 [0.9.31]: https://github.com/rohitg00/agentmemory/compare/v0.9.30...v0.9.31 [0.9.30]: https://github.com/rohitg00/agentmemory/compare/v0.9.29...v0.9.30 [0.9.29]: https://github.com/rohitg00/agentmemory/compare/v0.9.28...v0.9.29 diff --git a/README.md b/README.md index 1ba26a7a2a..0f67202635 100644 --- a/README.md +++ b/README.md @@ -332,14 +332,14 @@ Latest release notes: [CHANGELOG.md](CHANGELOG.md). --- -### What's new in 0.9.31 +### What's new in 0.9.32 -- **More focused recall:** project and agent scopes, saved-memory retrieval, explicit context budgets and full-source expansion. -- **Less repeated work:** incremental session summaries skip unchanged observations; exports page through stored data. -- **More native integrations:** installable Pi package, OMP and DeepSeek Harness plugins, and improved Cursor workspace attribution. -- **Safer recovery:** compression, import validation and runtime recovery fixes, with status and activity visible in the viewer. +- **Providers are opt-in:** a key alone sends nothing out. Set `AGENTMEMORY_LLM_PROVIDER` for LLM features and `EMBEDDING_PROVIDER` for cloud embeddings. +- **Native Windows works:** Worker Compose starts, iii installs itself, and `doctor` never waits on a prompt in scripts. +- **Reliable boot:** agentmemory waits for the state worker, so slow starts keep their search index and vectors. +- **Better recall:** CJK queries, scoped smart-search and project isolation fixes. -[Release notes and contributor credits](https://github.com/rohitg00/agentmemory/releases/tag/v0.9.31). +[Release notes and contributor credits](https://github.com/rohitg00/agentmemory/releases/tag/v0.9.32).

Benchmarks

diff --git a/integrations/hermes/plugin.yaml b/integrations/hermes/plugin.yaml index 95eca81e61..23174373d7 100644 --- a/integrations/hermes/plugin.yaml +++ b/integrations/hermes/plugin.yaml @@ -1,5 +1,5 @@ name: agentmemory -version: 0.9.31 +version: 0.9.32 description: "Persistent memory for Hermes Agent with profile-scoped capture, recall, and native memory tools." author: "Rohit Ghumare" homepage: "https://github.com/rohitg00/agentmemory" diff --git a/integrations/omp/package.json b/integrations/omp/package.json index 47419e64ef..164ec4ad65 100644 --- a/integrations/omp/package.json +++ b/integrations/omp/package.json @@ -2,7 +2,7 @@ "name": "agentmemory-omp-extension", "private": true, "type": "module", - "version": "0.9.31", + "version": "0.9.32", "omp": { "name": "agentmemory", "description": "Persistent cross-session memory for omp \u2014 captures sessions, tools, approvals, and compaction; injects smart-search recall.", diff --git a/integrations/openclaw/openclaw.plugin.json b/integrations/openclaw/openclaw.plugin.json index eae33a5cdd..975e1ce74f 100644 --- a/integrations/openclaw/openclaw.plugin.json +++ b/integrations/openclaw/openclaw.plugin.json @@ -3,7 +3,7 @@ "kind": "memory", "name": "agentmemory", "description": "Persistent cross-session memory for OpenClaw via agentmemory.", - "version": "0.9.31", + "version": "0.9.32", "configSchema": { "type": "object", "additionalProperties": false, diff --git a/integrations/openclaw/package.json b/integrations/openclaw/package.json index b582960870..b9f8d8d8a4 100644 --- a/integrations/openclaw/package.json +++ b/integrations/openclaw/package.json @@ -1,6 +1,6 @@ { "name": "agentmemory", - "version": "0.9.31", + "version": "0.9.32", "type": "module", "openclaw": { "extensions": [ diff --git a/integrations/openclaw/plugin.yaml b/integrations/openclaw/plugin.yaml index e7b0bdeb77..b0ea067481 100644 --- a/integrations/openclaw/plugin.yaml +++ b/integrations/openclaw/plugin.yaml @@ -1,5 +1,5 @@ name: agentmemory -version: 0.9.31 +version: 0.9.32 description: "Persistent cross-session memory for OpenClaw via agentmemory." author: "Rohit Ghumare" homepage: "https://github.com/rohitg00/agentmemory" diff --git a/package.json b/package.json index 9b668b56c2..9119e591b6 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "@agentmemory/agentmemory", - "version": "0.9.31", + "version": "0.9.32", "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 4b7c132e83..60bfb0126e 100644 --- a/packages/mcp/package.json +++ b/packages/mcp/package.json @@ -1,6 +1,6 @@ { "name": "@agentmemory/mcp", - "version": "0.9.31", + "version": "0.9.32", "description": "Standalone MCP server for agentmemory — thin shim that re-exposes @agentmemory/agentmemory's MCP entrypoint", "type": "module", "bin": { @@ -28,7 +28,7 @@ "homepage": "https://github.com/rohitg00/agentmemory#readme", "bugs": "https://github.com/rohitg00/agentmemory/issues", "dependencies": { - "@agentmemory/agentmemory": "0.9.31" + "@agentmemory/agentmemory": "0.9.32" }, "publishConfig": { "access": "public", diff --git a/plugin/.claude-plugin/plugin.json b/plugin/.claude-plugin/plugin.json index d09a6814c2..c4e7962170 100644 --- a/plugin/.claude-plugin/plugin.json +++ b/plugin/.claude-plugin/plugin.json @@ -1,6 +1,6 @@ { "name": "agentmemory", - "version": "0.9.31", + "version": "0.9.32", "description": "Persistent local memory for Claude. Hooks record prompts, tool calls and replies to a separately installed agentmemory server on your machine; skills and 54 MCP tools search and manage that memory. No outside AI provider is used unless you enable one.", "author": { "name": "Rohit Ghumare", diff --git a/plugin/.codex-plugin/plugin.json b/plugin/.codex-plugin/plugin.json index f4ccc88a16..ee7e12e455 100644 --- a/plugin/.codex-plugin/plugin.json +++ b/plugin/.codex-plugin/plugin.json @@ -1,6 +1,6 @@ { "name": "agentmemory", - "version": "0.9.31", + "version": "0.9.32", "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", diff --git a/plugin/.devin-plugin/plugin.json b/plugin/.devin-plugin/plugin.json index 66d717dbf5..aefb900707 100644 --- a/plugin/.devin-plugin/plugin.json +++ b/plugin/.devin-plugin/plugin.json @@ -1,7 +1,7 @@ { "name": "agentmemory", "displayName": "agentmemory", - "version": "0.9.31", + "version": "0.9.32", "description": "Persistent memory for Devin CLI and Devin Desktop. Captures every session automatically, recalls with hybrid BM25 + vector + graph search, and exposes 54 memory tools over MCP. Keyless by default, runs on your machine. Not supported in cloud sessions.", "logo": "assets/icon.svg", "author": { @@ -23,7 +23,7 @@ "command": "npx", "args": [ "-y", - "@agentmemory/mcp@0.9.31" + "@agentmemory/mcp@0.9.32" ], "env": { "AGENTMEMORY_URL": "${AGENTMEMORY_URL:-http://localhost:3111}" diff --git a/plugin/opencode/plugin.json b/plugin/opencode/plugin.json index a53650ac68..27340dffb1 100644 --- a/plugin/opencode/plugin.json +++ b/plugin/opencode/plugin.json @@ -1,6 +1,6 @@ { "name": "agentmemory-capture", - "version": "0.9.31", + "version": "0.9.32", "description": "OpenCode plugin for agentmemory — full Claude Code hook parity: session lifecycle (create/idle/status/compacted/update/diff/delete/error), messages & prompts (chat.message, message.updated user+assistant, message.removed), tool lifecycle (ToolPart states with timing), part tracking (subtask, step-finish, reasoning, file, patch, compaction, agent, retry), file enrichment pipeline, permissions, task tracking (w/ priority), commands, config & model tracking. 22 hooks, 2 slash commands.", "author": { "name": "Rohit Ghumare", diff --git a/plugin/plugin.json b/plugin/plugin.json index f78c5ad8d6..c901700c3f 100644 --- a/plugin/plugin.json +++ b/plugin/plugin.json @@ -1,6 +1,6 @@ { "name": "agentmemory", - "version": "0.9.31", + "version": "0.9.32", "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", diff --git a/plugin/scripts/plugin-bridge.mjs b/plugin/scripts/plugin-bridge.mjs index 5b490165cd..8c54d77745 100644 --- a/plugin/scripts/plugin-bridge.mjs +++ b/plugin/scripts/plugin-bridge.mjs @@ -3,7 +3,7 @@ import { readFileSync, realpathSync } from "node:fs"; import { homedir } from "node:os"; import { join } from "node:path"; //#region src/version.ts -const VERSION = "0.9.31"; +const VERSION = "0.9.32"; //#endregion //#region src/secret-store.ts const SECRET_KEY = "AGENTMEMORY_SECRET"; diff --git a/scripts/docs-sync.state.json b/scripts/docs-sync.state.json index c41e6e028b..75275bbc3d 100644 --- a/scripts/docs-sync.state.json +++ b/scripts/docs-sync.state.json @@ -1,5 +1,5 @@ { - "version": "0.9.31", + "version": "0.9.32", "facts": { "mcpTools": [ "54" diff --git a/src/functions/export-import.ts b/src/functions/export-import.ts index 05d7ff78fa..730dd590cd 100644 --- a/src/functions/export-import.ts +++ b/src/functions/export-import.ts @@ -310,7 +310,7 @@ export function registerExportImportFunction(sdk: IIIClient, state: StateKV): vo 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", "0.9.10", "0.9.11", "0.9.12", "0.9.13", "0.9.14", "0.9.15", "0.9.16", "0.9.17", "0.9.18", "0.9.19", "0.9.20", "0.9.21", "0.9.22", "0.9.23", "0.9.24", "0.9.25", "0.9.26", "0.9.27", "0.9.28", "0.9.29", "0.9.30", "0.9.31"]); + 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", "0.9.11", "0.9.12", "0.9.13", "0.9.14", "0.9.15", "0.9.16", "0.9.17", "0.9.18", "0.9.19", "0.9.20", "0.9.21", "0.9.22", "0.9.23", "0.9.24", "0.9.25", "0.9.26", "0.9.27", "0.9.28", "0.9.29", "0.9.30", "0.9.31", "0.9.32"]); if (!supportedVersions.has(importData.version)) { return { success: false, diff --git a/src/types.ts b/src/types.ts index eff9b8ca86..5ab42970f2 100644 --- a/src/types.ts +++ b/src/types.ts @@ -398,7 +398,7 @@ export interface ExportCollectionPagination { } 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" | "0.9.10" | "0.9.11" | "0.9.12" | "0.9.13" | "0.9.14" | "0.9.15" | "0.9.16" | "0.9.17" | "0.9.18" | "0.9.19" | "0.9.20" | "0.9.21" | "0.9.22" | "0.9.23" | "0.9.24" | "0.9.25" | "0.9.26" | "0.9.27" | "0.9.28" | "0.9.29" | "0.9.30" | "0.9.31"; + 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" | "0.9.11" | "0.9.12" | "0.9.13" | "0.9.14" | "0.9.15" | "0.9.16" | "0.9.17" | "0.9.18" | "0.9.19" | "0.9.20" | "0.9.21" | "0.9.22" | "0.9.23" | "0.9.24" | "0.9.25" | "0.9.26" | "0.9.27" | "0.9.28" | "0.9.29" | "0.9.30" | "0.9.31" | "0.9.32"; exportedAt: string; sessions: Session[]; observations: Record; diff --git a/src/version.ts b/src/version.ts index 4a86705db0..74eb790c21 100644 --- a/src/version.ts +++ b/src/version.ts @@ -1,2 +1,2 @@ -export const VERSION = "0.9.31"; +export const VERSION = "0.9.32"; export const III_PINNED_VERSION = "0.25.0";