@keemakr/agent-sdk 0.1.0 → 0.2.0

package/dist/client.d.ts

@@ -20,6 +20,33 @@ export interface KeeConnection {
         account_label: string | null;
     }>;
 }
+/** One stored memory entry. */
+export interface MemoryEntry {
+    namespace: string;
+    key: string;
+    value: unknown;
+    written_by_agent: string | null;
+    created_at: string;
+    updated_at: string;
+}
+/**
+ * Cross-session, tenant-owned key-value memory. TENANT-SHARED: any of the
+ * tenant's installed agents can read/write any namespace. For per-session working
+ * memory use eve's defineState instead — this is for state that must outlive the
+ * session. Requires the `memory:rw` scope.
+ */
+export interface KeeMemory {
+    /** Read a key's value, or null if absent. */
+    get(namespace: string, key: string): Promise<unknown | null>;
+    /** Read the full entry (value + provenance + timestamps), or null. */
+    getEntry(namespace: string, key: string): Promise<MemoryEntry | null>;
+    /** Write a key. Returns the stored entry. */
+    set(namespace: string, key: string, value: unknown): Promise<MemoryEntry>;
+    /** Delete a key. Returns whether it existed. */
+    delete(namespace: string, key: string): Promise<boolean>;
+    /** List every entry in a namespace (tenant-wide). */
+    list(namespace: string): Promise<MemoryEntry[]>;
+}
 export interface Kee {
     tenantId: string;
     scopes: string[];
@@ -27,6 +54,7 @@ export interface Kee {
         /** Explicit accessor (equivalent to kee.connections[provider]). */
         get(provider: string): KeeConnection;
     };
+    memory: KeeMemory;
 }
 /**
  * Build a tenant-scoped capability client from a tool's context. Call inside a

package/dist/client.js

@@ -32,16 +32,17 @@ function coreBaseUrl() {
         return jwks.replace(/\/\.well-known\/jwks\.json\/?$/, '');
     throw keeError('KEE_CORE_URL (or KEE_CORE_JWKS_URL) must be set to reach the Capability API');
 }
-async function capabilityFetch(grant, path, body) {
+async function capabilityFetch(grant, path, body, method = 'POST') {
     const url = `${coreBaseUrl()}/api/capability/${path}`;
+    const hasBody = method !== 'GET' && method !== 'DELETE';
     const res = await fetch(url, {
-        method: 'POST',
+        method,
         headers: {
-            'content-type': 'application/json',
+            ...(hasBody ? { 'content-type': 'application/json' } : {}),
             authorization: `Bearer ${grant.token}`,
             ...(grant.traceId ? { 'x-keemakr-trace-id': grant.traceId } : {}),
         },
-        body: JSON.stringify(body ?? {}),
+        ...(hasBody ? { body: JSON.stringify(body ?? {}) } : {}),
     });
     const json = (await res.json().catch(() => ({})));
     if (!res.ok) {
@@ -74,5 +75,35 @@ export function useKee(ctx) {
             return connectionFor(prop);
         },
     });
-    return { tenantId: grant.tenantId, scopes: grant.scopes, connections };
+    const enc = encodeURIComponent;
+    const memory = {
+        async getEntry(namespace, key) {
+            try {
+                const json = (await capabilityFetch(grant, `memory/${enc(namespace)}/${enc(key)}`, undefined, 'GET'));
+                return json.entry ?? null;
+            }
+            catch (e) {
+                if (e.status === 404)
+                    return null;
+                throw e;
+            }
+        },
+        async get(namespace, key) {
+            const entry = await this.getEntry(namespace, key);
+            return entry ? entry.value : null;
+        },
+        async set(namespace, key, value) {
+            const json = (await capabilityFetch(grant, `memory/${enc(namespace)}/${enc(key)}`, { value }, 'PUT'));
+            return json.entry;
+        },
+        async delete(namespace, key) {
+            const json = (await capabilityFetch(grant, `memory/${enc(namespace)}/${enc(key)}`, undefined, 'DELETE'));
+            return !!json.deleted;
+        },
+        async list(namespace) {
+            const json = (await capabilityFetch(grant, `memory/${enc(namespace)}`, undefined, 'GET'));
+            return json.entries ?? [];
+        },
+    };
+    return { tenantId: grant.tenantId, scopes: grant.scopes, connections, memory };
 }

package/dist/index.d.ts

@@ -1,2 +1,2 @@
 export { grantAuth } from './grant-auth.js';
-export { useKee, type Kee, type KeeConnection, type KeeContext, type KeeError } from './client.js';
+export { useKee, type Kee, type KeeConnection, type KeeContext, type KeeError, type KeeMemory, type MemoryEntry, } from './client.js';

package/dist/index.js

@@ -9,4 +9,4 @@
 //   const kee = useKee(ctx);
 //   const r = await kee.connections.hunter.call('email-finder', { domain, first_name, last_name });
 export { grantAuth } from './grant-auth.js';
-export { useKee } from './client.js';
+export { useKee, } from './client.js';

package/package.json

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