@anuma/sdk 6.43.1 → 6.44.0

package/dist/expo/index.cjs

@@ -21533,6 +21533,7 @@ var MAX_BATCH = 50;
 var MAX_QUERY_IDS = 1e3;
 var MAX_QUERY_TOPICS = 100;
 var MAX_QUERY_FILTER = 20;
+var GRAPH_LANE_ROWS = 256;
 var RemoteMemoryPartialCreateError = class extends Error {
   constructor(created, cause) {
     super(`createMany stored ${created.length} memories before a batch failed`);
@@ -21628,7 +21629,11 @@ function createRemoteMemoryStore(options) {
   const { persistence, embeddingOptions } = options;
   const model = embeddingOptions.model ?? DEFAULT_API_EMBEDDING_MODEL;
   const pollIntervalMs = options.pollIntervalMs ?? 6e4;
-  const pipeline = createRemoteMemoryPipeline(options);
+  const pipeline = createRemoteMemoryPipeline({
+    ...options,
+    graphRanking: options.graphRanking ?? ((query, _traverse, recallOptions) => topicGraphRanking(query, recallOptions)),
+    temporalRanking: options.temporalRanking ?? (() => Promise.resolve([]))
+  });
   const subscribers = /* @__PURE__ */ new Set();
   const seen = /* @__PURE__ */ new Map();
   let timer;
@@ -21660,6 +21665,36 @@ function createRemoteMemoryStore(options) {
   const decrypted = (options2) => persistence.query(options2);
   const metadata2 = (options2) => persistence.queryMetadata(options2);
   const enumerate = (filters, max = Infinity) => pages(decrypted, filters, max);
+  const memoriesByTopics = async (names) => {
+    const wanted = new Set(names.map(normalizeEntityName).filter(Boolean));
+    const out = /* @__PURE__ */ new Map();
+    const pages2 = await Promise.all(
+      chunks2([...wanted], MAX_QUERY_TOPICS).map((topics) => enumerate({ topics }))
+    );
+    for (const { memory } of pages2.flat()) {
+      const matched = [...canonicalTopics(memory)].filter((name) => wanted.has(name));
+      if (matched.length) out.set(memory.memory_id, new Set(matched));
+    }
+    return out;
+  };
+  const topicGraphRanking = async (query, recallOptions = {}) => {
+    const wanted = new Set(extractQueryEntities(query).map(normalizeEntityName).filter(Boolean));
+    if (wanted.size === 0 || recallOptions.memoryIds?.length === 0) return [];
+    const rows = await pages(
+      metadata2,
+      {
+        topics: [...wanted].slice(0, MAX_QUERY_TOPICS),
+        ...recallOptions.scopes && { scopes: recallOptions.scopes },
+        ...recallOptions.factTypes && { fact_types: recallOptions.factTypes },
+        ...recallOptions.memoryIds && { memory_ids: recallOptions.memoryIds }
+      },
+      GRAPH_LANE_ROWS
+    );
+    return rows.map(({ memory }) => ({
+      memoryId: memory.memory_id,
+      matched: [...canonicalTopics(memory)].filter((name) => wanted.has(name)).length
+    })).filter((row) => row.matched > 0).sort((a, b) => b.matched - a.matched).slice(0, NODE_BUDGET).map((row) => row.memoryId);
+  };
   const enumerateIds = async (read, ids, filters) => (await Promise.all(
     chunks2([...new Set(ids)], MAX_QUERY_IDS).map(
       (memory_ids) => pages(read, { ...filters, memory_ids })
@@ -22100,18 +22135,7 @@ function createRemoteMemoryStore(options) {
     listArchived: async () => (await enumerate({ archived_only: true, order: "archived", include_embeddings: true })).map(
       (record2) => stored(record2.memory)
     ),
-    memoriesByTopics: async (names) => {
-      const wanted = new Set(names.map(normalizeEntityName).filter(Boolean));
-      const out = /* @__PURE__ */ new Map();
-      const pages2 = await Promise.all(
-        chunks2([...wanted], MAX_QUERY_TOPICS).map((topics) => enumerate({ topics }))
-      );
-      for (const { memory } of pages2.flat()) {
-        const matched = [...canonicalTopics(memory)].filter((name) => wanted.has(name));
-        if (matched.length) out.set(memory.memory_id, new Set(matched));
-      }
-      return out;
-    },
+    memoriesByTopics,
     topicsByMemories: async (memoryIds) => {
       const out = /* @__PURE__ */ new Map();
       for (const { memory } of await enumerateIds(decrypted, memoryIds, {

package/dist/expo/index.d.mts

@@ -9793,8 +9793,10 @@ declare function createRemoteMemoryPipeline(options: RemoteMemoryPipelineOptions
 interface RemoteMemoryStoreOptions {
     persistence: RemoteMemoryPersistence;
     embeddingOptions: EmbeddingOptions;
-    graphRanking: RecallFactSource["graphRanking"];
-    temporalRanking: RecallFactSource["temporalRanking"];
+    /** Defaults to ranking memories by how many query entities their topics name. */
+    graphRanking?: RecallFactSource["graphRanking"];
+    /** Defaults to no temporal lane: nearby has no event-time filter yet. */
+    temporalRanking?: RecallFactSource["temporalRanking"];
     pollIntervalMs?: number;
 }
 declare class RemoteMemoryPartialCreateError extends Error {

package/dist/expo/index.d.ts

@@ -9793,8 +9793,10 @@ declare function createRemoteMemoryPipeline(options: RemoteMemoryPipelineOptions
 interface RemoteMemoryStoreOptions {
     persistence: RemoteMemoryPersistence;
     embeddingOptions: EmbeddingOptions;
-    graphRanking: RecallFactSource["graphRanking"];
-    temporalRanking: RecallFactSource["temporalRanking"];
+    /** Defaults to ranking memories by how many query entities their topics name. */
+    graphRanking?: RecallFactSource["graphRanking"];
+    /** Defaults to no temporal lane: nearby has no event-time filter yet. */
+    temporalRanking?: RecallFactSource["temporalRanking"];
     pollIntervalMs?: number;
 }
 declare class RemoteMemoryPartialCreateError extends Error {

package/dist/expo/index.mjs

@@ -19896,6 +19896,7 @@ var MAX_BATCH = 50;
 var MAX_QUERY_IDS = 1e3;
 var MAX_QUERY_TOPICS = 100;
 var MAX_QUERY_FILTER = 20;
+var GRAPH_LANE_ROWS = 256;
 var RemoteMemoryPartialCreateError = class extends Error {
   constructor(created, cause) {
     super(`createMany stored ${created.length} memories before a batch failed`);
@@ -19991,7 +19992,11 @@ function createRemoteMemoryStore(options) {
   const { persistence, embeddingOptions } = options;
   const model = embeddingOptions.model ?? DEFAULT_API_EMBEDDING_MODEL;
   const pollIntervalMs = options.pollIntervalMs ?? 6e4;
-  const pipeline = createRemoteMemoryPipeline(options);
+  const pipeline = createRemoteMemoryPipeline({
+    ...options,
+    graphRanking: options.graphRanking ?? ((query, _traverse, recallOptions) => topicGraphRanking(query, recallOptions)),
+    temporalRanking: options.temporalRanking ?? (() => Promise.resolve([]))
+  });
   const subscribers = /* @__PURE__ */ new Set();
   const seen = /* @__PURE__ */ new Map();
   let timer;
@@ -20023,6 +20028,36 @@ function createRemoteMemoryStore(options) {
   const decrypted = (options2) => persistence.query(options2);
   const metadata2 = (options2) => persistence.queryMetadata(options2);
   const enumerate = (filters, max = Infinity) => pages(decrypted, filters, max);
+  const memoriesByTopics = async (names) => {
+    const wanted = new Set(names.map(normalizeEntityName).filter(Boolean));
+    const out = /* @__PURE__ */ new Map();
+    const pages2 = await Promise.all(
+      chunks2([...wanted], MAX_QUERY_TOPICS).map((topics) => enumerate({ topics }))
+    );
+    for (const { memory } of pages2.flat()) {
+      const matched = [...canonicalTopics(memory)].filter((name) => wanted.has(name));
+      if (matched.length) out.set(memory.memory_id, new Set(matched));
+    }
+    return out;
+  };
+  const topicGraphRanking = async (query, recallOptions = {}) => {
+    const wanted = new Set(extractQueryEntities(query).map(normalizeEntityName).filter(Boolean));
+    if (wanted.size === 0 || recallOptions.memoryIds?.length === 0) return [];
+    const rows = await pages(
+      metadata2,
+      {
+        topics: [...wanted].slice(0, MAX_QUERY_TOPICS),
+        ...recallOptions.scopes && { scopes: recallOptions.scopes },
+        ...recallOptions.factTypes && { fact_types: recallOptions.factTypes },
+        ...recallOptions.memoryIds && { memory_ids: recallOptions.memoryIds }
+      },
+      GRAPH_LANE_ROWS
+    );
+    return rows.map(({ memory }) => ({
+      memoryId: memory.memory_id,
+      matched: [...canonicalTopics(memory)].filter((name) => wanted.has(name)).length
+    })).filter((row) => row.matched > 0).sort((a, b) => b.matched - a.matched).slice(0, NODE_BUDGET).map((row) => row.memoryId);
+  };
   const enumerateIds = async (read, ids, filters) => (await Promise.all(
     chunks2([...new Set(ids)], MAX_QUERY_IDS).map(
       (memory_ids) => pages(read, { ...filters, memory_ids })
@@ -20463,18 +20498,7 @@ function createRemoteMemoryStore(options) {
     listArchived: async () => (await enumerate({ archived_only: true, order: "archived", include_embeddings: true })).map(
       (record2) => stored(record2.memory)
     ),
-    memoriesByTopics: async (names) => {
-      const wanted = new Set(names.map(normalizeEntityName).filter(Boolean));
-      const out = /* @__PURE__ */ new Map();
-      const pages2 = await Promise.all(
-        chunks2([...wanted], MAX_QUERY_TOPICS).map((topics) => enumerate({ topics }))
-      );
-      for (const { memory } of pages2.flat()) {
-        const matched = [...canonicalTopics(memory)].filter((name) => wanted.has(name));
-        if (matched.length) out.set(memory.memory_id, new Set(matched));
-      }
-      return out;
-    },
+    memoriesByTopics,
     topicsByMemories: async (memoryIds) => {
       const out = /* @__PURE__ */ new Map();
       for (const { memory } of await enumerateIds(decrypted, memoryIds, {

package/dist/react/index.cjs

@@ -24906,6 +24906,7 @@ var MAX_BATCH = 50;
 var MAX_QUERY_IDS = 1e3;
 var MAX_QUERY_TOPICS = 100;
 var MAX_QUERY_FILTER = 20;
+var GRAPH_LANE_ROWS = 256;
 var RemoteMemoryPartialCreateError = class extends Error {
   constructor(created, cause) {
     super(`createMany stored ${created.length} memories before a batch failed`);
@@ -25001,7 +25002,11 @@ function createRemoteMemoryStore(options) {
   const { persistence, embeddingOptions } = options;
   const model = embeddingOptions.model ?? DEFAULT_API_EMBEDDING_MODEL;
   const pollIntervalMs = options.pollIntervalMs ?? 6e4;
-  const pipeline = createRemoteMemoryPipeline(options);
+  const pipeline = createRemoteMemoryPipeline({
+    ...options,
+    graphRanking: options.graphRanking ?? ((query, _traverse, recallOptions) => topicGraphRanking(query, recallOptions)),
+    temporalRanking: options.temporalRanking ?? (() => Promise.resolve([]))
+  });
   const subscribers = /* @__PURE__ */ new Set();
   const seen = /* @__PURE__ */ new Map();
   let timer;
@@ -25033,6 +25038,36 @@ function createRemoteMemoryStore(options) {
   const decrypted = (options2) => persistence.query(options2);
   const metadata2 = (options2) => persistence.queryMetadata(options2);
   const enumerate = (filters, max = Infinity) => pages(decrypted, filters, max);
+  const memoriesByTopics = async (names) => {
+    const wanted = new Set(names.map(normalizeEntityName).filter(Boolean));
+    const out = /* @__PURE__ */ new Map();
+    const pages2 = await Promise.all(
+      chunks2([...wanted], MAX_QUERY_TOPICS).map((topics) => enumerate({ topics }))
+    );
+    for (const { memory } of pages2.flat()) {
+      const matched = [...canonicalTopics(memory)].filter((name) => wanted.has(name));
+      if (matched.length) out.set(memory.memory_id, new Set(matched));
+    }
+    return out;
+  };
+  const topicGraphRanking = async (query, recallOptions = {}) => {
+    const wanted = new Set(extractQueryEntities(query).map(normalizeEntityName).filter(Boolean));
+    if (wanted.size === 0 || recallOptions.memoryIds?.length === 0) return [];
+    const rows = await pages(
+      metadata2,
+      {
+        topics: [...wanted].slice(0, MAX_QUERY_TOPICS),
+        ...recallOptions.scopes && { scopes: recallOptions.scopes },
+        ...recallOptions.factTypes && { fact_types: recallOptions.factTypes },
+        ...recallOptions.memoryIds && { memory_ids: recallOptions.memoryIds }
+      },
+      GRAPH_LANE_ROWS
+    );
+    return rows.map(({ memory }) => ({
+      memoryId: memory.memory_id,
+      matched: [...canonicalTopics(memory)].filter((name) => wanted.has(name)).length
+    })).filter((row) => row.matched > 0).sort((a, b) => b.matched - a.matched).slice(0, NODE_BUDGET).map((row) => row.memoryId);
+  };
   const enumerateIds = async (read, ids, filters) => (await Promise.all(
     chunks2([...new Set(ids)], MAX_QUERY_IDS).map(
       (memory_ids) => pages(read, { ...filters, memory_ids })
@@ -25473,18 +25508,7 @@ function createRemoteMemoryStore(options) {
     listArchived: async () => (await enumerate({ archived_only: true, order: "archived", include_embeddings: true })).map(
       (record2) => stored(record2.memory)
     ),
-    memoriesByTopics: async (names) => {
-      const wanted = new Set(names.map(normalizeEntityName).filter(Boolean));
-      const out = /* @__PURE__ */ new Map();
-      const pages2 = await Promise.all(
-        chunks2([...wanted], MAX_QUERY_TOPICS).map((topics) => enumerate({ topics }))
-      );
-      for (const { memory } of pages2.flat()) {
-        const matched = [...canonicalTopics(memory)].filter((name) => wanted.has(name));
-        if (matched.length) out.set(memory.memory_id, new Set(matched));
-      }
-      return out;
-    },
+    memoriesByTopics,
     topicsByMemories: async (memoryIds) => {
       const out = /* @__PURE__ */ new Map();
       for (const { memory } of await enumerateIds(decrypted, memoryIds, {

package/dist/react/index.d.mts

@@ -12029,8 +12029,10 @@ declare function createRemoteMemoryPipeline(options: RemoteMemoryPipelineOptions
 interface RemoteMemoryStoreOptions {
     persistence: RemoteMemoryPersistence;
     embeddingOptions: EmbeddingOptions;
-    graphRanking: RecallFactSource["graphRanking"];
-    temporalRanking: RecallFactSource["temporalRanking"];
+    /** Defaults to ranking memories by how many query entities their topics name. */
+    graphRanking?: RecallFactSource["graphRanking"];
+    /** Defaults to no temporal lane: nearby has no event-time filter yet. */
+    temporalRanking?: RecallFactSource["temporalRanking"];
     pollIntervalMs?: number;
 }
 declare class RemoteMemoryPartialCreateError extends Error {

package/dist/react/index.d.ts

@@ -12029,8 +12029,10 @@ declare function createRemoteMemoryPipeline(options: RemoteMemoryPipelineOptions
 interface RemoteMemoryStoreOptions {
     persistence: RemoteMemoryPersistence;
     embeddingOptions: EmbeddingOptions;
-    graphRanking: RecallFactSource["graphRanking"];
-    temporalRanking: RecallFactSource["temporalRanking"];
+    /** Defaults to ranking memories by how many query entities their topics name. */
+    graphRanking?: RecallFactSource["graphRanking"];
+    /** Defaults to no temporal lane: nearby has no event-time filter yet. */
+    temporalRanking?: RecallFactSource["temporalRanking"];
     pollIntervalMs?: number;
 }
 declare class RemoteMemoryPartialCreateError extends Error {

package/dist/react/index.mjs

@@ -22998,6 +22998,7 @@ var MAX_BATCH = 50;
 var MAX_QUERY_IDS = 1e3;
 var MAX_QUERY_TOPICS = 100;
 var MAX_QUERY_FILTER = 20;
+var GRAPH_LANE_ROWS = 256;
 var RemoteMemoryPartialCreateError = class extends Error {
   constructor(created, cause) {
     super(`createMany stored ${created.length} memories before a batch failed`);
@@ -23093,7 +23094,11 @@ function createRemoteMemoryStore(options) {
   const { persistence, embeddingOptions } = options;
   const model = embeddingOptions.model ?? DEFAULT_API_EMBEDDING_MODEL;
   const pollIntervalMs = options.pollIntervalMs ?? 6e4;
-  const pipeline = createRemoteMemoryPipeline(options);
+  const pipeline = createRemoteMemoryPipeline({
+    ...options,
+    graphRanking: options.graphRanking ?? ((query, _traverse, recallOptions) => topicGraphRanking(query, recallOptions)),
+    temporalRanking: options.temporalRanking ?? (() => Promise.resolve([]))
+  });
   const subscribers = /* @__PURE__ */ new Set();
   const seen = /* @__PURE__ */ new Map();
   let timer;
@@ -23125,6 +23130,36 @@ function createRemoteMemoryStore(options) {
   const decrypted = (options2) => persistence.query(options2);
   const metadata2 = (options2) => persistence.queryMetadata(options2);
   const enumerate = (filters, max = Infinity) => pages(decrypted, filters, max);
+  const memoriesByTopics = async (names) => {
+    const wanted = new Set(names.map(normalizeEntityName).filter(Boolean));
+    const out = /* @__PURE__ */ new Map();
+    const pages2 = await Promise.all(
+      chunks2([...wanted], MAX_QUERY_TOPICS).map((topics) => enumerate({ topics }))
+    );
+    for (const { memory } of pages2.flat()) {
+      const matched = [...canonicalTopics(memory)].filter((name) => wanted.has(name));
+      if (matched.length) out.set(memory.memory_id, new Set(matched));
+    }
+    return out;
+  };
+  const topicGraphRanking = async (query, recallOptions = {}) => {
+    const wanted = new Set(extractQueryEntities(query).map(normalizeEntityName).filter(Boolean));
+    if (wanted.size === 0 || recallOptions.memoryIds?.length === 0) return [];
+    const rows = await pages(
+      metadata2,
+      {
+        topics: [...wanted].slice(0, MAX_QUERY_TOPICS),
+        ...recallOptions.scopes && { scopes: recallOptions.scopes },
+        ...recallOptions.factTypes && { fact_types: recallOptions.factTypes },
+        ...recallOptions.memoryIds && { memory_ids: recallOptions.memoryIds }
+      },
+      GRAPH_LANE_ROWS
+    );
+    return rows.map(({ memory }) => ({
+      memoryId: memory.memory_id,
+      matched: [...canonicalTopics(memory)].filter((name) => wanted.has(name)).length
+    })).filter((row) => row.matched > 0).sort((a, b) => b.matched - a.matched).slice(0, NODE_BUDGET).map((row) => row.memoryId);
+  };
   const enumerateIds = async (read, ids, filters) => (await Promise.all(
     chunks2([...new Set(ids)], MAX_QUERY_IDS).map(
       (memory_ids) => pages(read, { ...filters, memory_ids })
@@ -23565,18 +23600,7 @@ function createRemoteMemoryStore(options) {
     listArchived: async () => (await enumerate({ archived_only: true, order: "archived", include_embeddings: true })).map(
       (record2) => stored(record2.memory)
     ),
-    memoriesByTopics: async (names) => {
-      const wanted = new Set(names.map(normalizeEntityName).filter(Boolean));
-      const out = /* @__PURE__ */ new Map();
-      const pages2 = await Promise.all(
-        chunks2([...wanted], MAX_QUERY_TOPICS).map((topics) => enumerate({ topics }))
-      );
-      for (const { memory } of pages2.flat()) {
-        const matched = [...canonicalTopics(memory)].filter((name) => wanted.has(name));
-        if (matched.length) out.set(memory.memory_id, new Set(matched));
-      }
-      return out;
-    },
+    memoriesByTopics,
     topicsByMemories: async (memoryIds) => {
       const out = /* @__PURE__ */ new Map();
       for (const { memory } of await enumerateIds(decrypted, memoryIds, {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@anuma/sdk",
-  "version": "6.43.1",
+  "version": "6.44.0",
   "description": "",
   "main": "./dist/index.cjs",
   "module": "./dist/index.mjs",