@remnic/core 9.7.15 → 9.9.0

package/dist/chunk-NINSR6LX.js

@@ -0,0 +1,83 @@
+import {
+  log
+} from "./chunk-3WCASNQZ.js";
+
+// src/access-citation.ts
+async function recordCitationUsage(deps, request) {
+  if (request.entries.length === 0) return { submitted: 0, matched: 0 };
+  const fallbackNamespace = deps.resolveNamespace(
+    request.namespace,
+    request.sessionId,
+    request.authenticatedPrincipal
+  );
+  const memoryEntries = (await Promise.all(
+    request.entries.map(async (entry) => {
+      const basename = entry.path.split(/[\\/]/).pop() ?? entry.path;
+      const id = basename.endsWith(".md") ? basename.slice(0, -3) : basename;
+      if (id.length === 0) return null;
+      const namespace = deps.resolveNamespaceForPath ? await deps.resolveNamespaceForPath(
+        entry.path,
+        fallbackNamespace,
+        request.sessionId,
+        request.authenticatedPrincipal
+      ) : fallbackNamespace;
+      const citedPath = namespace && entry.path.startsWith(`${namespace}/`) ? entry.path.slice(namespace.length + 1) : entry.path;
+      return { id, citedPath, namespace };
+    })
+  )).filter(
+    (entry) => entry !== null
+  );
+  if (memoryEntries.length === 0) return { submitted: 0, matched: 0 };
+  const matchedEntries = [];
+  const entriesByNamespace = /* @__PURE__ */ new Map();
+  for (const entry of memoryEntries) {
+    const entries = entriesByNamespace.get(entry.namespace) ?? [];
+    entries.push(entry);
+    entriesByNamespace.set(entry.namespace, entries);
+  }
+  for (const [namespace, namespaceEntries] of entriesByNamespace) {
+    const storage = await deps.getStorage(namespace);
+    const ids = [...new Set(namespaceEntries.map((entry) => entry.id))];
+    const preferredPaths = /* @__PURE__ */ new Map();
+    for (const entry of namespaceEntries) {
+      const paths = preferredPaths.get(entry.id) ?? [];
+      paths.push(entry.citedPath);
+      preferredPaths.set(entry.id, paths);
+    }
+    const pathsById = await storage.findExistingMemoryPaths(ids, preferredPaths);
+    const remainingPathsById = new Map(
+      Array.from(pathsById.entries()).map(([id, paths]) => [id, [...paths]])
+    );
+    for (const entry of namespaceEntries) {
+      const paths = remainingPathsById.get(entry.id);
+      if (!paths || paths.length === 0) continue;
+      const preferredIndex = paths.indexOf(entry.citedPath);
+      const pathIndex = preferredIndex >= 0 ? preferredIndex : 0;
+      const [memoryPath] = paths.splice(pathIndex, 1);
+      if (memoryPath) {
+        matchedEntries.push({
+          id: entry.id,
+          path: memoryPath,
+          namespace
+        });
+      }
+    }
+  }
+  if (matchedEntries.length > 0) {
+    try {
+      deps.trackMemoryAccess(
+        matchedEntries.map((entry) => entry.id),
+        matchedEntries.map((entry) => entry.path),
+        matchedEntries.map((entry) => entry.namespace)
+      );
+    } catch {
+      log.debug("citation usage tracking: failed to record access for cited memories");
+    }
+  }
+  return { submitted: memoryEntries.length, matched: matchedEntries.length };
+}
+
+export {
+  recordCitationUsage
+};
+//# sourceMappingURL=chunk-NINSR6LX.js.map

package/dist/chunk-NINSR6LX.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/access-citation.ts"],"sourcesContent":["import { log } from \"./logger.js\";\n\nexport interface CitationUsageRequest {\n  sessionId?: string;\n  namespace?: string;\n  authenticatedPrincipal?: string;\n  entries: Array<{ path: string; lineStart: number; lineEnd: number; note: string }>;\n  rolloutIds: string[];\n}\n\nexport interface CitationStorage {\n  findExistingMemoryPaths(\n    ids: string[],\n    preferredPaths?: Map<string, string[]>,\n  ): Promise<Map<string, string[]>>;\n}\n\nexport interface CitationUsageDependencies {\n  resolveNamespace: (\n    namespace: string | undefined,\n    sessionId: string | undefined,\n    authenticatedPrincipal: string | undefined,\n  ) => string;\n  resolveNamespaceForPath?: (\n    path: string,\n    fallbackNamespace: string,\n    sessionId: string | undefined,\n    authenticatedPrincipal: string | undefined,\n  ) => Promise<string>;\n  getStorage: (namespace: string) => Promise<CitationStorage>;\n  trackMemoryAccess: (\n    memoryIds: string[],\n    memoryPaths: string[],\n    memoryNamespaces?: Array<string | undefined>,\n  ) => void;\n}\n\nexport interface CitationUsageResult {\n  submitted: number;\n  matched: number;\n}\n\nexport async function recordCitationUsage(\n  deps: CitationUsageDependencies,\n  request: CitationUsageRequest,\n): Promise<CitationUsageResult> {\n  if (request.entries.length === 0) return { submitted: 0, matched: 0 };\n\n  const fallbackNamespace = deps.resolveNamespace(\n    request.namespace,\n    request.sessionId,\n    request.authenticatedPrincipal,\n  );\n  const memoryEntries = (await Promise.all(\n    request.entries.map(async (entry) => {\n      const basename = entry.path.split(/[\\\\/]/).pop() ?? entry.path;\n      const id = basename.endsWith(\".md\") ? basename.slice(0, -3) : basename;\n      if (id.length === 0) return null;\n      const namespace = deps.resolveNamespaceForPath\n        ? await deps.resolveNamespaceForPath(\n            entry.path,\n            fallbackNamespace,\n            request.sessionId,\n            request.authenticatedPrincipal,\n          )\n        : fallbackNamespace;\n      // Strip the resolved namespace prefix so citedPath is storage-relative for\n      // both preferred-path matching and the exact-match lookup below. Namespace\n      // names may contain \"/\", which the storage helper cannot strip alone (#2020).\n      const citedPath =\n        namespace && entry.path.startsWith(`${namespace}/`)\n          ? entry.path.slice(namespace.length + 1)\n          : entry.path;\n      return { id, citedPath, namespace };\n    }),\n  )).filter(\n    (\n      entry,\n    ): entry is { id: string; citedPath: string; namespace: string } =>\n      entry !== null,\n  );\n\n  if (memoryEntries.length === 0) return { submitted: 0, matched: 0 };\n\n  const matchedEntries: Array<{\n    id: string;\n    path: string;\n    namespace: string;\n  }> = [];\n  const entriesByNamespace = new Map<string, typeof memoryEntries>();\n  for (const entry of memoryEntries) {\n    const entries = entriesByNamespace.get(entry.namespace) ?? [];\n    entries.push(entry);\n    entriesByNamespace.set(entry.namespace, entries);\n  }\n\n  for (const [namespace, namespaceEntries] of entriesByNamespace) {\n    const storage = await deps.getStorage(namespace);\n    const ids = [...new Set(namespaceEntries.map((entry) => entry.id))];\n    const preferredPaths = new Map<string, string[]>();\n    for (const entry of namespaceEntries) {\n      const paths = preferredPaths.get(entry.id) ?? [];\n      paths.push(entry.citedPath);\n      preferredPaths.set(entry.id, paths);\n    }\n    const pathsById = await storage.findExistingMemoryPaths(ids, preferredPaths);\n    const remainingPathsById = new Map(\n      Array.from(pathsById.entries()).map(([id, paths]) => [id, [...paths]]),\n    );\n    for (const entry of namespaceEntries) {\n      const paths = remainingPathsById.get(entry.id);\n      if (!paths || paths.length === 0) continue;\n      const preferredIndex = paths.indexOf(entry.citedPath);\n      const pathIndex = preferredIndex >= 0 ? preferredIndex : 0;\n      const [memoryPath] = paths.splice(pathIndex, 1);\n      if (memoryPath) {\n        matchedEntries.push({\n          id: entry.id,\n          path: memoryPath,\n          namespace,\n        });\n      }\n    }\n  }\n\n  if (matchedEntries.length > 0) {\n    try {\n      deps.trackMemoryAccess(\n        matchedEntries.map((entry) => entry.id),\n        matchedEntries.map((entry) => entry.path),\n        matchedEntries.map((entry) => entry.namespace),\n      );\n    } catch {\n      log.debug(\"citation usage tracking: failed to record access for cited memories\");\n    }\n  }\n\n  return { submitted: memoryEntries.length, matched: matchedEntries.length };\n}\n"],"mappings":"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","names":[]}

package/dist/{chunk-MTWKDOVO.js → chunk-NLE6TSLG.js}

@@ -1,6 +1,6 @@
 import {
   log
-} from "./chunk-37CTGERM.js";
+} from "./chunk-3WCASNQZ.js";
 
 // src/profiling.ts
 import {
@@ -308,4 +308,4 @@ export {
   ProfilingCollector,
   formatProfileTraceAscii
 };
-//# sourceMappingURL=chunk-MTWKDOVO.js.map
+//# sourceMappingURL=chunk-NLE6TSLG.js.map

package/dist/{chunk-OAZVR2BV.js → chunk-OGCAYLNA.js}

@@ -1,20 +1,22 @@
 import {
   memoryStoreRequestSchema
-} from "./chunk-2MR3MFQB.js";
+} from "./chunk-2VEOKUPP.js";
 import {
   defineOperation
-} from "./chunk-BS4SGLWV.js";
+} from "./chunk-KF5EUVKQ.js";
 import {
   CorrectionContractError,
   DECISION_SUBCOMMANDS,
   DELTA_SUBCOMMANDS,
-  EngramAccessInputError,
   isCodegraphToolName
-} from "./chunk-LZOV7MX7.js";
+} from "./chunk-XQDRKZ7V.js";
 import {
   serializeMutations,
   withHeldFileLock
-} from "./chunk-LTJAMRGI.js";
+} from "./chunk-WL5EBRDH.js";
+import {
+  EngramAccessInputError
+} from "./chunk-2Z24E5W2.js";
 
 // src/access-operations.ts
 import { z as z3 } from "zod";
@@ -1805,4 +1807,4 @@ export {
   codegraphIngestTracesOperation,
   REGISTERED_OPERATIONS
 };
-//# sourceMappingURL=chunk-OAZVR2BV.js.map
+//# sourceMappingURL=chunk-OGCAYLNA.js.map