@pentatonic-ai/ai-agent-sdk 0.9.5 → 0.10.0

package/README.md

@@ -114,7 +114,7 @@ sudo systemctl restart ollama
 
 ```bash
 git clone https://github.com/Pentatonic-Ltd/ai-agent-sdk.git
-cd ai-agent-sdk/packages/memory-engine
+cd ai-agent-sdk/packages/memory-engine-v2
 
 # Default .env points at Ollama on the host. Edit if your Ollama is
 # elsewhere or you want to use a higher-quality model (e.g. mxbai-embed-large
@@ -238,7 +238,7 @@ await adapter.init();
 await adapter.ingestChunk('User prefers dark mode', { kind: 'note' });
 ```
 
-For raw `/search` and `/store`, just `fetch()` against `${engineUrl}/search` etc. The wire format is documented in `packages/memory-engine/MIGRATION.md`.
+For raw `/search` and `/store`, just `fetch()` against `${engineUrl}/search` etc. The wire format is documented in `packages/memory-engine-v2/MIGRATION.md`.
 
 ---
 
@@ -504,7 +504,7 @@ const { content, model, usage, toolCalls } = normalizeResponse(openaiResponse);
 
 Thin HTTP client for the memory engine. `config = { engineUrl, arena, apiKey? }`. Returns `{ ingestChunk(content, metadata), deleteByCorpusFile(repoAbs, relPath), init() }`. See [Use as a library](#use-as-a-library).
 
-For raw `/store` / `/search` calls, just `fetch()` against `${engineUrl}` directly — the wire format is documented in `packages/memory-engine/MIGRATION.md`.
+For raw `/store` / `/search` calls, just `fetch()` against `${engineUrl}` directly — the wire format is documented in `packages/memory-engine-v2/MIGRATION.md`.
 
 ---
 

package/bin/cli.js

@@ -78,7 +78,7 @@ function ask(question) {
 // in favour of:
 //   - `tes config local`  → writes the plugin config + prints engine
 //                           bring-up instructions
-//   - `cd packages/memory-engine && docker compose up -d` → runs the
+//   - `cd packages/memory-engine-v2 && docker compose up -d` → runs the
 //                           actual engine
 // `ask` is kept for any future interactive prompts.
 

package/bin/commands/config.js

@@ -131,7 +131,7 @@ async function runConfigLocal(opts) {
   log("");
   log("  2. Bring up the engine docker stack:");
   log("");
-  log("       cd packages/memory-engine");
+  log("       cd packages/memory-engine-v2");
   log("       cp .env.example .env             # if no .env yet");
   log("       # edit .env if you want a different embedding model/dim");
   log("       docker compose up -d --scale nv-embed=0");

package/dist/index.cjs

@@ -17,8 +17,8 @@ var __copyProps = (to, from, except, desc) => {
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
 // src/index.js
-var src_exports = {};
-__export(src_exports, {
+var index_exports = {};
+__export(index_exports, {
   Session: () => Session,
   TESClient: () => TESClient,
   buildTrackUrl: () => buildTrackUrl,
@@ -27,7 +27,7 @@ __export(src_exports, {
   signPayload: () => signPayload,
   verifyPayload: () => verifyPayload
 });
-module.exports = __toCommonJS(src_exports);
+module.exports = __toCommonJS(index_exports);
 
 // src/normalizer.js
 function normalizeResponse(raw) {
@@ -189,8 +189,7 @@ var encoder = new TextEncoder();
 function toBase64Url(buffer) {
   const bytes = new Uint8Array(buffer);
   let binary = "";
-  for (let i = 0; i < bytes.length; i++)
-    binary += String.fromCharCode(bytes[i]);
+  for (let i = 0; i < bytes.length; i++) binary += String.fromCharCode(bytes[i]);
   return btoa(binary).replace(/\+/g, "-").replace(/\//g, "_").replace(/=+$/, "");
 }
 async function signPayload(secret, payload) {
@@ -211,27 +210,22 @@ async function verifyPayload(secret, payload, signature) {
 }
 async function buildTrackUrl(endpoint, apiKey, payload) {
   const p = { ...payload };
-  if (!p.e)
-    p.e = "LINK_CLICK";
+  if (!p.e) p.e = "LINK_CLICK";
   const encoded = toBase64Url(encoder.encode(JSON.stringify(p)));
   const sig = await signPayload(apiKey, p);
   return `${endpoint}/r/${encoded}?sig=${sig}`;
 }
 var URL_RE = /https?:\/\/[^\s"'<>)\]]+/g;
 async function rewriteUrls(text, config, sessionId, metadata) {
-  if (!text)
-    return text;
+  if (!text) return text;
   const redirectPrefix = `${config.endpoint}/r/`;
   const matches = [...text.matchAll(URL_RE)];
-  if (matches.length === 0)
-    return text;
+  if (matches.length === 0) return text;
   const replacements = /* @__PURE__ */ new Map();
   for (const m of matches) {
     const originalUrl = m[0];
-    if (originalUrl.startsWith(redirectPrefix))
-      continue;
-    if (replacements.has(originalUrl))
-      continue;
+    if (originalUrl.startsWith(redirectPrefix)) continue;
+    if (replacements.has(originalUrl)) continue;
     const payload = {
       u: originalUrl,
       s: sessionId,
@@ -254,10 +248,8 @@ async function rewriteUrls(text, config, sessionId, metadata) {
 
 // src/session.js
 function truncate(value, maxLen) {
-  if (!value || !maxLen || typeof value !== "string")
-    return value;
-  if (value.length <= maxLen)
-    return value;
+  if (!value || !maxLen || typeof value !== "string") return value;
+  if (value.length <= maxLen) return value;
   return value.slice(0, maxLen) + "...[truncated]";
 }
 var Session = class {
@@ -420,8 +412,7 @@ var Session = class {
 // packages/memory/src/inject.js
 var MAX_CHARS_PER_MEMORY = 1200;
 function injectMemories(body, memories, provider) {
-  if (!memories || memories.length === 0)
-    return body;
+  if (!memories || memories.length === 0) return body;
   const preamble = formatPreamble(memories);
   if (provider === "anthropic") {
     return injectAnthropic(body, preamble);
@@ -482,8 +473,7 @@ var DEFAULT_SEARCH_TIMEOUT_MS = 5e3;
 var DEFAULT_SEARCH_LIMIT = 6;
 var DEFAULT_SEARCH_MIN_SCORE = 0.55;
 function normalizeConfig(config) {
-  if (!config)
-    throw new Error("hosted: config is required");
+  if (!config) throw new Error("hosted: config is required");
   const endpoint = config.endpoint || config.tes_endpoint;
   const clientId = config.clientId || config.tes_client_id;
   const apiKey = config.apiKey || config.tes_api_key;
@@ -508,8 +498,7 @@ function buildHostedHeaders(config) {
   return headers;
 }
 async function hostedSearch(config, query, opts = {}) {
-  if (!query)
-    return { memories: [], skipped: "no_query" };
+  if (!query) return { memories: [], skipped: "no_query" };
   let cfg;
   try {
     cfg = normalizeConfig(config);
@@ -556,8 +545,7 @@ async function hostedSearch(config, query, opts = {}) {
   return { memories: payload.data?.semanticSearchMemories || [] };
 }
 function shortenReason(msg) {
-  if (typeof msg !== "string")
-    return "unknown";
+  if (typeof msg !== "string") return "unknown";
   return msg.toLowerCase().replace(/[^a-z0-9]+/g, "_").slice(0, 60);
 }
 
@@ -568,23 +556,19 @@ var MEMORY_DEFAULTS = {
   timeoutMs: 800
 };
 function detectClientType(client) {
-  if (client?.chat?.completions?.create)
-    return "openai";
-  if (client?.messages?.create)
-    return "anthropic";
-  if (typeof client?.run === "function")
-    return "workers-ai";
+  if (client?.chat?.completions?.create) return "openai";
+  if (client?.messages?.create) return "anthropic";
+  if (typeof client?.run === "function") return "workers-ai";
   return "unknown";
 }
 function extractLastUserMessage(params, provider) {
+  void provider;
   const msgs = Array.isArray(params?.messages) ? params.messages : null;
-  if (!msgs)
-    return null;
+  if (!msgs) return null;
   for (let i = msgs.length - 1; i >= 0; i--) {
     if (msgs[i].role === "user") {
       const c = msgs[i].content;
-      if (typeof c === "string")
-        return c;
+      if (typeof c === "string") return c;
       if (Array.isArray(c)) {
         return c.filter((p) => p.type === "text" && typeof p.text === "string").map((p) => p.text).join("\n");
       }
@@ -634,8 +618,7 @@ function wrapClient(clientConfig, client, sessionOpts = {}) {
     metadata: sessionOpts.metadata
   });
   const type = detectClientType(client);
-  if (type === "openai")
-    return wrapOpenAI(clientConfig, client, sessionOpts);
+  if (type === "openai") return wrapOpenAI(clientConfig, client, sessionOpts);
   if (type === "anthropic")
     return wrapAnthropic(clientConfig, client, sessionOpts);
   if (type === "workers-ai")
@@ -649,10 +632,8 @@ function wrapOpenAI(clientConfig, client, sessionOpts) {
     get(target, prop) {
       if (prop === "chat")
         return wrapOpenAIChat(clientConfig, target.chat, target, sessionOpts);
-      if (prop === "sessionId")
-        return sessionOpts._resolvedSessionId;
-      if (prop === "tesSession")
-        return sessionOpts._session;
+      if (prop === "sessionId") return sessionOpts._resolvedSessionId;
+      if (prop === "tesSession") return sessionOpts._session;
       if (prop === "session")
         return (opts) => new OpenAISession(clientConfig, target, opts);
       return target[prop];
@@ -729,10 +710,8 @@ function wrapAnthropic(clientConfig, client, sessionOpts) {
           target,
           sessionOpts
         );
-      if (prop === "sessionId")
-        return sessionOpts._resolvedSessionId;
-      if (prop === "tesSession")
-        return sessionOpts._session;
+      if (prop === "sessionId") return sessionOpts._resolvedSessionId;
+      if (prop === "tesSession") return sessionOpts._session;
       if (prop === "session")
         return (opts) => new AnthropicSession(clientConfig, target, opts);
       return target[prop];
@@ -819,10 +798,8 @@ function wrapWorkersAI(clientConfig, aiBinding, sessionOpts) {
           return result;
         };
       }
-      if (prop === "sessionId")
-        return sessionOpts._resolvedSessionId;
-      if (prop === "tesSession")
-        return sessionOpts._session;
+      if (prop === "sessionId") return sessionOpts._resolvedSessionId;
+      if (prop === "tesSession") return sessionOpts._session;
       if (prop === "session")
         return (opts) => new WorkersAISession(clientConfig, target, opts);
       return target[prop];
@@ -841,29 +818,24 @@ var WorkersAISession = class extends Session {
   }
 };
 function extractToolResults(session, messages) {
-  if (!messages?.length || !session._toolCalls.length)
-    return;
+  if (!messages?.length || !session._toolCalls.length) return;
   const idToName = /* @__PURE__ */ new Map();
   for (const msg of messages) {
     if (msg.role === "assistant" && msg.tool_calls) {
       for (const tc of msg.tool_calls) {
         const id = tc.id || tc.tool_call_id;
         const name = tc.function?.name || tc.name;
-        if (id && name)
-          idToName.set(id, name);
+        if (id && name) idToName.set(id, name);
       }
     }
   }
   for (const msg of messages) {
-    if (msg.role !== "tool" || !msg.content)
-      continue;
+    if (msg.role !== "tool" || !msg.content) continue;
     const callId = msg.tool_call_id;
     const toolName = callId ? idToName.get(callId) : null;
     for (const tc of session._toolCalls) {
-      if (tc.result)
-        continue;
-      if (toolName && tc.tool !== toolName)
-        continue;
+      if (tc.result) continue;
+      if (toolName && tc.tool !== toolName) continue;
       try {
         const parsed = JSON.parse(msg.content);
         if (Array.isArray(parsed)) {
@@ -906,7 +878,7 @@ function fireAndForgetEmit(clientConfig, sessionOpts, messages, result, model) {
 }
 
 // src/telemetry.js
-var VERSION = "0.9.5";
+var VERSION = "0.10.0";
 var TELEMETRY_URL = "https://sdk-telemetry.philip-134.workers.dev";
 function machineId() {
   const raw = typeof process !== "undefined" ? `${process.env?.USER || process.env?.USERNAME || "u"}:${process.platform || "x"}:${process.arch || "x"}` : "browser";
@@ -917,11 +889,9 @@ function machineId() {
   return (hash >>> 0).toString(16).padStart(8, "0");
 }
 function emitTelemetry(mode) {
-  if (typeof process !== "undefined" && process.env?.PENTATONIC_TELEMETRY === "0")
-    return;
+  if (typeof process !== "undefined" && process.env?.PENTATONIC_TELEMETRY === "0") return;
   const f = globalThis.fetch;
-  if (!f)
-    return;
+  if (!f) return;
   f(TELEMETRY_URL, {
     method: "POST",
     headers: { "Content-Type": "application/json" },
@@ -941,12 +911,9 @@ function emitTelemetry(mode) {
 // src/client.js
 var TESClient = class {
   constructor({ clientId, apiKey, endpoint, headers, userId, captureContent = true, maxContentLength = 4096 }) {
-    if (!clientId)
-      throw new Error("clientId is required");
-    if (!apiKey)
-      throw new Error("apiKey is required");
-    if (!endpoint)
-      throw new Error("endpoint is required");
+    if (!clientId) throw new Error("clientId is required");
+    if (!apiKey) throw new Error("apiKey is required");
+    if (!endpoint) throw new Error("endpoint is required");
     const cleanEndpoint = endpoint.replace(/\/$/, "");
     const isLocalDev = /^http:\/\/localhost(:\d+)?(\/|$)/.test(cleanEndpoint) || /^http:\/\/127\.0\.0\.1(:\d+)?(\/|$)/.test(cleanEndpoint);
     if (!cleanEndpoint.startsWith("https://") && !isLocalDev) {

package/dist/index.js

@@ -158,8 +158,7 @@ var encoder = new TextEncoder();
 function toBase64Url(buffer) {
   const bytes = new Uint8Array(buffer);
   let binary = "";
-  for (let i = 0; i < bytes.length; i++)
-    binary += String.fromCharCode(bytes[i]);
+  for (let i = 0; i < bytes.length; i++) binary += String.fromCharCode(bytes[i]);
   return btoa(binary).replace(/\+/g, "-").replace(/\//g, "_").replace(/=+$/, "");
 }
 async function signPayload(secret, payload) {
@@ -180,27 +179,22 @@ async function verifyPayload(secret, payload, signature) {
 }
 async function buildTrackUrl(endpoint, apiKey, payload) {
   const p = { ...payload };
-  if (!p.e)
-    p.e = "LINK_CLICK";
+  if (!p.e) p.e = "LINK_CLICK";
   const encoded = toBase64Url(encoder.encode(JSON.stringify(p)));
   const sig = await signPayload(apiKey, p);
   return `${endpoint}/r/${encoded}?sig=${sig}`;
 }
 var URL_RE = /https?:\/\/[^\s"'<>)\]]+/g;
 async function rewriteUrls(text, config, sessionId, metadata) {
-  if (!text)
-    return text;
+  if (!text) return text;
   const redirectPrefix = `${config.endpoint}/r/`;
   const matches = [...text.matchAll(URL_RE)];
-  if (matches.length === 0)
-    return text;
+  if (matches.length === 0) return text;
   const replacements = /* @__PURE__ */ new Map();
   for (const m of matches) {
     const originalUrl = m[0];
-    if (originalUrl.startsWith(redirectPrefix))
-      continue;
-    if (replacements.has(originalUrl))
-      continue;
+    if (originalUrl.startsWith(redirectPrefix)) continue;
+    if (replacements.has(originalUrl)) continue;
     const payload = {
       u: originalUrl,
       s: sessionId,
@@ -223,10 +217,8 @@ async function rewriteUrls(text, config, sessionId, metadata) {
 
 // src/session.js
 function truncate(value, maxLen) {
-  if (!value || !maxLen || typeof value !== "string")
-    return value;
-  if (value.length <= maxLen)
-    return value;
+  if (!value || !maxLen || typeof value !== "string") return value;
+  if (value.length <= maxLen) return value;
   return value.slice(0, maxLen) + "...[truncated]";
 }
 var Session = class {
@@ -389,8 +381,7 @@ var Session = class {
 // packages/memory/src/inject.js
 var MAX_CHARS_PER_MEMORY = 1200;
 function injectMemories(body, memories, provider) {
-  if (!memories || memories.length === 0)
-    return body;
+  if (!memories || memories.length === 0) return body;
   const preamble = formatPreamble(memories);
   if (provider === "anthropic") {
     return injectAnthropic(body, preamble);
@@ -451,8 +442,7 @@ var DEFAULT_SEARCH_TIMEOUT_MS = 5e3;
 var DEFAULT_SEARCH_LIMIT = 6;
 var DEFAULT_SEARCH_MIN_SCORE = 0.55;
 function normalizeConfig(config) {
-  if (!config)
-    throw new Error("hosted: config is required");
+  if (!config) throw new Error("hosted: config is required");
   const endpoint = config.endpoint || config.tes_endpoint;
   const clientId = config.clientId || config.tes_client_id;
   const apiKey = config.apiKey || config.tes_api_key;
@@ -477,8 +467,7 @@ function buildHostedHeaders(config) {
   return headers;
 }
 async function hostedSearch(config, query, opts = {}) {
-  if (!query)
-    return { memories: [], skipped: "no_query" };
+  if (!query) return { memories: [], skipped: "no_query" };
   let cfg;
   try {
     cfg = normalizeConfig(config);
@@ -525,8 +514,7 @@ async function hostedSearch(config, query, opts = {}) {
   return { memories: payload.data?.semanticSearchMemories || [] };
 }
 function shortenReason(msg) {
-  if (typeof msg !== "string")
-    return "unknown";
+  if (typeof msg !== "string") return "unknown";
   return msg.toLowerCase().replace(/[^a-z0-9]+/g, "_").slice(0, 60);
 }
 
@@ -537,23 +525,19 @@ var MEMORY_DEFAULTS = {
   timeoutMs: 800
 };
 function detectClientType(client) {
-  if (client?.chat?.completions?.create)
-    return "openai";
-  if (client?.messages?.create)
-    return "anthropic";
-  if (typeof client?.run === "function")
-    return "workers-ai";
+  if (client?.chat?.completions?.create) return "openai";
+  if (client?.messages?.create) return "anthropic";
+  if (typeof client?.run === "function") return "workers-ai";
   return "unknown";
 }
 function extractLastUserMessage(params, provider) {
+  void provider;
   const msgs = Array.isArray(params?.messages) ? params.messages : null;
-  if (!msgs)
-    return null;
+  if (!msgs) return null;
   for (let i = msgs.length - 1; i >= 0; i--) {
     if (msgs[i].role === "user") {
       const c = msgs[i].content;
-      if (typeof c === "string")
-        return c;
+      if (typeof c === "string") return c;
       if (Array.isArray(c)) {
         return c.filter((p) => p.type === "text" && typeof p.text === "string").map((p) => p.text).join("\n");
       }
@@ -603,8 +587,7 @@ function wrapClient(clientConfig, client, sessionOpts = {}) {
     metadata: sessionOpts.metadata
   });
   const type = detectClientType(client);
-  if (type === "openai")
-    return wrapOpenAI(clientConfig, client, sessionOpts);
+  if (type === "openai") return wrapOpenAI(clientConfig, client, sessionOpts);
   if (type === "anthropic")
     return wrapAnthropic(clientConfig, client, sessionOpts);
   if (type === "workers-ai")
@@ -618,10 +601,8 @@ function wrapOpenAI(clientConfig, client, sessionOpts) {
     get(target, prop) {
       if (prop === "chat")
         return wrapOpenAIChat(clientConfig, target.chat, target, sessionOpts);
-      if (prop === "sessionId")
-        return sessionOpts._resolvedSessionId;
-      if (prop === "tesSession")
-        return sessionOpts._session;
+      if (prop === "sessionId") return sessionOpts._resolvedSessionId;
+      if (prop === "tesSession") return sessionOpts._session;
       if (prop === "session")
         return (opts) => new OpenAISession(clientConfig, target, opts);
       return target[prop];
@@ -698,10 +679,8 @@ function wrapAnthropic(clientConfig, client, sessionOpts) {
           target,
           sessionOpts
         );
-      if (prop === "sessionId")
-        return sessionOpts._resolvedSessionId;
-      if (prop === "tesSession")
-        return sessionOpts._session;
+      if (prop === "sessionId") return sessionOpts._resolvedSessionId;
+      if (prop === "tesSession") return sessionOpts._session;
       if (prop === "session")
         return (opts) => new AnthropicSession(clientConfig, target, opts);
       return target[prop];
@@ -788,10 +767,8 @@ function wrapWorkersAI(clientConfig, aiBinding, sessionOpts) {
           return result;
         };
       }
-      if (prop === "sessionId")
-        return sessionOpts._resolvedSessionId;
-      if (prop === "tesSession")
-        return sessionOpts._session;
+      if (prop === "sessionId") return sessionOpts._resolvedSessionId;
+      if (prop === "tesSession") return sessionOpts._session;
       if (prop === "session")
         return (opts) => new WorkersAISession(clientConfig, target, opts);
       return target[prop];
@@ -810,29 +787,24 @@ var WorkersAISession = class extends Session {
   }
 };
 function extractToolResults(session, messages) {
-  if (!messages?.length || !session._toolCalls.length)
-    return;
+  if (!messages?.length || !session._toolCalls.length) return;
   const idToName = /* @__PURE__ */ new Map();
   for (const msg of messages) {
     if (msg.role === "assistant" && msg.tool_calls) {
       for (const tc of msg.tool_calls) {
         const id = tc.id || tc.tool_call_id;
         const name = tc.function?.name || tc.name;
-        if (id && name)
-          idToName.set(id, name);
+        if (id && name) idToName.set(id, name);
       }
     }
   }
   for (const msg of messages) {
-    if (msg.role !== "tool" || !msg.content)
-      continue;
+    if (msg.role !== "tool" || !msg.content) continue;
     const callId = msg.tool_call_id;
     const toolName = callId ? idToName.get(callId) : null;
     for (const tc of session._toolCalls) {
-      if (tc.result)
-        continue;
-      if (toolName && tc.tool !== toolName)
-        continue;
+      if (tc.result) continue;
+      if (toolName && tc.tool !== toolName) continue;
       try {
         const parsed = JSON.parse(msg.content);
         if (Array.isArray(parsed)) {
@@ -875,7 +847,7 @@ function fireAndForgetEmit(clientConfig, sessionOpts, messages, result, model) {
 }
 
 // src/telemetry.js
-var VERSION = "0.9.5";
+var VERSION = "0.10.0";
 var TELEMETRY_URL = "https://sdk-telemetry.philip-134.workers.dev";
 function machineId() {
   const raw = typeof process !== "undefined" ? `${process.env?.USER || process.env?.USERNAME || "u"}:${process.platform || "x"}:${process.arch || "x"}` : "browser";
@@ -886,11 +858,9 @@ function machineId() {
   return (hash >>> 0).toString(16).padStart(8, "0");
 }
 function emitTelemetry(mode) {
-  if (typeof process !== "undefined" && process.env?.PENTATONIC_TELEMETRY === "0")
-    return;
+  if (typeof process !== "undefined" && process.env?.PENTATONIC_TELEMETRY === "0") return;
   const f = globalThis.fetch;
-  if (!f)
-    return;
+  if (!f) return;
   f(TELEMETRY_URL, {
     method: "POST",
     headers: { "Content-Type": "application/json" },
@@ -910,12 +880,9 @@ function emitTelemetry(mode) {
 // src/client.js
 var TESClient = class {
   constructor({ clientId, apiKey, endpoint, headers, userId, captureContent = true, maxContentLength = 4096 }) {
-    if (!clientId)
-      throw new Error("clientId is required");
-    if (!apiKey)
-      throw new Error("apiKey is required");
-    if (!endpoint)
-      throw new Error("endpoint is required");
+    if (!clientId) throw new Error("clientId is required");
+    if (!apiKey) throw new Error("apiKey is required");
+    if (!endpoint) throw new Error("endpoint is required");
     const cleanEndpoint = endpoint.replace(/\/$/, "");
     const isLocalDev = /^http:\/\/localhost(:\d+)?(\/|$)/.test(cleanEndpoint) || /^http:\/\/127\.0\.0\.1(:\d+)?(\/|$)/.test(cleanEndpoint);
     if (!cleanEndpoint.startsWith("https://") && !isLocalDev) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pentatonic-ai/ai-agent-sdk",
-  "version": "0.9.5",
+  "version": "0.10.0",
   "description": "TES SDK — LLM observability and lifecycle tracking via Pentatonic Thing Event System. Track token usage, tool calls, and conversations. Manage things through event-sourced lifecycle stages with AI enrichment and vector search.",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -27,7 +27,7 @@
     "src",
     "bin",
     "packages/memory",
-    "packages/memory-engine",
+    "packages/memory-engine-v2",
     "packages/doctor",
     "build.js",
     "README.md",
@@ -73,11 +73,18 @@
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.27.1",
     "@pentatonic-ai/ai-agent-sdk": "^0.4.0",
-    "esbuild": "^0.20.0"
+    "esbuild": "^0.25.0"
   },
   "devDependencies": {
     "@jest/globals": "^29.7.0",
     "jest": "^29.7.0",
     "pg": "^8.20.0"
+  },
+  "overrides": {
+    "path-to-regexp": "^8.4.0",
+    "ip-address": "^10.1.1",
+    "@hono/node-server": "^1.19.13",
+    "picomatch": "^4.0.4",
+    "esbuild": "^0.25.0"
   }
 }

package/packages/doctor/src/checks/local-memory.js

@@ -2,7 +2,7 @@
  * Local memory engine checks.
  *
  * Targets the engine stack started by:
- *   cd packages/memory-engine && docker compose up -d
+ *   cd packages/memory-engine-v2 && docker compose up -d
  *
  * The engine exposes a compat HTTP shim on port 8099 (or whatever
  * memory_url is set to in the user's plugin config). All checks are
@@ -202,7 +202,7 @@ function checkEmbeddingPath() {
         }
         return {
           ok: false,
-          msg: `nv_embed=${nv} — L4/L5/L6 indexing will fail. Check NV_EMBED_URL in packages/memory-engine/.env`,
+          msg: `nv_embed=${nv} — L4/L5/L6 indexing will fail. Check NV_EMBED_URL in packages/memory-engine-v2/.env`,
           detail: { nv_embed: nv },
         };
       } catch (err) {

package/packages/memory/README.md

@@ -4,11 +4,11 @@
 >
 > This package is the **legacy** single-process MCP server backed by
 > PostgreSQL + pgvector + Ollama. It's superseded by the **7-layer
-> memory engine** at [`packages/memory-engine/`](../memory-engine/),
+> memory engine** at [`packages/memory-engine-v2/`](../memory-engine/),
 > which is what the top-level SDK README walks users into and what
 > TES production runs.
 >
-> | | This package (legacy) | `packages/memory-engine/` (current) |
+> | | This package (legacy) | `packages/memory-engine-v2/` (current) |
 > |---|---|---|
 > | Wire | MCP over stdio | HTTP (`/store`, `/search`, ...) |
 > | Storage | One Postgres table, one embedding | 7 layers fused via RRF |

package/packages/memory/openclaw-plugin/README.md

@@ -7,7 +7,7 @@ Persistent, searchable memory for OpenClaw. Local (Docker + Ollama) or hosted (P
 > The `database_url` / `embedding_url` / `llm_url` config fields shown
 > in this README configure the **legacy** `packages/memory/` Postgres+
 > Ollama+pgvector MCP server, which is being retired in favour of the
-> 7-layer memory engine at `packages/memory-engine/`. Both backends
+> 7-layer memory engine at `packages/memory-engine-v2/`. Both backends
 > still work; the legacy one will be removed in v1.0.
 >
 > **For new installs, prefer:**
@@ -23,7 +23,7 @@ Persistent, searchable memory for OpenClaw. Local (Docker + Ollama) or hosted (P
 > ```
 >
 > …with the engine brought up via `docker compose up -d` from
-> `packages/memory-engine/`. See the
+> `packages/memory-engine-v2/`. See the
 > [top-level SDK README](../../../README.md#local-self-hosted) for the
 > walkthrough.
 

package/packages/memory/openclaw-plugin/openclaw.plugin.json

@@ -17,7 +17,7 @@
       "memory_url": {
         "type": "string",
         "default": "http://localhost:8099",
-        "description": "Memory engine HTTP URL (local mode). Default 8099 = packages/memory-engine compat shim. (3333 was the legacy single-process MCP server port — deprecated.)"
+        "description": "Memory engine HTTP URL (local mode). Default 8099 = packages/memory-engine-v2 compat shim. (3333 was the legacy single-process MCP server port — deprecated.)"
       },
       "database_url": {
         "type": "string",