@pentatonic-ai/ai-agent-sdk 0.10.20 → 0.10.21

package/dist/index.cjs

@@ -878,7 +878,7 @@ function fireAndForgetEmit(clientConfig, sessionOpts, messages, result, model) {
 }
 
 // src/telemetry.js
-var VERSION = "0.10.20";
+var VERSION = "0.10.21";
 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";

package/dist/index.js

@@ -847,7 +847,7 @@ function fireAndForgetEmit(clientConfig, sessionOpts, messages, result, model) {
 }
 
 // src/telemetry.js
-var VERSION = "0.10.20";
+var VERSION = "0.10.21";
 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";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pentatonic-ai/ai-agent-sdk",
-  "version": "0.10.20",
+  "version": "0.10.21",
   "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",

package/packages/memory-engine-v2/compat/server.py

@@ -913,6 +913,34 @@ def _resolve_arenas(req: GraphQueryRequest) -> list[str]:
     return arenas
 
 
+# Decay access signal (RFC-decay-and-fusion Part B1): the Fusion Drive decay pass
+# ages salience by the most recent of (last_accessed, last_seen/asserted_at), so
+# without an access bump a frequently-retrieved memory still decays and can be
+# evicted. Bump last_accessed on the nodes a read returns so retrieval keeps them
+# alive. THROTTLED to once / _ACCESS_BUMP_THROTTLE per node (the UPDATE no-ops for
+# nodes touched recently) to bound write amplification on these hot read paths,
+# and BEST-EFFORT — a bump failure must never fail the read. `table` is always a
+# trusted literal (never user input).
+_ACCESS_BUMP_THROTTLE = "6 hours"
+
+
+async def _bump_last_accessed(conn, cur, table: str, ids: list[str]) -> None:
+    ids = [i for i in ids if i]
+    if not ids:
+        return
+    try:
+        await cur.execute(
+            f"UPDATE {table} SET last_accessed = NOW() "
+            f"WHERE id = ANY(%s) AND (last_accessed IS NULL "
+            f"OR last_accessed < NOW() - interval '{_ACCESS_BUMP_THROTTLE}')",
+            (ids,),
+        )
+        await conn.commit()
+    except Exception as e:  # noqa: BLE001 — never let the access bump break a read
+        await conn.rollback()
+        log.warning("last_accessed bump failed on %s: %s", table, e)
+
+
 @app.post("/entities")
 async def list_entities(req: GraphQueryRequest):
     """Filter entities by arena + optional type + optional name pattern.
@@ -930,10 +958,10 @@ async def list_entities(req: GraphQueryRequest):
         params.extend([pattern, pattern])
     sql = f"""
         SELECT id, arena, entity_type, canonical_name, aliases,
-               provenance_event_ids, attributes, last_seen
+               provenance_event_ids, attributes, salience, last_seen
           FROM entities
          WHERE {' AND '.join(conditions)}
-      ORDER BY last_seen DESC
+      ORDER BY salience DESC, last_seen DESC
          LIMIT %s
     """
     params.append(req.limit)
@@ -941,6 +969,7 @@ async def list_entities(req: GraphQueryRequest):
         async with conn.cursor() as cur:
             await cur.execute(sql, params)
             rows = await cur.fetchall()
+            await _bump_last_accessed(conn, cur, "entities", [r["id"] for r in rows])
     return {"results": [dict(r) for r in rows]}
 
 
@@ -977,10 +1006,10 @@ async def list_facts(req: GraphQueryRequest):
         SELECT f.id, f.arena, f.category, f.predicate, f.statement,
                f.subject_entity_id, f.object_entity_id,
                f.confidence, f.stage, f.asserted_at,
-               f.provenance_event_ids
+               f.salience, f.provenance_event_ids
           FROM facts f
          WHERE {' AND '.join(conditions)}
-      ORDER BY f.asserted_at DESC
+      ORDER BY f.salience DESC, f.asserted_at DESC
          LIMIT %s
     """
     params.append(req.limit)
@@ -988,6 +1017,7 @@ async def list_facts(req: GraphQueryRequest):
         async with conn.cursor() as cur:
             await cur.execute(sql, params)
             rows = await cur.fetchall()
+            await _bump_last_accessed(conn, cur, "facts", [r["id"] for r in rows])
     return {"results": [dict(r) for r in rows]}
 
 
@@ -1013,13 +1043,13 @@ async def list_relationships(req: GraphQueryRequest):
                r.from_entity_id, r.to_entity_id,
                ef.canonical_name AS from_name,
                et.canonical_name AS to_name,
-               r.first_seen, r.last_seen,
+               r.first_seen, r.last_seen, r.salience,
                r.provenance_event_ids
           FROM relationships r
           JOIN entities ef ON ef.id = r.from_entity_id
           JOIN entities et ON et.id = r.to_entity_id
          WHERE {' AND '.join(conditions)}
-      ORDER BY r.last_seen DESC
+      ORDER BY r.salience DESC, r.last_seen DESC
          LIMIT %s
     """
     params.append(req.limit)
@@ -1027,6 +1057,7 @@ async def list_relationships(req: GraphQueryRequest):
         async with conn.cursor() as cur:
             await cur.execute(sql, params)
             rows = await cur.fetchall()
+            await _bump_last_accessed(conn, cur, "relationships", [r["id"] for r in rows])
     return {"results": [dict(r) for r in rows]}