@keemakr/agent-sdk 0.3.0 → 0.4.0

package/README.md

@@ -82,6 +82,25 @@ await kee.connections.get("hunter").call("email-finder", { ... }); // equivalent
 const { access_token } = await kee.connections.hunter.token();
 ```
 
+### Memory (cross-session, tenant-shared)
+
+```ts
+await kee.memory.set("prefs", "tone", { tone: "formal" });
+await kee.memory.get("prefs", "tone");          // → { tone: "formal" }
+await kee.memory.list("prefs");                  // → entries in the namespace
+await kee.memory.delete("prefs", "tone");
+// Semantic search by meaning (embeddings):
+const hits = await kee.memory.search("how should I speak to the user?", { limit: 5 });
+// → [{ namespace, key, value, score, … }]  (score 0–1, nearest first)
+```
+
+### Platform tools
+
+```ts
+await kee.tools.list();                 // tools this grant is entitled to
+await kee.tools.run("current-time");    // run one in keemakr-core
+```
+
 A call whose grant lacks the required scope returns a `KeeError` with `status: 403`; an expired/invalid grant returns `status: 401`.
 
 ## Security model

package/dist/client.d.ts

@@ -35,6 +35,11 @@ export interface MemoryEntry {
  * memory use eve's defineState instead — this is for state that must outlive the
  * session. Requires the `memory:rw` scope.
  */
+/** A semantic-search hit — a memory entry with its similarity score. */
+export interface MemorySearchHit extends MemoryEntry {
+    /** Cosine similarity in [0,1] (1 = identical). */
+    score: number;
+}
 export interface KeeMemory {
     /** Read a key's value, or null if absent. */
     get(namespace: string, key: string): Promise<unknown | null>;
@@ -46,6 +51,11 @@ export interface KeeMemory {
     delete(namespace: string, key: string): Promise<boolean>;
     /** List every entry in a namespace (tenant-wide). */
     list(namespace: string): Promise<MemoryEntry[]>;
+    /** Semantic search by meaning. Optionally scope to a namespace. */
+    search(query: string, opts?: {
+        namespace?: string;
+        limit?: number;
+    }): Promise<MemorySearchHit[]>;
 }
 /** Platform registry tools (Shape B) — defined in core, run server-side. */
 export interface KeeTools {

package/dist/client.js

@@ -104,6 +104,14 @@ export function useKee(ctx) {
             const json = (await capabilityFetch(grant, `memory/${enc(namespace)}`, undefined, 'GET'));
             return json.entries ?? [];
         },
+        async search(query, opts) {
+            const json = (await capabilityFetch(grant, 'memory/search', {
+                query,
+                namespace: opts?.namespace,
+                limit: opts?.limit,
+            }));
+            return json.hits ?? [];
+        },
     };
     const tools = {
         async list() {

package/dist/index.d.ts

@@ -1,3 +1,3 @@
 export { grantAuth } from './grant-auth.js';
-export { useKee, type Kee, type KeeConnection, type KeeContext, type KeeError, type KeeMemory, type KeeTools, type MemoryEntry, } from './client.js';
+export { useKee, type Kee, type KeeConnection, type KeeContext, type KeeError, type KeeMemory, type KeeTools, type MemoryEntry, type MemorySearchHit, } from './client.js';
 export { keemakrToolDirectory } from './tool-directory.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@keemakr/agent-sdk",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "The floor for keemakr marketplace agents: verify the capability grant and reach tenant connections, memory, and shared platform tools through keemakr-core — without holding raw secrets or resolving the tenant yourself.",
   "license": "MIT",
   "type": "module",