@pentatonic-ai/ai-agent-sdk 0.4.2 → 0.4.5

package/README.md

@@ -171,7 +171,7 @@ Works with both local and hosted setups. Just tell OpenClaw to set it up.
 ### Install
 
 ```bash
-openclaw plugins install @pentatonic-ai/ai-agent-sdk
+openclaw plugins install @pentatonic-ai/openclaw-memory-plugin
 ```
 
 ### Set up

package/bin/cli.js

@@ -2,7 +2,7 @@
 
 import { createInterface } from "readline";
 import { execFileSync } from "child_process";
-import { existsSync, mkdirSync, writeFileSync } from "fs";
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "fs";
 import { join } from "path";
 import { homedir } from "os";
 

package/dist/index.cjs

@@ -120,18 +120,36 @@ function parseArgs(args) {
 }
 
 // src/transport.js
-var EMIT_EVENT_MUTATION = `
-  mutation EmitEvent($input: EventInput!) {
-    emitEvent(input: $input) {
+var CREATE_MODULE_EVENT_MUTATION = `
+  mutation CreateModuleEvent($moduleId: String!, $input: ModuleEventInput!) {
+    createModuleEvent(moduleId: $moduleId, input: $input) {
       success
       eventId
-      message
     }
   }
 `;
+function getModuleId(eventType) {
+  if (["STORE_MEMORY", "SESSION_START", "SESSION_END"].includes(eventType)) {
+    return "deep-memory";
+  }
+  return "conversation-analytics";
+}
 async function sendEvent({ endpoint, apiKey, clientId, userId, headers }, input, fetchFn) {
   const f = fetchFn || globalThis.fetch;
   const authHeaders = apiKey.startsWith("tes_") ? { Authorization: `Bearer ${apiKey}` } : { "x-service-key": apiKey };
+  const moduleId = getModuleId(input.eventType);
+  const attributes = {
+    ...input.data?.attributes,
+    clientId,
+    ...userId ? { userId } : {}
+  };
+  const moduleInput = {
+    eventType: input.eventType,
+    data: {
+      entity_id: input.data?.entity_id || input.entityId || "",
+      attributes
+    }
+  };
   const response = await f(`${endpoint}/api/graphql`, {
     method: "POST",
     headers: {
@@ -141,10 +159,8 @@ async function sendEvent({ endpoint, apiKey, clientId, userId, headers }, input,
       ...authHeaders
     },
     body: JSON.stringify({
-      query: EMIT_EVENT_MUTATION,
-      variables: {
-        input: userId ? { ...input, data: { ...input.data, attributes: { ...input.data?.attributes, userId } } } : input
-      }
+      query: CREATE_MODULE_EVENT_MUTATION,
+      variables: { moduleId, input: moduleInput }
     })
   });
   if (!response.ok) {
@@ -154,7 +170,7 @@ async function sendEvent({ endpoint, apiKey, clientId, userId, headers }, input,
   if (json.errors?.length) {
     throw new Error(`TES GraphQL error: ${json.errors[0].message}`);
   }
-  return json.data.emitEvent;
+  return json.data.createModuleEvent;
 }
 
 // src/tracking.js

package/dist/index.js

@@ -89,18 +89,36 @@ function parseArgs(args) {
 }
 
 // src/transport.js
-var EMIT_EVENT_MUTATION = `
-  mutation EmitEvent($input: EventInput!) {
-    emitEvent(input: $input) {
+var CREATE_MODULE_EVENT_MUTATION = `
+  mutation CreateModuleEvent($moduleId: String!, $input: ModuleEventInput!) {
+    createModuleEvent(moduleId: $moduleId, input: $input) {
       success
       eventId
-      message
     }
   }
 `;
+function getModuleId(eventType) {
+  if (["STORE_MEMORY", "SESSION_START", "SESSION_END"].includes(eventType)) {
+    return "deep-memory";
+  }
+  return "conversation-analytics";
+}
 async function sendEvent({ endpoint, apiKey, clientId, userId, headers }, input, fetchFn) {
   const f = fetchFn || globalThis.fetch;
   const authHeaders = apiKey.startsWith("tes_") ? { Authorization: `Bearer ${apiKey}` } : { "x-service-key": apiKey };
+  const moduleId = getModuleId(input.eventType);
+  const attributes = {
+    ...input.data?.attributes,
+    clientId,
+    ...userId ? { userId } : {}
+  };
+  const moduleInput = {
+    eventType: input.eventType,
+    data: {
+      entity_id: input.data?.entity_id || input.entityId || "",
+      attributes
+    }
+  };
   const response = await f(`${endpoint}/api/graphql`, {
     method: "POST",
     headers: {
@@ -110,10 +128,8 @@ async function sendEvent({ endpoint, apiKey, clientId, userId, headers }, input,
       ...authHeaders
     },
     body: JSON.stringify({
-      query: EMIT_EVENT_MUTATION,
-      variables: {
-        input: userId ? { ...input, data: { ...input.data, attributes: { ...input.data?.attributes, userId } } } : input
-      }
+      query: CREATE_MODULE_EVENT_MUTATION,
+      variables: { moduleId, input: moduleInput }
     })
   });
   if (!response.ok) {
@@ -123,7 +139,7 @@ async function sendEvent({ endpoint, apiKey, clientId, userId, headers }, input,
   if (json.errors?.length) {
     throw new Error(`TES GraphQL error: ${json.errors[0].message}`);
   }
-  return json.data.emitEvent;
+  return json.data.createModuleEvent;
 }
 
 // src/tracking.js

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pentatonic-ai/ai-agent-sdk",
-  "version": "0.4.2",
+  "version": "0.4.5",
   "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",
@@ -52,7 +52,8 @@
     "model-context-protocol"
   ],
   "openclaw": {
-    "extensions": ["./packages/memory/src/openclaw/index.js"]
+    "extensions": ["./packages/memory/src/openclaw/index.js"],
+    "hooks": {}
   },
   "license": "MIT",
   "homepage": "https://thingeventsystem.ai",

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

@@ -0,0 +1,60 @@
+# @pentatonic-ai/openclaw-memory-plugin
+
+Persistent, searchable memory for OpenClaw. Local (Docker + Ollama) or hosted (Pentatonic TES).
+
+## Install
+
+```bash
+openclaw plugins install @pentatonic-ai/openclaw-memory-plugin
+```
+
+## Setup
+
+Tell OpenClaw:
+
+```
+Set up pentatonic memory
+```
+
+Or configure manually in `openclaw.json`:
+
+```json
+{
+  "plugins": {
+    "slots": { "contextEngine": "pentatonic-memory" },
+    "entries": {
+      "pentatonic-memory": {
+        "enabled": true,
+        "config": {
+          "database_url": "postgres://memory:memory@localhost:5433/memory",
+          "embedding_url": "http://localhost:11435/v1",
+          "embedding_model": "nomic-embed-text",
+          "llm_url": "http://localhost:11435/v1",
+          "llm_model": "llama3.2:3b"
+        }
+      }
+    }
+  }
+}
+```
+
+## What it does
+
+Every lifecycle event is handled automatically:
+
+- **Ingest** — every message stored with embeddings + HyDE query expansion
+- **Assemble** — relevant memories injected as context before every prompt
+- **Compact** — decay cycle when context window fills
+- **After turn** — high-access memories consolidated to semantic layer
+
+Plus tools: `memory_search`, `memory_store`, `memory_layers`
+
+## Local vs Hosted
+
+**Local**: Fully private. Requires Docker (Postgres + pgvector + Ollama). Run `npx @pentatonic-ai/ai-agent-sdk memory` to set up.
+
+**Hosted**: Connect to Pentatonic TES for higher-dimensional embeddings, team memory, and analytics. Run `npx @pentatonic-ai/ai-agent-sdk init`.
+
+## License
+
+MIT