Skip to content

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

chore(engine): move iii-sdk and the engine pin to 0.22.1 (#1397)

Rohit Ghumarebb6cef38990b
diff --git a/.env.example b/.env.example
index 153aef4d..9219a338 100644
--- a/.env.example
+++ b/.env.example
@@ -181,11 +181,14 @@
# -----------------------------------------------------------------------------
#
# agentmemory pins iii-engine to the same release as its iii-sdk dependency
-# (v0.19.7). The worker speaks the wire protocol of that engine, so the two move
+# (v0.22.1). The worker speaks the wire protocol of that engine, so the two move
# together in agentmemory releases. Override with AGENTMEMORY_III_VERSION only
# if you run your own engine and know it matches.
-# AGENTMEMORY_III_VERSION=0.19.7
+# AGENTMEMORY_III_VERSION=0.22.1
+
+# Engine usage telemetry (iii). Off unless you set it; true opts in.
+# III_TELEMETRY_ENABLED=false
# -----------------------------------------------------------------------------
# 9. Claude Code bridge (opt-in)
diff --git a/AGENTS.md b/AGENTS.md
index dc08f431..a2226903 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -4,7 +4,7 @@
agentmemory is a persistent memory system for AI coding agents, built on iii-engine's three primitives (Worker/Function/Trigger). Everything goes through `registerFunction`/`registerTrigger`/`sdk.trigger()` — never bypass iii-engine with standalone SQLite or in-process alternatives.
-- **Engine**: iii-sdk (WebSocket to iii-engine on port 49134)
+- **Engine**: iii-sdk 0.22.1 with @iii-dev/helpers 0.22.1 (WebSocket to iii-engine 0.22.1 on port 49134; the client type is `IIIClient`, HTTP requests are `HttpRequest` from `@iii-dev/helpers/http`)
- **State**: File-based SQLite via iii-engine's StateModule (`./data/state_store.db`)
- **Build**: TypeScript → ESM via tsdown, output to `dist/`
- **Test**: vitest (`npm test` excludes integration tests)
@@ -59,7 +59,9 @@ sdk.registerFunction(
### REST Endpoint Registration
```typescript
-sdk.registerFunction("api::your-endpoint", async (req: ApiRequest) => {
+import type { HttpRequest } from "@iii-dev/helpers/http";
+
+sdk.registerFunction("api::your-endpoint", async (req: HttpRequest) => {
const denied = checkAuth(req, secret);
if (denied) return denied;
const body = req.body as Record<string, unknown>;
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 340d46dd..a95daeda 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -8,10 +8,17 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
### Changed
-- **iii engine and `iii-sdk` move from 0.11.2 to 0.19.7.** Same release on both sides, as before; the CLI downloads the pinned engine into `~/.agentmemory/bin`, the bundled `docker-compose.yml` pulls `iiidev/iii:0.19.7`, and `agentmemory upgrade` pins the SDK to the version this package was built against. The deploy templates under `deploy/` install the published npm package, so their engine pair moves together with `AGENTMEMORY_VERSION` at release time. 0.19.7 is the last engine before the 0.20 SDK reorganization and carries the upstream fix that keeps HTTP routes owned by the reconnecting worker, so `/agentmemory/*` no longer answers 404 after the engine reconnects (#1013). Existing state stores load unchanged.
-- **Runtime config is re-seeded on every start.** Engines from 0.19.4 on persist each builtin worker's `config:` block into `data/configuration/<worker>.yaml` on first boot and treat that copy as the source of truth afterwards, which would have made `--port`, `--instance` and data-dir changes silently ineffective after the first run. The CLI now clears those persisted builtin entries right before it spawns the engine, so the runtime config it renders from your environment is the seed every time. If one of them cannot be removed, `agentmemory start` stops with the path instead of launching an engine that would ignore the requested ports. The bundled `docker-compose.yml` keeps the same directory on a tmpfs so container starts behave the same way.
+- **iii engine and `iii-sdk` move from 0.11.2 to 0.22.1, with `@iii-dev/helpers` 0.22.1 alongside.** Same release on both sides, as before; the CLI downloads the pinned engine into `~/.agentmemory/bin`, the bundled `docker-compose.yml` pulls `iiidev/iii:0.22.1`, and `agentmemory upgrade` pins both packages to the version this package was built against. The deploy templates under `deploy/` install the published npm package, so their engine pair moves together with `AGENTMEMORY_VERSION` at release time. 0.22.x is the last engine line before 0.23 removes the `config.yaml` worker lifecycle the CLI relies on; it carries the upstream fix that keeps HTTP routes owned by the reconnecting worker, so `/agentmemory/*` no longer answers 404 after the engine reconnects (#1013), and its Node SDK bounds WebSocket connect attempts and detects half-open sockets. The bundled configs keep the `iii-` prefixed builtin workers (`iii-http`, `iii-state`, `iii-queue`, `iii-pubsub`, `iii-cron`): on 0.22.1 the unprefixed names resolve to the standalone registry workers, which is the 0.23 migration. Existing state stores load unchanged.
+- **Runtime config is re-seeded on every start.** Engines from 0.19.4 on persist each builtin worker's `config:` block on first boot (0.22 writes `config/<worker>.yaml` next to the config file; earlier engines wrote `data/configuration/` under the working directory) and treat that copy as the source of truth afterwards, which would have made `--port`, `--instance` and data-dir changes silently ineffective after the first run. The CLI now clears those persisted entries in both locations right before it spawns the engine, so the runtime config it renders from your environment is the seed every time. If one of them cannot be removed, `agentmemory start` stops with the path instead of launching an engine that would ignore the requested ports. The bundled `docker-compose.yml` keeps the same directory on a tmpfs so container starts behave the same way.
- Dependabot no longer proposes `iii-sdk` bumps; the engine pin and the SDK version are updated together by hand.
- The deploy Dockerfiles (`deploy/fly`, `railway`, `render`, `coolify`) refuse to build when `III_VERSION` and `III_SDK_VERSION` differ, so overriding the engine tag alone can no longer produce a worker that speaks the wrong wire protocol.
+- **The pinned engine starts quiet.** The CLI spawns it with `--no-update-check` (no update or security-advisory lookups against GitHub at boot) and with iii's anonymous usage telemetry off (`III_TELEMETRY_ENABLED=false` unless you export the variable yourself); the bundled compose file passes the same flag and variable.
+- The deploy entrypoints (`deploy/*/entrypoint.sh`) generate the same observability settings as the bundled `iii-config.yaml` (`sampling_ratio: 0.1`, console log output off) instead of full sampling with console logs, the combination behind the log feedback loop fixed in 0.9.22.
+- The README section on extending agentmemory with registry workers no longer lists builtins that already ship in `iii-config.yaml`, uses the current registry names (`database` replaced `iii-database`), and says where a custom config lives (`~/.agentmemory/iii-config.yaml`).
+
+### Added
+
+- **`agentmemory console`** launches the iii web console (workers, functions, triggers, queues, traces) through the pinned engine, against the ports agentmemory resolved, one port above the viewer by default (`--console-port` overrides). Engine 0.22 ships the console as part of `iii` and downloads it on first use, so the "install iii console?" prompt on start and the `skipConsoleInstall` preference are gone; the ready panel now points at the command instead.
### Fixed
diff --git a/INSTALL_FOR_AGENTS.md b/INSTALL_FOR_AGENTS.md
index b10e9934..6bb1d111 100644
--- a/INSTALL_FOR_AGENTS.md
+++ b/INSTALL_FOR_AGENTS.md
@@ -4,7 +4,7 @@ You are a coding agent. Follow this runbook top to bottom to install agentmemory
## What you are installing
-agentmemory is a local memory server for coding agents. It exposes a REST API and MCP HTTP routes on port 3111, streams on 3112, a viewer on 3113, and connects its worker to iii-engine on 49134. It is built on the iii engine, which agentmemory manages as a pinned v0.19.7 binary under `~/.agentmemory/bin` on macOS/Linux or `%USERPROFILE%\.agentmemory\bin` on Windows.
+agentmemory is a local memory server for coding agents. It exposes a REST API and MCP HTTP routes on port 3111, streams on 3112, a viewer on 3113, and connects its worker to iii-engine on 49134. It is built on the iii engine, which agentmemory manages as a pinned v0.22.1 binary under `~/.agentmemory/bin` on macOS/Linux or `%USERPROFILE%\.agentmemory\bin` on Windows.
Configuration and the managed iii binary live under `~/.agentmemory`. Persistent iii state uses the platform data directory: `~/Library/Application Support/agentmemory` on macOS, `$XDG_DATA_HOME/agentmemory` or `~/.local/share/agentmemory` on Linux, and `%APPDATA%\agentmemory` on Windows. Override it with `--data-dir <path>` or `AGENTMEMORY_DATA_DIR`; use the same override on every restart. For instance 0, an existing `./data/state_store.db` or `./data/iii-config.yaml` takes precedence over the platform default, while an explicit flag or environment override still wins. Native and Docker starts use the same resolved host data directory.
@@ -14,7 +14,7 @@ Default keyless mode needs no API key or cloud account and disables vector embed
- Node.js >= 20 with npm and npx. Check with `node -v`, `npm -v`, and `npx -v`.
- macOS/Linux automatic iii installation also requires `curl`, a POSIX `sh`, and `tar`. Check with `command -v curl sh tar`. Minimal images such as `node:20-slim` may not include them.
-- Windows: WSL2 follows the Linux path above. Native Windows requires a manually downloaded, pinned iii-engine v0.19.7 `iii.exe`, or Docker Desktop; the CLI does not auto-extract the Windows ZIP. Native automated `connect` supports only `copilot-cli`. Other Windows agents need manual MCP configuration; WSL `connect` applies only to agents installed in that same WSL environment.
+- Windows: WSL2 follows the Linux path above. Native Windows requires a manually downloaded, pinned iii-engine v0.22.1 `iii.exe`, or Docker Desktop; the CLI does not auto-extract the Windows ZIP. Native automated `connect` supports only `copilot-cli`. Other Windows agents need manual MCP configuration; WSL `connect` applies only to agents installed in that same WSL environment.
- Ports 3111 (REST), 3112 (streams), 3113 (viewer), and 49134 (engine) free. If any are taken, stop whatever is using them before starting (see Troubleshooting).
## Running non-interactively
@@ -38,12 +38,12 @@ For native Windows, install the engine before continuing:
```powershell
# Download the archive that matches your CPU from the pinned release:
-# https://github.com/iii-hq/iii/releases/tag/iii%2Fv0.19.7
+# https://github.com/iii-hq/iii/releases/tag/iii%2Fv0.22.1
# Extract iii.exe to $HOME\.agentmemory\bin\iii.exe, then verify the pin:
& "$HOME\.agentmemory\bin\iii.exe" --version
```
-Expect: exactly `0.19.7`. Do not install the latest unpinned iii release. Alternatively, use WSL2 or start Docker Desktop and choose the Docker path when agentmemory starts.
+Expect: exactly `0.22.1`. Do not install the latest unpinned iii release. Alternatively, use WSL2 or start Docker Desktop and choose the Docker path when agentmemory starts.
## 2. Start the server
@@ -61,7 +61,7 @@ npx -y @agentmemory/agentmemory@latest --data-dir /absolute/path/to/agentmemory-
Docker bind-mounts that same resolved host directory at `/data`. For a second isolated daemon, add `--instance 1`; it stores data and lifecycle metadata under `instance-1` and defaults to ports 3211, 3212, 3213, and 49234. Do not use `--port` alone for concurrent daemons: it changes the ports but keeps instance 0's canonical lifecycle ownership. Use `--instance` for isolation.
-Expect: iii-engine v0.19.7 starts, the agentmemory worker registers with iii, and the ready panel lists REST, viewer, streams, and engine addresses. First boot can take longer while the engine binary is downloaded.
+Expect: iii-engine v0.22.1 starts, the agentmemory worker registers with iii, and the ready panel lists REST, viewer, streams, and engine addresses. First boot can take longer while the engine binary is downloaded.
## 3. Validate the server and all four ports
@@ -202,9 +202,9 @@ The MCP server exposes 54 tools by default (`--tools all`). Use `--tools core` (
- Server starts but `livez` never returns 200: re-run with `npx -y @agentmemory/agentmemory@latest --verbose` to see engine stderr.
- `The engine process started but the REST API never responded.`: inspect all four derived ports, confirm the pinned iii process stayed alive, and use `--verbose` for captured engine stderr.
- Engine version warning on start: harmless. agentmemory uses its own pinned engine in `~/.agentmemory/bin` regardless of any `iii` on `PATH`. Set `AGENTMEMORY_III_VERSION` only to override deliberately.
-- "engine conflict" / another iii engine already running: if a different iii version is already serving the port, agentmemory will not adopt it. Stop that engine (`npx -y @agentmemory/agentmemory@latest stop --force`, or however you started it), then rerun the canonical command. Its private v0.19.7 binary does not replace a user-managed `iii` on `PATH`.
+- "engine conflict" / another iii engine already running: if a different iii version is already serving the port, agentmemory will not adopt it. Stop that engine (`npx -y @agentmemory/agentmemory@latest stop --force`, or however you started it), then rerun the canonical command. Its private v0.22.1 binary does not replace a user-managed `iii` on `PATH`.
- Only 7 tools visible in the agent: the MCP shim is in local fallback because it could not reach a server. Start `npx -y @agentmemory/agentmemory@latest`, ensure `AGENTMEMORY_URL` points at it (default `http://localhost:3111`), then reload MCP.
-- Native Windows: the CLI does not auto-extract the ZIP. Install the pinned v0.19.7 `iii.exe` manually, use WSL2, or run with Docker Desktop and `AGENTMEMORY_USE_DOCKER=1`. Automated `connect` supports only `copilot-cli`; configure other native agents manually.
+- Native Windows: the CLI does not auto-extract the ZIP. Install the pinned v0.22.1 `iii.exe` manually, use WSL2, or run with Docker Desktop and `AGENTMEMORY_USE_DOCKER=1`. Automated `connect` supports only `copilot-cli`; configure other native agents manually.
- Semantic demo query returns zero hits: this is expected with vectors disabled in default keyless mode. Set `EMBEDDING_PROVIDER=local`, restart, allow the first model download to complete, and rerun the demo.
## Report success
@@ -212,7 +212,7 @@ The MCP server exposes 54 tools by default (`--tools all`). Use `--tools core` (
Report back to the user:
- agentmemory installed, version, and the server running on port 3111
-- iii-engine v0.19.7 running, the selected platform data directory, and all four ports accounted for
+- iii-engine v0.22.1 running, the selected platform data directory, and all four ports accounted for
- which agent was wired via `agentmemory connect`, and the tool count the agent now sees
- the save and recall round-trip returned the probe memory after a full stop/start
- the viewer is available at `http://localhost:3113`
diff --git a/README.md b/README.md
index 730342b2..8c376ddd 100644
--- a/README.md
+++ b/README.md
@@ -79,7 +79,7 @@ Requirements:
- Node.js 20 or newer with npm and npx (`node -v`, `npm -v`, and `npx -v`).
- macOS/Linux automatic iii-engine installation also needs `curl`, a POSIX `sh`, and `tar`. Minimal images such as `node:20-slim` may not include them.
-- Native Windows requires the pinned iii-engine v0.19.7 `iii.exe` to be installed manually. WSL2 or Docker Desktop are the other supported paths.
+- Native Windows requires the pinned iii-engine v0.22.1 `iii.exe` to be installed manually. WSL2 or Docker Desktop are the other supported paths.
Canonical fresh-install command:
@@ -111,7 +111,7 @@ Wire more agents any time with `agentmemory connect <agent>` — 20 adapters lis
<details>
<summary><strong>Windows</strong></summary>
-The fast path is WSL2. Native Windows engine setup requires the pinned v0.19.7 ZIP to be downloaded and `iii.exe` extracted manually; the CLI does not auto-extract it. Docker Desktop is also supported. See the [Windows notes](#windows) for the step-by-step.
+The fast path is WSL2. Native Windows engine setup requires the pinned v0.22.1 ZIP to be downloaded and `iii.exe` extracted manually; the CLI does not auto-extract it. Docker Desktop is also supported. See the [Windows notes](#windows) for the step-by-step.
</details>
@@ -136,7 +136,7 @@ npx caches per version. Force the latest with `npx -y @agentmemory/agentmemory@l
<details>
<summary><strong>Already running your own iii engine</strong></summary>
-agentmemory pins iii-engine v0.19.7 and won't attach to a different version (the worker can't speak another engine's protocol). Stop the other engine, then run `npx -y @agentmemory/agentmemory@latest`. It installs and runs the pinned v0.19.7 in `~/.agentmemory/bin`, leaving your own `iii` untouched.
+agentmemory pins iii-engine v0.22.1 and won't attach to a different version (the worker can't speak another engine's protocol). Stop the other engine, then run `npx -y @agentmemory/agentmemory@latest`. It installs and runs the pinned v0.22.1 in `~/.agentmemory/bin`, leaving your own `iii` untouched.
</details>
@@ -496,7 +496,7 @@ None of these auto-capture from coding-agent hooks, ship a local-first viewer, o
<h2 id="quick-start"><picture><source media="(prefers-color-scheme: dark)" srcset="assets/tags/light/section-quickstart.svg"><img src="assets/tags/section-quickstart.svg" alt="Quick Start" height="32" /></picture></h2>
-Compatibility: this release targets `iii-sdk` 0.19.7 and pins iii-engine v0.19.7.
+Compatibility: this release targets `iii-sdk` 0.22.1 and pins iii-engine v0.22.1.
### Try it in 30 seconds
@@ -575,7 +575,7 @@ Use the maintenance command when you intentionally want to update your local run
npx -y @agentmemory/agentmemory@latest upgrade
```
-Warning: this command mutates the current workspace/runtime. It can update JavaScript dependencies and pull the pinned `iiidev/iii:0.19.7` Docker image. It never installs an unpinned or newer iii engine.
+Warning: this command mutates the current workspace/runtime. It can update JavaScript dependencies and pull the pinned `iiidev/iii:0.22.1` Docker image. It never installs an unpinned or newer iii engine.
Implementation details live in `src/cli.ts` (see `runUpgrade` around the `src/cli.ts:544-595` region).
@@ -793,28 +793,28 @@ npm install && npm run build && npm start
This starts agentmemory with a local `iii-engine` if the pinned binary is already installed, or uses Docker Compose when selected. REST, streams, and the viewer bind to `127.0.0.1` by default. The automatic macOS/Linux binary path requires `curl`, a POSIX `sh`, and `tar`.
-Install `iii-engine` manually. **agentmemory currently pins `iii-engine` to `v0.19.7`**, the same release as its `iii-sdk` dependency; the worker speaks that engine's wire protocol, and 0.20.0 reorganized the SDK surface, so the two move together in agentmemory releases. Override with `AGENTMEMORY_III_VERSION=<version>` if you run your own engine and know it matches.
+Install `iii-engine` manually. **agentmemory currently pins `iii-engine` to `v0.22.1`**, the same release as its `iii-sdk` dependency; the worker speaks that engine's wire protocol, and 0.20.0 reorganized the SDK surface, so the two move together in agentmemory releases. Override with `AGENTMEMORY_III_VERSION=<version>` if you run your own engine and know it matches.
-- **macOS arm64:** `mkdir -p ~/.local/bin && curl -fsSL https://github.com/iii-hq/iii/releases/download/iii/v0.19.7/iii-aarch64-apple-darwin.tar.gz | tar -xz -C ~/.local/bin && chmod +x ~/.local/bin/iii`
+- **macOS arm64:** `mkdir -p ~/.local/bin && curl -fsSL https://github.com/iii-hq/iii/releases/download/iii/v0.22.1/iii-aarch64-apple-darwin.tar.gz | tar -xz -C ~/.local/bin && chmod +x ~/.local/bin/iii`
- **macOS x64:** swap `aarch64-apple-darwin` for `x86_64-apple-darwin`
- **Linux x64:** swap for `x86_64-unknown-linux-gnu`
- **Linux arm64:** swap for `aarch64-unknown-linux-gnu`
-- **Windows:** download `iii-x86_64-pc-windows-msvc.zip` from [iii-hq/iii releases v0.19.7](https://github.com/iii-hq/iii/releases/tag/iii%2Fv0.19.7) and extract `iii.exe` to `%USERPROFILE%\.agentmemory\bin\iii.exe`
+- **Windows:** download `iii-x86_64-pc-windows-msvc.zip` from [iii-hq/iii releases v0.22.1](https://github.com/iii-hq/iii/releases/tag/iii%2Fv0.22.1) and extract `iii.exe` to `%USERPROFILE%\.agentmemory\bin\iii.exe`
-Or use Docker (the bundled `docker-compose.yml` pulls `iiidev/iii:0.19.7`). Full docs: [iii.dev/docs](https://iii.dev/docs).
+Or use Docker (the bundled `docker-compose.yml` pulls `iiidev/iii:0.22.1`). Full docs: [iii.dev/docs](https://iii.dev/docs).
### Windows
-agentmemory runs on Windows 10/11, but the Node.js package alone isn't enough; you also need the pinned iii-engine v0.19.7 runtime as a background process. The CLI does not auto-extract the Windows ZIP, so native Windows users must install `iii.exe` manually, use WSL2, or choose Docker Desktop.
+agentmemory runs on Windows 10/11, but the Node.js package alone isn't enough; you also need the pinned iii-engine v0.22.1 runtime as a background process. The CLI does not auto-extract the Windows ZIP, so native Windows users must install `iii.exe` manually, use WSL2, or choose Docker Desktop.
Native Windows automated MCP wiring supports only `agentmemory connect copilot-cli`. For Claude Code, Codex, Cursor, and every other native Windows agent, copy the manual MCP block from [Other agents](#other-agents) into that agent's Windows config. Running `connect` in WSL is appropriate only when the target agent is also installed in the same WSL environment; it does not edit a Windows-host agent's configuration.
**Option A: prebuilt Windows binary (recommended)**
```powershell
-# 1. Open https://github.com/iii-hq/iii/releases/tag/iii%2Fv0.19.7 in your browser
+# 1. Open https://github.com/iii-hq/iii/releases/tag/iii%2Fv0.22.1 in your browser
# (agentmemory pins the engine to the same release as its iii-sdk;
-# v0.19.7 is the current pair)
+# v0.22.1 is the current pair)
# 2. Download iii-x86_64-pc-windows-msvc.zip
# (or iii-aarch64-pc-windows-msvc.zip if you're on an ARM machine)
# 3. Extract iii.exe to agentmemory's private engine directory:
@@ -822,7 +822,7 @@ New-Item -ItemType Directory -Force "$HOME\.agentmemory\bin"
# Copy iii.exe to $HOME\.agentmemory\bin\iii.exe
# 4. Verify:
& "$HOME\.agentmemory\bin\iii.exe" --version
-# Should print: 0.19.7
+# Should print: 0.22.1
# 5. Then run agentmemory as usual:
npx -y @agentmemory/agentmemory@latest
@@ -855,7 +855,7 @@ npx -y @agentmemory/mcp
| Port conflict | `netstat -ano \| findstr :3111` to see what's bound, then kill it or use `--port <N>` |
| Docker fallback skipped even though Docker is installed | Make sure Docker Desktop is actually running (system tray icon) |
-> Note: the iii **engine** is a prebuilt binary, not a cargo crate, so don't try to `cargo install` it. (The iii **SDKs** are published on crates.io, npm, and PyPI, but agentmemory doesn't need them.) Supported engine install methods are all pinned to v0.19.7: the prebuilt binary above, agentmemory's macOS/Linux auto-install path (`curl`, POSIX `sh`, and `tar` required), and the Docker image `iiidev/iii:0.19.7`. A bare upstream `install.sh | sh` installs the latest engine, which agentmemory does not support. Use `npx -y @agentmemory/agentmemory@latest`; on macOS/Linux it fetches the pinned engine into `~/.agentmemory/bin`.
+> Note: the iii **engine** is a prebuilt binary, not a cargo crate, so don't try to `cargo install` it. (The iii **SDKs** are published on crates.io, npm, and PyPI, but agentmemory doesn't need them.) Supported engine install methods are all pinned to v0.22.1: the prebuilt binary above, agentmemory's macOS/Linux auto-install path (`curl`, POSIX `sh`, and `tar` required), and the Docker image `iiidev/iii:0.22.1`. A bare upstream `install.sh | sh` installs the latest engine, which agentmemory does not support. Use `npx -y @agentmemory/agentmemory@latest`; on macOS/Linux it fetches the pinned engine into `~/.agentmemory/bin`.
---
@@ -1210,22 +1210,20 @@ agentmemory ships this for free because every function call and trigger fires th
<em>Workers page: every connected worker, including agentmemory itself, with PID, function count, runtime, and last-seen.</em>
</p>
-**Already installed.** The console ships with `iii`; no separate installer.
+**Already installed.** The console ships with the pinned `iii` engine (0.22+); nothing separate to install. The first launch downloads the console binary next to the engine.
**Launch alongside agentmemory:**
```bash
-# agentmemory viewer holds port 3113, so run the console on 3114.
-# Engine REST (3111), WebSocket (3112), and bridge (49134) defaults match agentmemory.
-iii console --port 3114
+agentmemory console
```
-Then open `http://localhost:3114`. Add `--enable-flow` for the experimental architecture-graph page.
+This runs the pinned engine's `iii console` against the ports agentmemory resolved (REST, streams, bridge) and serves it one port above the viewer, `http://localhost:3114` by default. `--console-port N` picks another port; `--port` and `--instance` select the agentmemory instance the same way they do for `stop`; any other flag is passed through, for example `--enable-flow` for the experimental architecture-graph page.
-Override engine endpoints only if you've moved them:
+The same thing by hand, useful when `agentmemory` is not on PATH:
```bash
-iii console --port 3114 \
+~/.agentmemory/bin/iii console --port 3114 \
--engine-port 3111 \
--ws-port 3112 \
--bridge-port 49134
@@ -1254,7 +1252,7 @@ iii console --port 3114 \
**Traces are already on:**
-`iii-config.yaml` ships with the `iii-observability` worker enabled (`exporter: memory`, `sampling_ratio: 1.0`, metrics + logs). No extra config needed; the moment agentmemory starts, every memory operation emits a trace span and a structured log the console can read.
+`iii-config.yaml` ships with the `iii-observability` worker enabled (`exporter: memory`, `sampling_ratio: 0.1`, metrics + logs). No extra config needed; the moment agentmemory starts, every memory operation emits a structured log the console can read, and one in ten of them (`sampling_ratio: 0.1`) also emits a trace span.
If you want to export to Jaeger/Honeycomb/Grafana Tempo instead, change `exporter: memory` to `exporter: otlp` and set the collector endpoint per iii's observability docs.
@@ -1268,30 +1266,26 @@ agentmemory is **already a running [iii](https://iii.dev) instance**. Three prim
That means one more command extends agentmemory with an entire new capability.
-### Extend agentmemory with one command
+### Extend agentmemory with more workers
-```bash
-iii worker add iii-pubsub # fan memory writes out to every connected instance
-iii worker add iii-cron # scheduled consolidation, decay sweeps, snapshot rotation
-iii worker add iii-queue # durable retries for embedding + compression jobs
-iii worker add iii-observability # OTEL traces on every memory op (default on)
-iii worker add iii-sandbox # run recalled code inside an isolated microVM
-iii worker add iii-database # swap in a SQL-backed state adapter
-iii worker add mcp # generic MCP host alongside the agentmemory MCP
-```
+The builtins agentmemory needs are already in `iii-config.yaml` and boot with it: `iii-state` (KV), `iii-queue` (durable retries for the event subscribers), `iii-pubsub`, `iii-cron`, `iii-stream`, and `iii-observability` (OTEL traces, metrics and logs on every function). Anything else from the [iii worker registry](https://workers.iii.dev) plugs into the same engine: copy `iii-config.yaml` to `~/.agentmemory/iii-config.yaml` (the CLI prefers that file over the bundled one and still renders ports and data paths into it), add the entry, install the worker runtime once with `~/.agentmemory/bin/iii update worker`, and restart agentmemory.
-Each `iii worker add` registers new functions and triggers into the same engine agentmemory is already running on. The viewer and console pick them up immediately: no reload, no new integration, no new container.
+```yaml
+workers:
+ # ...the bundled entries...
+ - name: database # SQL-backed state adapter when you outgrow the KV defaults
+ - name: iii-sandbox # run code that came out of memory_recall inside a throwaway VM
+ - name: mcp # extra MCP servers next to agentmemory's, same engine
+```
-| `iii worker add` | What you get on top of agentmemory |
+| Worker | What you get on top of agentmemory |
|---|---|
-| [`iii-pubsub`](https://workers.iii.dev/workers/iii-pubsub) | Multi-instance memory: every `remember` fans out, every `search` reads the union |
-| [`iii-cron`](https://workers.iii.dev/workers/iii-cron) | Scheduled lifecycle: nightly consolidation, weekly snapshots, decay on a fixed clock |
-| [`iii-queue`](https://workers.iii.dev/workers/iii-queue) | Durable retries: failed embedding + compression jobs survive restart, no lost observations |
-| [`iii-observability`](https://workers.iii.dev/workers/iii-observability) | OTEL traces, metrics, logs on every function, wired in `iii-config.yaml` from day one |
+| [`database`](https://workers.iii.dev/workers/database) | SQL-backed state adapter when you outgrow the in-memory KV defaults |
| [`iii-sandbox`](https://workers.iii.dev/workers/iii-sandbox) | Code that came out of `memory_recall` runs inside a throwaway VM, not your shell |
-| [`iii-database`](https://workers.iii.dev/workers/iii-database) | SQL-backed state adapter when you outgrow the in-memory KV defaults |
| [`mcp`](https://workers.iii.dev/workers/mcp) | Stand up extra MCP servers next to agentmemory's, share the same engine |
+On engine 0.22.x keep the `iii-` prefixed names for the builtins above; the unprefixed `http`, `state`, `queue`, `pubsub` and `cron` entries are the standalone registry workers agentmemory moves to with the 0.23 migration.
+
Full registry: [workers.iii.dev](https://workers.iii.dev). Every worker there composes through the same primitives agentmemory uses, and the agentmemory you already have is one of them.
### What iii replaces
@@ -1433,6 +1427,8 @@ agentmemory + iii-engine bind four ports by default. If a restart fails with `po
`--port <N>` changes the REST anchor and derives streams `N+1`, viewer `N+2`, and engine WebSocket `N+46023` only where the corresponding explicit port or URL above is unset. It does not create an isolated lifecycle namespace. Use `--instance 1` for a second daemon; it uses anchor 3211, defaults to `3211/3212/3213/49234`, and receives a separate `instance-1` data and lifecycle directory. Instances 1 through 50 follow the same pattern.
+The pinned engine starts with `--no-update-check` (no update or security-advisory lookups against GitHub at boot) and with iii's anonymous usage telemetry off: agentmemory sets `III_TELEMETRY_ENABLED=false` for the engine it spawns unless you export the variable yourself, and the bundled compose file does the same.
+
Stale-process cleanup when ports stay bound after a crashed run:
```bash
@@ -1546,6 +1542,9 @@ Create `~/.agentmemory/.env`:
# Ports (defaults: 3111 API, 3113 viewer)
# III_REST_PORT=3111
+# Engine usage telemetry (iii). Off unless you set it; true opts in.
+# III_TELEMETRY_ENABLED=false
+
# Features
# AGENTMEMORY_AUTO_COMPRESS=false # OFF by default. Requires an LLM
# provider as well. When both are on,
@@ -1647,7 +1646,7 @@ npm test # 1,674 tests
npm run test:integration # API tests (requires running services)
```
-**Prerequisites:** Node.js >= 20 with npm/npx; [iii-engine](https://iii.dev/docs) v0.19.7 or Docker. The macOS/Linux automatic engine install also requires `curl`, a POSIX `sh`, and `tar`; native Windows uses the manual pinned `iii.exe`, WSL2, or Docker Desktop.
+**Prerequisites:** Node.js >= 20 with npm/npx; [iii-engine](https://iii.dev/docs) v0.22.1 or Docker. The macOS/Linux automatic engine install also requires `curl`, a POSIX `sh`, and `tar`; native Windows uses the manual pinned `iii.exe`, WSL2, or Docker Desktop.
<h2 id="license"><picture><source media="(prefers-color-scheme: dark)" srcset="assets/tags/light/section-license.svg"><img src="assets/tags/section-license.svg" alt="License" height="32" /></picture></h2>
diff --git a/READMEs/README.de-DE.md b/READMEs/README.de-DE.md
index 3ea4fc9a..02631d18 100644
--- a/READMEs/README.de-DE.md
+++ b/READMEs/README.de-DE.md
@@ -124,7 +124,7 @@ npx cached pro Version. Erzwingen Sie die neueste mit `npx -y @agentmemory/agent
<details>
<summary><strong>Sie betreiben bereits eine eigene iii-Engine</strong></summary>
-agentmemory pinnt iii-engine v0.19.7 und verbindet sich nicht mit einer anderen Version (der Worker kann das Protokoll einer anderen Engine nicht sprechen). Stoppen Sie die andere Engine und führen Sie dann `npx -y @agentmemory/agentmemory@latest` aus. Es installiert und startet das gepinnte v0.19.7 in `~/.agentmemory/bin` und lässt Ihre eigene `iii` unangetastet.
+agentmemory pinnt iii-engine v0.22.1 und verbindet sich nicht mit einer anderen Version (der Worker kann das Protokoll einer anderen Engine nicht sprechen). Stoppen Sie die andere Engine und führen Sie dann `npx -y @agentmemory/agentmemory@latest` aus. Es installiert und startet das gepinnte v0.22.1 in `~/.agentmemory/bin` und lässt Ihre eigene `iii` unangetastet.
</details>
@@ -463,7 +463,7 @@ Keines davon erfasst automatisch aus Coding-Agent-Hooks, liefert einen local-fir
<h2 id="quick-start"><picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/section-quickstart.svg"><img src="../assets/tags/section-quickstart.svg" alt="Schnellstart" height="32" /></picture></h2>
-Kompatibilität: Diese Version zielt auf `iii-sdk` 0.19.7 und pinnt iii-engine v0.19.7.
+Kompatibilität: Diese Version zielt auf `iii-sdk` 0.22.1 und pinnt iii-engine v0.22.1.
### In 30 Sekunden ausprobieren
@@ -517,7 +517,7 @@ Verwenden Sie den Wartungsbefehl, wenn Sie Ihr lokales Runtime bewusst aktualisi
npx @agentmemory/agentmemory upgrade
```
-Achtung: Dieser Befehl verändert den aktuellen Workspace/Runtime. Er kann JavaScript-Abhängigkeiten aktualisieren und das gepinnte Docker-Image `iiidev/iii:0.19.7` ziehen. Er installiert niemals eine ungepinnte oder neuere iii-Engine.
+Achtung: Dieser Befehl verändert den aktuellen Workspace/Runtime. Er kann JavaScript-Abhängigkeiten aktualisieren und das gepinnte Docker-Image `iiidev/iii:0.22.1` ziehen. Er installiert niemals eine ungepinnte oder neuere iii-Engine.
Implementierungsdetails in `src/cli.ts` (siehe `runUpgrade` rund um den Bereich `src/cli.ts:544-595`).
@@ -721,15 +721,15 @@ npm install && npm run build && npm start
Das startet agentmemory mit einer lokalen `iii-engine`, falls `iii` bereits installiert ist, oder fällt auf Docker Compose zurück, falls Docker vorhanden ist. REST, Streams und der Viewer binden sich standardmäßig an `127.0.0.1`.
-`iii-engine` manuell installieren. **agentmemory pinnt `iii-engine` derzeit auf `v0.19.7`**, dieselbe Version wie seine `iii-sdk`-Abhängigkeit; der Worker spricht das Wire-Protokoll genau dieser Engine, und 0.20.0 hat die SDK-Oberfläche neu organisiert, daher werden beide in agentmemory-Releases gemeinsam angehoben. Mit `AGENTMEMORY_III_VERSION=<version>` überschreiben, wenn du eine eigene Engine betreibst und weißt, dass sie passt.
+`iii-engine` manuell installieren. **agentmemory pinnt `iii-engine` derzeit auf `v0.22.1`**, dieselbe Version wie seine `iii-sdk`-Abhängigkeit; der Worker spricht das Wire-Protokoll genau dieser Engine, und 0.20.0 hat die SDK-Oberfläche neu organisiert, daher werden beide in agentmemory-Releases gemeinsam angehoben. Mit `AGENTMEMORY_III_VERSION=<version>` überschreiben, wenn du eine eigene Engine betreibst und weißt, dass sie passt.
-- **macOS arm64:** `mkdir -p ~/.local/bin && curl -fsSL https://github.com/iii-hq/iii/releases/download/iii/v0.19.7/iii-aarch64-apple-darwin.tar.gz | tar -xz -C ~/.local/bin && chmod +x ~/.local/bin/iii`
+- **macOS arm64:** `mkdir -p ~/.local/bin && curl -fsSL https://github.com/iii-hq/iii/releases/download/iii/v0.22.1/iii-aarch64-apple-darwin.tar.gz | tar -xz -C ~/.local/bin && chmod +x ~/.local/bin/iii`
- **macOS x64:** `aarch64-apple-darwin` durch `x86_64-apple-darwin` ersetzen
- **Linux x64:** durch `x86_64-unknown-linux-gnu` ersetzen
- **Linux arm64:** durch `aarch64-unknown-linux-gnu` ersetzen
-- **Windows:** `iii-x86_64-pc-windows-msvc.zip` von [iii-hq/iii releases v0.19.7](https://github.com/iii-hq/iii/releases/tag/iii%2Fv0.19.7) herunterladen, `iii.exe` extrahieren, zum PATH hinzufügen
+- **Windows:** `iii-x86_64-pc-windows-msvc.zip` von [iii-hq/iii releases v0.22.1](https://github.com/iii-hq/iii/releases/tag/iii%2Fv0.22.1) herunterladen, `iii.exe` extrahieren, zum PATH hinzufügen
-Oder Docker verwenden (die mitgelieferte `docker-compose.yml` zieht `iiidev/iii:0.19.7`). Vollständige Doku: [iii.dev/docs](https://iii.dev/docs).
+Oder Docker verwenden (die mitgelieferte `docker-compose.yml` zieht `iiidev/iii:0.22.1`). Vollständige Doku: [iii.dev/docs](https://iii.dev/docs).
### Windows
@@ -738,9 +738,9 @@ agentmemory läuft auf Windows 10/11, aber das Node.js-Paket allein genügt nich
**Option A: vorgebautes Windows-Binary (empfohlen)**
```powershell
-# 1. Open https://github.com/iii-hq/iii/releases/tag/iii%2Fv0.19.7 in your browser
+# 1. Open https://github.com/iii-hq/iii/releases/tag/iii%2Fv0.22.1 in your browser
# (agentmemory pins the engine to the same release as its iii-sdk;
-# v0.19.7 is the current pair)
+# v0.22.1 is the current pair)
# 2. Download iii-x86_64-pc-windows-msvc.zip
# (or iii-aarch64-pc-windows-msvc.zip if you're on an ARM machine)
# 3. Extract iii.exe somewhere on PATH, or place it at:
@@ -748,7 +748,7 @@ agentmemory läuft auf Windows 10/11, aber das Node.js-Paket allein genügt nich
# (agentmemory checks that location automatically)
# 4. Verify:
iii --version
-# Should print: 0.19.7
+# Should print: 0.22.1
# 5. Then run agentmemory as usual:
npx -y @agentmemory/agentmemory
@@ -780,7 +780,7 @@ npx -y @agentmemory/mcp
| Port-Konflikt | `netstat -ano \| findstr :3111`, um zu sehen, was gebunden ist, dann beenden oder `--port <N>` verwenden |
| Docker-Fallback wird übersprungen, obwohl Docker installiert ist | Stellen Sie sicher, dass Docker Desktop tatsächlich läuft (Taskleisten-Icon) |
-> Hinweis: Die iii-**Engine** ist ein vorgebautes Binary, kein Cargo-Crate, versuche also nicht, sie per `cargo install` zu installieren. (Die iii-**SDKs** sind auf crates.io, npm und PyPI veröffentlicht, aber agentmemory benötigt sie nicht.) Unterstützte Engine-Installationsmethoden, alle auf v0.19.7 gepinnt: das vorgebaute v0.19.7-Binary oben, das Upstream-`sh`-Installationsskript **mit dem Versions-Pin** `curl -fsSL https://install.iii.dev/iii/main/install.sh | VERSION=0.19.7 sh` (macOS/Linux) und das Docker-Image `iiidev/iii:0.19.7`. Ein bloßes `install.sh | sh` installiert die **neueste** Engine, die agentmemory nicht unterstützt; übergib immer `VERSION=0.19.7`. Am einfachsten von allen: Führe einfach `npx @agentmemory/agentmemory` aus, das die gepinnte Engine für dich nach `~/.agentmemory/bin` holt.
+> Hinweis: Die iii-**Engine** ist ein vorgebautes Binary, kein Cargo-Crate, versuche also nicht, sie per `cargo install` zu installieren. (Die iii-**SDKs** sind auf crates.io, npm und PyPI veröffentlicht, aber agentmemory benötigt sie nicht.) Unterstützte Engine-Installationsmethoden, alle auf v0.22.1 gepinnt: das vorgebaute v0.22.1-Binary oben, das Upstream-`sh`-Installationsskript **mit dem Versions-Pin** `curl -fsSL https://install.iii.dev/iii/main/install.sh | VERSION=0.22.1 sh` (macOS/Linux) und das Docker-Image `iiidev/iii:0.22.1`. Ein bloßes `install.sh | sh` installiert die **neueste** Engine, die agentmemory nicht unterstützt; übergib immer `VERSION=0.22.1`. Am einfachsten von allen: Führe einfach `npx @agentmemory/agentmemory` aus, das die gepinnte Engine für dich nach `~/.agentmemory/bin` holt.
---
@@ -1176,7 +1176,7 @@ iii console --port 3114 \
**Traces sind bereits aktiv:**
-`iii-config.yaml` wird mit aktiviertem `iii-observability`-Worker ausgeliefert (`exporter: memory`, `sampling_ratio: 1.0`, Metriken + Logs). Keine zusätzliche Konfig nötig; in dem Moment, in dem agentmemory startet, emittiert jede Memory-Operation einen Trace-Span und ein strukturiertes Log, das die Console lesen kann.
+`iii-config.yaml` wird mit aktiviertem `iii-observability`-Worker ausgeliefert (`exporter: memory`, `sampling_ratio: 0.1`, Metriken + Logs). Keine zusätzliche Konfig nötig; in dem Moment, in dem agentmemory startet, emittiert jede Memory-Operation ein strukturiertes Log, das die Console lesen kann, und jede zehnte (`sampling_ratio: 0.1`) zusätzlich einen Trace-Span.
Wenn Sie stattdessen zu Jaeger/Honeycomb/Grafana Tempo exportieren wollen, ändern Sie `exporter: memory` zu `exporter: otlp` und setzen den Collector-Endpunkt gemäß der iii-Observability-Doku.
@@ -1198,7 +1198,7 @@ iii worker add iii-cron # scheduled consolidation, decay sweeps, snap
iii worker add iii-queue # durable retries for embedding + compression jobs
iii worker add iii-observability # OTEL traces on every memory op (default on)
iii worker add iii-sandbox # run recalled code inside an isolated microVM
-iii worker add iii-database # swap in a SQL-backed state adapter
+iii worker add database # swap in a SQL-backed state adapter
iii worker add mcp # generic MCP host alongside the agentmemory MCP
```
@@ -1211,7 +1211,7 @@ Jedes `iii worker add` registriert neue Funktionen und Trigger im selben Engine,
| [`iii-queue`](https://workers.iii.dev/workers/iii-queue) | Durable Retries: fehlgeschlagene Embedding-/Kompressions-Jobs überleben den Neustart, keine verlorenen Beobachtungen |
| [`iii-observability`](https://workers.iii.dev/workers/iii-observability) | OTEL-Traces, Metriken, Logs auf jeder Funktion, in `iii-config.yaml` ab dem ersten Tag verdrahtet |
| [`iii-sandbox`](https://workers.iii.dev/workers/iii-sandbox) | Code, der aus `memory_recall` kommt, läuft in einer wegwerf-VM, nicht in Ihrer Shell |
-| [`iii-database`](https://workers.iii.dev/workers/iii-database) | SQL-gestützter State-Adapter, wenn Sie die In-Memory-KV-Voreinstellungen überwachsen |
+| [`database`](https://workers.iii.dev/workers/database) | SQL-gestützter State-Adapter, wenn Sie die In-Memory-KV-Voreinstellungen überwachsen |
| [`mcp`](https://workers.iii.dev/workers/mcp) | Zusätzliche MCP-Server neben dem von agentmemory aufstellen, die sich denselben Engine teilen |
Volle Registry: [workers.iii.dev](https://workers.iii.dev). Jeder Worker dort komponiert sich über dieselben Primitiven wie agentmemory, und das agentmemory, das Sie bereits haben, ist einer davon.
diff --git a/READMEs/README.es-ES.md b/READMEs/README.es-ES.md
index dfb70309..a01a1618 100644
--- a/READMEs/README.es-ES.md
+++ b/READMEs/README.es-ES.md
@@ -124,7 +124,7 @@ npx cachea por versión. Fuerza la última con `npx -y @agentmemory/agentmemory@
<details>
<summary><strong>Ya ejecutas tu propio engine iii</strong></summary>
-agentmemory fija iii-engine a v0.19.7 y no se conectará a una versión distinta (el worker no puede hablar el protocolo de otro engine). Detén el otro engine y ejecuta `npx -y @agentmemory/agentmemory@latest`. Instala y ejecuta la v0.19.7 fijada en `~/.agentmemory/bin`, dejando tu propio `iii` intacto.
+agentmemory fija iii-engine a v0.22.1 y no se conectará a una versión distinta (el worker no puede hablar el protocolo de otro engine). Detén el otro engine y ejecuta `npx -y @agentmemory/agentmemory@latest`. Instala y ejecuta la v0.22.1 fijada en `~/.agentmemory/bin`, dejando tu propio `iii` intacto.
</details>
@@ -463,7 +463,7 @@ Ninguno de estos captura automáticamente desde hooks de agentes de codificació
<h2 id="quick-start"><picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/section-quickstart.svg"><img src="../assets/tags/section-quickstart.svg" alt="Inicio rápido" height="32" /></picture></h2>
-Compatibilidad: esta release apunta a `iii-sdk` 0.19.7 y fija iii-engine v0.19.7.
+Compatibilidad: esta release apunta a `iii-sdk` 0.22.1 y fija iii-engine v0.22.1.
### Pruébalo en 30 segundos
@@ -517,7 +517,7 @@ Usa el comando de mantenimiento cuando intencionadamente quieras actualizar tu r
npx @agentmemory/agentmemory upgrade
```
-Aviso: este comando muta el workspace/runtime actual. Puede actualizar dependencias de JavaScript y traer la imagen Docker fijada `iiidev/iii:0.19.7`. Nunca instala un motor iii sin fijar ni más nuevo.
+Aviso: este comando muta el workspace/runtime actual. Puede actualizar dependencias de JavaScript y traer la imagen Docker fijada `iiidev/iii:0.22.1`. Nunca instala un motor iii sin fijar ni más nuevo.
Los detalles de implementación están en `src/cli.ts` (ver `runUpgrade` en torno a la región `src/cli.ts:544-595`).
@@ -721,15 +721,15 @@ npm install && npm run build && npm start
Esto arranca agentmemory con un `iii-engine` local si `iii` ya está instalado, o cae a Docker Compose si hay Docker disponible. REST, streams y el visor se enlazan a `127.0.0.1` por defecto.
-Instala `iii-engine` manualmente. **agentmemory actualmente fija `iii-engine` a `v0.19.7`**, la misma release que su dependencia `iii-sdk`; el worker habla el protocolo de ese engine, y 0.20.0 reorganizó la superficie del SDK, así que ambos avanzan juntos en cada release de agentmemory. Sobrescribe con `AGENTMEMORY_III_VERSION=<version>` si ejecutas tu propio engine y sabes que coincide.
+Instala `iii-engine` manualmente. **agentmemory actualmente fija `iii-engine` a `v0.22.1`**, la misma release que su dependencia `iii-sdk`; el worker habla el protocolo de ese engine, y 0.20.0 reorganizó la superficie del SDK, así que ambos avanzan juntos en cada release de agentmemory. Sobrescribe con `AGENTMEMORY_III_VERSION=<version>` si ejecutas tu propio engine y sabes que coincide.
-- **macOS arm64:** `mkdir -p ~/.local/bin && curl -fsSL https://github.com/iii-hq/iii/releases/download/iii/v0.19.7/iii-aarch64-apple-darwin.tar.gz | tar -xz -C ~/.local/bin && chmod +x ~/.local/bin/iii`
+- **macOS arm64:** `mkdir -p ~/.local/bin && curl -fsSL https://github.com/iii-hq/iii/releases/download/iii/v0.22.1/iii-aarch64-apple-darwin.tar.gz | tar -xz -C ~/.local/bin && chmod +x ~/.local/bin/iii`
- **macOS x64:** cambia `aarch64-apple-darwin` por `x86_64-apple-darwin`
- **Linux x64:** cambia por `x86_64-unknown-linux-gnu`
- **Linux arm64:** cambia por `aarch64-unknown-linux-gnu`
-- **Windows:** descarga `iii-x86_64-pc-windows-msvc.zip` desde [iii-hq/iii releases v0.19.7](https://github.com/iii-hq/iii/releases/tag/iii%2Fv0.19.7), extrae `iii.exe`, añádelo al PATH
+- **Windows:** descarga `iii-x86_64-pc-windows-msvc.zip` desde [iii-hq/iii releases v0.22.1](https://github.com/iii-hq/iii/releases/tag/iii%2Fv0.22.1), extrae `iii.exe`, añádelo al PATH
-O usa Docker (el `docker-compose.yml` empaquetado descarga `iiidev/iii:0.19.7`). Documentación completa: [iii.dev/docs](https://iii.dev/docs).
+O usa Docker (el `docker-compose.yml` empaquetado descarga `iiidev/iii:0.22.1`). Documentación completa: [iii.dev/docs](https://iii.dev/docs).
### Windows
@@ -738,9 +738,9 @@ agentmemory funciona en Windows 10/11, pero el paquete de Node.js por sí solo n
**Opción A: binario Windows preconstruido (recomendado)**
```powershell
-# 1. Open https://github.com/iii-hq/iii/releases/tag/iii%2Fv0.19.7 in your browser
+# 1. Open https://github.com/iii-hq/iii/releases/tag/iii%2Fv0.22.1 in your browser
# (agentmemory pins the engine to the same release as its iii-sdk;
-# v0.19.7 is the current pair)
+# v0.22.1 is the current pair)
# 2. Download iii-x86_64-pc-windows-msvc.zip
# (or iii-aarch64-pc-windows-msvc.zip if you're on an ARM machine)
# 3. Extract iii.exe somewhere on PATH, or place it at:
@@ -748,7 +748,7 @@ agentmemory funciona en Windows 10/11, pero el paquete de Node.js por sí solo n
# (agentmemory checks that location automatically)
# 4. Verify:
iii --version
-# Should print: 0.19.7
+# Should print: 0.22.1
# 5. Then run agentmemory as usual:
npx -y @agentmemory/agentmemory
@@ -780,7 +780,7 @@ npx -y @agentmemory/mcp
| Conflicto de puerto | `netstat -ano \| findstr :3111` para ver qué está vinculado, mátalo o usa `--port <N>` |
| Se omite el fallback a Docker aunque Docker esté instalado | Asegúrate de que Docker Desktop esté efectivamente en ejecución (icono en la bandeja del sistema) |
-> Nota: el **motor** iii es un binario preconstruido, no un crate de cargo, así que no intentes instalarlo con `cargo install`. (Los **SDK** de iii sí están publicados en crates.io, npm y PyPI, pero agentmemory no los necesita.) Métodos de instalación del motor soportados, todos fijados a v0.19.7: el binario preconstruido v0.19.7 de arriba, el script de instalación `sh` upstream **con el pin de versión** `curl -fsSL https://install.iii.dev/iii/main/install.sh | VERSION=0.19.7 sh` (macOS/Linux) y la imagen Docker `iiidev/iii:0.19.7`. Un simple `install.sh | sh` instala el motor **más reciente**, que agentmemory no soporta; pasa siempre `VERSION=0.19.7`. Lo más fácil de todo: simplemente ejecuta `npx @agentmemory/agentmemory`, que obtiene el motor fijado en `~/.agentmemory/bin` por ti.
+> Nota: el **motor** iii es un binario preconstruido, no un crate de cargo, así que no intentes instalarlo con `cargo install`. (Los **SDK** de iii sí están publicados en crates.io, npm y PyPI, pero agentmemory no los necesita.) Métodos de instalación del motor soportados, todos fijados a v0.22.1: el binario preconstruido v0.22.1 de arriba, el script de instalación `sh` upstream **con el pin de versión** `curl -fsSL https://install.iii.dev/iii/main/install.sh | VERSION=0.22.1 sh` (macOS/Linux) y la imagen Docker `iiidev/iii:0.22.1`. Un simple `install.sh | sh` instala el motor **más reciente**, que agentmemory no soporta; pasa siempre `VERSION=0.22.1`. Lo más fácil de todo: simplemente ejecuta `npx @agentmemory/agentmemory`, que obtiene el motor fijado en `~/.agentmemory/bin` por ti.
---
@@ -1169,7 +1169,7 @@ iii console --port 3114 \
**Las trazas ya están activas:**
-`iii-config.yaml` se sirve con el worker `iii-observability` habilitado (`exporter: memory`, `sampling_ratio: 1.0`, métricas + logs). No se necesita configuración adicional; desde el momento en que agentmemory arranca, cada operación de memoria emite una traza-span y un log estructurado que la console puede leer.
+`iii-config.yaml` se sirve con el worker `iii-observability` habilitado (`exporter: memory`, `sampling_ratio: 0.1`, métricas + logs). No se necesita configuración adicional; desde el momento en que agentmemory arranca, cada operación de memoria emite un log estructurado que la console puede leer, y una de cada diez (`sampling_ratio: 0.1`) emite además una traza-span.
Si quieres exportar a Jaeger/Honeycomb/Grafana Tempo en su lugar, cambia `exporter: memory` por `exporter: otlp` y define el endpoint del collector según la documentación de observabilidad de iii.
@@ -1191,7 +1191,7 @@ iii worker add iii-cron # scheduled consolidation, decay sweeps, snap
iii worker add iii-queue # durable retries for embedding + compression jobs
iii worker add iii-observability # OTEL traces on every memory op (default on)
iii worker add iii-sandbox # run recalled code inside an isolated microVM
-iii worker add iii-database # swap in a SQL-backed state adapter
+iii worker add database # swap in a SQL-backed state adapter
iii worker add mcp # generic MCP host alongside the agentmemory MCP
```
@@ -1204,7 +1204,7 @@ Cada `iii worker add` registra nuevas funciones y triggers en el mismo engine en
| [`iii-queue`](https://workers.iii.dev/workers/iii-queue) | Reintentos duraderos: los jobs de embedding + compresión fallidos sobreviven al reinicio, sin observaciones perdidas |
| [`iii-observability`](https://workers.iii.dev/workers/iii-observability) | Trazas OTEL, métricas y logs en cada función, cableado en `iii-config.yaml` desde el primer día |
| [`iii-sandbox`](https://workers.iii.dev/workers/iii-sandbox) | El código salido de `memory_recall` corre dentro de una VM desechable, no en tu shell |
-| [`iii-database`](https://workers.iii.dev/workers/iii-database) | Adaptador de estado respaldado por SQL cuando te quedas pequeño con el KV in-memory por defecto |
+| [`database`](https://workers.iii.dev/workers/database) | Adaptador de estado respaldado por SQL cuando te quedas pequeño con el KV in-memory por defecto |
| [`mcp`](https://workers.iii.dev/workers/mcp) | Levanta servidores MCP adicionales junto al MCP de agentmemory, compartiendo el mismo engine |
Registro completo: [workers.iii.dev](https://workers.iii.dev). Cada worker allí se compone a través de los mismos primitivos que usa agentmemory, y el agentmemory que ya tienes es uno de ellos.
diff --git a/READMEs/README.fr-FR.md b/READMEs/README.fr-FR.md
index 175d4e22..7261aea4 100644
--- a/READMEs/README.fr-FR.md
+++ b/READMEs/README.fr-FR.md
@@ -124,7 +124,7 @@ npx met en cache par version. Forcez la dernière avec `npx -y @agentmemory/agen
<details>
<summary><strong>Vous faites déjà tourner votre propre moteur iii</strong></summary>
-agentmemory épingle iii-engine v0.19.7 et ne s'attachera pas à une autre version (le worker ne peut pas parler le protocole d'un autre moteur). Arrêtez l'autre moteur, puis lancez `npx -y @agentmemory/agentmemory@latest`. Il installe et exécute le v0.19.7 épinglé dans `~/.agentmemory/bin`, sans toucher à votre propre `iii`.
+agentmemory épingle iii-engine v0.22.1 et ne s'attachera pas à une autre version (le worker ne peut pas parler le protocole d'un autre moteur). Arrêtez l'autre moteur, puis lancez `npx -y @agentmemory/agentmemory@latest`. Il installe et exécute le v0.22.1 épinglé dans `~/.agentmemory/bin`, sans toucher à votre propre `iii`.
</details>
@@ -463,7 +463,7 @@ Aucun d'eux ne capture automatiquement depuis les hooks d'agents de codage, ne l
<h2 id="quick-start"><picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/section-quickstart.svg"><img src="../assets/tags/section-quickstart.svg" alt="Démarrage rapide" height="32" /></picture></h2>
-Compatibilité : cette version cible `iii-sdk` 0.19.7 et épingle iii-engine v0.19.7.
+Compatibilité : cette version cible `iii-sdk` 0.22.1 et épingle iii-engine v0.22.1.
### Essayez en 30 secondes
@@ -517,7 +517,7 @@ Utilisez la commande de maintenance lorsque vous voulez intentionnellement mettr
npx @agentmemory/agentmemory upgrade
```
-Avertissement : cette commande modifie l'espace de travail / runtime courant. Elle peut mettre à jour les dépendances JavaScript et tirer l'image Docker épinglée `iiidev/iii:0.19.7`. Elle n'installe jamais un moteur iii non épinglé ou plus récent.
+Avertissement : cette commande modifie l'espace de travail / runtime courant. Elle peut mettre à jour les dépendances JavaScript et tirer l'image Docker épinglée `iiidev/iii:0.22.1`. Elle n'installe jamais un moteur iii non épinglé ou plus récent.
Détails d'implémentation dans `src/cli.ts` (voir `runUpgrade` autour de la zone `src/cli.ts:544-595`).
@@ -721,15 +721,15 @@ npm install && npm run build && npm start
Cela démarre agentmemory avec un `iii-engine` local si `iii` est déjà installé, ou retombe sur Docker Compose si Docker est disponible. REST, streams et visualiseur se lient à `127.0.0.1` par défaut.
-Installer `iii-engine` manuellement. **agentmemory épingle actuellement `iii-engine` à `v0.19.7`**, la même version que sa dépendance `iii-sdk` ; le worker parle le protocole de ce moteur précis, et 0.20.0 a réorganisé la surface du SDK, donc les deux évoluent ensemble dans les versions d'agentmemory. Remplacez avec `AGENTMEMORY_III_VERSION=<version>` si vous exécutez votre propre moteur et savez qu'il correspond.
+Installer `iii-engine` manuellement. **agentmemory épingle actuellement `iii-engine` à `v0.22.1`**, la même version que sa dépendance `iii-sdk` ; le worker parle le protocole de ce moteur précis, et 0.20.0 a réorganisé la surface du SDK, donc les deux évoluent ensemble dans les versions d'agentmemory. Remplacez avec `AGENTMEMORY_III_VERSION=<version>` si vous exécutez votre propre moteur et savez qu'il correspond.
-- **macOS arm64 :** `mkdir -p ~/.local/bin && curl -fsSL https://github.com/iii-hq/iii/releases/download/iii/v0.19.7/iii-aarch64-apple-darwin.tar.gz | tar -xz -C ~/.local/bin && chmod +x ~/.local/bin/iii`
+- **macOS arm64 :** `mkdir -p ~/.local/bin && curl -fsSL https://github.com/iii-hq/iii/releases/download/iii/v0.22.1/iii-aarch64-apple-darwin.tar.gz | tar -xz -C ~/.local/bin && chmod +x ~/.local/bin/iii`
- **macOS x64 :** remplacez `aarch64-apple-darwin` par `x86_64-apple-darwin`
- **Linux x64 :** remplacez par `x86_64-unknown-linux-gnu`
- **Linux arm64 :** remplacez par `aarch64-unknown-linux-gnu`
-- **Windows :** téléchargez `iii-x86_64-pc-windows-msvc.zip` depuis [iii-hq/iii releases v0.19.7](https://github.com/iii-hq/iii/releases/tag/iii%2Fv0.19.7), extrayez `iii.exe`, ajoutez-le au PATH
+- **Windows :** téléchargez `iii-x86_64-pc-windows-msvc.zip` depuis [iii-hq/iii releases v0.22.1](https://github.com/iii-hq/iii/releases/tag/iii%2Fv0.22.1), extrayez `iii.exe`, ajoutez-le au PATH
-Ou utilisez Docker (le `docker-compose.yml` fourni tire `iiidev/iii:0.19.7`). Documentation complète : [iii.dev/docs](https://iii.dev/docs).
+Ou utilisez Docker (le `docker-compose.yml` fourni tire `iiidev/iii:0.22.1`). Documentation complète : [iii.dev/docs](https://iii.dev/docs).
### Windows
@@ -738,9 +738,9 @@ agentmemory tourne sur Windows 10/11, mais le paquet Node.js seul ne suffit pas
**Option A : binaire Windows précompilé (recommandé)**
```powershell
-# 1. Open https://github.com/iii-hq/iii/releases/tag/iii%2Fv0.19.7 in your browser
+# 1. Open https://github.com/iii-hq/iii/releases/tag/iii%2Fv0.22.1 in your browser
# (agentmemory pins the engine to the same release as its iii-sdk;
-# v0.19.7 is the current pair)
+# v0.22.1 is the current pair)
# 2. Download iii-x86_64-pc-windows-msvc.zip
# (or iii-aarch64-pc-windows-msvc.zip if you're on an ARM machine)
# 3. Extract iii.exe somewhere on PATH, or place it at:
@@ -748,7 +748,7 @@ agentmemory tourne sur Windows 10/11, mais le paquet Node.js seul ne suffit pas
# (agentmemory checks that location automatically)
# 4. Verify:
iii --version
-# Should print: 0.19.7
+# Should print: 0.22.1
# 5. Then run agentmemory as usual:
npx -y @agentmemory/agentmemory
@@ -780,7 +780,7 @@ npx -y @agentmemory/mcp
| Conflit de port | `netstat -ano \| findstr :3111` pour voir ce qui est lié, puis tuez-le ou utilisez `--port <N>` |
| Fallback Docker ignoré bien que Docker soit installé | Assurez-vous que Docker Desktop tourne effectivement (icône de la barre d'état système) |
-> Note : le **moteur** iii est un binaire précompilé, pas un crate cargo, donc n'essayez pas de l'installer avec `cargo install`. (Les **SDK** iii sont bien publiés sur crates.io, npm et PyPI, mais agentmemory n'en a pas besoin.) Méthodes d'installation du moteur supportées, toutes épinglées à v0.19.7 : le binaire précompilé v0.19.7 ci-dessus, le script d'installation `sh` amont **avec l'épingle de version** `curl -fsSL https://install.iii.dev/iii/main/install.sh | VERSION=0.19.7 sh` (macOS/Linux) et l'image Docker `iiidev/iii:0.19.7`. Un simple `install.sh | sh` installe le moteur **le plus récent**, que agentmemory ne supporte pas ; passez toujours `VERSION=0.19.7`. Le plus simple de tout : exécutez simplement `npx @agentmemory/agentmemory`, qui récupère le moteur épinglé dans `~/.agentmemory/bin` pour vous.
+> Note : le **moteur** iii est un binaire précompilé, pas un crate cargo, donc n'essayez pas de l'installer avec `cargo install`. (Les **SDK** iii sont bien publiés sur crates.io, npm et PyPI, mais agentmemory n'en a pas besoin.) Méthodes d'installation du moteur supportées, toutes épinglées à v0.22.1 : le binaire précompilé v0.22.1 ci-dessus, le script d'installation `sh` amont **avec l'épingle de version** `curl -fsSL https://install.iii.dev/iii/main/install.sh | VERSION=0.22.1 sh` (macOS/Linux) et l'image Docker `iiidev/iii:0.22.1`. Un simple `install.sh | sh` installe le moteur **le plus récent**, que agentmemory ne supporte pas ; passez toujours `VERSION=0.22.1`. Le plus simple de tout : exécutez simplement `npx @agentmemory/agentmemory`, qui récupère le moteur épinglé dans `~/.agentmemory/bin` pour vous.
---
@@ -1176,7 +1176,7 @@ iii console --port 3114 \
**Les traces sont déjà actives :**
-`iii-config.yaml` est livré avec le worker `iii-observability` activé (`exporter: memory`, `sampling_ratio: 1.0`, métriques + logs). Aucune config supplémentaire ; dès qu'agentmemory démarre, chaque opération mémoire émet un span de trace et un log structuré que la console peut lire.
+`iii-config.yaml` est livré avec le worker `iii-observability` activé (`exporter: memory`, `sampling_ratio: 0.1`, métriques + logs). Aucune config supplémentaire ; dès qu'agentmemory démarre, chaque opération mémoire émet un log structuré que la console peut lire, et une sur dix (`sampling_ratio: 0.1`) émet aussi un span de trace.
Si vous voulez exporter vers Jaeger/Honeycomb/Grafana Tempo à la place, changez `exporter: memory` en `exporter: otlp` et définissez l'endpoint du collecteur selon la documentation d'observabilité d'iii.
@@ -1198,7 +1198,7 @@ iii worker add iii-cron # scheduled consolidation, decay sweeps, snap
iii worker add iii-queue # durable retries for embedding + compression jobs
iii worker add iii-observability # OTEL traces on every memory op (default on)
iii worker add iii-sandbox # run recalled code inside an isolated microVM
-iii worker add iii-database # swap in a SQL-backed state adapter
+iii worker add database # swap in a SQL-backed state adapter
iii worker add mcp # generic MCP host alongside the agentmemory MCP
```
@@ -1211,7 +1211,7 @@ Chaque `iii worker add` enregistre de nouvelles fonctions et triggers dans le m
| [`iii-queue`](https://workers.iii.dev/workers/iii-queue) | Retries durables : les jobs d'embedding + compression en échec survivent au redémarrage, aucune observation perdue |
| [`iii-observability`](https://workers.iii.dev/workers/iii-observability) | Traces, métriques et logs OTEL sur chaque fonction, câblés dans `iii-config.yaml` dès le premier jour |
| [`iii-sandbox`](https://workers.iii.dev/workers/iii-sandbox) | Le code issu de `memory_recall` s'exécute dans une VM jetable, pas dans votre shell |
-| [`iii-database`](https://workers.iii.dev/workers/iii-database) | Adaptateur d'état adossé à SQL lorsque vous dépassez les valeurs par défaut KV en mémoire |
+| [`database`](https://workers.iii.dev/workers/database) | Adaptateur d'état adossé à SQL lorsque vous dépassez les valeurs par défaut KV en mémoire |
| [`mcp`](https://workers.iii.dev/workers/mcp) | Déployez des serveurs MCP supplémentaires à côté de celui d'agentmemory, partageant le même moteur |
Registre complet : [workers.iii.dev](https://workers.iii.dev). Chaque worker là-bas se compose via les mêmes primitives qu'utilise agentmemory, et l'agentmemory que vous avez déjà en est un.
diff --git a/READMEs/README.hi-IN.md b/READMEs/README.hi-IN.md
index 20395845..aa959dd3 100644
--- a/READMEs/README.hi-IN.md
+++ b/READMEs/README.hi-IN.md
@@ -124,7 +124,7 @@ npx प्रति-वर्ज़न कैश करता है। नव
<details>
<summary><strong>पहले से अपना iii engine चला रहे हैं</strong></summary>
-agentmemory iii-engine v0.19.7 को pin करता है और किसी भिन्न version से attach नहीं होगा (worker किसी दूसरे engine का protocol नहीं बोल सकता)। दूसरे engine को रोकें, फिर `npx -y @agentmemory/agentmemory@latest` चलाएँ। यह pinned v0.19.7 को `~/.agentmemory/bin` में install और run करता है, आपके अपने `iii` को अछूता छोड़ते हुए।
+agentmemory iii-engine v0.22.1 को pin करता है और किसी भिन्न version से attach नहीं होगा (worker किसी दूसरे engine का protocol नहीं बोल सकता)। दूसरे engine को रोकें, फिर `npx -y @agentmemory/agentmemory@latest` चलाएँ। यह pinned v0.22.1 को `~/.agentmemory/bin` में install और run करता है, आपके अपने `iii` को अछूता छोड़ते हुए।
</details>
@@ -463,7 +463,7 @@ npx @agentmemory/agentmemory
<h2 id="quick-start"><picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/section-quickstart.svg"><img src="../assets/tags/section-quickstart.svg" alt="Quick Start" height="32" /></picture></h2>
-संगतता: यह रिलीज़ `iii-sdk` 0.19.7 को टार्गेट करता है और iii-engine को v0.19.7 पर pin करता है।
+संगतता: यह रिलीज़ `iii-sdk` 0.22.1 को टार्गेट करता है और iii-engine को v0.22.1 पर pin करता है।
### 30 सेकंड में आज़माएँ
@@ -515,7 +515,7 @@ Imported सेशंस native ones के साथ Replay picker में
npx @agentmemory/agentmemory upgrade
```
-चेतावनी: यह कमांड वर्तमान workspace/runtime को mutate करता है। यह JavaScript निर्भरताएँ update कर सकता है और pinned Docker image `iiidev/iii:0.19.7` खींच सकता है। यह कभी भी unpinned या नया iii engine install नहीं करता।
+चेतावनी: यह कमांड वर्तमान workspace/runtime को mutate करता है। यह JavaScript निर्भरताएँ update कर सकता है और pinned Docker image `iiidev/iii:0.22.1` खींच सकता है। यह कभी भी unpinned या नया iii engine install नहीं करता।
Implementation विवरण `src/cli.ts` में हैं (`src/cli.ts:544-595` क्षेत्र के आसपास `runUpgrade` देखें)।
@@ -700,15 +700,15 @@ npm install && npm run build && npm start
यह agentmemory को local `iii-engine` के साथ शुरू करता है अगर `iii` पहले से installed है, या Docker उपलब्ध होने पर Docker Compose पर fallback करता है। REST, streams, और व्यूअर default रूप से `127.0.0.1` से bind करते हैं।
-`iii-engine` मैनुअली इंस्टॉल करें। **agentmemory वर्तमान में `iii-engine` को `v0.19.7` पर pin करता है**, जो इसकी `iii-sdk` dependency वाला ही release है; worker उसी engine का wire protocol बोलता है, और 0.20.0 ने SDK surface को reorganize किया, इसलिए दोनों agentmemory releases में साथ बढ़ते हैं। यदि आप अपना engine चलाते हैं और जानते हैं कि वह मेल खाता है तो `AGENTMEMORY_III_VERSION=<version>` से override करें।
+`iii-engine` मैनुअली इंस्टॉल करें। **agentmemory वर्तमान में `iii-engine` को `v0.22.1` पर pin करता है**, जो इसकी `iii-sdk` dependency वाला ही release है; worker उसी engine का wire protocol बोलता है, और 0.20.0 ने SDK surface को reorganize किया, इसलिए दोनों agentmemory releases में साथ बढ़ते हैं। यदि आप अपना engine चलाते हैं और जानते हैं कि वह मेल खाता है तो `AGENTMEMORY_III_VERSION=<version>` से override करें।
-- **macOS arm64:** `mkdir -p ~/.local/bin && curl -fsSL https://github.com/iii-hq/iii/releases/download/iii/v0.19.7/iii-aarch64-apple-darwin.tar.gz | tar -xz -C ~/.local/bin && chmod +x ~/.local/bin/iii`
+- **macOS arm64:** `mkdir -p ~/.local/bin && curl -fsSL https://github.com/iii-hq/iii/releases/download/iii/v0.22.1/iii-aarch64-apple-darwin.tar.gz | tar -xz -C ~/.local/bin && chmod +x ~/.local/bin/iii`
- **macOS x64:** `aarch64-apple-darwin` को `x86_64-apple-darwin` के साथ बदलें
- **Linux x64:** `x86_64-unknown-linux-gnu` के साथ बदलें
- **Linux arm64:** `aarch64-unknown-linux-gnu` के साथ बदलें
-- **Windows:** [iii-hq/iii releases v0.19.7](https://github.com/iii-hq/iii/releases/tag/iii%2Fv0.19.7) से `iii-x86_64-pc-windows-msvc.zip` download करें, `iii.exe` extract करें, PATH में जोड़ें
+- **Windows:** [iii-hq/iii releases v0.22.1](https://github.com/iii-hq/iii/releases/tag/iii%2Fv0.22.1) से `iii-x86_64-pc-windows-msvc.zip` download करें, `iii.exe` extract करें, PATH में जोड़ें
-या Docker का उपयोग करें (bundled `docker-compose.yml` `iiidev/iii:0.19.7` खींचता है)। पूर्ण docs: [iii.dev/docs](https://iii.dev/docs)।
+या Docker का उपयोग करें (bundled `docker-compose.yml` `iiidev/iii:0.22.1` खींचता है)। पूर्ण docs: [iii.dev/docs](https://iii.dev/docs)।
### Windows
@@ -717,9 +717,9 @@ agentmemory Windows 10/11 पर चलता है, लेकिन केव
**विकल्प A: prebuilt Windows binary (अनुशंसित)**
```powershell
-# 1. अपने browser में https://github.com/iii-hq/iii/releases/tag/iii%2Fv0.19.7 खोलें
+# 1. अपने browser में https://github.com/iii-hq/iii/releases/tag/iii%2Fv0.22.1 खोलें
# (agentmemory engine को अपनी iii-sdk वाले ही release पर pin करता है;
-# वर्तमान pair v0.19.7 है)
+# वर्तमान pair v0.22.1 है)
# 2. iii-x86_64-pc-windows-msvc.zip download करें
# (या ARM machine पर हैं तो iii-aarch64-pc-windows-msvc.zip)
# 3. PATH पर कहीं iii.exe extract करें, या यहाँ रखें:
@@ -727,7 +727,7 @@ agentmemory Windows 10/11 पर चलता है, लेकिन केव
# (agentmemory उस location को automatically check करता है)
# 4. Verify करें:
iii --version
-# Print होना चाहिए: 0.19.7
+# Print होना चाहिए: 0.22.1
# 5. फिर agentmemory को सामान्य की तरह चलाएँ:
npx -y @agentmemory/agentmemory
@@ -759,7 +759,7 @@ npx -y @agentmemory/mcp
| Port conflict | `netstat -ano \| findstr :3111` से देखें कि क्या bind है, फिर उसे kill करें या `--port <N>` का उपयोग करें |
| Docker installed होने पर भी Docker fallback skip हो रहा है | सुनिश्चित करें कि Docker Desktop वास्तव में चल रहा है (system tray icon) |
-> नोट: iii **engine** एक prebuilt binary है, cargo crate नहीं, इसलिए इसे `cargo install` से install करने की कोशिश न करें। (iii **SDKs** crates.io, npm, और PyPI पर publish हैं, लेकिन agentmemory को उनकी ज़रूरत नहीं है।) समर्थित engine install methods, सभी v0.19.7 पर pinned: ऊपर वाला prebuilt v0.19.7 binary, version pin **के साथ** upstream `sh` install script `curl -fsSL https://install.iii.dev/iii/main/install.sh | VERSION=0.19.7 sh` (macOS/Linux), और Docker image `iiidev/iii:0.19.7`। केवल `install.sh | sh` **latest** engine install करता है, जिसे agentmemory support नहीं करता; हमेशा `VERSION=0.19.7` पास करें। सबसे आसान: बस `npx @agentmemory/agentmemory` चलाएँ, जो pinned engine को आपके लिए `~/.agentmemory/bin` में ले आता है।
+> नोट: iii **engine** एक prebuilt binary है, cargo crate नहीं, इसलिए इसे `cargo install` से install करने की कोशिश न करें। (iii **SDKs** crates.io, npm, और PyPI पर publish हैं, लेकिन agentmemory को उनकी ज़रूरत नहीं है।) समर्थित engine install methods, सभी v0.22.1 पर pinned: ऊपर वाला prebuilt v0.22.1 binary, version pin **के साथ** upstream `sh` install script `curl -fsSL https://install.iii.dev/iii/main/install.sh | VERSION=0.22.1 sh` (macOS/Linux), और Docker image `iiidev/iii:0.22.1`। केवल `install.sh | sh` **latest** engine install करता है, जिसे agentmemory support नहीं करता; हमेशा `VERSION=0.22.1` पास करें। सबसे आसान: बस `npx @agentmemory/agentmemory` चलाएँ, जो pinned engine को आपके लिए `~/.agentmemory/bin` में ले आता है।
---
@@ -1158,7 +1158,7 @@ iii console --port 3114 \
**Traces पहले से on हैं:**
-`iii-config.yaml` `iii-observability` worker enabled (`exporter: memory`, `sampling_ratio: 1.0`, metrics + logs) के साथ ship होता है। कोई extra config की ज़रूरत नहीं; जैसे ही agentmemory शुरू होता है, हर memory operation एक trace span और एक structured log emit करता है जिसे console पढ़ सकता है।
+`iii-config.yaml` `iii-observability` worker enabled (`exporter: memory`, `sampling_ratio: 0.1`, metrics + logs) के साथ ship होता है। कोई extra config की ज़रूरत नहीं; जैसे ही agentmemory शुरू होता है, हर memory operation एक structured log emit करता है जिसे console पढ़ सकता है, और उनमें से हर दसवाँ (`sampling_ratio: 0.1`) एक trace span भी emit करता है।
अगर आप इसके बजाय Jaeger/Honeycomb/Grafana Tempo पर export करना चाहते हैं, तो `exporter: memory` को `exporter: otlp` में बदलें और iii के observability docs के अनुसार collector endpoint set करें।
@@ -1180,7 +1180,7 @@ iii worker add iii-cron # scheduled consolidation, decay sweeps, snap
iii worker add iii-queue # embedding + compression jobs के लिए durable retries
iii worker add iii-observability # हर memory op पर OTEL traces (default on)
iii worker add iii-sandbox # recalled code को isolated microVM के अंदर चलाएँ
-iii worker add iii-database # एक SQL-backed state adapter में swap करें
+iii worker add database # एक SQL-backed state adapter में swap करें
iii worker add mcp # agentmemory MCP के साथ-साथ generic MCP host
```
@@ -1193,7 +1193,7 @@ iii worker add mcp # agentmemory MCP के साथ-साथ
| [`iii-queue`](https://workers.iii.dev/workers/iii-queue) | Durable retries: failed embedding + compression jobs restart से बचते हैं, कोई lost observations नहीं |
| [`iii-observability`](https://workers.iii.dev/workers/iii-observability) | हर function पर OTEL traces, metrics, logs, दिन एक से `iii-config.yaml` में wired |
| [`iii-sandbox`](https://workers.iii.dev/workers/iii-sandbox) | `memory_recall` से निकला code throwaway VM के अंदर चलता है, आपके shell में नहीं |
-| [`iii-database`](https://workers.iii.dev/workers/iii-database) | जब आप in-memory KV defaults से बाहर निकलते हैं तो SQL-backed state adapter |
+| [`database`](https://workers.iii.dev/workers/database) | जब आप in-memory KV defaults से बाहर निकलते हैं तो SQL-backed state adapter |
| [`mcp`](https://workers.iii.dev/workers/mcp) | agentmemory के साथ-साथ extra MCP servers खड़े करें, वही engine share करें |
Full registry: [workers.iii.dev](https://workers.iii.dev)। वहाँ हर worker उन्हीं primitives के माध्यम से compose करता है जिनका agentmemory उपयोग करता है, और आपके पास पहले से जो agentmemory है, वह उनमें से एक है।
diff --git a/READMEs/README.ja-JP.md b/READMEs/README.ja-JP.md
index 624cc33c..0badfa5c 100644
--- a/READMEs/README.ja-JP.md
+++ b/READMEs/README.ja-JP.md
@@ -124,7 +124,7 @@ npx はバージョン単位でキャッシュします。`npx -y @agentmemory/a
<details>
<summary><strong>自前の iii エンジンを既に動かしている</strong></summary>
-agentmemory は iii-engine v0.19.7 にピン留めしており、異なるバージョンにはアタッチしません(worker は別のエンジンのプロトコルを話せません)。他のエンジンを停止してから `npx -y @agentmemory/agentmemory@latest` を実行してください。ピン留めされた v0.19.7 を `~/.agentmemory/bin` にインストールして実行し、あなた自身の `iii` には触れません。
+agentmemory は iii-engine v0.22.1 にピン留めしており、異なるバージョンにはアタッチしません(worker は別のエンジンのプロトコルを話せません)。他のエンジンを停止してから `npx -y @agentmemory/agentmemory@latest` を実行してください。ピン留めされた v0.22.1 を `~/.agentmemory/bin` にインストールして実行し、あなた自身の `iii` には触れません。
</details>
@@ -463,7 +463,7 @@ npx @agentmemory/agentmemory
<h2 id="quick-start"><picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/section-quickstart.svg"><img src="../assets/tags/section-quickstart.svg" alt="Quick Start" height="32" /></picture></h2>
-互換性:このリリースは `iii-sdk` 0.19.7 を対象とし、iii-engine v0.19.7 にピン留めします。
+互換性:このリリースは `iii-sdk` 0.22.1 を対象とし、iii-engine v0.22.1 にピン留めします。
### 30 秒で試す
@@ -517,7 +517,7 @@ npx @agentmemory/agentmemory import-jsonl ~/.claude/projects/-my-project/abc123.
npx @agentmemory/agentmemory upgrade
```
-警告: このコマンドは現在のワークスペース/ランタイムを変更します。JavaScript 依存を更新したり、ピン留めされた Docker イメージ `iiidev/iii:0.19.7` を pull したりすることがあります。ピン留めされていない、あるいは新しい iii エンジンをインストールすることは決してありません。
+警告: このコマンドは現在のワークスペース/ランタイムを変更します。JavaScript 依存を更新したり、ピン留めされた Docker イメージ `iiidev/iii:0.22.1` を pull したりすることがあります。ピン留めされていない、あるいは新しい iii エンジンをインストールすることは決してありません。
実装の詳細は `src/cli.ts` を参照(`src/cli.ts:544-595` 付近の `runUpgrade`)。
@@ -722,15 +722,15 @@ npm install && npm run build && npm start
`iii` が既にインストールされていれば、これでローカルの `iii-engine` で agentmemory が起動します。Docker が使える場合は Docker Compose にフォールバックします。REST、ストリーム、ビューワーはデフォルトで `127.0.0.1` にバインドします。
-`iii-engine` を手動でインストールしてください。**agentmemory は現在 `iii-engine` を `v0.19.7` にピン留めしています** — `iii-sdk` 依存関係と同じリリースです。worker はそのエンジンの wire プロトコルを話し、0.20.0 で SDK の API 面が再編されたため、両者は agentmemory のリリースで一緒に更新されます。自前のエンジンを運用していて一致していると分かっている場合は `AGENTMEMORY_III_VERSION=<version>` で上書きできます。
+`iii-engine` を手動でインストールしてください。**agentmemory は現在 `iii-engine` を `v0.22.1` にピン留めしています** — `iii-sdk` 依存関係と同じリリースです。worker はそのエンジンの wire プロトコルを話し、0.20.0 で SDK の API 面が再編されたため、両者は agentmemory のリリースで一緒に更新されます。自前のエンジンを運用していて一致していると分かっている場合は `AGENTMEMORY_III_VERSION=<version>` で上書きできます。
-- **macOS arm64:** `mkdir -p ~/.local/bin && curl -fsSL https://github.com/iii-hq/iii/releases/download/iii/v0.19.7/iii-aarch64-apple-darwin.tar.gz | tar -xz -C ~/.local/bin && chmod +x ~/.local/bin/iii`
+- **macOS arm64:** `mkdir -p ~/.local/bin && curl -fsSL https://github.com/iii-hq/iii/releases/download/iii/v0.22.1/iii-aarch64-apple-darwin.tar.gz | tar -xz -C ~/.local/bin && chmod +x ~/.local/bin/iii`
- **macOS x64:** `aarch64-apple-darwin` を `x86_64-apple-darwin` に置換
- **Linux x64:** `x86_64-unknown-linux-gnu` に置換
- **Linux arm64:** `aarch64-unknown-linux-gnu` に置換
-- **Windows:** [iii-hq/iii releases v0.19.7](https://github.com/iii-hq/iii/releases/tag/iii%2Fv0.19.7) から `iii-x86_64-pc-windows-msvc.zip` をダウンロード、`iii.exe` を展開し PATH に追加
+- **Windows:** [iii-hq/iii releases v0.22.1](https://github.com/iii-hq/iii/releases/tag/iii%2Fv0.22.1) から `iii-x86_64-pc-windows-msvc.zip` をダウンロード、`iii.exe` を展開し PATH に追加
-または Docker を使用(同梱の `docker-compose.yml` が `iiidev/iii:0.19.7` を pull します)。詳細ドキュメント:[iii.dev/docs](https://iii.dev/docs)。
+または Docker を使用(同梱の `docker-compose.yml` が `iiidev/iii:0.22.1` を pull します)。詳細ドキュメント:[iii.dev/docs](https://iii.dev/docs)。
### Windows
@@ -739,9 +739,9 @@ agentmemory は Windows 10/11 で動作しますが、Node.js パッケージだ
**選択肢 A: ビルド済み Windows バイナリ(推奨)**
```powershell
-# 1. ブラウザで https://github.com/iii-hq/iii/releases/tag/iii%2Fv0.19.7 を開く
+# 1. ブラウザで https://github.com/iii-hq/iii/releases/tag/iii%2Fv0.22.1 を開く
# (agentmemory はエンジンを iii-sdk と同じリリースにピン留めしています。
-# 現在のペアは v0.19.7)
+# 現在のペアは v0.22.1)
# 2. iii-x86_64-pc-windows-msvc.zip をダウンロード
# (ARM マシンの場合は iii-aarch64-pc-windows-msvc.zip)
# 3. iii.exe を PATH 上のどこかに展開、または以下に配置:
@@ -749,7 +749,7 @@ agentmemory は Windows 10/11 で動作しますが、Node.js パッケージだ
# (agentmemory はこの場所を自動でチェックします)
# 4. 確認:
iii --version
-# 出力: 0.19.7
+# 出力: 0.22.1
# 5. その後 agentmemory を通常通り起動:
npx -y @agentmemory/agentmemory
@@ -781,7 +781,7 @@ npx -y @agentmemory/mcp
| ポート競合 | `netstat -ano \| findstr :3111` でバインドを確認、kill するか `--port <N>` を使用 |
| Docker をインストール済みなのにフォールバックがスキップされる | Docker Desktop が実際に動作している(システムトレイアイコン)ことを確認 |
-> 注意: iii **エンジン** はビルド済みバイナリであり、cargo クレートではありません — `cargo install` でインストールしようとしないでください。(iii **SDK** は crates.io、npm、PyPI に公開されていますが、agentmemory には不要です。)サポートされるエンジンのインストール方法はすべて v0.19.7 にピン留めされています: 上記のビルド済み v0.19.7 バイナリ、バージョンピン**付き**の上流 `sh` インストールスクリプト `curl -fsSL https://install.iii.dev/iii/main/install.sh | VERSION=0.19.7 sh`(macOS/Linux)、および Docker イメージ `iiidev/iii:0.19.7`。単なる `install.sh | sh` は **最新** のエンジンをインストールしますが、agentmemory はそれをサポートしていません — 必ず `VERSION=0.19.7` を渡してください。最も簡単なのは、`npx @agentmemory/agentmemory` を実行するだけです。これがピン留めされたエンジンを `~/.agentmemory/bin` に取得してくれます。
+> 注意: iii **エンジン** はビルド済みバイナリであり、cargo クレートではありません — `cargo install` でインストールしようとしないでください。(iii **SDK** は crates.io、npm、PyPI に公開されていますが、agentmemory には不要です。)サポートされるエンジンのインストール方法はすべて v0.22.1 にピン留めされています: 上記のビルド済み v0.22.1 バイナリ、バージョンピン**付き**の上流 `sh` インストールスクリプト `curl -fsSL https://install.iii.dev/iii/main/install.sh | VERSION=0.22.1 sh`(macOS/Linux)、および Docker イメージ `iiidev/iii:0.22.1`。単なる `install.sh | sh` は **最新** のエンジンをインストールしますが、agentmemory はそれをサポートしていません — 必ず `VERSION=0.22.1` を渡してください。最も簡単なのは、`npx @agentmemory/agentmemory` を実行するだけです。これがピン留めされたエンジンを `~/.agentmemory/bin` に取得してくれます。
---
@@ -1179,7 +1179,7 @@ iii console --port 3114 \
**Traces は既にオン:**
-`iii-config.yaml` は出荷時から `iii-observability` worker を有効化(`exporter: memory`、`sampling_ratio: 1.0`、メトリクス + ログ)。追加設定不要 — agentmemory が起動した瞬間に、すべてのメモリ操作がトレーススパンとコンソールが読み取れる構造化ログを出します。
+`iii-config.yaml` は出荷時から `iii-observability` worker を有効化(`exporter: memory`、`sampling_ratio: 0.1`、メトリクス + ログ)。追加設定不要 — agentmemory が起動した瞬間に、すべてのメモリ操作がコンソールが読み取れる構造化ログを出し、そのうち 10 分の 1(`sampling_ratio: 0.1`)はトレーススパンも出します。
代わりに Jaeger / Honeycomb / Grafana Tempo へエクスポートしたい場合は、`exporter: memory` を `exporter: otlp` に変更し、iii の可観測性ドキュメントに従ってコレクタエンドポイントを設定してください。
@@ -1201,7 +1201,7 @@ iii worker add iii-cron # スケジュール統合、減衰スイー
iii worker add iii-queue # 埋め込み + 圧縮ジョブの永続リトライ
iii worker add iii-observability # すべてのメモリ操作に OTEL トレース(デフォルト オン)
iii worker add iii-sandbox # リコールしたコードを隔離 microVM 内で実行
-iii worker add iii-database # SQL バックエンドのステートアダプタに切り替え
+iii worker add database # SQL バックエンドのステートアダプタに切り替え
iii worker add mcp # agentmemory MCP の横に汎用 MCP ホストを立てる
```
@@ -1214,7 +1214,7 @@ iii worker add mcp # agentmemory MCP の横に汎用 MCP ホス
| [`iii-queue`](https://workers.iii.dev/workers/iii-queue) | 永続リトライ: 失敗した埋め込み + 圧縮ジョブが再起動を生き延び、観測は失われない |
| [`iii-observability`](https://workers.iii.dev/workers/iii-observability) | すべての function に OTEL トレース、メトリクス、ログ — 初日から `iii-config.yaml` に配線済み |
| [`iii-sandbox`](https://workers.iii.dev/workers/iii-sandbox) | `memory_recall` から出てきたコードはあなたのシェルではなく使い捨て VM 内で実行 |
-| [`iii-database`](https://workers.iii.dev/workers/iii-database) | デフォルトのインメモリ KV では足りないときの SQL バックエンドのステートアダプタ |
+| [`database`](https://workers.iii.dev/workers/database) | デフォルトのインメモリ KV では足りないときの SQL バックエンドのステートアダプタ |
| [`mcp`](https://workers.iii.dev/workers/mcp) | agentmemory の隣に追加の MCP サーバーを立て、同じエンジンを共有 |
完全なレジストリ:[workers.iii.dev](https://workers.iii.dev)。そこにあるすべての worker は agentmemory が使っているのと同じプリミティブで組み立てられています — そして既に手元にある agentmemory もその 1 つです。
diff --git a/READMEs/README.ko-KR.md b/READMEs/README.ko-KR.md
index 3c6843ac..1c3ae696 100644
--- a/READMEs/README.ko-KR.md
+++ b/READMEs/README.ko-KR.md
@@ -124,7 +124,7 @@ npx는 버전별로 캐싱합니다. `npx -y @agentmemory/agentmemory@latest`로
<details>
<summary><strong>이미 자체 iii 엔진을 실행 중인 경우</strong></summary>
-agentmemory는 iii-engine v0.19.7를 고정하며 다른 버전에는 연결되지 않습니다(워커가 다른 엔진의 프로토콜을 말할 수 없습니다). 다른 엔진을 중지한 후 `npx -y @agentmemory/agentmemory@latest`를 실행하십시오. 고정된 v0.19.7를 `~/.agentmemory/bin`에 설치·실행하며, 기존 `iii`는 건드리지 않습니다.
+agentmemory는 iii-engine v0.22.1를 고정하며 다른 버전에는 연결되지 않습니다(워커가 다른 엔진의 프로토콜을 말할 수 없습니다). 다른 엔진을 중지한 후 `npx -y @agentmemory/agentmemory@latest`를 실행하십시오. 고정된 v0.22.1를 `~/.agentmemory/bin`에 설치·실행하며, 기존 `iii`는 건드리지 않습니다.
</details>
@@ -463,7 +463,7 @@ npx @agentmemory/agentmemory
<h2 id="quick-start"><picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/section-quickstart.svg"><img src="../assets/tags/section-quickstart.svg" alt="빠른 시작" height="32" /></picture></h2>
-호환성: 이 릴리스는 `iii-sdk` 0.19.7을 대상으로 하며 iii-engine을 v0.19.7로 고정합니다.
+호환성: 이 릴리스는 `iii-sdk` 0.22.1을 대상으로 하며 iii-engine을 v0.22.1로 고정합니다.
### 30초 만에 사용해 보기
@@ -515,7 +515,7 @@ npx @agentmemory/agentmemory import-jsonl ~/.claude/projects/-my-project/abc123.
npx @agentmemory/agentmemory upgrade
```
-경고: 이 명령은 현재 workspace/런타임을 변경합니다. JavaScript 의존성을 업데이트할 수 있으며, 고정된 Docker 이미지 `iiidev/iii:0.19.7`를 pull할 수 있습니다. 고정되지 않았거나 더 새로운 iii 엔진을 설치하는 일은 절대 없습니다.
+경고: 이 명령은 현재 workspace/런타임을 변경합니다. JavaScript 의존성을 업데이트할 수 있으며, 고정된 Docker 이미지 `iiidev/iii:0.22.1`를 pull할 수 있습니다. 고정되지 않았거나 더 새로운 iii 엔진을 설치하는 일은 절대 없습니다.
구현 세부 사항은 `src/cli.ts`에 있습니다 (`runUpgrade`는 `src/cli.ts:544-595` 부근 참고).
@@ -719,15 +719,15 @@ npm install && npm run build && npm start
`iii`가 이미 설치되어 있으면 로컬 `iii-engine`으로 agentmemory를 시작하고, Docker가 사용 가능하면 Docker Compose로 폴백합니다. REST, 스트림, 뷰어는 기본적으로 `127.0.0.1`에 바인딩됩니다.
-`iii-engine`을 수동으로 설치하십시오. **agentmemory는 현재 `iii-engine`을 `v0.19.7`로 고정합니다**. `iii-sdk` 의존성과 같은 릴리스입니다. 워커는 해당 엔진의 wire 프로토콜을 사용하고 0.20.0에서 SDK 표면이 재구성되었으므로, 둘은 agentmemory 릴리스에서 함께 올라갑니다. 직접 운영하는 엔진이 일치한다고 확신한다면 `AGENTMEMORY_III_VERSION=<version>`으로 재정의하세요.
+`iii-engine`을 수동으로 설치하십시오. **agentmemory는 현재 `iii-engine`을 `v0.22.1`로 고정합니다**. `iii-sdk` 의존성과 같은 릴리스입니다. 워커는 해당 엔진의 wire 프로토콜을 사용하고 0.20.0에서 SDK 표면이 재구성되었으므로, 둘은 agentmemory 릴리스에서 함께 올라갑니다. 직접 운영하는 엔진이 일치한다고 확신한다면 `AGENTMEMORY_III_VERSION=<version>`으로 재정의하세요.
-- **macOS arm64:** `mkdir -p ~/.local/bin && curl -fsSL https://github.com/iii-hq/iii/releases/download/iii/v0.19.7/iii-aarch64-apple-darwin.tar.gz | tar -xz -C ~/.local/bin && chmod +x ~/.local/bin/iii`
+- **macOS arm64:** `mkdir -p ~/.local/bin && curl -fsSL https://github.com/iii-hq/iii/releases/download/iii/v0.22.1/iii-aarch64-apple-darwin.tar.gz | tar -xz -C ~/.local/bin && chmod +x ~/.local/bin/iii`
- **macOS x64:** `aarch64-apple-darwin`을 `x86_64-apple-darwin`으로 교체
- **Linux x64:** `x86_64-unknown-linux-gnu`로 교체
- **Linux arm64:** `aarch64-unknown-linux-gnu`로 교체
-- **Windows:** [iii-hq/iii releases v0.19.7](https://github.com/iii-hq/iii/releases/tag/iii%2Fv0.19.7)에서 `iii-x86_64-pc-windows-msvc.zip`을 다운로드하고 `iii.exe`를 추출한 후 PATH에 추가
+- **Windows:** [iii-hq/iii releases v0.22.1](https://github.com/iii-hq/iii/releases/tag/iii%2Fv0.22.1)에서 `iii-x86_64-pc-windows-msvc.zip`을 다운로드하고 `iii.exe`를 추출한 후 PATH에 추가
-또는 Docker 사용 (번들된 `docker-compose.yml`이 `iiidev/iii:0.19.7`를 pull). 전체 문서: [iii.dev/docs](https://iii.dev/docs).
+또는 Docker 사용 (번들된 `docker-compose.yml`이 `iiidev/iii:0.22.1`를 pull). 전체 문서: [iii.dev/docs](https://iii.dev/docs).
### Windows
@@ -736,9 +736,9 @@ agentmemory는 Windows 10/11에서 실행되지만, Node.js 패키지만으로
**옵션 A: 사전 빌드된 Windows 바이너리 (권장)**
```powershell
-# 1. Open https://github.com/iii-hq/iii/releases/tag/iii%2Fv0.19.7 in your browser
+# 1. Open https://github.com/iii-hq/iii/releases/tag/iii%2Fv0.22.1 in your browser
# (agentmemory pins the engine to the same release as its iii-sdk;
-# v0.19.7 is the current pair)
+# v0.22.1 is the current pair)
# 2. Download iii-x86_64-pc-windows-msvc.zip
# (or iii-aarch64-pc-windows-msvc.zip if you're on an ARM machine)
# 3. Extract iii.exe somewhere on PATH, or place it at:
@@ -746,7 +746,7 @@ agentmemory는 Windows 10/11에서 실행되지만, Node.js 패키지만으로
# (agentmemory checks that location automatically)
# 4. Verify:
iii --version
-# Should print: 0.19.7
+# Should print: 0.22.1
# 5. Then run agentmemory as usual:
npx -y @agentmemory/agentmemory
@@ -778,7 +778,7 @@ npx -y @agentmemory/mcp
| 포트 충돌 | `netstat -ano \| findstr :3111`로 무엇이 바인딩되어 있는지 확인하고 종료하거나 `--port <N>` 사용 |
| Docker가 설치되어 있어도 Docker 폴백을 건너뜀 | Docker Desktop이 실제로 실행 중인지 확인 (시스템 트레이 아이콘) |
-> 참고: iii **엔진**은 사전 빌드된 바이너리이며 cargo 크레이트가 아니므로, `cargo install`로 설치하려 하지 마세요. (iii **SDK**는 crates.io, npm, PyPI에 게시되어 있지만 agentmemory에는 필요하지 않습니다.) 지원되는 엔진 설치 방법은 모두 v0.19.7에 고정되어 있습니다: 위의 사전 빌드된 v0.19.7 바이너리, 버전 핀**을 포함한** 업스트림 `sh` 설치 스크립트 `curl -fsSL https://install.iii.dev/iii/main/install.sh | VERSION=0.19.7 sh` (macOS/Linux), 그리고 Docker 이미지 `iiidev/iii:0.19.7`. 그냥 `install.sh | sh`를 실행하면 **최신** 엔진이 설치되는데, agentmemory는 이를 지원하지 않습니다; 항상 `VERSION=0.19.7`를 전달하세요. 가장 쉬운 방법은 그냥 `npx @agentmemory/agentmemory`를 실행하는 것입니다. 이 명령이 고정된 엔진을 `~/.agentmemory/bin`에 가져다 줍니다.
+> 참고: iii **엔진**은 사전 빌드된 바이너리이며 cargo 크레이트가 아니므로, `cargo install`로 설치하려 하지 마세요. (iii **SDK**는 crates.io, npm, PyPI에 게시되어 있지만 agentmemory에는 필요하지 않습니다.) 지원되는 엔진 설치 방법은 모두 v0.22.1에 고정되어 있습니다: 위의 사전 빌드된 v0.22.1 바이너리, 버전 핀**을 포함한** 업스트림 `sh` 설치 스크립트 `curl -fsSL https://install.iii.dev/iii/main/install.sh | VERSION=0.22.1 sh` (macOS/Linux), 그리고 Docker 이미지 `iiidev/iii:0.22.1`. 그냥 `install.sh | sh`를 실행하면 **최신** 엔진이 설치되는데, agentmemory는 이를 지원하지 않습니다; 항상 `VERSION=0.22.1`를 전달하세요. 가장 쉬운 방법은 그냥 `npx @agentmemory/agentmemory`를 실행하는 것입니다. 이 명령이 고정된 엔진을 `~/.agentmemory/bin`에 가져다 줍니다.
---
@@ -1158,7 +1158,7 @@ iii console --port 3114 \
**Traces는 이미 켜져 있습니다:**
-`iii-config.yaml`은 `iii-observability` 워커가 활성화된 상태로 제공됩니다(`exporter: memory`, `sampling_ratio: 1.0`, metrics + logs). 추가 설정이 필요 없습니다. agentmemory가 시작되는 순간 모든 메모리 작업이 콘솔이 읽을 수 있는 trace span과 구조화된 로그를 방출합니다.
+`iii-config.yaml`은 `iii-observability` 워커가 활성화된 상태로 제공됩니다(`exporter: memory`, `sampling_ratio: 0.1`, metrics + logs). 추가 설정이 필요 없습니다. agentmemory가 시작되는 순간 모든 메모리 작업이 콘솔이 읽을 수 있는 구조화된 로그를 방출하고, 그중 10분의 1(`sampling_ratio: 0.1`)은 trace span도 방출합니다.
대신 Jaeger/Honeycomb/Grafana Tempo로 내보내고 싶다면 `exporter: memory`를 `exporter: otlp`로 변경하고 iii의 가시성 문서에 따라 collector 엔드포인트를 설정하십시오.
@@ -1180,7 +1180,7 @@ iii worker add iii-cron # scheduled consolidation, decay sweeps, snap
iii worker add iii-queue # durable retries for embedding + compression jobs
iii worker add iii-observability # OTEL traces on every memory op (default on)
iii worker add iii-sandbox # run recalled code inside an isolated microVM
-iii worker add iii-database # swap in a SQL-backed state adapter
+iii worker add database # swap in a SQL-backed state adapter
iii worker add mcp # generic MCP host alongside the agentmemory MCP
```
@@ -1193,7 +1193,7 @@ iii worker add mcp # generic MCP host alongside the agentmemory
| [`iii-queue`](https://workers.iii.dev/workers/iii-queue) | 내구성 있는 재시도: 실패한 임베딩 + 압축 작업은 재시작에도 살아남아 관측 손실 없음 |
| [`iii-observability`](https://workers.iii.dev/workers/iii-observability) | 모든 함수에 OTEL traces, metrics, logs, 첫날부터 `iii-config.yaml`에 연결됨 |
| [`iii-sandbox`](https://workers.iii.dev/workers/iii-sandbox) | `memory_recall`에서 나온 코드를 셸이 아니라 일회용 VM 안에서 실행 |
-| [`iii-database`](https://workers.iii.dev/workers/iii-database) | 인메모리 KV 기본값을 넘어설 때 SQL 기반 state adapter |
+| [`database`](https://workers.iii.dev/workers/database) | 인메모리 KV 기본값을 넘어설 때 SQL 기반 state adapter |
| [`mcp`](https://workers.iii.dev/workers/mcp) | agentmemory의 MCP 옆에 추가 MCP 서버를 세우고 동일한 엔진을 공유 |
전체 레지스트리: [workers.iii.dev](https://workers.iii.dev). 그곳의 모든 워커는 agentmemory가 사용하는 동일한 프리미티브로 구성되며, 이미 갖고 있는 agentmemory도 그중 하나입니다.
diff --git a/READMEs/README.pt-BR.md b/READMEs/README.pt-BR.md
index 30f5d8e2..0dc6643d 100644
--- a/READMEs/README.pt-BR.md
+++ b/READMEs/README.pt-BR.md
@@ -124,7 +124,7 @@ O npx faz cache por versão. Force a mais recente com `npx -y @agentmemory/agent
<details>
<summary><strong>Já roda seu próprio engine iii</strong></summary>
-agentmemory fixa o iii-engine em v0.19.7 e não se conecta a uma versão diferente (o worker não fala o protocolo de outro engine). Pare o outro engine e rode `npx -y @agentmemory/agentmemory@latest`. Ele instala e executa a v0.19.7 fixada em `~/.agentmemory/bin`, deixando o seu próprio `iii` intocado.
+agentmemory fixa o iii-engine em v0.22.1 e não se conecta a uma versão diferente (o worker não fala o protocolo de outro engine). Pare o outro engine e rode `npx -y @agentmemory/agentmemory@latest`. Ele instala e executa a v0.22.1 fixada em `~/.agentmemory/bin`, deixando o seu próprio `iii` intocado.
</details>
@@ -463,7 +463,7 @@ Nenhum deles faz captura automática a partir de hooks de agentes de codificaç
<h2 id="quick-start"><picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/section-quickstart.svg"><img src="../assets/tags/section-quickstart.svg" alt="Início rápido" height="32" /></picture></h2>
-Compatibilidade: este release tem como alvo o `iii-sdk` 0.19.7 e fixa o iii-engine em v0.19.7.
+Compatibilidade: este release tem como alvo o `iii-sdk` 0.22.1 e fixa o iii-engine em v0.22.1.
### Experimente em 30 segundos
@@ -517,7 +517,7 @@ Use o comando de manutenção quando você intencionalmente quiser atualizar seu
npx @agentmemory/agentmemory upgrade
```
-Aviso: este comando muta o workspace/runtime atual. Pode atualizar dependências JavaScript e puxar a imagem Docker fixada `iiidev/iii:0.19.7`. Nunca instala um engine iii sem fixação ou mais recente.
+Aviso: este comando muta o workspace/runtime atual. Pode atualizar dependências JavaScript e puxar a imagem Docker fixada `iiidev/iii:0.22.1`. Nunca instala um engine iii sem fixação ou mais recente.
Detalhes de implementação estão em `src/cli.ts` (veja `runUpgrade` na região `src/cli.ts:544-595`).
@@ -721,15 +721,15 @@ npm install && npm run build && npm start
Isso inicia o agentmemory com um `iii-engine` local se `iii` já estiver instalado, ou cai para Docker Compose se o Docker estiver disponível. REST, streams e o viewer fazem bind em `127.0.0.1` por padrão.
-Instale o `iii-engine` manualmente. **O agentmemory atualmente fixa o `iii-engine` em `v0.19.7`**, o mesmo release da sua dependência `iii-sdk`; o worker fala o protocolo desse engine, e a 0.20.0 reorganizou a superfície do SDK, então os dois avançam juntos a cada release do agentmemory. Sobrescreva com `AGENTMEMORY_III_VERSION=<version>` se você roda seu próprio engine e sabe que ele corresponde.
+Instale o `iii-engine` manualmente. **O agentmemory atualmente fixa o `iii-engine` em `v0.22.1`**, o mesmo release da sua dependência `iii-sdk`; o worker fala o protocolo desse engine, e a 0.20.0 reorganizou a superfície do SDK, então os dois avançam juntos a cada release do agentmemory. Sobrescreva com `AGENTMEMORY_III_VERSION=<version>` se você roda seu próprio engine e sabe que ele corresponde.
-- **macOS arm64:** `mkdir -p ~/.local/bin && curl -fsSL https://github.com/iii-hq/iii/releases/download/iii/v0.19.7/iii-aarch64-apple-darwin.tar.gz | tar -xz -C ~/.local/bin && chmod +x ~/.local/bin/iii`
+- **macOS arm64:** `mkdir -p ~/.local/bin && curl -fsSL https://github.com/iii-hq/iii/releases/download/iii/v0.22.1/iii-aarch64-apple-darwin.tar.gz | tar -xz -C ~/.local/bin && chmod +x ~/.local/bin/iii`
- **macOS x64:** troque `aarch64-apple-darwin` por `x86_64-apple-darwin`
- **Linux x64:** troque por `x86_64-unknown-linux-gnu`
- **Linux arm64:** troque por `aarch64-unknown-linux-gnu`
-- **Windows:** baixe `iii-x86_64-pc-windows-msvc.zip` de [iii-hq/iii releases v0.19.7](https://github.com/iii-hq/iii/releases/tag/iii%2Fv0.19.7), extraia `iii.exe`, adicione ao PATH
+- **Windows:** baixe `iii-x86_64-pc-windows-msvc.zip` de [iii-hq/iii releases v0.22.1](https://github.com/iii-hq/iii/releases/tag/iii%2Fv0.22.1), extraia `iii.exe`, adicione ao PATH
-Ou use Docker (o `docker-compose.yml` empacotado puxa `iiidev/iii:0.19.7`). Docs completas: [iii.dev/docs](https://iii.dev/docs).
+Ou use Docker (o `docker-compose.yml` empacotado puxa `iiidev/iii:0.22.1`). Docs completas: [iii.dev/docs](https://iii.dev/docs).
### Windows
@@ -738,9 +738,9 @@ agentmemory roda em Windows 10/11, mas só o pacote Node.js não é suficiente;
**Opção A: binário Windows pré-compilado (recomendado)**
```powershell
-# 1. Open https://github.com/iii-hq/iii/releases/tag/iii%2Fv0.19.7 in your browser
+# 1. Open https://github.com/iii-hq/iii/releases/tag/iii%2Fv0.22.1 in your browser
# (agentmemory pins the engine to the same release as its iii-sdk;
-# v0.19.7 is the current pair)
+# v0.22.1 is the current pair)
# 2. Download iii-x86_64-pc-windows-msvc.zip
# (or iii-aarch64-pc-windows-msvc.zip if you're on an ARM machine)
# 3. Extract iii.exe somewhere on PATH, or place it at:
@@ -748,7 +748,7 @@ agentmemory roda em Windows 10/11, mas só o pacote Node.js não é suficiente;
# (agentmemory checks that location automatically)
# 4. Verify:
iii --version
-# Should print: 0.19.7
+# Should print: 0.22.1
# 5. Then run agentmemory as usual:
npx -y @agentmemory/agentmemory
@@ -780,7 +780,7 @@ npx -y @agentmemory/mcp
| Conflito de porta | `netstat -ano \| findstr :3111` para ver o que está em bind, mate o processo ou use `--port <N>` |
| Fallback do Docker é pulado mesmo com Docker instalado | Confira se o Docker Desktop está de fato rodando (ícone na bandeja do sistema) |
-> Nota: o **engine** iii é um binário pré-compilado, não um crate do cargo, então não tente instalá-lo com `cargo install`. (Os **SDKs** do iii são publicados no crates.io, npm e PyPI, mas o agentmemory não precisa deles.) Métodos de instalação do engine suportados, todos fixados em v0.19.7: o binário pré-compilado v0.19.7 acima, o script de instalação `sh` upstream **com a fixação de versão** `curl -fsSL https://install.iii.dev/iii/main/install.sh | VERSION=0.19.7 sh` (macOS/Linux) e a imagem Docker `iiidev/iii:0.19.7`. Um simples `install.sh | sh` instala o engine **mais recente**, que o agentmemory não suporta; sempre passe `VERSION=0.19.7`. O mais fácil de tudo: basta rodar `npx @agentmemory/agentmemory`, que busca o engine fixado em `~/.agentmemory/bin` para você.
+> Nota: o **engine** iii é um binário pré-compilado, não um crate do cargo, então não tente instalá-lo com `cargo install`. (Os **SDKs** do iii são publicados no crates.io, npm e PyPI, mas o agentmemory não precisa deles.) Métodos de instalação do engine suportados, todos fixados em v0.22.1: o binário pré-compilado v0.22.1 acima, o script de instalação `sh` upstream **com a fixação de versão** `curl -fsSL https://install.iii.dev/iii/main/install.sh | VERSION=0.22.1 sh` (macOS/Linux) e a imagem Docker `iiidev/iii:0.22.1`. Um simples `install.sh | sh` instala o engine **mais recente**, que o agentmemory não suporta; sempre passe `VERSION=0.22.1`. O mais fácil de tudo: basta rodar `npx @agentmemory/agentmemory`, que busca o engine fixado em `~/.agentmemory/bin` para você.
---
@@ -1169,7 +1169,7 @@ iii console --port 3114 \
**Traces já estão ativos:**
-`iii-config.yaml` vem com o worker `iii-observability` habilitado (`exporter: memory`, `sampling_ratio: 1.0`, métricas + logs). Sem configuração extra; no momento em que o agentmemory inicia, toda operação de memória emite um trace span e um log estruturado que o console consegue ler.
+`iii-config.yaml` vem com o worker `iii-observability` habilitado (`exporter: memory`, `sampling_ratio: 0.1`, métricas + logs). Sem configuração extra; no momento em que o agentmemory inicia, toda operação de memória emite um log estruturado que o console consegue ler, e uma em cada dez (`sampling_ratio: 0.1`) também emite um trace span.
Se você quiser exportar para Jaeger/Honeycomb/Grafana Tempo, troque `exporter: memory` por `exporter: otlp` e configure o endpoint do collector conforme a documentação de observabilidade do iii.
@@ -1191,7 +1191,7 @@ iii worker add iii-cron # scheduled consolidation, decay sweeps, snap
iii worker add iii-queue # durable retries for embedding + compression jobs
iii worker add iii-observability # OTEL traces on every memory op (default on)
iii worker add iii-sandbox # run recalled code inside an isolated microVM
-iii worker add iii-database # swap in a SQL-backed state adapter
+iii worker add database # swap in a SQL-backed state adapter
iii worker add mcp # generic MCP host alongside the agentmemory MCP
```
@@ -1204,7 +1204,7 @@ Cada `iii worker add` registra novas funções e triggers no mesmo engine onde o
| [`iii-queue`](https://workers.iii.dev/workers/iii-queue) | Retries duráveis: jobs falhos de embedding + compressão sobrevivem a restart, sem observações perdidas |
| [`iii-observability`](https://workers.iii.dev/workers/iii-observability) | Traces OTEL, métricas, logs em toda função, cabeado em `iii-config.yaml` desde o primeiro dia |
| [`iii-sandbox`](https://workers.iii.dev/workers/iii-sandbox) | Código que veio do `memory_recall` roda dentro de uma VM descartável, não no seu shell |
-| [`iii-database`](https://workers.iii.dev/workers/iii-database) | Adaptador de estado baseado em SQL quando você ultrapassa o KV in-memory padrão |
+| [`database`](https://workers.iii.dev/workers/database) | Adaptador de estado baseado em SQL quando você ultrapassa o KV in-memory padrão |
| [`mcp`](https://workers.iii.dev/workers/mcp) | Suba servidores MCP adicionais ao lado do MCP do agentmemory, compartilhando o mesmo engine |
Registry completo: [workers.iii.dev](https://workers.iii.dev). Todo worker lá se compõe pelos mesmos primitivos que o agentmemory usa, e o agentmemory que você já tem é um deles.
diff --git a/READMEs/README.ru-RU.md b/READMEs/README.ru-RU.md
index 1c349f59..f41b0207 100644
--- a/READMEs/README.ru-RU.md
+++ b/READMEs/README.ru-RU.md
@@ -124,7 +124,7 @@ npx кеширует пакеты по версиям. Принудительн
<details>
<summary><strong>Уже запущен собственный движок iii</strong></summary>
-agentmemory закреплён на iii-engine v0.19.7 и не подключится к другой версии (воркер не умеет говорить на протоколе другого движка). Остановите другой движок и запустите `npx -y @agentmemory/agentmemory@latest` — он установит и запустит закреплённый v0.19.7 в `~/.agentmemory/bin`, не трогая ваш собственный `iii`.
+agentmemory закреплён на iii-engine v0.22.1 и не подключится к другой версии (воркер не умеет говорить на протоколе другого движка). Остановите другой движок и запустите `npx -y @agentmemory/agentmemory@latest` — он установит и запустит закреплённый v0.22.1 в `~/.agentmemory/bin`, не трогая ваш собственный `iii`.
</details>
@@ -463,7 +463,7 @@ npx @agentmemory/agentmemory
<h2 id="quick-start"><picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/section-quickstart.svg"><img src="../assets/tags/section-quickstart.svg" alt="Быстрый старт" height="32" /></picture></h2>
-Совместимость: этот релиз нацелен на `iii-sdk` 0.19.7 и закрепляет iii-engine v0.19.7.
+Совместимость: этот релиз нацелен на `iii-sdk` 0.22.1 и закрепляет iii-engine v0.22.1.
### Попробуйте за 30 секунд
@@ -517,7 +517,7 @@ npx @agentmemory/agentmemory import-jsonl ~/.claude/projects/-my-project/abc123.
npx @agentmemory/agentmemory upgrade
```
-Внимание: команда меняет текущее рабочее окружение / runtime. Она может обновлять JavaScript-зависимости и стянуть закреплённый Docker-образ `iiidev/iii:0.19.7`. Она никогда не устанавливает незакреплённый или более новый движок iii.
+Внимание: команда меняет текущее рабочее окружение / runtime. Она может обновлять JavaScript-зависимости и стянуть закреплённый Docker-образ `iiidev/iii:0.22.1`. Она никогда не устанавливает незакреплённый или более новый движок iii.
Детали реализации — в `src/cli.ts` (см. `runUpgrade` в районе `src/cli.ts:544-595`).
@@ -721,15 +721,15 @@ npm install && npm run build && npm start
Это поднимает agentmemory с локальным `iii-engine`, если `iii` уже установлен, либо откатывается к Docker Compose, если есть Docker. REST, стримы и просмотрщик по умолчанию слушают на `127.0.0.1`.
-Установите `iii-engine` вручную. **agentmemory сейчас зафиксирован на `iii-engine` `v0.19.7`** — той же версии, что и его зависимость `iii-sdk`; воркер говорит на wire-протоколе именно этого движка, а 0.20.0 перестроил поверхность SDK, поэтому оба обновляются вместе в релизах agentmemory. Переопределите через `AGENTMEMORY_III_VERSION=<version>`, если запускаете собственный движок и уверены, что версии совпадают.
+Установите `iii-engine` вручную. **agentmemory сейчас зафиксирован на `iii-engine` `v0.22.1`** — той же версии, что и его зависимость `iii-sdk`; воркер говорит на wire-протоколе именно этого движка, а 0.20.0 перестроил поверхность SDK, поэтому оба обновляются вместе в релизах agentmemory. Переопределите через `AGENTMEMORY_III_VERSION=<version>`, если запускаете собственный движок и уверены, что версии совпадают.
-- **macOS arm64:** `mkdir -p ~/.local/bin && curl -fsSL https://github.com/iii-hq/iii/releases/download/iii/v0.19.7/iii-aarch64-apple-darwin.tar.gz | tar -xz -C ~/.local/bin && chmod +x ~/.local/bin/iii`
+- **macOS arm64:** `mkdir -p ~/.local/bin && curl -fsSL https://github.com/iii-hq/iii/releases/download/iii/v0.22.1/iii-aarch64-apple-darwin.tar.gz | tar -xz -C ~/.local/bin && chmod +x ~/.local/bin/iii`
- **macOS x64:** замените `aarch64-apple-darwin` на `x86_64-apple-darwin`
- **Linux x64:** замените на `x86_64-unknown-linux-gnu`
- **Linux arm64:** замените на `aarch64-unknown-linux-gnu`
-- **Windows:** скачайте `iii-x86_64-pc-windows-msvc.zip` из [iii-hq/iii releases v0.19.7](https://github.com/iii-hq/iii/releases/tag/iii%2Fv0.19.7), распакуйте `iii.exe`, добавьте в PATH
+- **Windows:** скачайте `iii-x86_64-pc-windows-msvc.zip` из [iii-hq/iii releases v0.22.1](https://github.com/iii-hq/iii/releases/tag/iii%2Fv0.22.1), распакуйте `iii.exe`, добавьте в PATH
-Либо используйте Docker (входящий в комплект `docker-compose.yml` тянет `iiidev/iii:0.19.7`). Полная документация: [iii.dev/docs](https://iii.dev/docs).
+Либо используйте Docker (входящий в комплект `docker-compose.yml` тянет `iiidev/iii:0.22.1`). Полная документация: [iii.dev/docs](https://iii.dev/docs).
### Windows
@@ -738,9 +738,9 @@ agentmemory работает на Windows 10/11, но одного Node.js-па
**Вариант A: готовый Windows-бинарь (рекомендуется)**
```powershell
-# 1. Open https://github.com/iii-hq/iii/releases/tag/iii%2Fv0.19.7 in your browser
+# 1. Open https://github.com/iii-hq/iii/releases/tag/iii%2Fv0.22.1 in your browser
# (agentmemory pins the engine to the same release as its iii-sdk;
-# v0.19.7 is the current pair)
+# v0.22.1 is the current pair)
# 2. Download iii-x86_64-pc-windows-msvc.zip
# (or iii-aarch64-pc-windows-msvc.zip if you're on an ARM machine)
# 3. Extract iii.exe somewhere on PATH, or place it at:
@@ -748,7 +748,7 @@ agentmemory работает на Windows 10/11, но одного Node.js-па
# (agentmemory checks that location automatically)
# 4. Verify:
iii --version
-# Should print: 0.19.7
+# Should print: 0.22.1
# 5. Then run agentmemory as usual:
npx -y @agentmemory/agentmemory
@@ -780,7 +780,7 @@ npx -y @agentmemory/mcp
| Конфликт порта | `netstat -ano \| findstr :3111`, чтобы понять, что занимает порт, затем убить процесс или использовать `--port <N>` |
| Откат на Docker пропускается, хотя Docker установлен | Убедитесь, что Docker Desktop действительно запущен (иконка в трее) |
-> Примечание: **движок** iii — это готовый бинарь, а не cargo-крейт, не пытайтесь установить его через `cargo install`. (**SDK** iii опубликованы на crates.io, npm и PyPI, но agentmemory они не нужны.) Поддерживаемые способы установки движка, все закреплены на v0.19.7: готовый бинарь v0.19.7 выше, upstream-`sh`-скрипт **с закреплением версии** `curl -fsSL https://install.iii.dev/iii/main/install.sh | VERSION=0.19.7 sh` (macOS/Linux) и Docker-образ `iiidev/iii:0.19.7`. Простой `install.sh | sh` устанавливает **последний** движок, который agentmemory не поддерживает, — всегда передавайте `VERSION=0.19.7`. Самый простой вариант: просто запустите `npx @agentmemory/agentmemory`, который сам загрузит закреплённый движок в `~/.agentmemory/bin`.
+> Примечание: **движок** iii — это готовый бинарь, а не cargo-крейт, не пытайтесь установить его через `cargo install`. (**SDK** iii опубликованы на crates.io, npm и PyPI, но agentmemory они не нужны.) Поддерживаемые способы установки движка, все закреплены на v0.22.1: готовый бинарь v0.22.1 выше, upstream-`sh`-скрипт **с закреплением версии** `curl -fsSL https://install.iii.dev/iii/main/install.sh | VERSION=0.22.1 sh` (macOS/Linux) и Docker-образ `iiidev/iii:0.22.1`. Простой `install.sh | sh` устанавливает **последний** движок, который agentmemory не поддерживает, — всегда передавайте `VERSION=0.22.1`. Самый простой вариант: просто запустите `npx @agentmemory/agentmemory`, который сам загрузит закреплённый движок в `~/.agentmemory/bin`.
---
@@ -1176,7 +1176,7 @@ iii console --port 3114 \
**Traces уже включены:**
-`iii-config.yaml` поставляется с включённым воркером `iii-observability` (`exporter: memory`, `sampling_ratio: 1.0`, метрики + логи). Дополнительная настройка не нужна — как только agentmemory запускается, каждая операция памяти эмитит trace-span и структурированный лог, который консоль читает.
+`iii-config.yaml` поставляется с включённым воркером `iii-observability` (`exporter: memory`, `sampling_ratio: 0.1`, метрики + логи). Дополнительная настройка не нужна — как только agentmemory запускается, каждая операция памяти эмитит структурированный лог, который консоль читает, а каждая десятая (`sampling_ratio: 0.1`) ещё и trace-span.
Если хотите экспортировать в Jaeger/Honeycomb/Grafana Tempo, измените `exporter: memory` на `exporter: otlp` и укажите эндпоинт коллектора согласно документации по observability в iii.
@@ -1198,7 +1198,7 @@ iii worker add iii-cron # scheduled consolidation, decay sweeps, snap
iii worker add iii-queue # durable retries for embedding + compression jobs
iii worker add iii-observability # OTEL traces on every memory op (default on)
iii worker add iii-sandbox # run recalled code inside an isolated microVM
-iii worker add iii-database # swap in a SQL-backed state adapter
+iii worker add database # swap in a SQL-backed state adapter
iii worker add mcp # generic MCP host alongside the agentmemory MCP
```
@@ -1211,7 +1211,7 @@ iii worker add mcp # generic MCP host alongside the agentmemory
| [`iii-queue`](https://workers.iii.dev/workers/iii-queue) | Надёжные повторы: упавшие job'ы эмбеддинга и компрессии переживают перезапуск, наблюдения не теряются |
| [`iii-observability`](https://workers.iii.dev/workers/iii-observability) | OTEL-трейсы, метрики, логи на каждой функции — подключены в `iii-config.yaml` с первого дня |
| [`iii-sandbox`](https://workers.iii.dev/workers/iii-sandbox) | Код, пришедший из `memory_recall`, исполняется внутри одноразовой VM, а не в вашем shell |
-| [`iii-database`](https://workers.iii.dev/workers/iii-database) | SQL-адаптер состояния, когда дефолтная in-memory KV уже мала |
+| [`database`](https://workers.iii.dev/workers/database) | SQL-адаптер состояния, когда дефолтная in-memory KV уже мала |
| [`mcp`](https://workers.iii.dev/workers/mcp) | Поднять дополнительные MCP-серверы рядом с MCP'ом agentmemory, на одном и том же движке |
Полный реестр: [workers.iii.dev](https://workers.iii.dev). Каждый воркер там собирается из тех же примитивов, что и agentmemory — и тот agentmemory, который у вас уже есть, — один из них.
diff --git a/READMEs/README.tr-TR.md b/READMEs/README.tr-TR.md
index 1c122190..ae7923d5 100644
--- a/READMEs/README.tr-TR.md
+++ b/READMEs/README.tr-TR.md
@@ -124,7 +124,7 @@ npx sürüm bazında önbelleğe alır. En güncelini `npx -y @agentmemory/agent
<details>
<summary><strong>Zaten kendi iii engine'inizi çalıştırıyorsanız</strong></summary>
-agentmemory iii-engine'i v0.19.7'ye sabitler ve farklı bir sürüme bağlanmaz (worker başka bir engine'in protokolünü konuşamaz). Diğer engine'i durdurun, ardından `npx -y @agentmemory/agentmemory@latest` çalıştırın. Sabitlenmiş v0.19.7'yi `~/.agentmemory/bin` içine kurup çalıştırır ve kendi `iii`'nizi olduğu gibi bırakır.
+agentmemory iii-engine'i v0.22.1'ye sabitler ve farklı bir sürüme bağlanmaz (worker başka bir engine'in protokolünü konuşamaz). Diğer engine'i durdurun, ardından `npx -y @agentmemory/agentmemory@latest` çalıştırın. Sabitlenmiş v0.22.1'yi `~/.agentmemory/bin` içine kurup çalıştırır ve kendi `iii`'nizi olduğu gibi bırakır.
</details>
@@ -463,7 +463,7 @@ Bunların hiçbiri kodlama-ajanı hook'larından otomatik yakalama yapmaz, yerel
<h2 id="quick-start"><picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/section-quickstart.svg"><img src="../assets/tags/section-quickstart.svg" alt="Quick Start" height="32" /></picture></h2>
-Uyumluluk: bu sürüm `iii-sdk` 0.19.7'yi hedefler ve iii-engine'i v0.19.7'ye sabitler.
+Uyumluluk: bu sürüm `iii-sdk` 0.22.1'yi hedefler ve iii-engine'i v0.22.1'ye sabitler.
### 30 saniyede deneyin
@@ -515,7 +515,7 @@ Yerel runtime'ınızı bilinçli olarak güncellemek istediğinizde bakım komut
npx @agentmemory/agentmemory upgrade
```
-Uyarı: bu komut mevcut çalışma alanını/runtime'ı değiştirir. JavaScript bağımlılıklarını güncelleyebilir ve sabitlenmiş `iiidev/iii:0.19.7` Docker imajını çekebilir. Asla sabitlenmemiş ya da daha yeni bir iii motoru kurmaz.
+Uyarı: bu komut mevcut çalışma alanını/runtime'ı değiştirir. JavaScript bağımlılıklarını güncelleyebilir ve sabitlenmiş `iiidev/iii:0.22.1` Docker imajını çekebilir. Asla sabitlenmemiş ya da daha yeni bir iii motoru kurmaz.
Uygulama detayları `src/cli.ts` içinde (`src/cli.ts:544-595` bölgesi civarında `runUpgrade`'a bakın).
@@ -719,15 +719,15 @@ npm install && npm run build && npm start
Bu, `iii` zaten kuruluysa yerel bir `iii-engine` ile agentmemory'yi başlatır veya Docker mevcutsa Docker Compose'a düşer. REST, stream'ler ve görüntüleyici varsayılan olarak `127.0.0.1`'e bağlanır.
-`iii-engine`'i manuel olarak kurun. **agentmemory şu anda `iii-engine`'i `v0.19.7`'ye sabitliyor**; bu, `iii-sdk` bağımlılığıyla aynı sürümdür. Worker tam olarak o engine'in wire protokolünü konuşur ve 0.20.0 SDK yüzeyini yeniden düzenlediği için ikisi agentmemory sürümlerinde birlikte yükseltilir. Kendi engine'inizi çalıştırıyor ve eşleştiğinden eminseniz `AGENTMEMORY_III_VERSION=<version>` ile geçersiz kılın.
+`iii-engine`'i manuel olarak kurun. **agentmemory şu anda `iii-engine`'i `v0.22.1`'ye sabitliyor**; bu, `iii-sdk` bağımlılığıyla aynı sürümdür. Worker tam olarak o engine'in wire protokolünü konuşur ve 0.20.0 SDK yüzeyini yeniden düzenlediği için ikisi agentmemory sürümlerinde birlikte yükseltilir. Kendi engine'inizi çalıştırıyor ve eşleştiğinden eminseniz `AGENTMEMORY_III_VERSION=<version>` ile geçersiz kılın.
-- **macOS arm64:** `mkdir -p ~/.local/bin && curl -fsSL https://github.com/iii-hq/iii/releases/download/iii/v0.19.7/iii-aarch64-apple-darwin.tar.gz | tar -xz -C ~/.local/bin && chmod +x ~/.local/bin/iii`
+- **macOS arm64:** `mkdir -p ~/.local/bin && curl -fsSL https://github.com/iii-hq/iii/releases/download/iii/v0.22.1/iii-aarch64-apple-darwin.tar.gz | tar -xz -C ~/.local/bin && chmod +x ~/.local/bin/iii`
- **macOS x64:** `aarch64-apple-darwin`'i `x86_64-apple-darwin` ile değiştirin
- **Linux x64:** `x86_64-unknown-linux-gnu` ile değiştirin
- **Linux arm64:** `aarch64-unknown-linux-gnu` ile değiştirin
-- **Windows:** [iii-hq/iii releases v0.19.7](https://github.com/iii-hq/iii/releases/tag/iii%2Fv0.19.7)'den `iii-x86_64-pc-windows-msvc.zip`'i indirin, `iii.exe`'yi çıkarın, PATH'e ekleyin
+- **Windows:** [iii-hq/iii releases v0.22.1](https://github.com/iii-hq/iii/releases/tag/iii%2Fv0.22.1)'den `iii-x86_64-pc-windows-msvc.zip`'i indirin, `iii.exe`'yi çıkarın, PATH'e ekleyin
-Veya Docker kullanın (paketli `docker-compose.yml` `iiidev/iii:0.19.7`'yi çeker). Tam dokümanlar: [iii.dev/docs](https://iii.dev/docs).
+Veya Docker kullanın (paketli `docker-compose.yml` `iiidev/iii:0.22.1`'yi çeker). Tam dokümanlar: [iii.dev/docs](https://iii.dev/docs).
### Windows
@@ -736,9 +736,9 @@ agentmemory Windows 10/11'de çalışır, ancak yalnızca Node.js paketi yeterli
**Seçenek A: önceden derlenmiş Windows ikiliği (önerilen)**
```powershell
-# 1. Tarayıcınızda https://github.com/iii-hq/iii/releases/tag/iii%2Fv0.19.7 açın
+# 1. Tarayıcınızda https://github.com/iii-hq/iii/releases/tag/iii%2Fv0.22.1 açın
# (agentmemory, engine'i iii-sdk ile aynı sürüme sabitler;
-# mevcut çift v0.19.7)
+# mevcut çift v0.22.1)
# 2. iii-x86_64-pc-windows-msvc.zip indirin
# (veya ARM makinedeyseniz iii-aarch64-pc-windows-msvc.zip)
# 3. iii.exe'yi PATH'te bir yere çıkarın veya şuraya yerleştirin:
@@ -746,7 +746,7 @@ agentmemory Windows 10/11'de çalışır, ancak yalnızca Node.js paketi yeterli
# (agentmemory bu konumu otomatik kontrol eder)
# 4. Doğrulayın:
iii --version
-# Şunu yazmalı: 0.19.7
+# Şunu yazmalı: 0.22.1
# 5. Ardından agentmemory'yi her zamanki gibi çalıştırın:
npx -y @agentmemory/agentmemory
@@ -778,7 +778,7 @@ npx -y @agentmemory/mcp
| Port çakışması | `netstat -ano \| findstr :3111` ile neyin bağlı olduğunu görün, ardından öldürün veya `--port <N>` kullanın |
| Docker kurulu olsa bile Docker fallback atlanıyor | Docker Desktop'ın gerçekten çalıştığından emin olun (sistem tepsisi simgesi) |
-> Not: iii **motoru** önceden derlenmiş bir ikiliktir, bir cargo crate'i değildir, bu yüzden onu `cargo install` ile kurmaya çalışmayın. (iii **SDK'ları** crates.io, npm ve PyPI'de yayımlanmıştır, ancak agentmemory bunlara ihtiyaç duymaz.) Desteklenen motor kurulum yöntemleri, hepsi v0.19.7'ye sabitlenmiştir: yukarıdaki önceden derlenmiş v0.19.7 ikiliği, sürüm sabitlemesi **ile** upstream `sh` kurulum scripti `curl -fsSL https://install.iii.dev/iii/main/install.sh | VERSION=0.19.7 sh` (macOS/Linux) ve Docker imajı `iiidev/iii:0.19.7`. Yalın bir `install.sh | sh`, agentmemory'nin desteklemediği **en son** motoru kurar; her zaman `VERSION=0.19.7` geçirin. Hepsinden kolayı: sadece `npx @agentmemory/agentmemory` çalıştırın; bu, sabitlenmiş motoru sizin için `~/.agentmemory/bin` dizinine indirir.
+> Not: iii **motoru** önceden derlenmiş bir ikiliktir, bir cargo crate'i değildir, bu yüzden onu `cargo install` ile kurmaya çalışmayın. (iii **SDK'ları** crates.io, npm ve PyPI'de yayımlanmıştır, ancak agentmemory bunlara ihtiyaç duymaz.) Desteklenen motor kurulum yöntemleri, hepsi v0.22.1'ye sabitlenmiştir: yukarıdaki önceden derlenmiş v0.22.1 ikiliği, sürüm sabitlemesi **ile** upstream `sh` kurulum scripti `curl -fsSL https://install.iii.dev/iii/main/install.sh | VERSION=0.22.1 sh` (macOS/Linux) ve Docker imajı `iiidev/iii:0.22.1`. Yalın bir `install.sh | sh`, agentmemory'nin desteklemediği **en son** motoru kurar; her zaman `VERSION=0.22.1` geçirin. Hepsinden kolayı: sadece `npx @agentmemory/agentmemory` çalıştırın; bu, sabitlenmiş motoru sizin için `~/.agentmemory/bin` dizinine indirir.
---
@@ -1178,7 +1178,7 @@ iii console --port 3114 \
**Trace'ler zaten açık:**
-`iii-config.yaml` `iii-observability` worker'ı etkinleştirilmiş olarak gelir (`exporter: memory`, `sampling_ratio: 1.0`, metrikler + log'lar). Ekstra yapılandırma gerekmez; agentmemory başlar başlamaz, her bellek işlemi konsolun okuyabileceği bir trace span'ı ve yapılandırılmış bir log yayar.
+`iii-config.yaml` `iii-observability` worker'ı etkinleştirilmiş olarak gelir (`exporter: memory`, `sampling_ratio: 0.1`, metrikler + log'lar). Ekstra yapılandırma gerekmez; agentmemory başlar başlamaz, her bellek işlemi konsolun okuyabileceği yapılandırılmış bir log yayar ve her on işlemden biri (`sampling_ratio: 0.1`) ayrıca bir trace span'ı yayar.
Bunun yerine Jaeger/Honeycomb/Grafana Tempo'ya dışa aktarmak isterseniz, `exporter: memory`'yi `exporter: otlp` olarak değiştirin ve collector endpoint'ini iii'nin observability dokümanlarına göre ayarlayın.
@@ -1200,7 +1200,7 @@ iii worker add iii-cron # zamanlanmış konsolidasyon, decay süpürm
iii worker add iii-queue # embedding + sıkıştırma işleri için dayanıklı yeniden denemeler
iii worker add iii-observability # her bellek op'unda OTEL trace'leri (varsayılan açık)
iii worker add iii-sandbox # hatırlanan kodu izole bir microVM içinde çalıştır
-iii worker add iii-database # SQL destekli bir state adaptörü tak
+iii worker add database # SQL destekli bir state adaptörü tak
iii worker add mcp # agentmemory MCP'sinin yanında genel MCP host'u
```
@@ -1213,7 +1213,7 @@ Her `iii worker add` agentmemory'nin zaten çalıştığı aynı engine'e yeni f
| [`iii-queue`](https://workers.iii.dev/workers/iii-queue) | Dayanıklı yeniden denemeler: başarısız embedding + sıkıştırma işleri yeniden başlatmaya dayanır, kayıp gözlem yok |
| [`iii-observability`](https://workers.iii.dev/workers/iii-observability) | OTEL trace'leri, metrikleri, log'ları her fonksiyonda, birinci günden itibaren `iii-config.yaml`'da bağlı |
| [`iii-sandbox`](https://workers.iii.dev/workers/iii-sandbox) | `memory_recall`'dan çıkan kod, shell'inizde değil, bir kullan-at VM içinde çalışır |
-| [`iii-database`](https://workers.iii.dev/workers/iii-database) | In-memory KV varsayılanlarını aştığınızda SQL destekli state adaptörü |
+| [`database`](https://workers.iii.dev/workers/database) | In-memory KV varsayılanlarını aştığınızda SQL destekli state adaptörü |
| [`mcp`](https://workers.iii.dev/workers/mcp) | agentmemory'ninin yanında ekstra MCP sunucuları ayağa kaldırın, aynı engine'i paylaşın |
Tam kayıt defteri: [workers.iii.dev](https://workers.iii.dev). Oradaki her worker, agentmemory'nin kullandığı aynı primitifler aracılığıyla bir araya gelir ve elinizdeki agentmemory de onlardan biridir.
diff --git a/READMEs/README.zh-CN.md b/READMEs/README.zh-CN.md
index 1030e02d..7f7c8a03 100644
--- a/READMEs/README.zh-CN.md
+++ b/READMEs/README.zh-CN.md
@@ -124,7 +124,7 @@ npx 会按版本缓存。用 `npx -y @agentmemory/agentmemory@latest` 强制拉
<details>
<summary><strong>已在运行自己的 iii 引擎</strong></summary>
-agentmemory 固定 iii-engine v0.19.7,不会挂接到其他版本(worker 无法使用其他引擎的协议)。停止另一个引擎,然后运行 `npx -y @agentmemory/agentmemory@latest`。它会在 `~/.agentmemory/bin` 安装并运行固定的 v0.19.7,不动你自己的 `iii`。
+agentmemory 固定 iii-engine v0.22.1,不会挂接到其他版本(worker 无法使用其他引擎的协议)。停止另一个引擎,然后运行 `npx -y @agentmemory/agentmemory@latest`。它会在 `~/.agentmemory/bin` 安装并运行固定的 v0.22.1,不动你自己的 `iii`。
</details>
@@ -463,7 +463,7 @@ npx @agentmemory/agentmemory
<h2 id="quick-start"><picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/section-quickstart.svg"><img src="../assets/tags/section-quickstart.svg" alt="Quick Start" height="32" /></picture></h2>
-兼容性:此版本面向 `iii-sdk` 0.19.7,并将 iii-engine 固定在 v0.19.7。
+兼容性:此版本面向 `iii-sdk` 0.22.1,并将 iii-engine 固定在 v0.22.1。
### 30 秒体验
@@ -515,7 +515,7 @@ npx @agentmemory/agentmemory import-jsonl ~/.claude/projects/-my-project/abc123.
npx @agentmemory/agentmemory upgrade
```
-警告:此命令会变更当前工作空间/运行时。它可能更新 JavaScript 依赖,并拉取固定版本的 Docker 镜像 `iiidev/iii:0.19.7`。它绝不会安装未固定版本或更新的 iii 引擎。
+警告:此命令会变更当前工作空间/运行时。它可能更新 JavaScript 依赖,并拉取固定版本的 Docker 镜像 `iiidev/iii:0.22.1`。它绝不会安装未固定版本或更新的 iii 引擎。
实现细节见 `src/cli.ts`(参考 `src/cli.ts:544-595` 附近的 `runUpgrade`)。
@@ -720,15 +720,15 @@ npm install && npm run build && npm start
如果已经安装 `iii`,这会以本地 `iii-engine` 启动 agentmemory;如果 Docker 可用,则回退到 Docker Compose。REST、流和查看器默认绑定到 `127.0.0.1`。
-手动安装 `iii-engine`。**agentmemory 当前将 `iii-engine` 固定在 `v0.19.7`**,与其 `iii-sdk` 依赖是同一个版本;worker 使用的是该引擎的 wire 协议,而 0.20.0 重组了 SDK 接口,因此两者在 agentmemory 的每个版本中一起升级。如果你运行自己的引擎并确定版本匹配,可用 `AGENTMEMORY_III_VERSION=<version>` 覆盖。
+手动安装 `iii-engine`。**agentmemory 当前将 `iii-engine` 固定在 `v0.22.1`**,与其 `iii-sdk` 依赖是同一个版本;worker 使用的是该引擎的 wire 协议,而 0.20.0 重组了 SDK 接口,因此两者在 agentmemory 的每个版本中一起升级。如果你运行自己的引擎并确定版本匹配,可用 `AGENTMEMORY_III_VERSION=<version>` 覆盖。
-- **macOS arm64:** `mkdir -p ~/.local/bin && curl -fsSL https://github.com/iii-hq/iii/releases/download/iii/v0.19.7/iii-aarch64-apple-darwin.tar.gz | tar -xz -C ~/.local/bin && chmod +x ~/.local/bin/iii`
+- **macOS arm64:** `mkdir -p ~/.local/bin && curl -fsSL https://github.com/iii-hq/iii/releases/download/iii/v0.22.1/iii-aarch64-apple-darwin.tar.gz | tar -xz -C ~/.local/bin && chmod +x ~/.local/bin/iii`
- **macOS x64:** 把 `aarch64-apple-darwin` 换成 `x86_64-apple-darwin`
- **Linux x64:** 换成 `x86_64-unknown-linux-gnu`
- **Linux arm64:** 换成 `aarch64-unknown-linux-gnu`
-- **Windows:** 从 [iii-hq/iii releases v0.19.7](https://github.com/iii-hq/iii/releases/tag/iii%2Fv0.19.7) 下载 `iii-x86_64-pc-windows-msvc.zip`,提取 `iii.exe`,加入 PATH
+- **Windows:** 从 [iii-hq/iii releases v0.22.1](https://github.com/iii-hq/iii/releases/tag/iii%2Fv0.22.1) 下载 `iii-x86_64-pc-windows-msvc.zip`,提取 `iii.exe`,加入 PATH
-或使用 Docker(捆绑的 `docker-compose.yml` 会拉取 `iiidev/iii:0.19.7`)。完整文档:[iii.dev/docs](https://iii.dev/docs)。
+或使用 Docker(捆绑的 `docker-compose.yml` 会拉取 `iiidev/iii:0.22.1`)。完整文档:[iii.dev/docs](https://iii.dev/docs)。
### Windows
@@ -737,9 +737,9 @@ agentmemory 可在 Windows 10/11 运行,但仅 Node.js 包不够;你还需要 `i
**选项 A:预构建 Windows 二进制(推荐)**
```powershell
-# 1. 在浏览器打开 https://github.com/iii-hq/iii/releases/tag/iii%2Fv0.19.7
+# 1. 在浏览器打开 https://github.com/iii-hq/iii/releases/tag/iii%2Fv0.22.1
# (agentmemory 将引擎固定在与其 iii-sdk 相同的版本;
-# 当前配对为 v0.19.7)
+# 当前配对为 v0.22.1)
# 2. 下载 iii-x86_64-pc-windows-msvc.zip
# (如果是 ARM 机器则下载 iii-aarch64-pc-windows-msvc.zip)
# 3. 把 iii.exe 解压到 PATH 上的某处,或放在:
@@ -747,7 +747,7 @@ agentmemory 可在 Windows 10/11 运行,但仅 Node.js 包不够;你还需要 `i
# (agentmemory 会自动检查该位置)
# 4. 验证:
iii --version
-# 应输出:0.19.7
+# 应输出:0.22.1
# 5. 然后照常运行 agentmemory:
npx -y @agentmemory/agentmemory
@@ -779,7 +779,7 @@ npx -y @agentmemory/mcp
| 端口冲突 | `netstat -ano \| findstr :3111` 查看占用,然后 kill 或用 `--port <N>` |
| Docker 已安装但仍跳过回退 | 确保 Docker Desktop 确实在运行(系统托盘图标) |
-> 注意:iii **引擎** 是预构建的二进制文件,而非 cargo crate,所以不要尝试用 `cargo install` 安装它。(iii 的 **SDK** 确实已发布到 crates.io、npm 和 PyPI,但 agentmemory 并不需要它们。)受支持的引擎安装方式均固定为 v0.19.7:上面的预构建 v0.19.7 二进制、**带版本固定** 的上游 `sh` 安装脚本 `curl -fsSL https://install.iii.dev/iii/main/install.sh | VERSION=0.19.7 sh`(macOS/Linux),以及 Docker 镜像 `iiidev/iii:0.19.7`。直接运行 `install.sh | sh` 会安装 **最新** 引擎,而 agentmemory 不支持该版本;请务必传入 `VERSION=0.19.7`。最简单的方式:直接运行 `npx @agentmemory/agentmemory`,它会为你把固定版本的引擎获取到 `~/.agentmemory/bin`。
+> 注意:iii **引擎** 是预构建的二进制文件,而非 cargo crate,所以不要尝试用 `cargo install` 安装它。(iii 的 **SDK** 确实已发布到 crates.io、npm 和 PyPI,但 agentmemory 并不需要它们。)受支持的引擎安装方式均固定为 v0.22.1:上面的预构建 v0.22.1 二进制、**带版本固定** 的上游 `sh` 安装脚本 `curl -fsSL https://install.iii.dev/iii/main/install.sh | VERSION=0.22.1 sh`(macOS/Linux),以及 Docker 镜像 `iiidev/iii:0.22.1`。直接运行 `install.sh | sh` 会安装 **最新** 引擎,而 agentmemory 不支持该版本;请务必传入 `VERSION=0.22.1`。最简单的方式:直接运行 `npx @agentmemory/agentmemory`,它会为你把固定版本的引擎获取到 `~/.agentmemory/bin`。
---
@@ -1175,7 +1175,7 @@ iii console --port 3114 \
**Traces 已开启:**
-`iii-config.yaml` 出厂启用 `iii-observability` worker(`exporter: memory`、`sampling_ratio: 1.0`、指标 + 日志)。无需额外配置;agentmemory 启动那一刻,每个记忆操作都会发出一个 trace span 和一个控制台可读的结构化日志。
+`iii-config.yaml` 出厂启用 `iii-observability` worker(`exporter: memory`、`sampling_ratio: 0.1`、指标 + 日志)。无需额外配置;agentmemory 启动那一刻,每个记忆操作都会发出一个控制台可读的结构化日志,其中十分之一(`sampling_ratio: 0.1`)还会发出一个 trace span。
如果你想改为导出到 Jaeger/Honeycomb/Grafana Tempo,把 `exporter: memory` 改为 `exporter: otlp` 并按 iii 的可观测性文档设置收集器端点。
@@ -1197,7 +1197,7 @@ iii worker add iii-cron # 定时整合、衰减扫描、快照轮换
iii worker add iii-queue # 嵌入 + 压缩任务的持久重试
iii worker add iii-observability # 每个记忆操作的 OTEL traces(默认开启)
iii worker add iii-sandbox # 在隔离 microVM 内运行召回到的代码
-iii worker add iii-database # 切换 SQL 后端的状态适配器
+iii worker add database # 切换 SQL 后端的状态适配器
iii worker add mcp # 在 agentmemory 的 MCP 旁开通用 MCP 宿主
```
@@ -1210,7 +1210,7 @@ iii worker add mcp # 在 agentmemory 的 MCP 旁开通用 MCP
| [`iii-queue`](https://workers.iii.dev/workers/iii-queue) | 持久重试:失败的嵌入 + 压缩任务在重启后存活,无观测丢失 |
| [`iii-observability`](https://workers.iii.dev/workers/iii-observability) | 每个函数的 OTEL traces、指标、日志,从第一天起就接入 `iii-config.yaml` |
| [`iii-sandbox`](https://workers.iii.dev/workers/iii-sandbox) | `memory_recall` 出来的代码在一次性 VM 中运行,不在你的 shell 中 |
-| [`iii-database`](https://workers.iii.dev/workers/iii-database) | 当默认的内存 KV 不够用时,SQL 后端状态适配器 |
+| [`database`](https://workers.iii.dev/workers/database) | 当默认的内存 KV 不够用时,SQL 后端状态适配器 |
| [`mcp`](https://workers.iii.dev/workers/mcp) | 在 agentmemory 的旁边架设额外 MCP 服务器,共享同一引擎 |
完整注册表:[workers.iii.dev](https://workers.iii.dev)。那里的每个 worker 都通过 agentmemory 所用的同样原语组合,而你已经拥有的 agentmemory 本身就是其中之一。
diff --git a/READMEs/README.zh-TW.md b/READMEs/README.zh-TW.md
index 80ea3af8..bf7362d3 100644
--- a/READMEs/README.zh-TW.md
+++ b/READMEs/README.zh-TW.md
@@ -124,7 +124,7 @@ npx 會依版本快取。用 `npx -y @agentmemory/agentmemory@latest` 強制使
<details>
<summary><strong>已在執行你自己的 iii 引擎</strong></summary>
-agentmemory 把 iii-engine 釘在 v0.19.7,不會附掛到其他版本(worker 無法使用另一個引擎的協定)。停止另一個引擎,然後執行 `npx -y @agentmemory/agentmemory@latest`。它會在 `~/.agentmemory/bin` 安裝並執行釘住的 v0.19.7,不動你自己的 `iii`。
+agentmemory 把 iii-engine 釘在 v0.22.1,不會附掛到其他版本(worker 無法使用另一個引擎的協定)。停止另一個引擎,然後執行 `npx -y @agentmemory/agentmemory@latest`。它會在 `~/.agentmemory/bin` 安裝並執行釘住的 v0.22.1,不動你自己的 `iii`。
</details>
@@ -463,7 +463,7 @@ npx @agentmemory/agentmemory
<h2 id="quick-start"><picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/section-quickstart.svg"><img src="../assets/tags/section-quickstart.svg" alt="Quick Start" height="32" /></picture></h2>
-相容性:此版本面向 `iii-sdk` 0.19.7,並將 iii-engine 釘在 v0.19.7。
+相容性:此版本面向 `iii-sdk` 0.22.1,並將 iii-engine 釘在 v0.22.1。
### 30 秒體驗
@@ -515,7 +515,7 @@ npx @agentmemory/agentmemory import-jsonl ~/.claude/projects/-my-project/abc123.
npx @agentmemory/agentmemory upgrade
```
-警告:此指令會變更目前工作區/執行階段。它可能更新 JavaScript 相依,並拉取固定版本的 Docker 鏡像 `iiidev/iii:0.19.7`。它絕不會安裝未固定版本或更新的 iii 引擎。
+警告:此指令會變更目前工作區/執行階段。它可能更新 JavaScript 相依,並拉取固定版本的 Docker 鏡像 `iiidev/iii:0.22.1`。它絕不會安裝未固定版本或更新的 iii 引擎。
實作細節見 `src/cli.ts`(參考 `src/cli.ts:544-595` 附近的 `runUpgrade`)。
@@ -720,15 +720,15 @@ npm install && npm run build && npm start
若 `iii` 已安裝,這會以本地 `iii-engine` 啟動 agentmemory;若 Docker 可用,則回退到 Docker Compose。REST、串流和檢視器預設繫結到 `127.0.0.1`。
-手動安裝 `iii-engine`。**agentmemory 目前把 `iii-engine` 釘在 `v0.19.7`**,與其 `iii-sdk` 相依是同一個版本;worker 使用該引擎的 wire 協定,而 0.20.0 重組了 SDK 介面,因此兩者在 agentmemory 的每個版本中一起升級。若你執行自己的引擎並確定版本相符,可用 `AGENTMEMORY_III_VERSION=<version>` 覆寫。
+手動安裝 `iii-engine`。**agentmemory 目前把 `iii-engine` 釘在 `v0.22.1`**,與其 `iii-sdk` 相依是同一個版本;worker 使用該引擎的 wire 協定,而 0.20.0 重組了 SDK 介面,因此兩者在 agentmemory 的每個版本中一起升級。若你執行自己的引擎並確定版本相符,可用 `AGENTMEMORY_III_VERSION=<version>` 覆寫。
-- **macOS arm64:** `mkdir -p ~/.local/bin && curl -fsSL https://github.com/iii-hq/iii/releases/download/iii/v0.19.7/iii-aarch64-apple-darwin.tar.gz | tar -xz -C ~/.local/bin && chmod +x ~/.local/bin/iii`
+- **macOS arm64:** `mkdir -p ~/.local/bin && curl -fsSL https://github.com/iii-hq/iii/releases/download/iii/v0.22.1/iii-aarch64-apple-darwin.tar.gz | tar -xz -C ~/.local/bin && chmod +x ~/.local/bin/iii`
- **macOS x64:** 把 `aarch64-apple-darwin` 換成 `x86_64-apple-darwin`
- **Linux x64:** 換成 `x86_64-unknown-linux-gnu`
- **Linux arm64:** 換成 `aarch64-unknown-linux-gnu`
-- **Windows:** 從 [iii-hq/iii releases v0.19.7](https://github.com/iii-hq/iii/releases/tag/iii%2Fv0.19.7) 下載 `iii-x86_64-pc-windows-msvc.zip`,擷取 `iii.exe`,加入 PATH
+- **Windows:** 從 [iii-hq/iii releases v0.22.1](https://github.com/iii-hq/iii/releases/tag/iii%2Fv0.22.1) 下載 `iii-x86_64-pc-windows-msvc.zip`,擷取 `iii.exe`,加入 PATH
-或使用 Docker(捆綁的 `docker-compose.yml` 會拉取 `iiidev/iii:0.19.7`)。完整文件:[iii.dev/docs](https://iii.dev/docs)。
+或使用 Docker(捆綁的 `docker-compose.yml` 會拉取 `iiidev/iii:0.22.1`)。完整文件:[iii.dev/docs](https://iii.dev/docs)。
### Windows
@@ -737,9 +737,9 @@ agentmemory 可在 Windows 10/11 執行,但僅 Node.js 套件不夠;你還需要
**選項 A:預建 Windows 二進位(推薦)**
```powershell
-# 1. 在瀏覽器打開 https://github.com/iii-hq/iii/releases/tag/iii%2Fv0.19.7
+# 1. 在瀏覽器打開 https://github.com/iii-hq/iii/releases/tag/iii%2Fv0.22.1
# (agentmemory 將引擎釘在與其 iii-sdk 相同的版本;
-# 目前配對為 v0.19.7)
+# 目前配對為 v0.22.1)
# 2. 下載 iii-x86_64-pc-windows-msvc.zip
# (若是 ARM 機器則下載 iii-aarch64-pc-windows-msvc.zip)
# 3. 把 iii.exe 解壓到 PATH 上的某處,或放在:
@@ -747,7 +747,7 @@ agentmemory 可在 Windows 10/11 執行,但僅 Node.js 套件不夠;你還需要
# (agentmemory 會自動檢查該位置)
# 4. 驗證:
iii --version
-# 應輸出:0.19.7
+# 應輸出:0.22.1
# 5. 然後照常執行 agentmemory:
npx -y @agentmemory/agentmemory
@@ -779,7 +779,7 @@ npx -y @agentmemory/mcp
| 連接埠衝突 | `netstat -ano \| findstr :3111` 查看佔用,然後 kill 或用 `--port <N>` |
| Docker 已安裝但仍跳過回退 | 確保 Docker Desktop 確實在執行(系統匣圖示) |
-> 注意:iii **引擎** 是預建的二進位檔,而非 cargo crate,請勿嘗試以 `cargo install` 安裝它。(iii 的 **SDK** 確實已發布到 crates.io、npm 和 PyPI,但 agentmemory 並不需要它們。)受支援的引擎安裝方式皆固定為 v0.19.7:上述預建的 v0.19.7 二進位、**帶版本固定** 的上游 `sh` 安裝指令稿 `curl -fsSL https://install.iii.dev/iii/main/install.sh | VERSION=0.19.7 sh`(macOS/Linux),以及 Docker 鏡像 `iiidev/iii:0.19.7`。直接執行 `install.sh | sh` 會安裝 **最新** 引擎,而 agentmemory 並不支援該版本;請務必傳入 `VERSION=0.19.7`。最簡單的方式:直接執行 `npx @agentmemory/agentmemory`,它會為你把固定版本的引擎取得到 `~/.agentmemory/bin`。
+> 注意:iii **引擎** 是預建的二進位檔,而非 cargo crate,請勿嘗試以 `cargo install` 安裝它。(iii 的 **SDK** 確實已發布到 crates.io、npm 和 PyPI,但 agentmemory 並不需要它們。)受支援的引擎安裝方式皆固定為 v0.22.1:上述預建的 v0.22.1 二進位、**帶版本固定** 的上游 `sh` 安裝指令稿 `curl -fsSL https://install.iii.dev/iii/main/install.sh | VERSION=0.22.1 sh`(macOS/Linux),以及 Docker 鏡像 `iiidev/iii:0.22.1`。直接執行 `install.sh | sh` 會安裝 **最新** 引擎,而 agentmemory 並不支援該版本;請務必傳入 `VERSION=0.22.1`。最簡單的方式:直接執行 `npx @agentmemory/agentmemory`,它會為你把固定版本的引擎取得到 `~/.agentmemory/bin`。
---
@@ -1175,7 +1175,7 @@ iii console --port 3114 \
**Traces 已開啟:**
-`iii-config.yaml` 出廠啟用 `iii-observability` worker(`exporter: memory`、`sampling_ratio: 1.0`、指標 + 日誌)。無需額外設定;agentmemory 啟動那一刻,每個記憶操作都會發出一個 trace span 和一個主控台可讀的結構化日誌。
+`iii-config.yaml` 出廠啟用 `iii-observability` worker(`exporter: memory`、`sampling_ratio: 0.1`、指標 + 日誌)。無需額外設定;agentmemory 啟動那一刻,每個記憶操作都會發出一個主控台可讀的結構化日誌,其中十分之一(`sampling_ratio: 0.1`)還會發出一個 trace span。
若你想改為匯出到 Jaeger/Honeycomb/Grafana Tempo,把 `exporter: memory` 改為 `exporter: otlp` 並依 iii 的可觀測性文件設定收集器端點。
@@ -1197,7 +1197,7 @@ iii worker add iii-cron # 排程整合、衰減掃描、快照輪替
iii worker add iii-queue # 嵌入 + 壓縮工作的持久重試
iii worker add iii-observability # 每個記憶操作的 OTEL traces(預設開啟)
iii worker add iii-sandbox # 在隔離 microVM 內執行召回到的程式碼
-iii worker add iii-database # 切換 SQL 後端的狀態適配器
+iii worker add database # 切換 SQL 後端的狀態適配器
iii worker add mcp # 在 agentmemory 的 MCP 旁開設通用 MCP 宿主
```
@@ -1210,7 +1210,7 @@ iii worker add mcp # 在 agentmemory 的 MCP 旁開設通用 MCP
| [`iii-queue`](https://workers.iii.dev/workers/iii-queue) | 持久重試:失敗的嵌入 + 壓縮工作在重啟後存活,無觀測遺失 |
| [`iii-observability`](https://workers.iii.dev/workers/iii-observability) | 每個函式的 OTEL traces、指標、日誌,從第一天起就接入 `iii-config.yaml` |
| [`iii-sandbox`](https://workers.iii.dev/workers/iii-sandbox) | `memory_recall` 出來的程式碼在一次性 VM 中執行,不在你的 shell 中 |
-| [`iii-database`](https://workers.iii.dev/workers/iii-database) | 當預設的記憶體 KV 不夠用時,SQL 後端狀態適配器 |
+| [`database`](https://workers.iii.dev/workers/database) | 當預設的記憶體 KV 不夠用時,SQL 後端狀態適配器 |
| [`mcp`](https://workers.iii.dev/workers/mcp) | 在 agentmemory 的旁邊架設額外 MCP 伺服器,共享同一引擎 |
完整登錄表:[workers.iii.dev](https://workers.iii.dev)。那裡的每個 worker 都透過 agentmemory 所用的同樣原語組合,而你已經擁有的 agentmemory 本身就是其中之一。
diff --git a/deploy/coolify/entrypoint.sh b/deploy/coolify/entrypoint.sh
index ffdd6333..c21ec1d8 100755
--- a/deploy/coolify/entrypoint.sh
+++ b/deploy/coolify/entrypoint.sh
@@ -70,10 +70,10 @@ workers:
enabled: true
service_name: agentmemory
exporter: memory
- sampling_ratio: 1.0
+ sampling_ratio: 0.1
metrics_enabled: true
logs_enabled: true
- logs_console_output: true
+ logs_console_output: false
EOF
chown "$RUN_AS" "$III_CONFIG"
diff --git a/deploy/fly/entrypoint.sh b/deploy/fly/entrypoint.sh
index 5fd4cc26..5b20f451 100755
--- a/deploy/fly/entrypoint.sh
+++ b/deploy/fly/entrypoint.sh
@@ -70,10 +70,10 @@ workers:
enabled: true
service_name: agentmemory
exporter: memory
- sampling_ratio: 1.0
+ sampling_ratio: 0.1
metrics_enabled: true
logs_enabled: true
- logs_console_output: true
+ logs_console_output: false
EOF
chown "$RUN_AS" "$III_CONFIG"
diff --git a/deploy/railway/entrypoint.sh b/deploy/railway/entrypoint.sh
index ffdd6333..c21ec1d8 100755
--- a/deploy/railway/entrypoint.sh
+++ b/deploy/railway/entrypoint.sh
@@ -70,10 +70,10 @@ workers:
enabled: true
service_name: agentmemory
exporter: memory
- sampling_ratio: 1.0
+ sampling_ratio: 0.1
metrics_enabled: true
logs_enabled: true
- logs_console_output: true
+ logs_console_output: false
EOF
chown "$RUN_AS" "$III_CONFIG"
diff --git a/deploy/render/entrypoint.sh b/deploy/render/entrypoint.sh
index ffdd6333..c21ec1d8 100755
--- a/deploy/render/entrypoint.sh
+++ b/deploy/render/entrypoint.sh
@@ -70,10 +70,10 @@ workers:
enabled: true
service_name: agentmemory
exporter: memory
- sampling_ratio: 1.0
+ sampling_ratio: 0.1
metrics_enabled: true
logs_enabled: true
- logs_console_output: true
+ logs_console_output: false
EOF
chown "$RUN_AS" "$III_CONFIG"
diff --git a/docker-compose.yml b/docker-compose.yml
index 7eb37ae2..8b195e4c 100644
--- a/docker-compose.yml
+++ b/docker-compose.yml
@@ -21,17 +21,19 @@ services:
# 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.
- # v0.19.7 is the last engine before the 0.20 SDK reorganization and
- # keeps HTTP routes owned by the reconnecting worker.
+ # 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.19.7 docker compose up
- image: iiidev/iii:${AGENTMEMORY_III_VERSION:-0.19.7}
+ # 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}"
@@ -45,13 +47,12 @@ services:
- "${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
- # data/configuration of its working directory (/home/nonroot 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.
+ # 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: /home/nonroot/data/configuration
+ target: /app/config
tmpfs:
mode: 01777
restart: unless-stopped
diff --git a/eval/README.md b/eval/README.md
index 0e274ad0..5b008d0d 100644
--- a/eval/README.md
+++ b/eval/README.md
@@ -26,11 +26,11 @@ source eval/scripts/sandbox.sh
npm run eval:coding-life -- --adapters grep,agentmemory
```
-Requires iii v0.19.7 on PATH (agentmemory pin). If you already have a different version installed, install the pinned build into `~/.local/bin` and make sure that directory comes first on `PATH`:
+Requires iii v0.22.1 on PATH (agentmemory pin). If you already have a different version installed, install the pinned build into `~/.local/bin` and make sure that directory comes first on `PATH`:
```sh
mkdir -p ~/.local/bin
-curl -fsSL https://github.com/iii-hq/iii/releases/download/iii/v0.19.7/iii-aarch64-apple-darwin.tar.gz | tar -xz -C ~/.local/bin
+curl -fsSL https://github.com/iii-hq/iii/releases/download/iii/v0.22.1/iii-aarch64-apple-darwin.tar.gz | tar -xz -C ~/.local/bin
export PATH="$HOME/.local/bin:$PATH" # add to ~/.zshrc or ~/.bashrc for persistence
```
diff --git a/eval/scripts/sandbox.sh b/eval/scripts/sandbox.sh
index f1923934..7d030c2d 100755
--- a/eval/scripts/sandbox.sh
+++ b/eval/scripts/sandbox.sh
@@ -14,13 +14,13 @@ REPO_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/../.." && pwd)"
if ! command -v iii >/dev/null 2>&1; then
echo "iii binary not on PATH. Install pinned version:"
- echo " curl -fsSL https://github.com/iii-hq/iii/releases/download/iii/v0.19.7/iii-aarch64-apple-darwin.tar.gz | tar -xz -C ~/.local/bin"
+ echo " curl -fsSL https://github.com/iii-hq/iii/releases/download/iii/v0.22.1/iii-aarch64-apple-darwin.tar.gz | tar -xz -C ~/.local/bin"
exit 1
fi
iii_ver=$(iii --version 2>&1 | head -1)
-if [[ "$iii_ver" != "0.19.7" ]]; then
- echo "warning: iii version on PATH is $iii_ver; agentmemory pins 0.19.7"
+if [[ "$iii_ver" != "0.22.1" ]]; then
+ echo "warning: iii version on PATH is $iii_ver; agentmemory pins 0.22.1"
fi
if [[ ! -f "$REPO_ROOT/dist/index.mjs" ]]; then
diff --git a/examples/python/README.md b/examples/python/README.md
index ea284dd4..3e4d3e59 100644
--- a/examples/python/README.md
+++ b/examples/python/README.md
@@ -10,7 +10,7 @@ This example uses the official Python SDK.
## Install
```bash
-pip install iii-sdk
+pip install iii-sdk==0.22.1
```
## Quickstart
diff --git a/examples/python/observe_and_recall.py b/examples/python/observe_and_recall.py
index 4747bf0b..b9c65de5 100644
--- a/examples/python/observe_and_recall.py
+++ b/examples/python/observe_and_recall.py
@@ -4,7 +4,7 @@ Pattern: send hook-style observations during a coding session, then ask
agentmemory to render the most relevant context back at a fixed token budget.
Prerequisites:
- pip install iii-sdk
+ pip install iii-sdk==0.22.1
npx -y @agentmemory/agentmemory
Run:
diff --git a/examples/python/quickstart.py b/examples/python/quickstart.py
index 56e5ae11..0339e079 100644
--- a/examples/python/quickstart.py
+++ b/examples/python/quickstart.py
@@ -1,7 +1,7 @@
"""Minimal agentmemory usage via iii-sdk.
Prerequisites:
- pip install iii-sdk
+ pip install iii-sdk==0.22.1
npx -y @agentmemory/agentmemory # daemon at ws://localhost:49134
Run:
diff --git a/package.json b/package.json
index 7bca837e..4360e3eb 100644
--- a/package.json
+++ b/package.json
@@ -65,7 +65,8 @@
"@anthropic-ai/sdk": "^0.100.1",
"@clack/prompts": "^1.2.0",
"dotenv": "^17.4.2",
- "iii-sdk": "0.19.7",
+ "@iii-dev/helpers": "0.22.1",
+ "iii-sdk": "0.22.1",
"picocolors": "^1.1.1",
"zod": "^4.0.0"
},
diff --git a/src/cli.ts b/src/cli.ts
index b1921720..de20cad9 100644
--- a/src/cli.ts
+++ b/src/cli.ts
@@ -63,6 +63,7 @@ import {
resolveEngineCwd,
rewriteBundledConfig,
runtimeConfigPath,
+ engineChildEnv,
} from "./cli/engine-launch.js";
import { runtimeMetadataPath } from "./runtime-paths.js";
import { createStartupStderrCapture } from "./cli/startup-stderr.js";
@@ -71,6 +72,7 @@ import {
renderEngineConfig,
} from "./cli/engine-config.js";
import { SHUTDOWN_HARD_EXIT_MS } from "./shutdown.js";
+import { consoleArgs, defaultConsolePort, parseConsoleArgs } from "./cli/console.js";
import { processStatIsRunning } from "./cli/process-state.js";
import { renderSplash } from "./cli/splash.js";
import { isFirstRun, readPrefs, resetPrefs, writePrefs } from "./cli/preferences.js";
@@ -116,17 +118,22 @@ if (args.includes("--version") || args.includes("-V")) {
process.exit(0);
}
-// Pinned iii-engine version. The engine and the iii-sdk in package.json must
-// stay on the same release: the worker speaks that engine's wire protocol and
-// the unpinned installer tracks `latest`. 0.19.7 is the last release before
-// the 0.20.0 SDK reorganization (ISdk -> IIIClient, helpers package) and the
-// first line that keeps HTTP routes owned by the reconnecting worker, which
-// stops the REST 404s after an engine reconnect. Bump this constant and the
-// package.json dependency together. AGENTMEMORY_III_VERSION overrides the pin
-// for anyone running a self-managed engine.
-const IIPINNED_DEFAULT_VERSION = "0.19.7";
+// Pinned iii-engine version. The engine, the iii-sdk and the @iii-dev/helpers
+// packages in package.json must stay on the same release: the worker speaks
+// that engine's wire protocol and the unpinned installer tracks `latest`.
+// 0.22.x is the last line before 0.23 removes the config.yaml worker
+// lifecycle this CLI relies on; it keeps HTTP routes owned by the
+// reconnecting worker (no REST 404s after an engine reconnect). The engine
+// still boots its iii- prefixed builtins from config.yaml (the unprefixed
+// http/state/queue/pubsub/cron names resolve to the standalone registry
+// workers, which is the 0.23 migration, not this one). Bump this
+// constant and the two package.json dependencies together.
+// AGENTMEMORY_III_VERSION overrides the pin for anyone running a
+// self-managed engine.
+const IIPINNED_DEFAULT_VERSION = "0.22.1";
const IIPINNED_VERSION =
process.env["AGENTMEMORY_III_VERSION"] || IIPINNED_DEFAULT_VERSION;
+const IIIENGINE_INSTALL_CMD = `curl -fsSL https://install.iii.dev/iii/main/install.sh | VERSION=${IIPINNED_VERSION} sh`;
// Map Node platform/arch → the asset name iii-hq/iii ships under
// https://github.com/iii-hq/iii/releases/download/iii/v<version>/<asset>
@@ -153,7 +160,7 @@ function iiiReleaseAsset(): string | null {
function iiiReleaseUrl(): string | null {
const asset = iiiReleaseAsset();
if (!asset) return null;
- // Tag name is monorepo-prefixed: `iii/v0.19.7`. Slash is URL-encoded
+ // Tag name is monorepo-prefixed: `iii/v0.22.1`. Slash is URL-encoded
// by GitHub when serving the download path, hence `iii/v...` not `iii%2Fv...`.
return `https://github.com/iii-hq/iii/releases/download/iii/v${IIPINNED_VERSION}/${asset}`;
}
@@ -192,6 +199,8 @@ Commands:
No arg = interactive picker. --all wires every detected agent.
--dry-run shows what would change. --force re-installs.
status Show connection status, memory count, flags, and health
+ console Launch the iii web console for this engine (workers, functions,
+ triggers, queues, traces). --console-port N, default viewer+1
doctor Interactive diagnostic + fixer. [F]ix · [S]kip · [?]more · [Q]uit
--all: apply every fix without prompting (CI)
--dry-run: show what each fix would do, don't execute
@@ -736,7 +745,7 @@ function engineStateRestPort(state: EngineState): number {
try {
const raw = readFileSync(state.configPath, "utf-8");
const httpBlock = raw.match(
- /- name:\s*iii-http([\s\S]*?)(?=\n\s*- name:|$)/,
+ /- name:\s*(?:iii-)?http([\s\S]*?)(?=\n\s*- name:|$)/,
)?.[1];
const configuredPort = httpBlock?.match(/\n\s*port:\s*(\d+)/)?.[1];
if (configuredPort) return parseInt(configuredPort, 10);
@@ -1242,95 +1251,6 @@ async function maybeOfferGlobalInstall(): Promise<void> {
}
}
-// iii-console install state.
-// "installed" — `iii-console` is on PATH or at `~/.local/bin/iii-console`
-// "missing" — binary not found anywhere we look
-// We deliberately do NOT probe the console's HTTP port: the binary
-// being on disk is the signal we care about (it's not auto-started by
-// agentmemory and its default port 3113 collides with our viewer, so
-// "is it listening?" is the wrong question at boot time).
-type IiiConsoleState =
- | { kind: "installed"; binPath: string }
- | { kind: "missing" };
-
-function detectIiiConsole(): IiiConsoleState {
- const onPath = whichBinary("iii-console");
- if (onPath) return { kind: "installed", binPath: onPath };
- const fallback = IS_WINDOWS
- ? join(process.env["USERPROFILE"] ?? "", ".local", "bin", "iii-console.exe")
- : join(homedir(), ".local", "bin", "iii-console");
- if (fallback && existsSync(fallback)) {
- return { kind: "installed", binPath: fallback };
- }
- return { kind: "missing" };
-}
-
-// The upstream install script reads `VERSION` as an env var (see
-// install.iii.dev/iii/main/install.sh: `engine_version="${VERSION:-}"`).
-// Pin to IIPINNED_VERSION so a fresh boot can never pull a newer iii
-// console that talks a different protocol than our pinned engine
-// (root cause of protocol drift).
-const III_CONSOLE_INSTALL_CMD =
- `curl -fsSL https://install.iii.dev/iii/main/install.sh | VERSION=${IIPINNED_VERSION} sh`;
-
-// Display-only renderer. The internal `runCommand(shBin, ["-c", ...])`
-// path uses III_CONSOLE_INSTALL_CMD verbatim (POSIX shell). Anywhere
-// that PRINTS the command to a user has to handle Windows separately
-// since `VERSION=X sh` and the pipe-to-sh idiom aren't valid in
-// cmd.exe / PowerShell.
-function iiiConsoleInstallHint(): string {
- if (!IS_WINDOWS) return III_CONSOLE_INSTALL_CMD;
- return (
- `# PowerShell:\n` +
- ` $env:VERSION = "${IIPINNED_VERSION}"\n` +
- ` iwr -useb https://install.iii.dev/iii/main/install.sh -OutFile install.sh\n` +
- ` bash install.sh # WSL or Git Bash required\n` +
- `# Or grab the pinned release directly:\n` +
- ` https://github.com/iii-hq/iii/releases/tag/iii%2Fv${IIPINNED_VERSION}`
- );
-}
-
-async function ensureIiiConsole(): Promise<IiiConsoleState> {
- const state = detectIiiConsole();
- if (state.kind === "installed") return state;
-
- // Non-interactive contexts get the panel hint but no prompt.
- if (!process.stdin.isTTY || process.env["CI"]) return state;
- const prefs = readPrefs();
- if (prefs.skipConsoleInstall) return state;
-
- const answer = await p.confirm({
- message:
- "iii console gives engine-level visibility (workers, functions, queues, traces). Install now?",
- initialValue: true,
- });
- if (p.isCancel(answer)) return state;
- if (answer === false) {
- writePrefs({ skipConsoleInstall: true });
- return state;
- }
-
- const shBin = whichBinary("sh");
- const curlBin = whichBinary("curl");
- if (!shBin || !curlBin) {
- p.log.warn(
- `curl or sh not found. Install manually:\n ${iiiConsoleInstallHint()}`,
- );
- return state;
- }
- const ok = runCommand(shBin, ["-c", III_CONSOLE_INSTALL_CMD], {
- label: "Installing iii console",
- });
- if (!ok) {
- p.log.warn(
- `iii console install failed. Re-run manually:\n ${iiiConsoleInstallHint()}`,
- );
- return state;
- }
- // Re-detect rather than trust install-script output paths.
- return detectIiiConsole();
-}
-
function adoptRunningEngine(): void {
try {
const existingState = readEngineState();
@@ -1480,6 +1400,7 @@ function spawnEngineBackground(
detached: true,
stdio: ["ignore", "ignore", "pipe"],
windowsHide: true,
+ env: engineChildEnv(process.env),
...(cwd ? { cwd } : {}),
});
const isDocker = label.includes("Docker");
@@ -1558,7 +1479,7 @@ function prepareEngineLaunch(configPath: string): {
mkdirSync(dirname(runtimePath), { recursive: true });
writeFileSync(runtimePath, rewritten, "utf-8");
try {
- const cleared = clearPersistedBuiltinConfig(cwd, rewritten);
+ const cleared = clearPersistedBuiltinConfig(cwd, runtimePath, rewritten);
if (cleared.length > 0) {
vlog(
`cleared ${cleared.length} persisted builtin config entries so the rendered runtime config seeds the engine again`,
@@ -1566,7 +1487,7 @@ function prepareEngineLaunch(configPath: string): {
}
} catch (err) {
p.log.error(
- `${String(err instanceof Error ? err.message : err)}. The engine would ignore the rendered runtime config and keep its previously persisted ports and timeouts. Fix the permissions under ${join(cwd, "data", "configuration")} and run agentmemory start again.`,
+ `${String(err instanceof Error ? err.message : err)}. The engine would ignore the rendered runtime config and keep its previously persisted ports and timeouts. Fix the permissions on that file and run agentmemory start again.`,
);
process.exit(1);
}
@@ -1606,7 +1527,12 @@ function startIiiBin(iiiBin: string, configPath: string): boolean {
configPath: launch.configPath,
binPath: iiiBin,
});
- spawnEngineBackground(iiiBin, ["--config", launch.configPath], "iii-engine", launch.cwd);
+ spawnEngineBackground(
+ iiiBin,
+ ["--config", launch.configPath, "--no-update-check"],
+ "iii-engine",
+ launch.cwd,
+ );
s.stop(c.ok("iii-engine process started"));
return true;
}
@@ -1855,9 +1781,8 @@ async function reconcilePersistedDockerEngine(): Promise<boolean> {
p.log.error("agentmemory worker did not become ready within 15s.");
process.exit(1);
}
- const consoleState = await ensureIiiConsole();
await maybeOfferGlobalInstall();
- printReadyHint(consoleState);
+ printReadyHint();
return true;
}
@@ -1934,26 +1859,16 @@ function getEngineHost(): string {
return "localhost";
}
-function printReadyHint(consoleState: IiiConsoleState): void {
- // REST goes through getBaseUrl which already honors AGENTMEMORY_URL
- // for full host+protocol overrides. Streams/Engine are derived from
- // III_ENGINE_URL so a remote bind reads correctly in the panel.
+function printReadyHint(): void {
const restUrl = getBaseUrl();
const viewerUrl = getViewerUrl();
const engineHost = getEngineHost();
const streamUrl = `ws://${engineHost}:${getStreamPort()}`;
const engineUrl = `ws://${engineHost}:${getEnginePort()}`;
+ const invocation = isInvokedViaNpx() ? "npx @agentmemory/agentmemory" : "agentmemory";
+ const consolePort = defaultConsolePort(getConfiguredViewerPort());
- const consoleLine =
- consoleState.kind === "installed"
- ? // We can't safely probe iii-console's port (default 3113
- // collides with our viewer) so we surface the binary location
- // and let the user start it on a port of their choice. Use
- // the detected binary path so `(run: ...)` is executable as-
- // is, even when the binary isn't on PATH under the bare
- // name `iii-console`.
- `${c.label("iii console")} ${c.dim(consoleState.binPath)} ${c.dim(`(run: ${consoleState.binPath} -p <port>)`)}`
- : `${c.label("iii console")} ${c.dim(`(install: ${iiiConsoleInstallHint()})`)}`;
+ const consoleLine = `${c.label("iii console")} ${c.cmd(`${invocation} console`)} ${c.dim(`(serves on :${consolePort}; first run downloads the console next to the pinned iii)`)}`;
const lines = [
`${c.label("REST API")} ${c.url(restUrl)}`,
@@ -1972,9 +1887,7 @@ function printReadyHint(consoleState: IiiConsoleState): void {
// (unless they accepted the global-install prompt and the npm bin
// dir was already on PATH in this shell), so we suggest the npx
// form for them; everyone else gets the global form.
- const demoCommand = isInvokedViaNpx()
- ? "npx @agentmemory/agentmemory demo"
- : "agentmemory demo";
+ const demoCommand = `${invocation} demo`;
process.stdout.write(`\n${c.dim("Try:")} ${c.cmd(demoCommand)}\n`);
}
@@ -2024,9 +1937,8 @@ async function main() {
if (IS_VERBOSE) p.log.info("Skipping engine check (--no-engine)");
await import("./index.js");
if (await waitForAgentmemoryReady(15000)) {
- const consoleState = await ensureIiiConsole();
await maybeOfferGlobalInstall();
- printReadyHint(consoleState);
+ printReadyHint();
}
return;
}
@@ -2064,9 +1976,8 @@ async function main() {
p.log.error("agentmemory worker did not become ready within 15s.");
process.exit(1);
}
- const consoleState = await ensureIiiConsole();
await maybeOfferGlobalInstall();
- printReadyHint(consoleState);
+ printReadyHint();
return;
}
@@ -2097,7 +2008,7 @@ async function main() {
` ${c.cmd(base)}`,
"",
c.dim(`Step 2 needs no manual install. To install iii v${IIPINNED_VERSION} yourself (replaces your global iii), curl:`),
- ` ${c.cmd(III_CONSOLE_INSTALL_CMD)}`,
+ ` ${c.cmd(IIIENGINE_INSTALL_CMD)}`,
` ${c.dim("or download the release:")} ${c.url(`https://github.com/iii-hq/iii/releases/tag/iii%2Fv${IIPINNED_VERSION}`)}`,
].join("\n"),
"engine conflict",
@@ -2176,9 +2087,8 @@ async function main() {
p.log.error("agentmemory worker did not become ready within 15s.");
process.exit(1);
}
- const consoleState = await ensureIiiConsole();
await maybeOfferGlobalInstall();
- printReadyHint(consoleState);
+ printReadyHint();
// Mark splash as something to skip on subsequent runs. This is a
// no-op if onboarding already flipped the flag (idempotent merge).
writePrefs({ skipSplash: true });
@@ -3193,19 +3103,35 @@ async function runUpgrade() {
label: "Refreshing dependencies (pnpm install)",
});
requireSuccess(installOk, "pnpm install");
- runCommand(pnpmBin, ["up", `iii-sdk@${IIPINNED_DEFAULT_VERSION}`], {
- label: `Pinning iii-sdk@${IIPINNED_DEFAULT_VERSION}`,
- optional: true,
- });
+ runCommand(
+ pnpmBin,
+ [
+ "up",
+ `iii-sdk@${IIPINNED_DEFAULT_VERSION}`,
+ `@iii-dev/helpers@${IIPINNED_DEFAULT_VERSION}`,
+ ],
+ {
+ label: `Pinning iii-sdk and @iii-dev/helpers at ${IIPINNED_DEFAULT_VERSION}`,
+ optional: true,
+ },
+ );
} else if (npmBin) {
const installOk = runCommand(npmBin, ["install"], {
label: "Refreshing dependencies (npm install)",
});
requireSuccess(installOk, "npm install");
- runCommand(npmBin, ["install", `iii-sdk@${IIPINNED_DEFAULT_VERSION}`], {
- label: `Pinning iii-sdk@${IIPINNED_DEFAULT_VERSION}`,
- optional: true,
- });
+ runCommand(
+ npmBin,
+ [
+ "install",
+ `iii-sdk@${IIPINNED_DEFAULT_VERSION}`,
+ `@iii-dev/helpers@${IIPINNED_DEFAULT_VERSION}`,
+ ],
+ {
+ label: `Pinning iii-sdk and @iii-dev/helpers at ${IIPINNED_DEFAULT_VERSION}`,
+ optional: true,
+ },
+ );
} else {
p.log.warn("No package manager found (pnpm/npm). Skipping JS dependency upgrade.");
}
@@ -4016,10 +3942,72 @@ async function runRemove(): Promise<void> {
);
}
+async function runConsole(): Promise<void> {
+ const iiiBin = pickCompatibleIii([
+ whichBinary("iii"),
+ ...fallbackIiiPaths().filter((candidate) => existsSync(candidate)),
+ ]);
+ if (!iiiBin) {
+ p.log.error(
+ `No iii v${IIPINNED_VERSION} found. Start agentmemory once so it installs the pinned engine into ${privateIiiPath()}, then run this again.`,
+ );
+ process.exit(1);
+ }
+ let parsed: ReturnType<typeof parseConsoleArgs>;
+ try {
+ parsed = parseConsoleArgs(
+ args.slice(1),
+ defaultConsolePort(getConfiguredViewerPort()),
+ );
+ } catch (err) {
+ p.log.error(err instanceof Error ? err.message : String(err));
+ process.exit(1);
+ }
+ const launch = {
+ iiiBin,
+ consolePort: parsed.consolePort,
+ restPort: getRestPort(),
+ streamPort: getStreamPort(),
+ enginePort: getEnginePort(),
+ extraArgs: parsed.extraArgs,
+ };
+ if (!(await isEngineRunning())) {
+ p.log.warn(
+ `No engine responding on port ${launch.restPort}. The console starts anyway and connects once agentmemory is up.`,
+ );
+ }
+ p.log.info(
+ `iii console: http://127.0.0.1:${launch.consolePort} (engine REST ${launch.restPort}, streams ${launch.streamPort}, bridge ${launch.enginePort}). The first run downloads the console binary next to the pinned iii.`,
+ );
+ const child = spawn(iiiBin, consoleArgs(launch), {
+ stdio: "inherit",
+ detached: true,
+ });
+ const forward = (signal: NodeJS.Signals): void => {
+ try {
+ process.kill(-child.pid!, signal);
+ } catch {
+ child.kill(signal);
+ }
+ };
+ for (const signal of ["SIGINT", "SIGTERM", "SIGHUP"] as const) {
+ process.on(signal, () => forward(signal));
+ }
+ const code = await new Promise<number>((resolve) => {
+ child.on("exit", (status, signal) => resolve(status ?? (signal ? 1 : 0)));
+ child.on("error", (err) => {
+ p.log.error(err.message);
+ resolve(1);
+ });
+ });
+ process.exit(code);
+}
+
const commands: Record<string, () => Promise<void>> = {
init: runInit,
connect: runConnectCmd,
status: runStatus,
+ console: runConsole,
doctor: runDoctor,
demo: runDemo,
upgrade: runUpgrade,
diff --git a/src/cli/console.ts b/src/cli/console.ts
new file mode 100644
index 00000000..e0fb42b2
--- /dev/null
+++ b/src/cli/console.ts
@@ -0,0 +1,66 @@
+export interface ConsoleLaunch {
+ iiiBin: string;
+ consolePort: number;
+ restPort: number;
+ streamPort: number;
+ enginePort: number;
+ extraArgs: string[];
+}
+
+const GLOBAL_VALUE_FLAGS = new Set(["--port", "--instance", "--data-dir", "--tools"]);
+const GLOBAL_BOOLEAN_FLAGS = new Set(["--verbose", "-v", "--no-engine"]);
+
+export function defaultConsolePort(viewerPort: number): number {
+ return viewerPort + 1;
+}
+
+function readPort(raw: string | undefined, flag: string): number {
+ const port = raw === undefined ? Number.NaN : Number(raw);
+ if (!Number.isInteger(port) || port < 1 || port > 65535) {
+ throw new Error(`${flag} needs a port between 1 and 65535`);
+ }
+ return port;
+}
+
+export function parseConsoleArgs(
+ tail: string[],
+ fallbackPort: number,
+): { consolePort: number; extraArgs: string[] } {
+ let consolePort = fallbackPort;
+ const extraArgs: string[] = [];
+ for (let i = 0; i < tail.length; i++) {
+ const arg = tail[i]!;
+ if (arg === "--console-port") {
+ consolePort = readPort(tail[i + 1], arg);
+ i++;
+ continue;
+ }
+ if (arg.startsWith("--console-port=")) {
+ consolePort = readPort(arg.slice("--console-port=".length), "--console-port");
+ continue;
+ }
+ if (GLOBAL_VALUE_FLAGS.has(arg)) {
+ i++;
+ continue;
+ }
+ if ([...GLOBAL_VALUE_FLAGS].some((flag) => arg.startsWith(`${flag}=`))) continue;
+ if (GLOBAL_BOOLEAN_FLAGS.has(arg)) continue;
+ extraArgs.push(arg);
+ }
+ return { consolePort, extraArgs };
+}
+
+export function consoleArgs(launch: ConsoleLaunch): string[] {
+ return [
+ "console",
+ "--port",
+ String(launch.consolePort),
+ "--engine-port",
+ String(launch.restPort),
+ "--ws-port",
+ String(launch.streamPort),
+ "--bridge-port",
+ String(launch.enginePort),
+ ...launch.extraArgs,
+ ];
+}
diff --git a/src/cli/doctor-diagnostics.ts b/src/cli/doctor-diagnostics.ts
index bab2fd29..78705d60 100644
--- a/src/cli/doctor-diagnostics.ts
+++ b/src/cli/doctor-diagnostics.ts
@@ -38,7 +38,7 @@ export type DoctorContext = {
pidfilePath: string;
/** Path to ~/.agentmemory/engine-state.json */
enginePath: string;
- /** Pinned engine version (e.g. "0.19.7"). */
+ /** Pinned engine version (e.g. "0.22.1"). */
pinnedVersion: string;
};
diff --git a/src/cli/engine-config.ts b/src/cli/engine-config.ts
index 7e5121ed..b48f09df 100644
--- a/src/cli/engine-config.ts
+++ b/src/cli/engine-config.ts
@@ -1,11 +1,16 @@
-import { rmSync } from "node:fs";
-import { join, resolve } from "node:path";
+import { readFileSync, rmSync } from "node:fs";
+import { basename, dirname, join, resolve } from "node:path";
const SEEDED_BUILTIN_WORKERS = [
+ "http",
"iii-http",
+ "state",
"iii-state",
+ "queue",
"iii-queue",
+ "pubsub",
"iii-pubsub",
+ "cron",
"iii-cron",
"iii-stream",
"iii-observability",
@@ -25,9 +30,14 @@ export function configuredPersistDir(renderedConfig: string): string | null {
export function persistedBuiltinConfigDirs(
engineCwd: string,
+ configPath: string,
renderedConfig?: string,
): string[] {
- const dirs = [join(engineCwd, "data", "configuration")];
+ const dirs = [
+ join(engineCwd, "config"),
+ join(dirname(configPath), "config"),
+ join(engineCwd, "data", "configuration"),
+ ];
const custom = renderedConfig ? configuredPersistDir(renderedConfig) : null;
if (custom) dirs.unshift(resolve(engineCwd, custom));
return [...new Set(dirs)];
@@ -35,20 +45,29 @@ export function persistedBuiltinConfigDirs(
export function persistedBuiltinConfigPaths(
engineCwd: string,
+ configPath: string,
renderedConfig?: string,
): string[] {
- return persistedBuiltinConfigDirs(engineCwd, renderedConfig).flatMap((dir) =>
+ return persistedBuiltinConfigDirs(engineCwd, configPath, renderedConfig).flatMap((dir) =>
SEEDED_BUILTIN_WORKERS.map((id) => join(dir, `${id}.yaml`)),
);
}
+export function isPersistedBuiltinEntry(content: string, id: string): boolean {
+ const firstLine = content.split("\n").find((line) => line.trim() !== "");
+ return firstLine?.trim() === `id: ${id}`;
+}
+
export function clearPersistedBuiltinConfig(
engineCwd: string,
+ configPath: string,
renderedConfig?: string,
): string[] {
const cleared: string[] = [];
- for (const path of persistedBuiltinConfigPaths(engineCwd, renderedConfig)) {
+ for (const path of persistedBuiltinConfigPaths(engineCwd, configPath, renderedConfig)) {
try {
+ const content = readFileSync(path, "utf8");
+ if (!isPersistedBuiltinEntry(content, basename(path, ".yaml"))) continue;
rmSync(path);
cleared.push(path);
} catch (err) {
diff --git a/src/cli/engine-launch.ts b/src/cli/engine-launch.ts
index b162e7f5..d7517360 100644
--- a/src/cli/engine-launch.ts
+++ b/src/cli/engine-launch.ts
@@ -187,3 +187,7 @@ export function legacyDataMigrations(
},
];
}
+
+export function engineChildEnv(base: NodeJS.ProcessEnv): NodeJS.ProcessEnv {
+ return { ...base, III_TELEMETRY_ENABLED: base["III_TELEMETRY_ENABLED"] ?? "false" };
+}
diff --git a/src/cli/preferences.ts b/src/cli/preferences.ts
index 63695db6..1518e43f 100644
--- a/src/cli/preferences.ts
+++ b/src/cli/preferences.ts
@@ -49,17 +49,13 @@ export interface Prefs {
// globally?" prompt on first npx run. We never ask again on this
// machine so the prompt stays a one-time DX nudge, not a nag.
skipGlobalInstall: boolean;
- // Set to true when the user declines the "install iii console?"
- // prompt. iii console is first-class engine UI but optional at the
- // install step — once the user says no, we stop asking.
- skipConsoleInstall: boolean;
// ISO timestamp of the first time onboarding completed. Set once,
// never updated, so we can show "you joined agentmemory N days ago"
// copy in /status later without keeping a separate file.
firstRunAt: string | null;
// Set to true once the user has answered the context-injection prompt
// (either way). We never re-ask after this so the prompt stays a
- // one-time choice, matching the skipGlobalInstall / skipConsoleInstall
+ // one-time choice, matching the skipGlobalInstall
// never-nag pattern.
injectContextChosen: boolean;
}
@@ -72,7 +68,6 @@ const DEFAULTS: Prefs = {
skipSplash: false,
skipNpxHint: false,
skipGlobalInstall: false,
- skipConsoleInstall: false,
firstRunAt: null,
injectContextChosen: false,
};
diff --git a/src/functions/actions.ts b/src/functions/actions.ts
index 12d12df3..9bf583f6 100644
--- a/src/functions/actions.ts
+++ b/src/functions/actions.ts
@@ -1,11 +1,11 @@
-import type { ISdk } from "iii-sdk";
+import type { IIIClient } from "iii-sdk";
import type { StateKV } from "../state/kv.js";
import { KV, generateId } from "../state/schema.js";
import { withKeyedLock } from "../state/keyed-mutex.js";
import type { Action, ActionEdge } from "../types.js";
import { recordAudit } from "./audit.js";
-export function registerActionsFunction(sdk: ISdk, kv: StateKV): void {
+export function registerActionsFunction(sdk: IIIClient, kv: StateKV): void {
sdk.registerFunction("mem::action-create",
async (data: {
title: string;
diff --git a/src/functions/auto-forget.ts b/src/functions/auto-forget.ts
index 74c571b9..d8f6ac70 100644
--- a/src/functions/auto-forget.ts
+++ b/src/functions/auto-forget.ts
@@ -1,4 +1,4 @@
-import type { ISdk } from "iii-sdk";
+import type { IIIClient } from "iii-sdk";
import type { Memory, CompressedObservation, Session } from "../types.js";
import { KV } from "../state/schema.js";
import { StateKV } from "../state/kv.js";
@@ -21,7 +21,7 @@ interface AutoForgetResult {
dryRun: boolean;
}
-export function registerAutoForgetFunction(sdk: ISdk, kv: StateKV): void {
+export function registerAutoForgetFunction(sdk: IIIClient, kv: StateKV): void {
sdk.registerFunction("mem::auto-forget",
async (data: { dryRun?: boolean }): Promise<AutoForgetResult> => {
const dryRun = data?.dryRun ?? false;
diff --git a/src/functions/branch-aware.ts b/src/functions/branch-aware.ts
index d0240f43..68e63336 100644
--- a/src/functions/branch-aware.ts
+++ b/src/functions/branch-aware.ts
@@ -1,4 +1,4 @@
-import type { ISdk } from "iii-sdk";
+import type { IIIClient } from "iii-sdk";
import type { StateKV } from "../state/kv.js";
import { KV } from "../state/schema.js";
import type { Session } from "../types.js";
@@ -18,7 +18,7 @@ function execAsync(
});
}
-export function registerBranchAwareFunction(sdk: ISdk, kv: StateKV): void {
+export function registerBranchAwareFunction(sdk: IIIClient, kv: StateKV): void {
sdk.registerFunction("mem::detect-worktree",
async (data: { cwd: string }) => {
if (!data.cwd) {
diff --git a/src/functions/cascade.ts b/src/functions/cascade.ts
index fb979e65..2167c506 100644
--- a/src/functions/cascade.ts
+++ b/src/functions/cascade.ts
@@ -1,10 +1,10 @@
-import type { ISdk } from "iii-sdk";
+import type { IIIClient } from "iii-sdk";
import type { StateKV } from "../state/kv.js";
import { KV } from "../state/schema.js";
import type { Memory, GraphNode, GraphEdge } from "../types.js";
import { recordAudit } from "./audit.js";
-export function registerCascadeFunction(sdk: ISdk, kv: StateKV): void {
+export function registerCascadeFunction(sdk: IIIClient, kv: StateKV): void {
sdk.registerFunction("mem::cascade-update",
async (data: { supersededMemoryId: string }) => {
if (!data.supersededMemoryId || typeof data.supersededMemoryId !== "string") {
diff --git a/src/functions/checkpoints.ts b/src/functions/checkpoints.ts
index efb3957a..525f07d9 100644
--- a/src/functions/checkpoints.ts
+++ b/src/functions/checkpoints.ts
@@ -1,11 +1,11 @@
-import type { ISdk } from "iii-sdk";
+import type { IIIClient } from "iii-sdk";
import type { StateKV } from "../state/kv.js";
import { KV, generateId } from "../state/schema.js";
import { withKeyedLock } from "../state/keyed-mutex.js";
import type { Action, ActionEdge, Checkpoint } from "../types.js";
import { recordAudit } from "./audit.js";
-export function registerCheckpointsFunction(sdk: ISdk, kv: StateKV): void {
+export function registerCheckpointsFunction(sdk: IIIClient, kv: StateKV): void {
sdk.registerFunction("mem::checkpoint-create",
async (data: {
name: string;
diff --git a/src/functions/claude-bridge.ts b/src/functions/claude-bridge.ts
index 3aba76f5..1c7c245e 100644
--- a/src/functions/claude-bridge.ts
+++ b/src/functions/claude-bridge.ts
@@ -1,4 +1,4 @@
-import type { ISdk } from "iii-sdk";
+import type { IIIClient } from "iii-sdk";
import { readFileSync, writeFileSync, mkdirSync, existsSync } from "node:fs";
import { dirname } from "node:path";
import type { Memory, ClaudeBridgeConfig } from "../types.js";
@@ -70,7 +70,7 @@ function serializeToMemoryMd(
}
export function registerClaudeBridgeFunction(
- sdk: ISdk,
+ sdk: IIIClient,
kv: StateKV,
config: ClaudeBridgeConfig,
): void {
diff --git a/src/functions/compress-file.ts b/src/functions/compress-file.ts
index 0a54452b..a1ce308f 100644
--- a/src/functions/compress-file.ts
+++ b/src/functions/compress-file.ts
@@ -1,7 +1,7 @@
import { constants } from "node:fs";
import { lstat, open, readFile, writeFile } from "node:fs/promises";
import { basename, dirname, extname, join, resolve } from "node:path";
-import type { ISdk } from "iii-sdk";
+import type { IIIClient } from "iii-sdk";
import type { MemoryProvider } from "../types.js";
import type { StateKV } from "../state/kv.js";
import { recordAudit } from "./audit.js";
@@ -93,7 +93,7 @@ function resolveBackupPath(filePath: string): string {
}
export function registerCompressFileFunction(
- sdk: ISdk,
+ sdk: IIIClient,
kv: StateKV,
provider: MemoryProvider,
): void {
diff --git a/src/functions/compress.ts b/src/functions/compress.ts
index c94d856e..a87a5b4f 100644
--- a/src/functions/compress.ts
+++ b/src/functions/compress.ts
@@ -1,4 +1,4 @@
-import { TriggerAction, type ISdk } from "iii-sdk";
+import { TriggerAction, type IIIClient } from "iii-sdk";
import { readFileSync } from "node:fs";
import { isManagedImagePath } from "../utils/image-store.js";
import type {
@@ -65,7 +65,7 @@ function parseCompressionXml(
}
export function registerCompressFunction(
- sdk: ISdk,
+ sdk: IIIClient,
kv: StateKV,
provider: MemoryProvider,
metricsStore?: MetricsStore,
diff --git a/src/functions/consolidate.ts b/src/functions/consolidate.ts
index d394e176..8924a03a 100644
--- a/src/functions/consolidate.ts
+++ b/src/functions/consolidate.ts
@@ -1,4 +1,4 @@
-import type { ISdk } from "iii-sdk";
+import type { IIIClient } from "iii-sdk";
import type {
CompressedObservation,
Memory,
@@ -63,7 +63,7 @@ function parseMemoryXml(
}
export function registerConsolidateFunction(
- sdk: ISdk,
+ sdk: IIIClient,
kv: StateKV,
provider: MemoryProvider,
): void {
diff --git a/src/functions/consolidation-pipeline.ts b/src/functions/consolidation-pipeline.ts
index e51ab97c..75791148 100644
--- a/src/functions/consolidation-pipeline.ts
+++ b/src/functions/consolidation-pipeline.ts
@@ -1,4 +1,4 @@
-import type { ISdk } from "iii-sdk";
+import type { IIIClient } from "iii-sdk";
import type {
SemanticMemory,
ProceduralMemory,
@@ -43,7 +43,7 @@ function applyDecay(
}
export function registerConsolidationPipelineFunction(
- sdk: ISdk,
+ sdk: IIIClient,
kv: StateKV,
provider: MemoryProvider,
): void {
diff --git a/src/functions/context.ts b/src/functions/context.ts
index 2d64b3f3..668ac61b 100644
--- a/src/functions/context.ts
+++ b/src/functions/context.ts
@@ -1,4 +1,4 @@
-import type { ISdk } from "iii-sdk";
+import type { IIIClient } from "iii-sdk";
import type {
Session,
CompressedObservation,
@@ -32,7 +32,7 @@ function escapeXmlAttr(s: string): string {
}
export function registerContextFunction(
- sdk: ISdk,
+ sdk: IIIClient,
kv: StateKV,
tokenBudget: number,
): void {
diff --git a/src/functions/crystallize.ts b/src/functions/crystallize.ts
index 1f0b8431..7904fee2 100644
--- a/src/functions/crystallize.ts
+++ b/src/functions/crystallize.ts
@@ -1,4 +1,4 @@
-import type { ISdk } from "iii-sdk";
+import type { IIIClient } from "iii-sdk";
import type { StateKV } from "../state/kv.js";
import { KV, generateId } from "../state/schema.js";
import type { Action, ActionEdge, Crystal, MemoryProvider } from "../types.js";
@@ -16,7 +16,7 @@ Extract: (1) what was accomplished in 1-2 sentences, (2) key decisions as bullet
Return as JSON: { "narrative": "...", "keyOutcomes": ["..."], "filesAffected": ["..."], "lessons": ["..."] }`;
export function registerCrystallizeFunction(
- sdk: ISdk,
+ sdk: IIIClient,
kv: StateKV,
provider: MemoryProvider,
): void {
diff --git a/src/functions/diagnostics.ts b/src/functions/diagnostics.ts
index cc982883..33bf3f0c 100644
--- a/src/functions/diagnostics.ts
+++ b/src/functions/diagnostics.ts
@@ -1,4 +1,4 @@
-import type { ISdk } from "iii-sdk";
+import type { IIIClient } from "iii-sdk";
import type { StateKV } from "../state/kv.js";
import { KV } from "../state/schema.js";
import { withKeyedLock } from "../state/keyed-mutex.js";
@@ -43,7 +43,7 @@ const ALL_CATEGORIES = [
const TWENTY_FOUR_HOURS_MS = 24 * 60 * 60 * 1000;
const ONE_HOUR_MS = 60 * 60 * 1000;
-export function registerDiagnosticsFunction(sdk: ISdk, kv: StateKV): void {
+export function registerDiagnosticsFunction(sdk: IIIClient, kv: StateKV): void {
sdk.registerFunction("mem::diagnose",
async (data: { categories?: string[] }) => {
const categories = data.categories && data.categories.length > 0
diff --git a/src/functions/disk-size-manager.ts b/src/functions/disk-size-manager.ts
index 0905e83c..9f61d6eb 100644
--- a/src/functions/disk-size-manager.ts
+++ b/src/functions/disk-size-manager.ts
@@ -1,4 +1,4 @@
-import { TriggerAction, type ISdk } from "iii-sdk";
+import { TriggerAction, type IIIClient } from "iii-sdk";
import { KV } from "../state/schema.js";
import { StateKV } from "../state/kv.js";
import { getMaxBytes } from "../utils/image-store.js";
@@ -8,7 +8,7 @@ import type { StateScope, StateScopeKey } from "../types.js";
const DISK_SIZE_KEY: StateScopeKey = "system:currentDiskSize";
-export function registerDiskSizeManager(sdk: ISdk, kv: StateKV): void {
+export function registerDiskSizeManager(sdk: IIIClient, kv: StateKV): void {
sdk.registerFunction(
"mem::disk-size-delta",
async (data: { deltaBytes: number }) => {
diff --git a/src/functions/enrich.ts b/src/functions/enrich.ts
index 032ec97b..d4f900af 100644
--- a/src/functions/enrich.ts
+++ b/src/functions/enrich.ts
@@ -1,4 +1,4 @@
-import type { ISdk } from "iii-sdk";
+import type { IIIClient } from "iii-sdk";
import type { Memory } from "../types.js";
import { KV } from "../state/schema.js";
import { StateKV } from "../state/kv.js";
@@ -15,7 +15,7 @@ function escapeXml(s: string): string {
.replace(/'/g, "&apos;");
}
-export function registerEnrichFunction(sdk: ISdk, kv: StateKV): void {
+export function registerEnrichFunction(sdk: IIIClient, kv: StateKV): void {
sdk.registerFunction("mem::enrich",
async (data: {
sessionId: string;
diff --git a/src/functions/evict.ts b/src/functions/evict.ts
index 72260695..b7afb202 100644
--- a/src/functions/evict.ts
+++ b/src/functions/evict.ts
@@ -1,4 +1,4 @@
-import type { ISdk } from "iii-sdk";
+import type { IIIClient } from "iii-sdk";
import type {
Session,
CompressedObservation,
@@ -55,7 +55,7 @@ function isCompressedObservation(
}
async function recoverStaleSession(
- sdk: ISdk,
+ sdk: IIIClient,
sessionId: string,
): Promise<boolean> {
try {
@@ -82,7 +82,7 @@ async function recoverStaleSession(
}
}
-async function runRecoveredSessionConsolidation(sdk: ISdk): Promise<void> {
+async function runRecoveredSessionConsolidation(sdk: IIIClient): Promise<void> {
// Same gate as the session-stop path: keyless installs must not fire
// no-op LLM consolidation from an eviction sweep either.
if (!isConsolidationEnabled()) return;
@@ -105,7 +105,7 @@ async function runRecoveredSessionConsolidation(sdk: ISdk): Promise<void> {
}
}
-export function registerEvictFunction(sdk: ISdk, kv: StateKV): void {
+export function registerEvictFunction(sdk: IIIClient, kv: StateKV): void {
sdk.registerFunction("mem::evict",
async (data: { dryRun?: boolean }): Promise<EvictionStats> => {
const dryRun = data?.dryRun ?? false;
diff --git a/src/functions/export-import.ts b/src/functions/export-import.ts
index 7bdabf61..6d0128f3 100644
--- a/src/functions/export-import.ts
+++ b/src/functions/export-import.ts
@@ -1,4 +1,4 @@
-import type { ISdk } from "iii-sdk";
+import type { IIIClient } from "iii-sdk";
import type {
Session,
CompressedObservation,
@@ -58,7 +58,7 @@ async function runChunked<T>(
}
}
-export function registerExportImportFunction(sdk: ISdk, kv: StateKV): void {
+export function registerExportImportFunction(sdk: IIIClient, kv: StateKV): void {
sdk.registerFunction("mem::export",
async (data?: { maxSessions?: number; offset?: number }) => {
const rawMax = Number(data?.maxSessions);
diff --git a/src/functions/facets.ts b/src/functions/facets.ts
index cb5b37dc..430d0a32 100644
--- a/src/functions/facets.ts
+++ b/src/functions/facets.ts
@@ -1,9 +1,9 @@
-import type { ISdk } from "iii-sdk";
+import type { IIIClient } from "iii-sdk";
import type { StateKV } from "../state/kv.js";
import { KV, generateId } from "../state/schema.js";
import type { Facet } from "../types.js";
-export function registerFacetsFunction(sdk: ISdk, kv: StateKV): void {
+export function registerFacetsFunction(sdk: IIIClient, kv: StateKV): void {
sdk.registerFunction("mem::facet-tag",
async (data: {
targetId: string;
diff --git a/src/functions/file-index.ts b/src/functions/file-index.ts
index a5c50318..a52bf035 100644
--- a/src/functions/file-index.ts
+++ b/src/functions/file-index.ts
@@ -1,4 +1,4 @@
-import type { ISdk } from "iii-sdk";
+import type { IIIClient } from "iii-sdk";
import type { CompressedObservation, Session } from "../types.js";
import { KV } from "../state/schema.js";
import { StateKV } from "../state/kv.js";
@@ -19,7 +19,7 @@ interface FileHistory {
}>;
}
-export function registerFileIndexFunction(sdk: ISdk, kv: StateKV): void {
+export function registerFileIndexFunction(sdk: IIIClient, kv: StateKV): void {
sdk.registerFunction("mem::file-context",
async (
data: { sessionId?: string; files?: string[]; project?: string } | undefined,
diff --git a/src/functions/flow-compress.ts b/src/functions/flow-compress.ts
index d2eb5a31..3be1ca6e 100644
--- a/src/functions/flow-compress.ts
+++ b/src/functions/flow-compress.ts
@@ -1,4 +1,4 @@
-import type { ISdk } from "iii-sdk";
+import type { IIIClient } from "iii-sdk";
import type { StateKV } from "../state/kv.js";
import { KV, generateId } from "../state/schema.js";
import type { Action, ActionEdge, RoutineRun, MemoryProvider } from "../types.js";
@@ -20,7 +20,7 @@ Output as XML:
</summary>`;
export function registerFlowCompressFunction(
- sdk: ISdk,
+ sdk: IIIClient,
kv: StateKV,
provider: MemoryProvider,
): void {
diff --git a/src/functions/frontier.ts b/src/functions/frontier.ts
index 30f43fec..0676f92b 100644
--- a/src/functions/frontier.ts
+++ b/src/functions/frontier.ts
@@ -1,4 +1,4 @@
-import type { ISdk } from "iii-sdk";
+import type { IIIClient } from "iii-sdk";
import type { StateKV } from "../state/kv.js";
import { KV } from "../state/schema.js";
import type { Action, ActionEdge, Checkpoint, Lease } from "../types.js";
@@ -10,7 +10,7 @@ export interface FrontierItem {
leased: boolean;
}
-export function registerFrontierFunction(sdk: ISdk, kv: StateKV): void {
+export function registerFrontierFunction(sdk: IIIClient, kv: StateKV): void {
sdk.registerFunction("mem::frontier",
async (data: {
project?: string;
diff --git a/src/functions/governance.ts b/src/functions/governance.ts
index 16d0d1c4..d8d0ab01 100644
--- a/src/functions/governance.ts
+++ b/src/functions/governance.ts
@@ -1,4 +1,4 @@
-import type { ISdk } from "iii-sdk";
+import type { IIIClient } from "iii-sdk";
import type { Memory, GovernanceFilter, AuditEntry } from "../types.js";
import { KV } from "../state/schema.js";
import type { StateKV } from "../state/kv.js";
@@ -7,7 +7,7 @@ import { deleteAccessLog } from "./access-tracker.js";
import { getSearchIndex, vectorIndexRemove, flushIndexSave } from "./search.js";
import { logger } from "../logger.js";
-export function registerGovernanceFunction(sdk: ISdk, kv: StateKV): void {
+export function registerGovernanceFunction(sdk: IIIClient, kv: StateKV): void {
sdk.registerFunction("mem::governance-delete",
async (data: { memoryIds: string[]; reason?: string }) => {
if (
diff --git a/src/functions/graph-import.ts b/src/functions/graph-import.ts
index 520decc6..502526e8 100644
--- a/src/functions/graph-import.ts
+++ b/src/functions/graph-import.ts
@@ -1,6 +1,6 @@
import { readFile, stat } from "node:fs/promises";
import { join } from "node:path";
-import type { ISdk } from "iii-sdk";
+import type { IIIClient } from "iii-sdk";
import type { GraphEdge, GraphEdgeType, GraphNode, GraphNodeType } from "../types.js";
import { KV, generateId } from "../state/schema.js";
import type { StateKV } from "../state/kv.js";
@@ -192,7 +192,7 @@ export function parseGraphifyGraph(raw: string): {
};
}
-export function registerGraphImportFunction(sdk: ISdk, kv: StateKV): void {
+export function registerGraphImportFunction(sdk: IIIClient, kv: StateKV): void {
sdk.registerFunction(
"mem::graph::import-graphify",
async (data?: { path?: string; cwd?: string }): Promise<GraphifyImportResult> => {
diff --git a/src/functions/graph.ts b/src/functions/graph.ts
index 76340d60..62e7343e 100644
--- a/src/functions/graph.ts
+++ b/src/functions/graph.ts
@@ -1,4 +1,4 @@
-import type { ISdk } from "iii-sdk";
+import type { IIIClient } from "iii-sdk";
import type {
GraphNode,
GraphEdge,
@@ -680,7 +680,7 @@ export async function persistGraphDelta(
}
export function registerGraphFunction(
- sdk: ISdk,
+ sdk: IIIClient,
kv: StateKV,
provider: MemoryProvider,
): void {
diff --git a/src/functions/image-quota-cleanup.ts b/src/functions/image-quota-cleanup.ts
index d07dfa96..12339bd6 100644
--- a/src/functions/image-quota-cleanup.ts
+++ b/src/functions/image-quota-cleanup.ts
@@ -1,4 +1,4 @@
-import { TriggerAction, type ISdk } from "iii-sdk";
+import { TriggerAction, type IIIClient } from "iii-sdk";
import { KV } from "../state/schema.js";
import { StateKV } from "../state/kv.js";
import { readdir, stat } from "node:fs/promises";
@@ -9,7 +9,7 @@ import { logger } from "../logger.js";
const GRACE_PERIOD_MS = 30_000;
-export function registerImageQuotaCleanup(sdk: ISdk, kv: StateKV): void {
+export function registerImageQuotaCleanup(sdk: IIIClient, kv: StateKV): void {
sdk.registerFunction(
"mem::image-quota-cleanup",
async () => {
diff --git a/src/functions/image-refs.ts b/src/functions/image-refs.ts
index ce1661df..918a7e7c 100644
--- a/src/functions/image-refs.ts
+++ b/src/functions/image-refs.ts
@@ -1,4 +1,4 @@
-import { TriggerAction, type ISdk } from "iii-sdk";
+import { TriggerAction, type IIIClient } from "iii-sdk";
import { KV } from "../state/schema.js";
import { StateKV } from "../state/kv.js";
import { deleteImage, touchImage } from "../utils/image-store.js";
@@ -17,7 +17,7 @@ export async function incrementImageRef(kv: StateKV, filePath: string): Promise<
});
}
-export async function decrementImageRef(kv: StateKV, sdk: ISdk, filePath: string): Promise<void> {
+export async function decrementImageRef(kv: StateKV, sdk: IIIClient, filePath: string): Promise<void> {
return withKeyedLock(`imgRef:${filePath}`, async () => {
const current = await getImageRefCount(kv, filePath);
if (current <= 1) {
diff --git a/src/functions/leases.ts b/src/functions/leases.ts
index 1a2de33b..dfe1ef47 100644
--- a/src/functions/leases.ts
+++ b/src/functions/leases.ts
@@ -1,4 +1,4 @@
-import type { ISdk } from "iii-sdk";
+import type { IIIClient } from "iii-sdk";
import type { StateKV } from "../state/kv.js";
import { KV, generateId } from "../state/schema.js";
import { withKeyedLock } from "../state/keyed-mutex.js";
@@ -8,7 +8,7 @@ import { recordAudit } from "./audit.js";
const DEFAULT_LEASE_TTL_MS = 10 * 60 * 1000;
const MAX_LEASE_TTL_MS = 60 * 60 * 1000;
-export function registerLeasesFunction(sdk: ISdk, kv: StateKV): void {
+export function registerLeasesFunction(sdk: IIIClient, kv: StateKV): void {
sdk.registerFunction("mem::lease-acquire",
async (data: { actionId: string; agentId: string; ttlMs?: number }) => {
if (!data.actionId || !data.agentId) {
diff --git a/src/functions/lessons.ts b/src/functions/lessons.ts
index d0a4a21e..c750b1d6 100644
--- a/src/functions/lessons.ts
+++ b/src/functions/lessons.ts
@@ -1,4 +1,4 @@
-import type { ISdk } from "iii-sdk";
+import type { IIIClient } from "iii-sdk";
import type { StateKV } from "../state/kv.js";
import { KV, fingerprintId } from "../state/schema.js";
import type { Lesson } from "../types.js";
@@ -63,7 +63,7 @@ function reinforceLesson(lesson: Lesson): void {
lesson.updatedAt = now;
}
-export function registerLessonsFunctions(sdk: ISdk, kv: StateKV): void {
+export function registerLessonsFunctions(sdk: IIIClient, kv: StateKV): void {
sdk.registerFunction("mem::lesson-save",
async (data: {
content: string;
diff --git a/src/functions/mesh.ts b/src/functions/mesh.ts
index ad52e5ea..139765ad 100644
--- a/src/functions/mesh.ts
+++ b/src/functions/mesh.ts
@@ -1,4 +1,4 @@
-import type { ISdk } from "iii-sdk";
+import type { IIIClient } from "iii-sdk";
import type { StateKV } from "../state/kv.js";
import { KV, generateId } from "../state/schema.js";
import { withKeyedLock } from "../state/keyed-mutex.js";
@@ -137,7 +137,7 @@ async function lwwMergeGraphNodes(
}
export function registerMeshFunction(
- sdk: ISdk,
+ sdk: IIIClient,
kv: StateKV,
meshAuthToken?: string,
): void {
diff --git a/src/functions/migrate.ts b/src/functions/migrate.ts
index c2039ea1..8cabef53 100644
--- a/src/functions/migrate.ts
+++ b/src/functions/migrate.ts
@@ -1,4 +1,4 @@
-import type { ISdk } from "iii-sdk";
+import type { IIIClient } from "iii-sdk";
import { resolve } from "node:path";
import { homedir } from "node:os";
import { KV, generateId } from "../state/schema.js";
@@ -85,7 +85,7 @@ export async function inferMemoryProjects(
return { updated, skipped, ambiguous };
}
-export function registerMigrateFunction(sdk: ISdk, kv: StateKV): void {
+export function registerMigrateFunction(sdk: IIIClient, kv: StateKV): void {
sdk.registerFunction("mem::migrate",
async (data: { dbPath?: string; step?: string; dryRun?: boolean }) => {
// In-place KV migration steps (no SQLite dependency).
diff --git a/src/functions/observe.ts b/src/functions/observe.ts
index e9b0f314..fa45f68f 100644
--- a/src/functions/observe.ts
+++ b/src/functions/observe.ts
@@ -1,4 +1,4 @@
-import { TriggerAction, type ISdk } from "iii-sdk";
+import { TriggerAction, type IIIClient } from "iii-sdk";
import type { RawObservation, HookPayload, Origin } from "../types.js";
const TOOL_HOOKS = new Set(["pre_tool_use", "post_tool_use", "post_tool_failure"]);
@@ -38,7 +38,7 @@ export function extractImage(d: unknown): string | undefined {
}
export function registerObserveFunction(
- sdk: ISdk,
+ sdk: IIIClient,
kv: StateKV,
dedupMap?: DedupMap,
maxObservationsPerSession?: number,
diff --git a/src/functions/obsidian-export.ts b/src/functions/obsidian-export.ts
index 0e819481..d55ea1bb 100644
--- a/src/functions/obsidian-export.ts
+++ b/src/functions/obsidian-export.ts
@@ -1,7 +1,7 @@
import { mkdir, writeFile } from "node:fs/promises";
import { join, resolve, sep } from "node:path";
import { homedir } from "node:os";
-import type { ISdk } from "iii-sdk";
+import type { IIIClient } from "iii-sdk";
import type { StateKV } from "../state/kv.js";
import { KV } from "../state/schema.js";
import type {
@@ -242,7 +242,7 @@ interface ExportError {
}
export function registerObsidianExportFunction(
- sdk: ISdk,
+ sdk: IIIClient,
kv: StateKV,
): void {
sdk.registerFunction("mem::obsidian-export",
diff --git a/src/functions/patterns.ts b/src/functions/patterns.ts
index ef6821cb..eef43f30 100644
--- a/src/functions/patterns.ts
+++ b/src/functions/patterns.ts
@@ -1,4 +1,4 @@
-import type { ISdk } from "iii-sdk";
+import type { IIIClient } from "iii-sdk";
import type { CompressedObservation, Session } from "../types.js";
import { KV } from "../state/schema.js";
import { StateKV } from "../state/kv.js";
@@ -12,7 +12,7 @@ interface Pattern {
sessions: string[];
}
-export function registerPatternsFunction(sdk: ISdk, kv: StateKV): void {
+export function registerPatternsFunction(sdk: IIIClient, kv: StateKV): void {
sdk.registerFunction("mem::patterns",
async (data: { project?: string }) => {
const patterns: Pattern[] = [];
diff --git a/src/functions/privacy.ts b/src/functions/privacy.ts
index f28edd3e..da84b621 100644
--- a/src/functions/privacy.ts
+++ b/src/functions/privacy.ts
@@ -1,4 +1,4 @@
-import type { ISdk } from "iii-sdk";
+import type { IIIClient } from "iii-sdk";
const PRIVATE_TAG_RE = /<private>[\s\S]*?<\/private>/gi;
@@ -28,7 +28,7 @@ export function stripPrivateData(input: string): string {
return result;
}
-export function registerPrivacyFunction(sdk: ISdk): void {
+export function registerPrivacyFunction(sdk: IIIClient): void {
sdk.registerFunction("mem::privacy",
async (data: { input?: unknown } | undefined) => {
if (!data || typeof data.input !== "string") {
diff --git a/src/functions/profile.ts b/src/functions/profile.ts
index 07881e92..a27a4463 100644
--- a/src/functions/profile.ts
+++ b/src/functions/profile.ts
@@ -1,4 +1,4 @@
-import type { ISdk } from "iii-sdk";
+import type { IIIClient } from "iii-sdk";
import type {
CompressedObservation,
Session,
@@ -9,7 +9,7 @@ import { StateKV } from "../state/kv.js";
import { recordAudit } from "./audit.js";
import { logger } from "../logger.js";
-export function registerProfileFunction(sdk: ISdk, kv: StateKV): void {
+export function registerProfileFunction(sdk: IIIClient, kv: StateKV): void {
sdk.registerFunction("mem::profile",
async (data: { project: string; refresh?: boolean } | undefined) => {
if (!data || typeof data.project !== "string" || !data.project.trim()) {
diff --git a/src/functions/query-expansion.ts b/src/functions/query-expansion.ts
index 00cfdf48..45e551db 100644
--- a/src/functions/query-expansion.ts
+++ b/src/functions/query-expansion.ts
@@ -1,4 +1,4 @@
-import type { ISdk } from "iii-sdk";
+import type { IIIClient } from "iii-sdk";
import type { MemoryProvider, QueryExpansion } from "../types.js";
import { logger } from "../logger.js";
@@ -67,7 +67,7 @@ function parseExpansionXml(xml: string): QueryExpansion | null {
}
export function registerQueryExpansionFunction(
- sdk: ISdk,
+ sdk: IIIClient,
provider: MemoryProvider,
): void {
sdk.registerFunction("mem::expand-query",
diff --git a/src/functions/recent-searches-sweep.ts b/src/functions/recent-searches-sweep.ts
index 03df192c..3b75a7e2 100644
--- a/src/functions/recent-searches-sweep.ts
+++ b/src/functions/recent-searches-sweep.ts
@@ -1,4 +1,4 @@
-import type { ISdk } from "iii-sdk";
+import type { IIIClient } from "iii-sdk";
import type { StateKV } from "../state/kv.js";
import { KV } from "../state/schema.js";
import { logger } from "../logger.js";
@@ -12,7 +12,7 @@ import { getFollowupWindowSeconds } from "../config.js";
const RETENTION_MS = 24 * 60 * 60 * 1000;
export function registerRecentSearchesSweepFunction(
- sdk: ISdk,
+ sdk: IIIClient,
kv: StateKV,
): void {
sdk.registerFunction(
diff --git a/src/functions/reflect.ts b/src/functions/reflect.ts
index 3a2af829..b93a5dc0 100644
--- a/src/functions/reflect.ts
+++ b/src/functions/reflect.ts
@@ -1,4 +1,4 @@
-import type { ISdk } from "iii-sdk";
+import type { IIIClient } from "iii-sdk";
import type { StateKV } from "../state/kv.js";
import { KV, fingerprintId } from "../state/schema.js";
import type {
@@ -161,7 +161,7 @@ function buildJaccardClusters(
}
export function registerReflectFunctions(
- sdk: ISdk,
+ sdk: IIIClient,
kv: StateKV,
provider: MemoryProvider,
): void {
diff --git a/src/functions/relations.ts b/src/functions/relations.ts
index 7921a328..7bde404c 100644
--- a/src/functions/relations.ts
+++ b/src/functions/relations.ts
@@ -1,4 +1,4 @@
-import type { ISdk } from "iii-sdk";
+import type { IIIClient } from "iii-sdk";
import type { Memory, MemoryRelation } from "../types.js";
import { KV, generateId } from "../state/schema.js";
import { StateKV } from "../state/kv.js";
@@ -36,7 +36,7 @@ function computeConfidence(
return Math.max(0, Math.min(1, score));
}
-export function registerRelationsFunction(sdk: ISdk, kv: StateKV): void {
+export function registerRelationsFunction(sdk: IIIClient, kv: StateKV): void {
sdk.registerFunction("mem::relate",
async (data: {
sourceId: string;
diff --git a/src/functions/remember.ts b/src/functions/remember.ts
index e7a1793c..73f6e3c3 100644
--- a/src/functions/remember.ts
+++ b/src/functions/remember.ts
@@ -1,4 +1,4 @@
-import { TriggerAction, type ISdk } from "iii-sdk";
+import { TriggerAction, type IIIClient } from "iii-sdk";
import type { Memory } from "../types.js";
import { KV, generateId, jaccardSimilarity } from "../state/schema.js";
import { StateKV } from "../state/kv.js";
@@ -19,7 +19,7 @@ function safeSlice(text: string, length: number): string {
return /[\uD800-\uDBFF]$/.test(sliced) ? sliced.slice(0, -1) : sliced;
}
-export function registerRememberFunction(sdk: ISdk, kv: StateKV): void {
+export function registerRememberFunction(sdk: IIIClient, kv: StateKV): void {
sdk.registerFunction("mem::remember",
async (data: {
content: string;
diff --git a/src/functions/replay.ts b/src/functions/replay.ts
index 246a6d61..aea735ff 100644
--- a/src/functions/replay.ts
+++ b/src/functions/replay.ts
@@ -1,7 +1,7 @@
import { homedir } from "node:os";
import { lstat, readFile, readdir } from "node:fs/promises";
import { resolve, join } from "node:path";
-import type { ISdk } from "iii-sdk";
+import type { IIIClient } from "iii-sdk";
import type {
CompressedObservation,
Crystal,
@@ -261,7 +261,7 @@ async function findJsonlFiles(
};
}
-export function registerReplayFunctions(sdk: ISdk, kv: StateKV): void {
+export function registerReplayFunctions(sdk: IIIClient, kv: StateKV): void {
sdk.registerFunction(
"mem::replay::load",
async (data: { sessionId: string }): Promise<
diff --git a/src/functions/retention.ts b/src/functions/retention.ts
index fd3e6466..fac16796 100644
--- a/src/functions/retention.ts
+++ b/src/functions/retention.ts
@@ -1,4 +1,4 @@
-import type { ISdk } from "iii-sdk";
+import type { IIIClient } from "iii-sdk";
import type {
Memory,
SemanticMemory,
@@ -121,7 +121,7 @@ function computeSalience(
}
export function registerRetentionFunctions(
- sdk: ISdk,
+ sdk: IIIClient,
kv: StateKV,
): void {
sdk.registerFunction("mem::retention-score",
diff --git a/src/functions/routines.ts b/src/functions/routines.ts
index d1a9135a..855536a2 100644
--- a/src/functions/routines.ts
+++ b/src/functions/routines.ts
@@ -1,11 +1,11 @@
-import type { ISdk } from "iii-sdk";
+import type { IIIClient } from "iii-sdk";
import type { StateKV } from "../state/kv.js";
import { KV, generateId } from "../state/schema.js";
import { withKeyedLock } from "../state/keyed-mutex.js";
import type { Action, Routine, RoutineStep, RoutineRun } from "../types.js";
import { recordAudit } from "./audit.js";
-export function registerRoutinesFunction(sdk: ISdk, kv: StateKV): void {
+export function registerRoutinesFunction(sdk: IIIClient, kv: StateKV): void {
sdk.registerFunction("mem::routine-create",
async (data: {
name: string;
diff --git a/src/functions/search.ts b/src/functions/search.ts
index 2f44273c..bb585aa0 100644
--- a/src/functions/search.ts
+++ b/src/functions/search.ts
@@ -1,4 +1,4 @@
-import type { ISdk } from 'iii-sdk'
+import type { IIIClient } from 'iii-sdk'
import type { CompactSearchResult, CompressedObservation, Memory, SearchResult, Session } from '../types.js'
import { KV } from '../state/schema.js'
import { StateKV } from '../state/kv.js'
@@ -385,7 +385,7 @@ export async function rebuildIndex(kv: StateKV): Promise<number> {
return indexed
}
-export function registerSearchFunction(sdk: ISdk, kv: StateKV): void {
+export function registerSearchFunction(sdk: IIIClient, kv: StateKV): void {
sdk.registerFunction(
'mem::search',
async (data: {
diff --git a/src/functions/sentinels.ts b/src/functions/sentinels.ts
index ed29aee9..17a1a20f 100644
--- a/src/functions/sentinels.ts
+++ b/src/functions/sentinels.ts
@@ -1,4 +1,4 @@
-import type { ISdk } from "iii-sdk";
+import type { IIIClient } from "iii-sdk";
import type { StateKV } from "../state/kv.js";
import { KV, generateId } from "../state/schema.js";
import { withKeyedLock } from "../state/keyed-mutex.js";
@@ -14,7 +14,7 @@ const VALID_TYPES: Sentinel["type"][] = [
"custom",
];
-export function registerSentinelsFunction(sdk: ISdk, kv: StateKV): void {
+export function registerSentinelsFunction(sdk: IIIClient, kv: StateKV): void {
sdk.registerFunction("mem::sentinel-create",
async (data: {
name: string;
diff --git a/src/functions/signals.ts b/src/functions/signals.ts
index 6abf746c..f98829ec 100644
--- a/src/functions/signals.ts
+++ b/src/functions/signals.ts
@@ -1,10 +1,10 @@
-import type { ISdk } from "iii-sdk";
+import type { IIIClient } from "iii-sdk";
import type { StateKV } from "../state/kv.js";
import { KV, generateId } from "../state/schema.js";
import type { Signal } from "../types.js";
import { recordAudit } from "./audit.js";
-export function registerSignalsFunction(sdk: ISdk, kv: StateKV): void {
+export function registerSignalsFunction(sdk: IIIClient, kv: StateKV): void {
sdk.registerFunction("mem::signal-send",
async (data: {
from: string;
diff --git a/src/functions/sketches.ts b/src/functions/sketches.ts
index c617a298..0ef329f4 100644
--- a/src/functions/sketches.ts
+++ b/src/functions/sketches.ts
@@ -1,11 +1,11 @@
-import type { ISdk } from "iii-sdk";
+import type { IIIClient } from "iii-sdk";
import type { StateKV } from "../state/kv.js";
import { KV, generateId } from "../state/schema.js";
import { withKeyedLock } from "../state/keyed-mutex.js";
import type { Action, ActionEdge, Sketch } from "../types.js";
import { safeAudit } from "./audit.js";
-export function registerSketchesFunction(sdk: ISdk, kv: StateKV): void {
+export function registerSketchesFunction(sdk: IIIClient, kv: StateKV): void {
sdk.registerFunction("mem::sketch-create",
async (data: {
title: string;
diff --git a/src/functions/skill-extract.ts b/src/functions/skill-extract.ts
index d3bbbd37..fd9dcd26 100644
--- a/src/functions/skill-extract.ts
+++ b/src/functions/skill-extract.ts
@@ -1,4 +1,4 @@
-import type { ISdk } from "iii-sdk";
+import type { IIIClient } from "iii-sdk";
import type {
CompressedObservation,
SessionSummary,
@@ -101,7 +101,7 @@ function parseSkillXml(
}
export function registerSkillExtractFunctions(
- sdk: ISdk,
+ sdk: IIIClient,
kv: StateKV,
provider: MemoryProvider,
): void {
diff --git a/src/functions/sliding-window.ts b/src/functions/sliding-window.ts
index 1de03dfc..b7cf8c48 100644
--- a/src/functions/sliding-window.ts
+++ b/src/functions/sliding-window.ts
@@ -1,4 +1,4 @@
-import type { ISdk } from "iii-sdk";
+import type { IIIClient } from "iii-sdk";
import type {
CompressedObservation,
EnrichedChunk,
@@ -114,7 +114,7 @@ function parseEnrichedXml(xml: string): {
}
export function registerSlidingWindowFunction(
- sdk: ISdk,
+ sdk: IIIClient,
kv: StateKV,
provider: MemoryProvider,
): void {
diff --git a/src/functions/slots.ts b/src/functions/slots.ts
index 47b49d49..70b14e9b 100644
--- a/src/functions/slots.ts
+++ b/src/functions/slots.ts
@@ -1,4 +1,4 @@
-import type { ISdk } from "iii-sdk";
+import type { IIIClient } from "iii-sdk";
import type { MemorySlot, CompressedObservation } from "../types.js";
import { KV } from "../state/schema.js";
import { StateKV } from "../state/kv.js";
@@ -193,7 +193,7 @@ export function renderPinnedContext(slots: MemorySlot[]): string {
return lines.join("\n");
}
-export function registerSlotsFunctions(sdk: ISdk, kv: StateKV): void {
+export function registerSlotsFunctions(sdk: IIIClient, kv: StateKV): void {
void seedDefaults(kv).catch((err) => {
logger.warn("slot defaults seed failed", {
error: err instanceof Error ? err.message : String(err),
diff --git a/src/functions/smart-search.ts b/src/functions/smart-search.ts
index 5d0147d9..1db87ff4 100644
--- a/src/functions/smart-search.ts
+++ b/src/functions/smart-search.ts
@@ -1,4 +1,4 @@
-import type { ISdk } from "iii-sdk";
+import type { IIIClient } from "iii-sdk";
import type {
CompactLessonResult,
CompactSearchResult,
@@ -73,7 +73,7 @@ export function resetFollowupStatsForTests(): void {
const LESSON_CONTENT_PREVIEW_CHARS = 240;
export function registerSmartSearchFunction(
- sdk: ISdk,
+ sdk: IIIClient,
kv: StateKV,
searchFn: (query: string, limit: number) => Promise<HybridSearchResult[]>,
): void {
@@ -288,7 +288,7 @@ export function registerSmartSearchFunction(
}
async function recallLessons(
- sdk: ISdk,
+ sdk: IIIClient,
query: string,
limit: number,
project?: string,
diff --git a/src/functions/snapshot.ts b/src/functions/snapshot.ts
index 99c45c06..483240e1 100644
--- a/src/functions/snapshot.ts
+++ b/src/functions/snapshot.ts
@@ -1,4 +1,4 @@
-import type { ISdk } from "iii-sdk";
+import type { IIIClient } from "iii-sdk";
import { execFile } from "node:child_process";
import { promisify } from "node:util";
import { existsSync, mkdirSync, writeFileSync, readFileSync } from "node:fs";
@@ -37,7 +37,7 @@ async function ensureGitRepo(dir: string): Promise<void> {
}
export function registerSnapshotFunction(
- sdk: ISdk,
+ sdk: IIIClient,
kv: StateKV,
snapshotDir: string,
): void {
diff --git a/src/functions/summarize.ts b/src/functions/summarize.ts
index 4c501ca8..b3ade48d 100644
--- a/src/functions/summarize.ts
+++ b/src/functions/summarize.ts
@@ -1,4 +1,4 @@
-import type { ISdk } from "iii-sdk";
+import type { IIIClient } from "iii-sdk";
import type {
CompressedObservation,
SessionSummary,
@@ -227,7 +227,7 @@ function parseSummaryXml(
}
export function registerSummarizeFunction(
- sdk: ISdk,
+ sdk: IIIClient,
kv: StateKV,
provider: MemoryProvider,
metricsStore?: MetricsStore,
diff --git a/src/functions/team.ts b/src/functions/team.ts
index a6461fe6..532e8b28 100644
--- a/src/functions/team.ts
+++ b/src/functions/team.ts
@@ -1,4 +1,4 @@
-import type { ISdk } from "iii-sdk";
+import type { IIIClient } from "iii-sdk";
import type {
TeamConfig,
TeamSharedItem,
@@ -13,7 +13,7 @@ import { logger } from "../logger.js";
const VALID_ITEM_TYPES = new Set(["memory", "pattern", "observation"]);
export function registerTeamFunction(
- sdk: ISdk,
+ sdk: IIIClient,
kv: StateKV,
config: TeamConfig,
): void {
diff --git a/src/functions/temporal-graph.ts b/src/functions/temporal-graph.ts
index 1e8d1df1..aed6730b 100644
--- a/src/functions/temporal-graph.ts
+++ b/src/functions/temporal-graph.ts
@@ -1,4 +1,4 @@
-import type { ISdk } from "iii-sdk";
+import type { IIIClient } from "iii-sdk";
import type {
GraphNode,
GraphEdge,
@@ -150,7 +150,7 @@ function parseTemporalGraphXml(
}
export function registerTemporalGraphFunctions(
- sdk: ISdk,
+ sdk: IIIClient,
kv: StateKV,
provider: MemoryProvider,
): void {
diff --git a/src/functions/timeline.ts b/src/functions/timeline.ts
index e2244fe1..2d83876a 100644
--- a/src/functions/timeline.ts
+++ b/src/functions/timeline.ts
@@ -1,4 +1,4 @@
-import type { ISdk } from "iii-sdk";
+import type { IIIClient } from "iii-sdk";
import type {
CompressedObservation,
Session,
@@ -9,7 +9,7 @@ import { StateKV } from "../state/kv.js";
import { recordAccessBatch } from "./access-tracker.js";
import { logger } from "../logger.js";
-export function registerTimelineFunction(sdk: ISdk, kv: StateKV): void {
+export function registerTimelineFunction(sdk: IIIClient, kv: StateKV): void {
sdk.registerFunction("mem::timeline",
async (data: {
anchor: string;
diff --git a/src/functions/verify.ts b/src/functions/verify.ts
index a6e393f6..398b8f62 100644
--- a/src/functions/verify.ts
+++ b/src/functions/verify.ts
@@ -1,4 +1,4 @@
-import type { ISdk } from "iii-sdk";
+import type { IIIClient } from "iii-sdk";
import type { StateKV } from "../state/kv.js";
import { KV } from "../state/schema.js";
import type {
@@ -7,7 +7,7 @@ import type {
Session,
} from "../types.js";
-export function registerVerifyFunction(sdk: ISdk, kv: StateKV): void {
+export function registerVerifyFunction(sdk: IIIClient, kv: StateKV): void {
sdk.registerFunction("mem::verify",
async (data: { id: string }) => {
if (!data.id || typeof data.id !== "string") {
diff --git a/src/functions/vision-search.ts b/src/functions/vision-search.ts
index 844ec9d5..bc31f6a7 100644
--- a/src/functions/vision-search.ts
+++ b/src/functions/vision-search.ts
@@ -1,4 +1,4 @@
-import type { ISdk } from "iii-sdk";
+import type { IIIClient } from "iii-sdk";
import type { EmbeddingProvider } from "../types.js";
import { KV } from "../state/schema.js";
import { StateKV } from "../state/kv.js";
@@ -17,7 +17,7 @@ interface StoredEmbedding {
}
export function registerVisionSearchFunctions(
- sdk: ISdk,
+ sdk: IIIClient,
kv: StateKV,
imageProvider: EmbeddingProvider | null,
): void {
diff --git a/src/functions/working-memory.ts b/src/functions/working-memory.ts
index 127195e5..125d5bd8 100644
--- a/src/functions/working-memory.ts
+++ b/src/functions/working-memory.ts
@@ -1,4 +1,4 @@
-import type { ISdk } from "iii-sdk";
+import type { IIIClient } from "iii-sdk";
import type { Memory, CompressedObservation, ContextBlock } from "../types.js";
import { KV, generateId } from "../state/schema.js";
import { StateKV } from "../state/kv.js";
@@ -32,7 +32,7 @@ function scoreEntry(entry: CoreMemoryEntry, now: number): number {
}
export function registerWorkingMemoryFunctions(
- sdk: ISdk,
+ sdk: IIIClient,
kv: StateKV,
tokenBudget: number,
): void {
diff --git a/src/health/monitor.ts b/src/health/monitor.ts
index 953c94a0..633c28b2 100644
--- a/src/health/monitor.ts
+++ b/src/health/monitor.ts
@@ -1,11 +1,11 @@
-import type { ISdk } from "iii-sdk";
+import type { IIIClient } from "iii-sdk";
import type { HealthSnapshot } from "../types.js";
import type { StateKV } from "../state/kv.js";
import { KV } from "../state/schema.js";
import { evaluateHealth } from "./thresholds.js";
export function registerHealthMonitor(
- sdk: ISdk,
+ sdk: IIIClient,
kv: StateKV,
): { stop: () => void } {
let connectionState = "connected";
diff --git a/src/mcp/server.ts b/src/mcp/server.ts
index ef26427a..75e6ba54 100644
--- a/src/mcp/server.ts
+++ b/src/mcp/server.ts
@@ -1,4 +1,5 @@
-import type { ISdk, ApiRequest } from "iii-sdk";
+import type { IIIClient } from "iii-sdk";
+import type { HttpRequest } from "@iii-dev/helpers/http";
import type { StateKV } from "../state/kv.js";
import { KV } from "../state/schema.js";
import type {
@@ -41,12 +42,12 @@ function parseCsvList(value: unknown): string[] {
}
export function registerMcpEndpoints(
- sdk: ISdk,
+ sdk: IIIClient,
kv: StateKV,
secret?: string,
): void {
function checkAuth(
- req: ApiRequest,
+ req: HttpRequest,
sec: string | undefined,
): McpResponse | null {
if (!sec) return null;
@@ -59,7 +60,7 @@ export function registerMcpEndpoints(
}
sdk.registerFunction("mcp::tools::list",
- async (req: ApiRequest): Promise<McpResponse> => {
+ async (req: HttpRequest): Promise<McpResponse> => {
const authErr = checkAuth(req, secret);
if (authErr) return authErr;
return { status_code: 200, body: { tools: getVisibleTools() } };
@@ -73,7 +74,7 @@ export function registerMcpEndpoints(
sdk.registerFunction("mcp::tools::call",
async (
- req: ApiRequest<{ name: string; arguments: Record<string, unknown> }>,
+ req: HttpRequest<{ name: string; arguments: Record<string, unknown> }>,
): Promise<McpResponse> => {
const authErr = checkAuth(req, secret);
if (authErr) return authErr;
@@ -1335,7 +1336,7 @@ export function registerMcpEndpoints(
];
sdk.registerFunction("mcp::resources::list",
- async (req: ApiRequest): Promise<McpResponse> => {
+ async (req: HttpRequest): Promise<McpResponse> => {
const authErr = checkAuth(req, secret);
if (authErr) return authErr;
return { status_code: 200, body: { resources: MCP_RESOURCES } };
@@ -1348,7 +1349,7 @@ export function registerMcpEndpoints(
});
sdk.registerFunction("mcp::resources::read",
- async (req: ApiRequest<{ uri: string }>): Promise<McpResponse> => {
+ async (req: HttpRequest<{ uri: string }>): Promise<McpResponse> => {
const authErr = checkAuth(req, secret);
if (authErr) return authErr;
@@ -1621,7 +1622,7 @@ export function registerMcpEndpoints(
];
sdk.registerFunction("mcp::prompts::list",
- async (req: ApiRequest): Promise<McpResponse> => {
+ async (req: HttpRequest): Promise<McpResponse> => {
const authErr = checkAuth(req, secret);
if (authErr) return authErr;
return { status_code: 200, body: { prompts: MCP_PROMPTS } };
@@ -1635,7 +1636,7 @@ export function registerMcpEndpoints(
sdk.registerFunction("mcp::prompts::get",
async (
- req: ApiRequest<{ name: string; arguments?: Record<string, string> }>,
+ req: HttpRequest<{ name: string; arguments?: Record<string, string> }>,
): Promise<McpResponse> => {
const authErr = checkAuth(req, secret);
if (authErr) return authErr;
diff --git a/src/state/kv.ts b/src/state/kv.ts
index 0c0e6ccc..a8a1707a 100644
--- a/src/state/kv.ts
+++ b/src/state/kv.ts
@@ -1,7 +1,7 @@
-import type { ISdk } from 'iii-sdk'
+import type { IIIClient } from 'iii-sdk'
export class StateKV {
- constructor(private sdk: ISdk) {}
+ constructor(private sdk: IIIClient) {}
async get<T = unknown>(scope: string, key: string): Promise<T | null> {
return this.sdk.trigger<{ scope: string; key: string }, T | null>({
diff --git a/src/triggers/api.ts b/src/triggers/api.ts
index 56fad4f0..9130381f 100644
--- a/src/triggers/api.ts
+++ b/src/triggers/api.ts
@@ -1,4 +1,5 @@
-import { TriggerAction, type ISdk, type ApiRequest } from "iii-sdk";
+import { TriggerAction, type IIIClient } from "iii-sdk";
+import type { HttpRequest } from "@iii-dev/helpers/http";
import type { Session, CompressedObservation, HookPayload, CommitLink, SessionSummary } from "../types.js";
import { withKeyedLock } from "../state/keyed-mutex.js";
import { KV } from "../state/schema.js";
@@ -39,7 +40,7 @@ function parseOptionalInt(raw: unknown): number | undefined {
}
function checkAuth(
- req: ApiRequest,
+ req: HttpRequest,
secret: string | undefined,
): Response | null {
if (!secret) return null;
@@ -138,7 +139,7 @@ function parseOptionalPositiveInt(value: unknown): number | undefined | null {
}
export function registerApiTriggers(
- sdk: ISdk,
+ sdk: IIIClient,
kv: StateKV,
secret?: string,
metricsStore?: MetricsStore,
@@ -191,7 +192,7 @@ export function registerApiTriggers(
});
sdk.registerFunction("api::config-flags",
- async (req: ApiRequest): Promise<Response> => {
+ async (req: HttpRequest): Promise<Response> => {
const authErr = checkAuth(req, secret);
if (authErr) return authErr;
const providerKind = detectLlmProviderKind();
@@ -264,7 +265,7 @@ export function registerApiTriggers(
});
sdk.registerFunction("api::health",
- async (req: ApiRequest): Promise<Response> => {
+ async (req: HttpRequest): Promise<Response> => {
const health = await getLatestHealth(kv);
const functionMetrics = metricsStore ? await metricsStore.getAll() : [];
const circuitBreaker =
@@ -298,7 +299,7 @@ export function registerApiTriggers(
});
sdk.registerFunction("api::observe",
- async (req: ApiRequest<HookPayload>): Promise<Response> => {
+ async (req: HttpRequest<HookPayload>): Promise<Response> => {
const body = (req.body ?? {}) as Record<string, unknown>;
const hookType = asNonEmptyString(body.hookType);
const sessionId = asNonEmptyString(body.sessionId);
@@ -338,7 +339,7 @@ export function registerApiTriggers(
sdk.registerFunction("api::context",
async (
- req: ApiRequest<{
+ req: HttpRequest<{
sessionId: string;
project: string;
budget?: number;
@@ -402,7 +403,7 @@ export function registerApiTriggers(
sdk.registerFunction("api::search",
async (
- req: ApiRequest<{
+ req: HttpRequest<{
query: string;
limit?: number;
project?: string;
@@ -488,7 +489,7 @@ export function registerApiTriggers(
});
sdk.registerFunction("api::compress-file",
- async (req: ApiRequest<{ filePath: string }>): Promise<Response> => {
+ async (req: HttpRequest<{ filePath: string }>): Promise<Response> => {
const authErr = checkAuth(req, secret);
if (authErr) return authErr;
const body = (req.body ?? {}) as Record<string, unknown>;
@@ -513,7 +514,7 @@ export function registerApiTriggers(
});
sdk.registerFunction("api::replay::load",
- async (req: ApiRequest): Promise<Response> => {
+ async (req: HttpRequest): Promise<Response> => {
const authErr = checkAuth(req, secret);
if (authErr) return authErr;
const sessionId = asNonEmptyString(req.query_params?.["sessionId"]);
@@ -534,7 +535,7 @@ export function registerApiTriggers(
});
sdk.registerFunction("api::replay::sessions",
- async (req: ApiRequest): Promise<Response> => {
+ async (req: HttpRequest): Promise<Response> => {
const authErr = checkAuth(req, secret);
if (authErr) return authErr;
const sessions = await kv.list<Session>(KV.sessions);
@@ -552,7 +553,7 @@ export function registerApiTriggers(
sdk.registerFunction("api::replay::import",
async (
- req: ApiRequest<{ path?: string; maxFiles?: number }>,
+ req: HttpRequest<{ path?: string; maxFiles?: number }>,
): Promise<Response> => {
const authErr = checkAuth(req, secret);
if (authErr) return authErr;
@@ -598,7 +599,7 @@ export function registerApiTriggers(
sdk.registerFunction("api::session::start",
async (
- req: ApiRequest<{ sessionId: string; project: string; cwd: string }>,
+ req: HttpRequest<{ sessionId: string; project: string; cwd: string }>,
): Promise<Response> => {
const body = (req.body ?? {}) as Record<string, unknown>;
const sessionId = asNonEmptyString(body.sessionId);
@@ -657,7 +658,7 @@ export function registerApiTriggers(
});
sdk.registerFunction("api::session::end",
- async (req: ApiRequest<{ sessionId: string }>): Promise<Response> => {
+ async (req: HttpRequest<{ sessionId: string }>): Promise<Response> => {
const sessionId = asNonEmptyString((req.body as Record<string, unknown>)?.sessionId);
if (!sessionId) {
return {
@@ -696,7 +697,7 @@ export function registerApiTriggers(
});
sdk.registerFunction("api::summarize",
- async (req: ApiRequest<{ sessionId: string }>): Promise<Response> => {
+ async (req: HttpRequest<{ sessionId: string }>): Promise<Response> => {
const sessionId = asNonEmptyString((req.body as Record<string, unknown>)?.sessionId);
if (!sessionId) {
return { status_code: 400, body: { error: "sessionId is required" } };
@@ -719,7 +720,7 @@ export function registerApiTriggers(
});
sdk.registerFunction("api::session::commit",
- async (req: ApiRequest): Promise<Response> => {
+ async (req: HttpRequest): Promise<Response> => {
const body = (req.body ?? {}) as Record<string, unknown>;
const sha = asNonEmptyString(body.sha);
if (!sha) {
@@ -785,7 +786,7 @@ export function registerApiTriggers(
});
sdk.registerFunction("api::session::by-commit",
- async (req: ApiRequest): Promise<Response> => {
+ async (req: HttpRequest): Promise<Response> => {
const authErr = checkAuth(req, secret);
if (authErr) return authErr;
const sha = asNonEmptyString(req.query_params?.["sha"]);
@@ -820,7 +821,7 @@ export function registerApiTriggers(
});
sdk.registerFunction("api::commits",
- async (req: ApiRequest): Promise<Response> => {
+ async (req: HttpRequest): Promise<Response> => {
const authErr = checkAuth(req, secret);
if (authErr) return authErr;
const branch = asNonEmptyString(req.query_params?.["branch"]);
@@ -847,7 +848,7 @@ export function registerApiTriggers(
});
sdk.registerFunction("api::sessions",
- async (req: ApiRequest): Promise<Response> => {
+ async (req: HttpRequest): Promise<Response> => {
const authErr = checkAuth(req, secret);
if (authErr) return authErr;
const sessions = await kv.list<Session>(KV.sessions);
@@ -893,7 +894,7 @@ export function registerApiTriggers(
});
sdk.registerFunction("api::observations",
- async (req: ApiRequest): Promise<Response> => {
+ async (req: HttpRequest): Promise<Response> => {
const authErr = checkAuth(req, secret);
if (authErr) return authErr;
const sessionId = asNonEmptyString(req.query_params?.["sessionId"]);
@@ -927,7 +928,7 @@ export function registerApiTriggers(
sdk.registerFunction("api::file-context",
async (
- req: ApiRequest<{ sessionId: string; files: string[] }>,
+ req: HttpRequest<{ sessionId: string; files: string[] }>,
): Promise<Response> => {
const authErr = checkAuth(req, secret);
if (authErr) return authErr;
@@ -943,7 +944,7 @@ export function registerApiTriggers(
sdk.registerFunction("api::enrich",
async (
- req: ApiRequest<{
+ req: HttpRequest<{
sessionId: string;
files: string[];
terms?: string[];
@@ -1007,7 +1008,7 @@ export function registerApiTriggers(
sdk.registerFunction("api::remember",
async (
- req: ApiRequest<{
+ req: HttpRequest<{
content: string;
type?: string;
concepts?: string[];
@@ -1059,7 +1060,7 @@ export function registerApiTriggers(
sdk.registerFunction("api::forget",
async (
- req: ApiRequest<{
+ req: HttpRequest<{
sessionId?: string;
observationIds?: string[];
memoryId?: string;
@@ -1085,7 +1086,7 @@ export function registerApiTriggers(
sdk.registerFunction("api::consolidate",
async (
- req: ApiRequest<{ project?: string; minObservations?: number }>,
+ req: HttpRequest<{ project?: string; minObservations?: number }>,
): Promise<Response> => {
const authErr = checkAuth(req, secret);
if (authErr) return authErr;
@@ -1100,7 +1101,7 @@ export function registerApiTriggers(
});
sdk.registerFunction("api::patterns",
- async (req: ApiRequest<{ project?: string }>): Promise<Response> => {
+ async (req: HttpRequest<{ project?: string }>): Promise<Response> => {
const authErr = checkAuth(req, secret);
if (authErr) return authErr;
const result = await sdk.trigger({ function_id: "mem::patterns", payload: req.body });
@@ -1114,7 +1115,7 @@ export function registerApiTriggers(
});
sdk.registerFunction("api::generate-rules",
- async (req: ApiRequest<{ project?: string }>): Promise<Response> => {
+ async (req: HttpRequest<{ project?: string }>): Promise<Response> => {
const authErr = checkAuth(req, secret);
if (authErr) return authErr;
const result = await sdk.trigger({ function_id: "mem::generate-rules", payload: req.body });
@@ -1129,7 +1130,7 @@ export function registerApiTriggers(
sdk.registerFunction("api::migrate",
async (
- req: ApiRequest<{ dbPath?: string; step?: string; dryRun?: boolean }>,
+ req: HttpRequest<{ dbPath?: string; step?: string; dryRun?: boolean }>,
): Promise<Response> => {
const authErr = checkAuth(req, secret);
if (authErr) return authErr;
@@ -1161,7 +1162,7 @@ export function registerApiTriggers(
});
sdk.registerFunction("api::evict",
- async (req: ApiRequest<{ dryRun?: boolean }>): Promise<Response> => {
+ async (req: HttpRequest<{ dryRun?: boolean }>): Promise<Response> => {
const authErr = checkAuth(req, secret);
if (authErr) return authErr;
const dryRun =
@@ -1178,7 +1179,7 @@ export function registerApiTriggers(
sdk.registerFunction("api::smart-search",
async (
- req: ApiRequest<{
+ req: HttpRequest<{
query?: string;
expandIds?: Array<string | { obsId: string; sessionId: string }>;
limit?: number;
@@ -1234,7 +1235,7 @@ export function registerApiTriggers(
// a directional signal — overcounts on legitimate query refinement —
// so help text + the CLI status line carry the same caveat.
sdk.registerFunction("api::diagnostic-followup",
- async (req: ApiRequest): Promise<Response> => {
+ async (req: HttpRequest): Promise<Response> => {
const authErr = checkAuth(req, secret);
if (authErr) return authErr;
const result = await sdk.trigger({
@@ -1264,7 +1265,7 @@ export function registerApiTriggers(
sdk.registerFunction("api::timeline",
async (
- req: ApiRequest<{
+ req: HttpRequest<{
anchor: string;
project?: string;
before?: number;
@@ -1287,7 +1288,7 @@ export function registerApiTriggers(
});
sdk.registerFunction("api::profile",
- async (req: ApiRequest): Promise<Response> => {
+ async (req: HttpRequest): Promise<Response> => {
const authErr = checkAuth(req, secret);
if (authErr) return authErr;
const project = req.query_params["project"] as string;
@@ -1308,7 +1309,7 @@ export function registerApiTriggers(
});
sdk.registerFunction("api::export",
- async (req: ApiRequest): Promise<Response> => {
+ async (req: HttpRequest): Promise<Response> => {
const authErr = checkAuth(req, secret);
if (authErr) return authErr;
// mem::export already supports maxSessions/offset internally,
@@ -1342,7 +1343,7 @@ export function registerApiTriggers(
sdk.registerFunction("api::import",
async (
- req: ApiRequest<{
+ req: HttpRequest<{
exportData: unknown;
strategy?: "merge" | "replace" | "skip";
}>,
@@ -1364,7 +1365,7 @@ export function registerApiTriggers(
sdk.registerFunction("api::relations",
async (
- req: ApiRequest<{ sourceId: string; targetId: string; type: string }>,
+ req: HttpRequest<{ sourceId: string; targetId: string; type: string }>,
): Promise<Response> => {
const authErr = checkAuth(req, secret);
if (authErr) return authErr;
@@ -1386,7 +1387,7 @@ export function registerApiTriggers(
sdk.registerFunction("api::evolve",
async (
- req: ApiRequest<{
+ req: HttpRequest<{
memoryId: string;
newContent: string;
newTitle?: string;
@@ -1411,7 +1412,7 @@ export function registerApiTriggers(
});
sdk.registerFunction("api::auto-forget",
- async (req: ApiRequest<{ dryRun?: boolean }>): Promise<Response> => {
+ async (req: HttpRequest<{ dryRun?: boolean }>): Promise<Response> => {
const authErr = checkAuth(req, secret);
if (authErr) return authErr;
const dryRun =
@@ -1427,7 +1428,7 @@ export function registerApiTriggers(
});
sdk.registerFunction("api::claude-bridge-read",
- async (req: ApiRequest): Promise<Response> => {
+ async (req: HttpRequest): Promise<Response> => {
const authErr = checkAuth(req, secret);
if (authErr) return authErr;
try {
@@ -1448,7 +1449,7 @@ export function registerApiTriggers(
});
sdk.registerFunction("api::claude-bridge-sync",
- async (req: ApiRequest): Promise<Response> => {
+ async (req: HttpRequest): Promise<Response> => {
const authErr = checkAuth(req, secret);
if (authErr) return authErr;
try {
@@ -1473,7 +1474,7 @@ export function registerApiTriggers(
sdk.registerFunction("api::graph-query",
async (
- req: ApiRequest<{
+ req: HttpRequest<{
startNodeId?: string;
nodeType?: string;
maxDepth?: number;
@@ -1509,7 +1510,7 @@ export function registerApiTriggers(
});
sdk.registerFunction("api::graph-stats",
- async (req: ApiRequest): Promise<Response> => {
+ async (req: HttpRequest): Promise<Response> => {
const authErr = checkAuth(req, secret);
if (authErr) return authErr;
try {
@@ -1532,7 +1533,7 @@ export function registerApiTriggers(
// unbounded kv.list. Operator-grade endpoint exposed for the viewer
// banner action and CLI repair.
sdk.registerFunction("api::graph-snapshot-rebuild",
- async (req: ApiRequest): Promise<Response> => {
+ async (req: HttpRequest): Promise<Response> => {
const authErr = checkAuth(req, secret);
if (authErr) return authErr;
try {
@@ -1557,7 +1558,7 @@ export function registerApiTriggers(
// recall + history stay intact while the graph rebuilds incrementally
// from new extracts (or a one-shot /graph/build replay).
sdk.registerFunction("api::graph-reset",
- async (req: ApiRequest): Promise<Response> => {
+ async (req: HttpRequest): Promise<Response> => {
const authErr = checkAuth(req, secret);
if (authErr) return authErr;
try {
@@ -1578,7 +1579,7 @@ export function registerApiTriggers(
});
sdk.registerFunction("api::graph-extract",
- async (req: ApiRequest<{ observations: unknown[] }>): Promise<Response> => {
+ async (req: HttpRequest<{ observations: unknown[] }>): Promise<Response> => {
const authErr = checkAuth(req, secret);
if (authErr) return authErr;
if (
@@ -1609,7 +1610,7 @@ export function registerApiTriggers(
// session, collects observations that have a `title` (compressed only),
// and feeds them through `mem::graph-extract` in batches.
sdk.registerFunction("api::graph-build",
- async (req: ApiRequest<{ batchSize?: number }>): Promise<Response> => {
+ async (req: HttpRequest<{ batchSize?: number }>): Promise<Response> => {
const authErr = checkAuth(req, secret);
if (authErr) return authErr;
const batchSize = Math.max(
@@ -1673,7 +1674,7 @@ export function registerApiTriggers(
// memory graph. Deterministic, no LLM call; idempotent via the graph
// name-index upsert.
sdk.registerFunction("api::graph-import-graphify",
- async (req: ApiRequest<{ path?: string; cwd?: string }>): Promise<Response> => {
+ async (req: HttpRequest<{ path?: string; cwd?: string }>): Promise<Response> => {
const authErr = checkAuth(req, secret);
if (authErr) return authErr;
const { path, cwd } = req.body ?? {};
@@ -1707,7 +1708,7 @@ export function registerApiTriggers(
});
sdk.registerFunction("api::consolidate-pipeline",
- async (req: ApiRequest<{ tier?: string }>): Promise<Response> => {
+ async (req: HttpRequest<{ tier?: string }>): Promise<Response> => {
const authErr = checkAuth(req, secret);
if (authErr) return authErr;
try {
@@ -1730,7 +1731,7 @@ export function registerApiTriggers(
sdk.registerFunction("api::team-share",
async (
- req: ApiRequest<{ itemId: string; itemType: string; project?: string }>,
+ req: HttpRequest<{ itemId: string; itemType: string; project?: string }>,
): Promise<Response> => {
const authErr = checkAuth(req, secret);
if (authErr) return authErr;
@@ -1755,7 +1756,7 @@ export function registerApiTriggers(
});
sdk.registerFunction("api::team-feed",
- async (req: ApiRequest): Promise<Response> => {
+ async (req: HttpRequest): Promise<Response> => {
const authErr = checkAuth(req, secret);
if (authErr) return authErr;
try {
@@ -1775,7 +1776,7 @@ export function registerApiTriggers(
});
sdk.registerFunction("api::team-profile",
- async (req: ApiRequest): Promise<Response> => {
+ async (req: HttpRequest): Promise<Response> => {
const authErr = checkAuth(req, secret);
if (authErr) return authErr;
try {
@@ -1793,7 +1794,7 @@ export function registerApiTriggers(
});
sdk.registerFunction("api::audit",
- async (req: ApiRequest): Promise<Response> => {
+ async (req: HttpRequest): Promise<Response> => {
const authErr = checkAuth(req, secret);
if (authErr) return authErr;
const parsedLimit = parseOptionalInt(req.query_params?.["limit"]);
@@ -1812,7 +1813,7 @@ export function registerApiTriggers(
sdk.registerFunction("api::governance-delete",
async (
- req: ApiRequest<{ memoryIds: string[]; reason?: string }>,
+ req: HttpRequest<{ memoryIds: string[]; reason?: string }>,
): Promise<Response> => {
const authErr = checkAuth(req, secret);
if (authErr) return authErr;
@@ -1837,7 +1838,7 @@ export function registerApiTriggers(
sdk.registerFunction("api::governance-bulk",
async (
- req: ApiRequest<{
+ req: HttpRequest<{
type?: string[];
dateFrom?: string;
dateTo?: string;
@@ -1861,7 +1862,7 @@ export function registerApiTriggers(
});
sdk.registerFunction("api::snapshots",
- async (req: ApiRequest): Promise<Response> => {
+ async (req: HttpRequest): Promise<Response> => {
const authErr = checkAuth(req, secret);
if (authErr) return authErr;
try {
@@ -1879,7 +1880,7 @@ export function registerApiTriggers(
});
sdk.registerFunction("api::snapshot-create",
- async (req: ApiRequest<{ message?: string }>): Promise<Response> => {
+ async (req: HttpRequest<{ message?: string }>): Promise<Response> => {
const authErr = checkAuth(req, secret);
if (authErr) return authErr;
try {
@@ -1898,7 +1899,7 @@ export function registerApiTriggers(
});
sdk.registerFunction("api::snapshot-restore",
- async (req: ApiRequest<{ commitHash: string }>): Promise<Response> => {
+ async (req: HttpRequest<{ commitHash: string }>): Promise<Response> => {
const authErr = checkAuth(req, secret);
if (authErr) return authErr;
if (!req.body?.commitHash) {
@@ -1919,7 +1920,7 @@ export function registerApiTriggers(
});
sdk.registerFunction("api::memories",
- async (req: ApiRequest): Promise<Response> => {
+ async (req: HttpRequest): Promise<Response> => {
const authErr = checkAuth(req, secret);
if (authErr) return authErr;
const memories = await kv.list<import("../types.js").Memory>(KV.memories);
@@ -2003,7 +2004,7 @@ export function registerApiTriggers(
});
sdk.registerFunction("api::memory-by-id",
- async (req: ApiRequest): Promise<Response> => {
+ async (req: HttpRequest): Promise<Response> => {
const authErr = checkAuth(req, secret);
if (authErr) return authErr;
const id = req.path_params?.["id"];
@@ -2024,7 +2025,7 @@ export function registerApiTriggers(
});
sdk.registerFunction("api::semantic-list",
- async (req: ApiRequest): Promise<Response> => {
+ async (req: HttpRequest): Promise<Response> => {
const authErr = checkAuth(req, secret);
if (authErr) return authErr;
const semantic = await kv.list<import("../types.js").SemanticMemory>(KV.semantic);
@@ -2038,7 +2039,7 @@ export function registerApiTriggers(
});
sdk.registerFunction("api::procedural-list",
- async (req: ApiRequest): Promise<Response> => {
+ async (req: HttpRequest): Promise<Response> => {
const authErr = checkAuth(req, secret);
if (authErr) return authErr;
const procedural = await kv.list<import("../types.js").ProceduralMemory>(KV.procedural);
@@ -2052,7 +2053,7 @@ export function registerApiTriggers(
});
sdk.registerFunction("api::relations-list",
- async (req: ApiRequest): Promise<Response> => {
+ async (req: HttpRequest): Promise<Response> => {
const authErr = checkAuth(req, secret);
if (authErr) return authErr;
const relations = await kv.list<import("../types.js").MemoryRelation>(KV.relations);
@@ -2066,7 +2067,7 @@ export function registerApiTriggers(
});
sdk.registerFunction("api::vision-search",
- async (req: ApiRequest): Promise<Response> => {
+ async (req: HttpRequest): Promise<Response> => {
const authErr = checkAuth(req, secret);
if (authErr) return authErr;
const body = (req.body ?? {}) as Record<string, unknown>;
@@ -2105,7 +2106,7 @@ export function registerApiTriggers(
});
sdk.registerFunction("api::vision-embed",
- async (req: ApiRequest): Promise<Response> => {
+ async (req: HttpRequest): Promise<Response> => {
const authErr = checkAuth(req, secret);
if (authErr) return authErr;
const body = (req.body ?? {}) as Record<string, unknown>;
@@ -2132,7 +2133,7 @@ export function registerApiTriggers(
config: { api_path: "/agentmemory/vision-embed", http_method: "POST" },
});
- sdk.registerFunction("api::slot-list", async (req: ApiRequest): Promise<Response> => {
+ sdk.registerFunction("api::slot-list", async (req: HttpRequest): Promise<Response> => {
const authErr = checkAuth(req, secret);
if (authErr) return authErr;
if (!isSlotsEnabled()) return slotsDisabledResponse();
@@ -2145,7 +2146,7 @@ export function registerApiTriggers(
config: { api_path: "/agentmemory/slots", http_method: "GET" },
});
- sdk.registerFunction("api::slot-get", async (req: ApiRequest): Promise<Response> => {
+ sdk.registerFunction("api::slot-get", async (req: HttpRequest): Promise<Response> => {
const authErr = checkAuth(req, secret);
if (authErr) return authErr;
if (!isSlotsEnabled()) return slotsDisabledResponse();
@@ -2164,7 +2165,7 @@ export function registerApiTriggers(
config: { api_path: "/agentmemory/slot", http_method: "GET" },
});
- sdk.registerFunction("api::slot-create", async (req: ApiRequest): Promise<Response> => {
+ sdk.registerFunction("api::slot-create", async (req: HttpRequest): Promise<Response> => {
const authErr = checkAuth(req, secret);
if (authErr) return authErr;
if (!isSlotsEnabled()) return slotsDisabledResponse();
@@ -2214,7 +2215,7 @@ export function registerApiTriggers(
config: { api_path: "/agentmemory/slot", http_method: "POST" },
});
- sdk.registerFunction("api::slot-append", async (req: ApiRequest): Promise<Response> => {
+ sdk.registerFunction("api::slot-append", async (req: HttpRequest): Promise<Response> => {
const authErr = checkAuth(req, secret);
if (authErr) return authErr;
if (!isSlotsEnabled()) return slotsDisabledResponse();
@@ -2237,7 +2238,7 @@ export function registerApiTriggers(
config: { api_path: "/agentmemory/slot/append", http_method: "POST" },
});
- sdk.registerFunction("api::slot-replace", async (req: ApiRequest): Promise<Response> => {
+ sdk.registerFunction("api::slot-replace", async (req: HttpRequest): Promise<Response> => {
const authErr = checkAuth(req, secret);
if (authErr) return authErr;
if (!isSlotsEnabled()) return slotsDisabledResponse();
@@ -2262,7 +2263,7 @@ export function registerApiTriggers(
config: { api_path: "/agentmemory/slot/replace", http_method: "POST" },
});
- sdk.registerFunction("api::slot-delete", async (req: ApiRequest): Promise<Response> => {
+ sdk.registerFunction("api::slot-delete", async (req: HttpRequest): Promise<Response> => {
const authErr = checkAuth(req, secret);
if (authErr) return authErr;
if (!isSlotsEnabled()) return slotsDisabledResponse();
@@ -2281,7 +2282,7 @@ export function registerApiTriggers(
config: { api_path: "/agentmemory/slot", http_method: "DELETE" },
});
- sdk.registerFunction("api::slot-reflect", async (req: ApiRequest): Promise<Response> => {
+ sdk.registerFunction("api::slot-reflect", async (req: HttpRequest): Promise<Response> => {
const authErr = checkAuth(req, secret);
if (authErr) return authErr;
if (!isSlotsEnabled()) return slotsDisabledResponse();
@@ -2304,7 +2305,7 @@ export function registerApiTriggers(
sdk.registerFunction("api::action-create",
async (
- req: ApiRequest<{
+ req: HttpRequest<{
title: string;
description?: string;
priority?: number;
@@ -2332,7 +2333,7 @@ export function registerApiTriggers(
sdk.registerFunction("api::action-update",
async (
- req: ApiRequest<{
+ req: HttpRequest<{
actionId: string;
status?: string;
title?: string;
@@ -2357,7 +2358,7 @@ export function registerApiTriggers(
});
sdk.registerFunction("api::action-list",
- async (req: ApiRequest): Promise<Response> => {
+ async (req: HttpRequest): Promise<Response> => {
const authErr = checkAuth(req, secret);
if (authErr) return authErr;
const result = await sdk.trigger({ function_id: "mem::action-list", payload: {
@@ -2375,7 +2376,7 @@ export function registerApiTriggers(
});
sdk.registerFunction("api::action-get",
- async (req: ApiRequest<{ actionId: string }>): Promise<Response> => {
+ async (req: HttpRequest<{ actionId: string }>): Promise<Response> => {
const authErr = checkAuth(req, secret);
if (authErr) return authErr;
const actionId = req.query_params?.["actionId"] as string;
@@ -2394,7 +2395,7 @@ export function registerApiTriggers(
sdk.registerFunction("api::action-edge",
async (
- req: ApiRequest<{
+ req: HttpRequest<{
sourceActionId: string;
targetActionId: string;
type: string;
@@ -2416,7 +2417,7 @@ export function registerApiTriggers(
});
sdk.registerFunction("api::frontier",
- async (req: ApiRequest): Promise<Response> => {
+ async (req: HttpRequest): Promise<Response> => {
const authErr = checkAuth(req, secret);
if (authErr) return authErr;
const parsedLimit = parseOptionalInt(req.query_params?.["limit"]);
@@ -2435,7 +2436,7 @@ export function registerApiTriggers(
});
sdk.registerFunction("api::next",
- async (req: ApiRequest): Promise<Response> => {
+ async (req: HttpRequest): Promise<Response> => {
const authErr = checkAuth(req, secret);
if (authErr) return authErr;
const result = await sdk.trigger({ function_id: "mem::next", payload: {
@@ -2453,7 +2454,7 @@ export function registerApiTriggers(
sdk.registerFunction("api::lease-acquire",
async (
- req: ApiRequest<{ actionId: string; agentId: string; ttlMs?: number }>,
+ req: HttpRequest<{ actionId: string; agentId: string; ttlMs?: number }>,
): Promise<Response> => {
const authErr = checkAuth(req, secret);
if (authErr) return authErr;
@@ -2472,7 +2473,7 @@ export function registerApiTriggers(
sdk.registerFunction("api::lease-release",
async (
- req: ApiRequest<{ actionId: string; agentId: string; result?: string }>,
+ req: HttpRequest<{ actionId: string; agentId: string; result?: string }>,
): Promise<Response> => {
const authErr = checkAuth(req, secret);
if (authErr) return authErr;
@@ -2491,7 +2492,7 @@ export function registerApiTriggers(
sdk.registerFunction("api::lease-renew",
async (
- req: ApiRequest<{ actionId: string; agentId: string; ttlMs?: number }>,
+ req: HttpRequest<{ actionId: string; agentId: string; ttlMs?: number }>,
): Promise<Response> => {
const authErr = checkAuth(req, secret);
if (authErr) return authErr;
@@ -2509,7 +2510,7 @@ export function registerApiTriggers(
});
sdk.registerFunction("api::routine-create",
- async (req: ApiRequest): Promise<Response> => {
+ async (req: HttpRequest): Promise<Response> => {
const authErr = checkAuth(req, secret);
if (authErr) return authErr;
if (!req.body?.name || !req.body?.steps) {
@@ -2529,7 +2530,7 @@ export function registerApiTriggers(
});
sdk.registerFunction("api::routine-list",
- async (req: ApiRequest): Promise<Response> => {
+ async (req: HttpRequest): Promise<Response> => {
const authErr = checkAuth(req, secret);
if (authErr) return authErr;
const result = await sdk.trigger({ function_id: "mem::routine-list", payload: {
@@ -2546,7 +2547,7 @@ export function registerApiTriggers(
sdk.registerFunction("api::routine-run",
async (
- req: ApiRequest<{ routineId: string; project?: string; initiatedBy?: string }>,
+ req: HttpRequest<{ routineId: string; project?: string; initiatedBy?: string }>,
): Promise<Response> => {
const authErr = checkAuth(req, secret);
if (authErr) return authErr;
@@ -2564,7 +2565,7 @@ export function registerApiTriggers(
});
sdk.registerFunction("api::routine-status",
- async (req: ApiRequest): Promise<Response> => {
+ async (req: HttpRequest): Promise<Response> => {
const authErr = checkAuth(req, secret);
if (authErr) return authErr;
const runId = req.query_params?.["runId"] as string;
@@ -2583,7 +2584,7 @@ export function registerApiTriggers(
sdk.registerFunction("api::signal-send",
async (
- req: ApiRequest<{
+ req: HttpRequest<{
from: string;
to?: string;
content: string;
@@ -2607,7 +2608,7 @@ export function registerApiTriggers(
});
sdk.registerFunction("api::signal-read",
- async (req: ApiRequest): Promise<Response> => {
+ async (req: HttpRequest): Promise<Response> => {
const authErr = checkAuth(req, secret);
if (authErr) return authErr;
const agentId = req.query_params?.["agentId"] as string;
@@ -2632,7 +2633,7 @@ export function registerApiTriggers(
sdk.registerFunction("api::checkpoint-create",
async (
- req: ApiRequest<{
+ req: HttpRequest<{
name: string;
description?: string;
type?: string;
@@ -2657,7 +2658,7 @@ export function registerApiTriggers(
sdk.registerFunction("api::checkpoint-resolve",
async (
- req: ApiRequest<{
+ req: HttpRequest<{
checkpointId: string;
status: string;
resolvedBy?: string;
@@ -2680,7 +2681,7 @@ export function registerApiTriggers(
});
sdk.registerFunction("api::checkpoint-list",
- async (req: ApiRequest): Promise<Response> => {
+ async (req: HttpRequest): Promise<Response> => {
const authErr = checkAuth(req, secret);
if (authErr) return authErr;
const result = await sdk.trigger({ function_id: "mem::checkpoint-list", payload: {
@@ -2698,7 +2699,7 @@ export function registerApiTriggers(
sdk.registerFunction("api::mesh-register",
async (
- req: ApiRequest<{ url: string; name: string; sharedScopes?: string[] }>,
+ req: HttpRequest<{ url: string; name: string; sharedScopes?: string[] }>,
): Promise<Response> => {
const secretErr = requireConfiguredSecret(secret, "mesh");
if (secretErr) return secretErr;
@@ -2718,7 +2719,7 @@ export function registerApiTriggers(
});
sdk.registerFunction("api::mesh-list",
- async (req: ApiRequest): Promise<Response> => {
+ async (req: HttpRequest): Promise<Response> => {
const secretErr = requireConfiguredSecret(secret, "mesh");
if (secretErr) return secretErr;
const authErr = checkAuth(req, secret);
@@ -2735,7 +2736,7 @@ export function registerApiTriggers(
sdk.registerFunction("api::mesh-sync",
async (
- req: ApiRequest<{ peerId?: string; direction?: string }>,
+ req: HttpRequest<{ peerId?: string; direction?: string }>,
): Promise<Response> => {
const secretErr = requireConfiguredSecret(secret, "mesh");
if (secretErr) return secretErr;
@@ -2752,7 +2753,7 @@ export function registerApiTriggers(
});
sdk.registerFunction("api::mesh-receive",
- async (req: ApiRequest): Promise<Response> => {
+ async (req: HttpRequest): Promise<Response> => {
const secretErr = requireConfiguredSecret(secret, "mesh");
if (secretErr) return secretErr;
const authErr = checkAuth(req, secret);
@@ -2768,7 +2769,7 @@ export function registerApiTriggers(
});
sdk.registerFunction("api::mesh-export",
- async (req: ApiRequest): Promise<Response> => {
+ async (req: HttpRequest): Promise<Response> => {
const secretErr = requireConfiguredSecret(secret, "mesh");
if (secretErr) return secretErr;
const authErr = checkAuth(req, secret);
@@ -2827,7 +2828,7 @@ export function registerApiTriggers(
sdk.registerFunction("api::flow-compress",
async (
- req: ApiRequest<{
+ req: HttpRequest<{
runId?: string;
actionIds?: string[];
project?: string;
@@ -2853,7 +2854,7 @@ export function registerApiTriggers(
});
sdk.registerFunction("api::branch-detect",
- async (req: ApiRequest): Promise<Response> => {
+ async (req: HttpRequest): Promise<Response> => {
const authErr = checkAuth(req, secret);
if (authErr) return authErr;
const cwd = (req.query_params?.["cwd"] as string) || process.cwd();
@@ -2868,7 +2869,7 @@ export function registerApiTriggers(
});
sdk.registerFunction("api::branch-worktrees",
- async (req: ApiRequest): Promise<Response> => {
+ async (req: HttpRequest): Promise<Response> => {
const authErr = checkAuth(req, secret);
if (authErr) return authErr;
const cwd = (req.query_params?.["cwd"] as string) || process.cwd();
@@ -2883,7 +2884,7 @@ export function registerApiTriggers(
});
sdk.registerFunction("api::branch-sessions",
- async (req: ApiRequest): Promise<Response> => {
+ async (req: HttpRequest): Promise<Response> => {
const authErr = checkAuth(req, secret);
if (authErr) return authErr;
const cwd = (req.query_params?.["cwd"] as string) || process.cwd();
@@ -2898,7 +2899,7 @@ export function registerApiTriggers(
});
sdk.registerFunction("api::viewer",
- async (req: ApiRequest): Promise<Response> => {
+ async (req: HttpRequest): Promise<Response> => {
const denied = checkAuth(req, secret);
if (denied) return denied;
const rendered = renderViewerDocument();
@@ -2927,7 +2928,7 @@ export function registerApiTriggers(
config: { api_path: "/agentmemory/viewer", http_method: "GET" },
});
- sdk.registerFunction("api::sentinel-create", async (req: ApiRequest) => {
+ sdk.registerFunction("api::sentinel-create", async (req: HttpRequest) => {
const denied = checkAuth(req, secret);
if (denied) return denied;
const body = req.body as Record<string, unknown>;
@@ -2937,7 +2938,7 @@ export function registerApiTriggers(
});
sdk.registerTrigger({ type: "http", function_id: "api::sentinel-create", config: { api_path: "/agentmemory/sentinels", http_method: "POST" } });
- sdk.registerFunction("api::sentinel-trigger", async (req: ApiRequest) => {
+ sdk.registerFunction("api::sentinel-trigger", async (req: HttpRequest) => {
const denied = checkAuth(req, secret);
if (denied) return denied;
const body = req.body as Record<string, unknown>;
@@ -2947,7 +2948,7 @@ export function registerApiTriggers(
});
sdk.registerTrigger({ type: "http", function_id: "api::sentinel-trigger", config: { api_path: "/agentmemory/sentinels/trigger", http_method: "POST" } });
- sdk.registerFunction("api::sentinel-check", async (req: ApiRequest) => {
+ sdk.registerFunction("api::sentinel-check", async (req: HttpRequest) => {
const denied = checkAuth(req, secret);
if (denied) return denied;
const result = await sdk.trigger({ function_id: "mem::sentinel-check", payload: {} });
@@ -2955,7 +2956,7 @@ export function registerApiTriggers(
});
sdk.registerTrigger({ type: "http", function_id: "api::sentinel-check", config: { api_path: "/agentmemory/sentinels/check", http_method: "POST" } });
- sdk.registerFunction("api::sentinel-cancel", async (req: ApiRequest) => {
+ sdk.registerFunction("api::sentinel-cancel", async (req: HttpRequest) => {
const denied = checkAuth(req, secret);
if (denied) return denied;
const body = req.body as Record<string, unknown>;
@@ -2965,7 +2966,7 @@ export function registerApiTriggers(
});
sdk.registerTrigger({ type: "http", function_id: "api::sentinel-cancel", config: { api_path: "/agentmemory/sentinels/cancel", http_method: "POST" } });
- sdk.registerFunction("api::sentinel-list", async (req: ApiRequest) => {
+ sdk.registerFunction("api::sentinel-list", async (req: HttpRequest) => {
const denied = checkAuth(req, secret);
if (denied) return denied;
const params = req.query_params || {};
@@ -2974,7 +2975,7 @@ export function registerApiTriggers(
});
sdk.registerTrigger({ type: "http", function_id: "api::sentinel-list", config: { api_path: "/agentmemory/sentinels", http_method: "GET" } });
- sdk.registerFunction("api::sketch-create", async (req: ApiRequest) => {
+ sdk.registerFunction("api::sketch-create", async (req: HttpRequest) => {
const denied = checkAuth(req, secret);
if (denied) return denied;
const body = req.body as Record<string, unknown>;
@@ -2984,7 +2985,7 @@ export function registerApiTriggers(
});
sdk.registerTrigger({ type: "http", function_id: "api::sketch-create", config: { api_path: "/agentmemory/sketches", http_method: "POST" } });
- sdk.registerFunction("api::sketch-add", async (req: ApiRequest) => {
+ sdk.registerFunction("api::sketch-add", async (req: HttpRequest) => {
const denied = checkAuth(req, secret);
if (denied) return denied;
const body = req.body as Record<string, unknown>;
@@ -2994,7 +2995,7 @@ export function registerApiTriggers(
});
sdk.registerTrigger({ type: "http", function_id: "api::sketch-add", config: { api_path: "/agentmemory/sketches/add", http_method: "POST" } });
- sdk.registerFunction("api::sketch-promote", async (req: ApiRequest) => {
+ sdk.registerFunction("api::sketch-promote", async (req: HttpRequest) => {
const denied = checkAuth(req, secret);
if (denied) return denied;
const body = req.body as Record<string, unknown>;
@@ -3004,7 +3005,7 @@ export function registerApiTriggers(
});
sdk.registerTrigger({ type: "http", function_id: "api::sketch-promote", config: { api_path: "/agentmemory/sketches/promote", http_method: "POST" } });
- sdk.registerFunction("api::sketch-discard", async (req: ApiRequest) => {
+ sdk.registerFunction("api::sketch-discard", async (req: HttpRequest) => {
const denied = checkAuth(req, secret);
if (denied) return denied;
const body = req.body as Record<string, unknown>;
@@ -3014,7 +3015,7 @@ export function registerApiTriggers(
});
sdk.registerTrigger({ type: "http", function_id: "api::sketch-discard", config: { api_path: "/agentmemory/sketches/discard", http_method: "POST" } });
- sdk.registerFunction("api::sketch-list", async (req: ApiRequest) => {
+ sdk.registerFunction("api::sketch-list", async (req: HttpRequest) => {
const denied = checkAuth(req, secret);
if (denied) return denied;
const params = req.query_params || {};
@@ -3023,7 +3024,7 @@ export function registerApiTriggers(
});
sdk.registerTrigger({ type: "http", function_id: "api::sketch-list", config: { api_path: "/agentmemory/sketches", http_method: "GET" } });
- sdk.registerFunction("api::sketch-gc", async (req: ApiRequest) => {
+ sdk.registerFunction("api::sketch-gc", async (req: HttpRequest) => {
const denied = checkAuth(req, secret);
if (denied) return denied;
const result = await sdk.trigger({ function_id: "mem::sketch-gc", payload: {} });
@@ -3031,7 +3032,7 @@ export function registerApiTriggers(
});
sdk.registerTrigger({ type: "http", function_id: "api::sketch-gc", config: { api_path: "/agentmemory/sketches/gc", http_method: "POST" } });
- sdk.registerFunction("api::crystallize", async (req: ApiRequest) => {
+ sdk.registerFunction("api::crystallize", async (req: HttpRequest) => {
const denied = checkAuth(req, secret);
if (denied) return denied;
const body = req.body as Record<string, unknown>;
@@ -3041,7 +3042,7 @@ export function registerApiTriggers(
});
sdk.registerTrigger({ type: "http", function_id: "api::crystallize", config: { api_path: "/agentmemory/crystals/create", http_method: "POST" } });
- sdk.registerFunction("api::crystal-list", async (req: ApiRequest) => {
+ sdk.registerFunction("api::crystal-list", async (req: HttpRequest) => {
const denied = checkAuth(req, secret);
if (denied) return denied;
const params = req.query_params || {};
@@ -3057,7 +3058,7 @@ export function registerApiTriggers(
});
sdk.registerTrigger({ type: "http", function_id: "api::crystal-list", config: { api_path: "/agentmemory/crystals", http_method: "GET" } });
- sdk.registerFunction("api::auto-crystallize", async (req: ApiRequest) => {
+ sdk.registerFunction("api::auto-crystallize", async (req: HttpRequest) => {
const denied = checkAuth(req, secret);
if (denied) return denied;
const body = req.body as Record<string, unknown>;
@@ -3066,7 +3067,7 @@ export function registerApiTriggers(
});
sdk.registerTrigger({ type: "http", function_id: "api::auto-crystallize", config: { api_path: "/agentmemory/crystals/auto", http_method: "POST" } });
- sdk.registerFunction("api::diagnose", async (req: ApiRequest) => {
+ sdk.registerFunction("api::diagnose", async (req: HttpRequest) => {
const denied = checkAuth(req, secret);
if (denied) return denied;
const body = req.body as Record<string, unknown>;
@@ -3075,7 +3076,7 @@ export function registerApiTriggers(
});
sdk.registerTrigger({ type: "http", function_id: "api::diagnose", config: { api_path: "/agentmemory/diagnostics", http_method: "POST" } });
- sdk.registerFunction("api::heal", async (req: ApiRequest) => {
+ sdk.registerFunction("api::heal", async (req: HttpRequest) => {
const denied = checkAuth(req, secret);
if (denied) return denied;
const body = req.body as Record<string, unknown>;
@@ -3084,7 +3085,7 @@ export function registerApiTriggers(
});
sdk.registerTrigger({ type: "http", function_id: "api::heal", config: { api_path: "/agentmemory/diagnostics/heal", http_method: "POST" } });
- sdk.registerFunction("api::facet-tag", async (req: ApiRequest) => {
+ sdk.registerFunction("api::facet-tag", async (req: HttpRequest) => {
const denied = checkAuth(req, secret);
if (denied) return denied;
const body = req.body as Record<string, unknown>;
@@ -3094,7 +3095,7 @@ export function registerApiTriggers(
});
sdk.registerTrigger({ type: "http", function_id: "api::facet-tag", config: { api_path: "/agentmemory/facets", http_method: "POST" } });
- sdk.registerFunction("api::facet-untag", async (req: ApiRequest) => {
+ sdk.registerFunction("api::facet-untag", async (req: HttpRequest) => {
const denied = checkAuth(req, secret);
if (denied) return denied;
const body = req.body as Record<string, unknown>;
@@ -3104,7 +3105,7 @@ export function registerApiTriggers(
});
sdk.registerTrigger({ type: "http", function_id: "api::facet-untag", config: { api_path: "/agentmemory/facets/remove", http_method: "POST" } });
- sdk.registerFunction("api::facet-query", async (req: ApiRequest) => {
+ sdk.registerFunction("api::facet-query", async (req: HttpRequest) => {
const denied = checkAuth(req, secret);
if (denied) return denied;
const body = req.body as Record<string, unknown>;
@@ -3113,7 +3114,7 @@ export function registerApiTriggers(
});
sdk.registerTrigger({ type: "http", function_id: "api::facet-query", config: { api_path: "/agentmemory/facets/query", http_method: "POST" } });
- sdk.registerFunction("api::facet-get", async (req: ApiRequest) => {
+ sdk.registerFunction("api::facet-get", async (req: HttpRequest) => {
const denied = checkAuth(req, secret);
if (denied) return denied;
const params = req.query_params || {};
@@ -3123,7 +3124,7 @@ export function registerApiTriggers(
});
sdk.registerTrigger({ type: "http", function_id: "api::facet-get", config: { api_path: "/agentmemory/facets", http_method: "GET" } });
- sdk.registerFunction("api::facet-stats", async (req: ApiRequest) => {
+ sdk.registerFunction("api::facet-stats", async (req: HttpRequest) => {
const denied = checkAuth(req, secret);
if (denied) return denied;
const params = req.query_params || {};
@@ -3132,7 +3133,7 @@ export function registerApiTriggers(
});
sdk.registerTrigger({ type: "http", function_id: "api::facet-stats", config: { api_path: "/agentmemory/facets/stats", http_method: "GET" } });
- sdk.registerFunction("api::verify", async (req: ApiRequest) => {
+ sdk.registerFunction("api::verify", async (req: HttpRequest) => {
const denied = checkAuth(req, secret);
if (denied) return denied;
const body = req.body as Record<string, unknown>;
@@ -3142,7 +3143,7 @@ export function registerApiTriggers(
});
sdk.registerTrigger({ type: "http", function_id: "api::verify", config: { api_path: "/agentmemory/verify", http_method: "POST" } });
- sdk.registerFunction("api::cascade-update", async (req: ApiRequest) => {
+ sdk.registerFunction("api::cascade-update", async (req: HttpRequest) => {
const denied = checkAuth(req, secret);
if (denied) return denied;
const body = req.body as Record<string, unknown>;
@@ -3154,7 +3155,7 @@ export function registerApiTriggers(
});
sdk.registerTrigger({ type: "http", function_id: "api::cascade-update", config: { api_path: "/agentmemory/cascade-update", http_method: "POST" } });
- sdk.registerFunction("api::lesson-save", async (req: ApiRequest) => {
+ sdk.registerFunction("api::lesson-save", async (req: HttpRequest) => {
const denied = checkAuth(req, secret);
if (denied) return denied;
const body = req.body as Record<string, unknown>;
@@ -3176,7 +3177,7 @@ export function registerApiTriggers(
});
sdk.registerTrigger({ type: "http", function_id: "api::lesson-save", config: { api_path: "/agentmemory/lessons", http_method: "POST" } });
- sdk.registerFunction("api::lesson-list", async (req: ApiRequest) => {
+ sdk.registerFunction("api::lesson-list", async (req: HttpRequest) => {
const denied = checkAuth(req, secret);
if (denied) return denied;
const params = req.query_params || {};
@@ -3204,7 +3205,7 @@ export function registerApiTriggers(
});
sdk.registerTrigger({ type: "http", function_id: "api::lesson-list", config: { api_path: "/agentmemory/lessons", http_method: "GET" } });
- sdk.registerFunction("api::lesson-search", async (req: ApiRequest) => {
+ sdk.registerFunction("api::lesson-search", async (req: HttpRequest) => {
const denied = checkAuth(req, secret);
if (denied) return denied;
const body = req.body as Record<string, unknown>;
@@ -3214,7 +3215,7 @@ export function registerApiTriggers(
});
sdk.registerTrigger({ type: "http", function_id: "api::lesson-search", config: { api_path: "/agentmemory/lessons/search", http_method: "POST" } });
- sdk.registerFunction("api::lesson-strengthen", async (req: ApiRequest) => {
+ sdk.registerFunction("api::lesson-strengthen", async (req: HttpRequest) => {
const denied = checkAuth(req, secret);
if (denied) return denied;
const body = req.body as Record<string, unknown>;
@@ -3224,7 +3225,7 @@ export function registerApiTriggers(
});
sdk.registerTrigger({ type: "http", function_id: "api::lesson-strengthen", config: { api_path: "/agentmemory/lessons/strengthen", http_method: "POST" } });
- sdk.registerFunction("api::lesson-delete", async (req: ApiRequest) => {
+ sdk.registerFunction("api::lesson-delete", async (req: HttpRequest) => {
const denied = checkAuth(req, secret);
if (denied) return denied;
const body = req.body as Record<string, unknown>;
@@ -3239,7 +3240,7 @@ export function registerApiTriggers(
});
sdk.registerTrigger({ type: "http", function_id: "api::lesson-delete", config: { api_path: "/agentmemory/lessons/delete", http_method: "POST" } });
- sdk.registerFunction("api::obsidian-export", async (req: ApiRequest) => {
+ sdk.registerFunction("api::obsidian-export", async (req: HttpRequest) => {
const denied = checkAuth(req, secret);
if (denied) return denied;
const body = (req.body as Record<string, unknown>) || {};
@@ -3256,7 +3257,7 @@ export function registerApiTriggers(
});
sdk.registerTrigger({ type: "http", function_id: "api::obsidian-export", config: { api_path: "/agentmemory/obsidian/export", http_method: "POST" } });
- sdk.registerFunction("api::reflect", async (req: ApiRequest) => {
+ sdk.registerFunction("api::reflect", async (req: HttpRequest) => {
const denied = checkAuth(req, secret);
if (denied) return denied;
const body = (req.body as Record<string, unknown>) || {};
@@ -3268,7 +3269,7 @@ export function registerApiTriggers(
});
sdk.registerTrigger({ type: "http", function_id: "api::reflect", config: { api_path: "/agentmemory/reflect", http_method: "POST" } });
- sdk.registerFunction("api::insight-list", async (req: ApiRequest) => {
+ sdk.registerFunction("api::insight-list", async (req: HttpRequest) => {
const denied = checkAuth(req, secret);
if (denied) return denied;
const params = req.query_params || {};
@@ -3295,7 +3296,7 @@ export function registerApiTriggers(
});
sdk.registerTrigger({ type: "http", function_id: "api::insight-list", config: { api_path: "/agentmemory/insights", http_method: "GET" } });
- sdk.registerFunction("api::insight-search", async (req: ApiRequest) => {
+ sdk.registerFunction("api::insight-search", async (req: HttpRequest) => {
const denied = checkAuth(req, secret);
if (denied) return denied;
const body = req.body as Record<string, unknown>;
diff --git a/src/triggers/events.ts b/src/triggers/events.ts
index bbf15db3..3ce2d4be 100644
--- a/src/triggers/events.ts
+++ b/src/triggers/events.ts
@@ -1,4 +1,4 @@
-import { TriggerAction, type ISdk } from "iii-sdk";
+import { TriggerAction, type IIIClient } from "iii-sdk";
import type { CompressedObservation, HookPayload, Session } from "../types.js";
import { KV, STREAM } from "../state/schema.js";
import { StateKV } from "../state/kv.js";
@@ -40,7 +40,7 @@ function consolidationDue(kv: StateKV): Promise<boolean> {
return result;
}
-export function registerEventTriggers(sdk: ISdk, kv: StateKV): void {
+export function registerEventTriggers(sdk: IIIClient, kv: StateKV): void {
sdk.registerFunction(
"event::session::started",
async (data: {
diff --git a/test/cli-console.test.ts b/test/cli-console.test.ts
new file mode 100644
index 00000000..451d3953
--- /dev/null
+++ b/test/cli-console.test.ts
@@ -0,0 +1,60 @@
+import { describe, expect, it } from "vitest";
+import {
+ consoleArgs,
+ defaultConsolePort,
+ parseConsoleArgs,
+} from "../src/cli/console.js";
+
+describe("agentmemory console", () => {
+ it("serves one port above the viewer so the two never collide", () => {
+ expect(defaultConsolePort(3113)).toBe(3114);
+ expect(defaultConsolePort(3213)).toBe(3214);
+ });
+
+ it("builds the pinned engine's console invocation against the resolved port quartet", () => {
+ expect(
+ consoleArgs({
+ iiiBin: "/home/u/.agentmemory/bin/iii",
+ consolePort: 3114,
+ restPort: 3111,
+ streamPort: 3112,
+ enginePort: 49134,
+ extraArgs: ["--enable-flow"],
+ }),
+ ).toEqual([
+ "console",
+ "--port",
+ "3114",
+ "--engine-port",
+ "3111",
+ "--ws-port",
+ "3112",
+ "--bridge-port",
+ "49134",
+ "--enable-flow",
+ ]);
+ });
+
+ it("takes --console-port in both spellings and falls back to the default", () => {
+ expect(parseConsoleArgs([], 3114)).toEqual({ consolePort: 3114, extraArgs: [] });
+ expect(parseConsoleArgs(["--console-port", "4000"], 3114).consolePort).toBe(4000);
+ expect(parseConsoleArgs(["--console-port=4001"], 3114).consolePort).toBe(4001);
+ });
+
+ it("drops the CLI's own global flags and forwards everything else to iii console", () => {
+ const parsed = parseConsoleArgs(
+ ["--port", "3211", "--instance=1", "--verbose", "--enable-flow", "--host", "0.0.0.0"],
+ 3214,
+ );
+
+ expect(parsed).toEqual({
+ consolePort: 3214,
+ extraArgs: ["--enable-flow", "--host", "0.0.0.0"],
+ });
+ });
+
+ it("rejects an unusable console port", () => {
+ expect(() => parseConsoleArgs(["--console-port", "70000"], 3114)).toThrow(/between 1 and 65535/);
+ expect(() => parseConsoleArgs(["--console-port"], 3114)).toThrow(/--console-port/);
+ });
+});
diff --git a/test/context-lessons.test.ts b/test/context-lessons.test.ts
index 92fcbce7..32f26a1e 100644
--- a/test/context-lessons.test.ts
+++ b/test/context-lessons.test.ts
@@ -36,7 +36,7 @@ function wireContext(kv: ReturnType<typeof mockKV>, budget = 4000) {
registerFunction: vi.fn((id: string, cb: ContextHandler) => {
if (id === "mem::context") handler = cb;
}),
- } as unknown as import("iii-sdk").ISdk;
+ } as unknown as import("iii-sdk").IIIClient;
registerContextFunction(sdk, kv as never, budget);
if (!handler) throw new Error("mem::context not registered");
return handler;
diff --git a/test/context-slots.test.ts b/test/context-slots.test.ts
index 808597c4..a6785d91 100644
--- a/test/context-slots.test.ts
+++ b/test/context-slots.test.ts
@@ -35,7 +35,7 @@ function wireContext(kv: ReturnType<typeof mockKV>) {
registerFunction: vi.fn((id: string, cb: ContextHandler) => {
if (id === "mem::context") handler = cb;
}),
- } as unknown as import("iii-sdk").ISdk;
+ } as unknown as import("iii-sdk").IIIClient;
registerContextFunction(sdk, kv as never, 2000);
if (!handler) throw new Error("mem::context not registered");
return handler;
diff --git a/test/docker-port-config.test.ts b/test/docker-port-config.test.ts
index 2bcc55b6..f5e87b81 100644
--- a/test/docker-port-config.test.ts
+++ b/test/docker-port-config.test.ts
@@ -41,6 +41,7 @@ describe("Docker engine port configuration", () => {
'user: "${AGENTMEMORY_DOCKER_UID:-65532}:${AGENTMEMORY_DOCKER_GID:-65532}"',
);
expect(compose).toContain("AGENTMEMORY_DOCKER_SKIP_CHOWN");
+ expect(compose).toContain("target: /app/config");
});
it("configures every iii listener from the same environment", () => {
@@ -50,6 +51,12 @@ describe("Docker engine port configuration", () => {
const manager = workerBlock("iii-worker-manager");
expect(manager).toContain("port: ${III_ENGINE_PORT:49134}");
expect(manager).toContain("host: 0.0.0.0");
+ expect(engineConfig).not.toMatch(/- name: (http|state|pubsub|cron|queue)$/m);
+ });
+
+ it("starts the pinned engine without update checks and with usage telemetry off by default", () => {
+ expect(compose).toContain('command: ["--config", "/app/config.yaml", "--no-update-check"]');
+ expect(compose).toContain('III_TELEMETRY_ENABLED: "${III_TELEMETRY_ENABLED:-false}"');
});
it("leaves worker ownership to the host CLI", () => {
diff --git a/test/engine-child-env.test.ts b/test/engine-child-env.test.ts
new file mode 100644
index 00000000..bdbb67d0
--- /dev/null
+++ b/test/engine-child-env.test.ts
@@ -0,0 +1,16 @@
+import { describe, expect, it } from "vitest";
+import { engineChildEnv } from "../src/cli/engine-launch.js";
+
+describe("engineChildEnv", () => {
+ it("turns the engine's anonymous usage telemetry off when the user has not chosen", () => {
+ const env = engineChildEnv({ PATH: "/usr/bin" });
+
+ expect(env["III_TELEMETRY_ENABLED"]).toBe("false");
+ expect(env["PATH"]).toBe("/usr/bin");
+ });
+
+ it("keeps an explicit opt-in or opt-out", () => {
+ expect(engineChildEnv({ III_TELEMETRY_ENABLED: "true" })["III_TELEMETRY_ENABLED"]).toBe("true");
+ expect(engineChildEnv({ III_TELEMETRY_ENABLED: "false" })["III_TELEMETRY_ENABLED"]).toBe("false");
+ });
+});
diff --git a/test/engine-config.test.ts b/test/engine-config.test.ts
index 43ab2783..59919a72 100644
--- a/test/engine-config.test.ts
+++ b/test/engine-config.test.ts
@@ -72,76 +72,141 @@ describe("renderEngineConfig", () => {
/- name: iii-worker-manager\n\s+config:\n\s+port: 49234\n\s+host: 127\.0\.0\.1/,
);
});
+
+ it("keeps the iii- prefixed builtin names: on 0.22.1 the unprefixed names resolve to registry workers", () => {
+ const source = readFileSync(
+ join(import.meta.dirname, "..", "iii-config.yaml"),
+ "utf8",
+ );
+ const names = [...source.matchAll(/^\s*- name: (\S+)$/gm)].map((m) => m[1]);
+
+ expect(names).toEqual(
+ expect.arrayContaining([
+ "iii-http",
+ "iii-state",
+ "iii-pubsub",
+ "iii-cron",
+ "iii-queue",
+ "iii-stream",
+ "iii-observability",
+ ]),
+ );
+ for (const bare of ["http", "state", "pubsub", "cron", "queue"]) {
+ expect(names).not.toContain(bare);
+ }
+ });
});
describe("clearPersistedBuiltinConfig", () => {
- it("lists one persisted entry per seeded builtin under data/configuration", () => {
- const paths = persistedBuiltinConfigPaths("/srv/engine");
+ const configPath = join("/srv", "state", "iii-config.runtime.yaml");
+ it("covers the engine cwd, the config file directory and the legacy 0.19 location", () => {
+ expect(persistedBuiltinConfigDirs("/srv/engine", configPath)).toEqual([
+ join("/srv", "engine", "config"),
+ join("/srv", "state", "config"),
+ join("/srv", "engine", "data", "configuration"),
+ ]);
+ });
+
+ it("lists both the unprefixed and the legacy entry name for every seeded builtin", () => {
+ const paths = persistedBuiltinConfigPaths("/srv/engine", configPath);
+
+ expect(paths).toContain(join("/srv", "state", "config", "http.yaml"));
+ expect(paths).toContain(join("/srv", "state", "config", "iii-http.yaml"));
+ expect(paths).toContain(join("/srv", "state", "config", "iii-worker-manager.yaml"));
expect(paths).toContain(
- join("/srv/engine", "data", "configuration", "iii-http.yaml"),
- );
- expect(paths).toContain(
- join("/srv/engine", "data", "configuration", "iii-worker-manager.yaml"),
+ join("/srv", "engine", "data", "configuration", "iii-http.yaml"),
);
expect(paths.every((p) => p.endsWith(".yaml"))).toBe(true);
});
it("adds the directory a configuration worker entry names, resolved against the engine cwd", () => {
- expect(persistedBuiltinConfigDirs("/srv/engine", customDirConfig)).toEqual([
+ expect(persistedBuiltinConfigDirs("/srv/engine", configPath, customDirConfig)).toEqual([
join("/srv", "engine", "custom-cfg"),
+ join("/srv", "engine", "config"),
+ join("/srv", "state", "config"),
join("/srv", "engine", "data", "configuration"),
]);
expect(
persistedBuiltinConfigDirs(
"/srv/engine",
+ configPath,
customDirConfig.replace("./custom-cfg", "'/var/lib/iii-cfg'"),
)[0],
).toBe(join("/var", "lib", "iii-cfg"));
expect(
- persistedBuiltinConfigDirs("/srv/engine", "workers:\n - name: iii-http\n"),
- ).toEqual([join("/srv", "engine", "data", "configuration")]);
+ persistedBuiltinConfigDirs("/srv/engine", configPath, "workers:\n - name: iii-http\n"),
+ ).toEqual(persistedBuiltinConfigDirs("/srv/engine", configPath));
});
- it("removes persisted builtin entries and leaves everything else in place", () => {
+ it("removes persisted builtin entries from both locations and leaves everything else in place", () => {
const cwd = mkdtempSync(join(tmpdir(), "agentmemory-engine-"));
- const dir = join(cwd, "data", "configuration");
+ const dataDir = mkdtempSync(join(tmpdir(), "agentmemory-data-"));
+ const runtimeConfig = join(dataDir, "iii-config.runtime.yaml");
+ const current = join(dataDir, "config");
+ const legacy = join(cwd, "data", "configuration");
+ mkdirSync(current, { recursive: true });
+ mkdirSync(legacy, { recursive: true });
+ writeFileSync(join(current, "http.yaml"), "id: http\nvalue:\n port: 3111\n");
+ writeFileSync(join(current, "iii-state.yaml"), "id: iii-state\nvalue: {}\n");
+ writeFileSync(join(current, "agentmemory.yaml"), "id: agentmemory\nvalue: {}\n");
+ writeFileSync(join(legacy, "iii-http.yaml"), "id: iii-http\nvalue:\n port: 3111\n");
+
+ const cleared = clearPersistedBuiltinConfig(cwd, runtimeConfig);
+
+ expect(cleared).toHaveLength(3);
+ expect(existsSync(join(current, "http.yaml"))).toBe(false);
+ expect(existsSync(join(current, "iii-state.yaml"))).toBe(false);
+ expect(existsSync(join(legacy, "iii-http.yaml"))).toBe(false);
+ expect(existsSync(join(current, "agentmemory.yaml"))).toBe(true);
+ });
+
+ it("removes the entries the engine persisted under a custom configuration directory", () => {
+ const cwd = mkdtempSync(join(tmpdir(), "agentmemory-engine-"));
+ const dir = join(cwd, "custom-cfg");
mkdirSync(dir, { recursive: true });
writeFileSync(join(dir, "iii-http.yaml"), "id: iii-http\nvalue:\n port: 3111\n");
- writeFileSync(join(dir, "iii-state.yaml"), "id: iii-state\nvalue: {}\n");
writeFileSync(join(dir, "agentmemory.yaml"), "id: agentmemory\nvalue: {}\n");
- const cleared = clearPersistedBuiltinConfig(cwd);
+ const cleared = clearPersistedBuiltinConfig(
+ cwd,
+ join(cwd, "iii-config.runtime.yaml"),
+ customDirConfig,
+ );
- expect(cleared).toHaveLength(2);
- expect(existsSync(join(dir, "iii-http.yaml"))).toBe(false);
- expect(existsSync(join(dir, "iii-state.yaml"))).toBe(false);
+ expect(cleared).toEqual([join(dir, "iii-http.yaml")]);
expect(existsSync(join(dir, "agentmemory.yaml"))).toBe(true);
});
- it("removes the entries the engine persisted under a custom configuration directory", () => {
+ it("leaves files that are not engine entries alone, even under a seeded builtin name", () => {
const cwd = mkdtempSync(join(tmpdir(), "agentmemory-engine-"));
- const dir = join(cwd, "custom-cfg");
+ const dir = join(cwd, "config");
mkdirSync(dir, { recursive: true });
- writeFileSync(join(dir, "iii-http.yaml"), "id: iii-http\nvalue:\n port: 3111\n");
- writeFileSync(join(dir, "agentmemory.yaml"), "id: agentmemory\nvalue: {}\n");
+ writeFileSync(join(dir, "http.yaml"), "host: 0.0.0.0\nport: 8080\n");
+ writeFileSync(join(dir, "state.yaml"), "id: something-else\nvalue: {}\n");
+ writeFileSync(join(dir, "iii-http.yaml"), "\nid: iii-http\nname: HTTP\nvalue:\n port: 3111\n");
- const cleared = clearPersistedBuiltinConfig(cwd, customDirConfig);
+ const cleared = clearPersistedBuiltinConfig(cwd, join(cwd, "iii-config.runtime.yaml"));
expect(cleared).toEqual([join(dir, "iii-http.yaml")]);
- expect(existsSync(join(dir, "agentmemory.yaml"))).toBe(true);
+ expect(existsSync(join(dir, "http.yaml"))).toBe(true);
+ expect(existsSync(join(dir, "state.yaml"))).toBe(true);
});
it("is a no-op when the engine has never persisted anything", () => {
const cwd = mkdtempSync(join(tmpdir(), "agentmemory-engine-"));
- expect(clearPersistedBuiltinConfig(cwd)).toEqual([]);
+ expect(
+ clearPersistedBuiltinConfig(cwd, join(cwd, "iii-config.runtime.yaml")),
+ ).toEqual([]);
});
it("fails loudly when a persisted entry exists but cannot be removed", () => {
const cwd = mkdtempSync(join(tmpdir(), "agentmemory-engine-"));
- mkdirSync(join(cwd, "data", "configuration", "iii-http.yaml"), { recursive: true });
+ mkdirSync(join(cwd, "config", "http.yaml"), { recursive: true });
- expect(() => clearPersistedBuiltinConfig(cwd)).toThrow(/iii-http\.yaml/);
+ expect(() =>
+ clearPersistedBuiltinConfig(cwd, join(cwd, "iii-config.runtime.yaml")),
+ ).toThrow(/http\.yaml/);
});
});
diff --git a/test/slots.test.ts b/test/slots.test.ts
index 70da2aed..31d320f0 100644
--- a/test/slots.test.ts
+++ b/test/slots.test.ts
@@ -30,7 +30,7 @@ function wire() {
registerFunction: vi.fn((id: string, cb) => {
handlers[id] = cb;
}),
- } as unknown as import("iii-sdk").ISdk;
+ } as unknown as import("iii-sdk").IIIClient;
registerSlotsFunctions(sdk, kv as never);
return { kv, handlers };
}
diff --git a/test/vision-search.test.ts b/test/vision-search.test.ts
index 015b3e2b..4c55cebd 100644
--- a/test/vision-search.test.ts
+++ b/test/vision-search.test.ts
@@ -70,7 +70,7 @@ describe("vision-search", () => {
registerFunction: vi.fn((id: string, cb) => {
handlers[id] = cb;
}),
- } as unknown as import("iii-sdk").ISdk;
+ } as unknown as import("iii-sdk").IIIClient;
registerVisionSearchFunctions(sdk, kv as never, fakeProvider);
visionSearch = handlers["mem::vision-search"]!;
visionEmbed = handlers["mem::vision-embed"]!;
@@ -166,7 +166,7 @@ describe("vision-search", () => {
registerFunction: vi.fn((id: string, cb) => {
handlers[id] = cb;
}),
- } as unknown as import("iii-sdk").ISdk;
+ } as unknown as import("iii-sdk").IIIClient;
registerVisionSearchFunctions(sdk, kv as never, null);
const res = (await handlers["mem::vision-search"]!({ queryText: "login" })) as {
success: boolean;