Solution for long term memory for agent coding CLIs and to facilitate handoff between different agent vendors
Rust
docs(sdk-ts): humanizer pass on the SDK documentation
AkitaOnRailsc56f701b1bae
diff --git a/docs/companion-crates.md b/docs/companion-crates.mdindex 2f7a7e85..e18a4367 100644--- a/docs/companion-crates.md+++ b/docs/companion-crates.md@@ -426,7 +426,7 @@ See [`docs/macos.md`](macos.md#scenario-d-menu-bar-app).## `ai-memory-ts`: TypeScript client SDK-Typed client for programs that are not coding-agent harnesses (issue #1165):+A typed client for programs that are not coding-agent harnesses (issue #1165):custom agents and bots, editor and app extensions (RFC #1166) and automationscripts. It lives at [`companions/ai-memory-ts`](../companions/ai-memory-ts),has no runtime dependencies, and talks to ai-memory only through the publicdiff --git a/docs/design-client-sdk.md b/docs/design-client-sdk.mdindex 3f25831e..deb00ccf 100644--- a/docs/design-client-sdk.md+++ b/docs/design-client-sdk.md@@ -190,8 +190,8 @@ release.One entry class with namespaces that mirror the server's concepts. The firstrelease targets Node 22 and newer. Deno and Bun work through standard-`fetch` in a manual smoke run but are not tested in CI (§9, Q8); callers on other runtimes inject their own-`fetch`.+`fetch` in a manual smoke run but are not tested in CI (§9, Q8); callers on+other runtimes inject their own `fetch`.```tsimport { AiMemoryClient } from "ai-memory-ts"; // final name: decision D1@@ -859,8 +859,8 @@ fits the plan:before sending, so a path cannot climb out of the prefix.- Q3 (marker file): **scope always comes from the caller.** No helper reads`.ai-memory.toml`. A library that reads files from its working directory- surprises callers in servers and bundles, and the static-client rule wants- the caller's code to show which project it writes to.+ surprises callers in servers and bundles, and under the static-client rule+ the caller's code shows which project it writes to.- Q4 (non-project writes): **not wrapped.** `pages.write` always sends aproject scope. Writes with `scope: "global"` or `"profile"` reach everyproject, so they stay explicit through `callTool` until a caller needs them.@@ -872,8 +872,9 @@ fits the plan:`pages.update(path, change)`. It reads the page, carries its metadata over(title, tier, tags, pinned, kind, entities, abstract, relations, TTL), appliesthe change (`null` clears a field), and writes with the read version as- `expectedPageId`. One attempt and no retry: a concurrent change raises- `PreconditionFailedError` and writes nothing. The page must exist.+ `expectedPageId`. It makes one attempt and does not retry: a concurrent+ change raises `PreconditionFailedError` and writes nothing. The page must+ exist.- Q8 (runtimes): **Node 22 floor**, tested on Node 22 and 24 in CI. Bun andDeno are documented as untested in CI; the SDK uses only standard `fetch`,`AbortSignal`, `TextDecoder` and `URL`, and a manual smoke run against a