getmnemo-anthropic 0.1.0 → 0.1.2

package/README.md

@@ -1,6 +1,6 @@
-# @ledgermem/anthropic
+# getmnemo-anthropic
 
-LedgerMem helper for the Anthropic SDK. Wraps `messages.create` with a single
+Mnemo helper for the Anthropic SDK. Wraps `messages.create` with a single
 `memory` tool (search + add), prompt caching on the system block, and
 optional extended thinking — the recommended setup for any long-lived Claude
 assistant.
@@ -8,26 +8,33 @@ assistant.
 ## Install
 
 ```bash
-npm install @ledgermem/anthropic @ledgermem/memory @anthropic-ai/sdk
+npm install getmnemo-anthropic @anthropic-ai/sdk
 ```
 
+`getmnemo` (the core SDK) is pulled in automatically as a dependency. You only
+need `@anthropic-ai/sdk` because you construct the Anthropic client yourself and
+pass it in.
+
+Get your Mnemo API key and workspace ID from
+[app.mnemohq.com/settings/api-keys](https://app.mnemohq.com/settings/api-keys).
+
 ## Quickstart (30 seconds)
 
 ```ts
 import Anthropic from "@anthropic-ai/sdk";
-import { LedgerMem } from "@ledgermem/memory";
-import { withMemoryTool } from "@ledgermem/anthropic";
+import { Mnemo } from "getmnemo";
+import { withMemoryTool } from "getmnemo-anthropic";
 
 const claude = new Anthropic();
-const ledgermem = new LedgerMem({
-  apiKey: process.env.LEDGERMEM_API_KEY!,
-  workspaceId: process.env.LEDGERMEM_WORKSPACE_ID!,
+const memory = new Mnemo({
+  apiKey: process.env.GETMNEMO_API_KEY!,
+  workspaceId: process.env.GETMNEMO_WORKSPACE_ID!,
 });
 
 const agent = withMemoryTool({
   client: claude,
-  ledgermem,
-  model: "claude-sonnet-4-7",
+  getmnemo: memory,
+  model: "claude-sonnet-4-6",
   thinkingBudgetTokens: 4000,
 });
 
@@ -51,6 +58,51 @@ console.log("memory tool calls:", result.memoryToolCalls);
 - Optionally enables extended thinking with a configurable token budget.
 - Returns the final transcript so you can persist it elsewhere.
 
+## API
+
+`withMemoryTool(options)` returns a wrapper with a single `run(input)` method.
+
+### `withMemoryTool(options)`
+
+| Option | Type | Default | Description |
+| --- | --- | --- | --- |
+| `client` | `Anthropic` | — | An `@anthropic-ai/sdk` client (anything with `messages.create`). |
+| `getmnemo` | `Mnemo` | — | A `Mnemo` instance from `getmnemo`. |
+| `model` | `string` | `"claude-sonnet-4-6"` | Default model; override per call. |
+| `maxTokens` | `number` | `1024` | Default `max_tokens`; override per call. |
+| `searchLimit` | `number` | `5` | Default top-k for memory search (clamped to 1–50). |
+| `cacheSystem` | `boolean` | `true` | Wrap the system prompt with `cache_control: { type: "ephemeral" }`. |
+| `thinkingBudgetTokens` | `number` | — | Enable extended thinking with this token budget. |
+| `metadata` | `Record<string, unknown>` | `{}` | Static metadata merged into every persisted memory. |
+| `maxIterations` | `number` | `6` | Hard cap on tool-use loop iterations. |
+
+### `run(input)`
+
+| Field | Type | Description |
+| --- | --- | --- |
+| `messages` | `ChatMessage[]` | Conversation so far (required). |
+| `system` | `string` | Optional system prompt. |
+| `model` | `string` | Per-call model override. |
+| `maxTokens` | `number` | Per-call `max_tokens` override. |
+| `metadata` | `Record<string, unknown>` | Per-call metadata merged into persisted memories. |
+
+Returns:
+
+| Field | Type | Description |
+| --- | --- | --- |
+| `text` | `string` | Final assistant text, concatenated across blocks. |
+| `responses` | `MessagesCreateResult[]` | Every raw API response from the tool-use loop. |
+| `memoryToolCalls` | `number` | How many times the memory tool ran. |
+| `messages` | `ChatMessage[]` | Final messages array after the loop — store this as your transcript. |
+
+The package also exports `MEMORY_TOOL_NAME` (the literal tool name, `"memory"`)
+and the `WithMemoryTool*` / `WithMemoryRun*` types.
+
+## Links
+
+- Docs: [mnemohq.com](https://mnemohq.com)
+- API keys: [app.mnemohq.com/settings/api-keys](https://app.mnemohq.com/settings/api-keys)
+
 ## License
 
 MIT

package/dist/memory-tool.d.ts

@@ -31,7 +31,7 @@ interface ChatMessage {
 export interface WithMemoryToolOptions {
     client: AnthropicLike;
     getmnemo: Mnemo;
-    /** Defaults to claude-sonnet-4-7. Override per call too. */
+    /** Defaults to claude-sonnet-4-6. Override per call too. */
     model?: string;
     /** Defaults to 1024. */
     maxTokens?: number;

package/dist/memory-tool.js

@@ -8,7 +8,7 @@ export const MEMORY_TOOL_NAME = "memory";
  */
 export function withMemoryTool(options) {
     const defaults = {
-        model: options.model ?? "claude-sonnet-4-7",
+        model: options.model ?? "claude-sonnet-4-6",
         maxTokens: options.maxTokens ?? 1024,
         searchLimit: options.searchLimit ?? 5,
         cacheSystem: options.cacheSystem ?? true,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "getmnemo-anthropic",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Mnemo helper for the Anthropic SDK — memory tool, prompt caching, and extended thinking wired together.",
   "type": "module",
   "main": "./dist/index.js",
@@ -30,7 +30,10 @@
     "tool-use",
     "prompt-caching"
   ],
-  "author": "Mnemo <founders@getmnemo.xyz>",
+  "author": {
+    "name": "Mnemo",
+    "url": "https://mnemohq.com"
+  },
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -50,5 +53,5 @@
   "engines": {
     "node": ">=18.17.0"
   },
-  "homepage": "https://getmnemo.xyz"
+  "homepage": "https://mnemohq.com"
 }

package/src/memory-tool.ts

@@ -33,7 +33,7 @@ interface ChatMessage {
 export interface WithMemoryToolOptions {
   client: AnthropicLike;
   getmnemo: Mnemo;
-  /** Defaults to claude-sonnet-4-7. Override per call too. */
+  /** Defaults to claude-sonnet-4-6. Override per call too. */
   model?: string;
   /** Defaults to 1024. */
   maxTokens?: number;
@@ -86,7 +86,7 @@ export function withMemoryTool(
   options: WithMemoryToolOptions,
 ): WithMemoryToolWrapper {
   const defaults = {
-    model: options.model ?? "claude-sonnet-4-7",
+    model: options.model ?? "claude-sonnet-4-6",
     maxTokens: options.maxTokens ?? 1024,
     searchLimit: options.searchLimit ?? 5,
     cacheSystem: options.cacheSystem ?? true,