@pentatonic-ai/ai-agent-sdk 0.7.8 → 0.7.9

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pentatonic-ai/ai-agent-sdk",
-  "version": "0.7.8",
+  "version": "0.7.9",
   "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/src/ingest.js

@@ -41,6 +41,18 @@ import { distill } from "./distill.js";
  *   ids) — pass the raw form here so retries of the same logical event
  *   match across runs whose prefixes differ by a few ms. Defaults to
  *   `content`.
+ * @param {"client" | "user"} [opts.dedupScope="client"] - Scope of the
+ *   dedup match. Default `"client"`: byte-equal content for the tenant
+ *   collapses to one row regardless of who emitted it (today's behaviour,
+ *   appropriate when each row is single-owner). Set `"user"` to also
+ *   require `user_id` equality, which lets multiple users legitimately
+ *   own their own copy of the same shared content (private chat-channel
+ *   members, group meeting attendees) — emit one ingest per member with
+ *   the same content but different `userId`, all with
+ *   `dedupScope: "user"`, and each user gets their own row with native
+ *   per-user access counting / recency / decay. Requires `userId` to be
+ *   set; when `userId` is null the option degrades to `"client"` scope
+ *   (a global shared row still collapses cross-emit).
  * @param {number} [opts.dedupLegacyWindowDays=7] - How far back the
  *   `[<iso>] <content>` legacy-form `LIKE` match scans. Default 7 days.
  *   The leading-wildcard `LIKE` can't use a btree index, so without a
@@ -94,6 +106,11 @@ export async function ingest(db, ai, llm, content, opts = {}) {
       opts.dedupLegacyWindowDays === undefined
         ? 7
         : Number(opts.dedupLegacyWindowDays);
+    // Per-user dedup requires `userId`; degrade to client-scope otherwise so
+    // a misuse can't accidentally relax the dedup boundary (we'd rather over-
+    // collapse than fragment the corpus on a missing userId).
+    const userScopedDedup = opts.dedupScope === "user" && !!opts.userId;
+    const userClause = userScopedDedup ? ` AND user_id = $4` : "";
     try {
       const sql =
         legacyWindowDays > 0
@@ -107,17 +124,18 @@ export async function ingest(db, ai, llm, content, opts = {}) {
                     content LIKE '%] ' || $2
                     AND created_at > NOW() - ($3 || ' days')::interval
                   )
-                )
+                )${userScopedDedup ? "\n                AND user_id = $4" : ""}
               LIMIT 1`
           : `SELECT id, 'exact' AS match_kind
                FROM memory_nodes
               WHERE client_id = $1
-                AND content = $2
+                AND content = $2${userClause}
               LIMIT 1`;
-      const params =
+      const baseParams =
         legacyWindowDays > 0
           ? [clientId, dedupKey, String(legacyWindowDays)]
           : [clientId, dedupKey];
+      const params = userScopedDedup ? [...baseParams, opts.userId] : baseParams;
       const dupCheck = await db(sql, params);
       if (dupCheck.rows?.length) {
         const matchKind = dupCheck.rows[0].match_kind || "exact";