@remnic/core 9.3.551 → 9.3.553

package/dist/{chunk-IC4GELZE.js → chunk-NINRTFSV.js}

@@ -6,7 +6,7 @@ import {
   canReadNamespace,
   defaultNamespaceForPrincipal,
   resolvePrincipal
-} from "./chunk-HWVTS5NO.js";
+} from "./chunk-UZYLX7M6.js";
 
 // src/active-memory-bridge.ts
 function isArtifactPath(value) {
@@ -46,6 +46,9 @@ function resolveActiveMemoryNamespace(orchestrator, sessionKey, requestedNamespa
     return "default";
   }
   const principal = typeof orchestrator.resolvePrincipal === "function" ? orchestrator.resolvePrincipal(sessionKey) : resolvePrincipal(sessionKey, config);
+  if (config.namespacesEnabled && !principal) {
+    throw new Error("authentication required: namespaces are enabled and no principal was supplied");
+  }
   if (explicitNamespace) {
     if (!canReadNamespace(principal, explicitNamespace, config)) {
       throw new Error(`namespace ${explicitNamespace} is not readable for principal ${principal}`);
@@ -118,4 +121,4 @@ export {
   recallForActiveMemory,
   getMemoryForActiveMemory
 };
-//# sourceMappingURL=chunk-IC4GELZE.js.map
+//# sourceMappingURL=chunk-NINRTFSV.js.map

package/dist/chunk-NINRTFSV.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/active-memory-bridge.ts"],"sourcesContent":["import { canReadNamespace, defaultNamespaceForPrincipal, resolvePrincipal } from \"./namespaces/principal.js\";\nimport type { MemoryFile, PluginConfig } from \"./types.js\";\nimport { collapseWhitespace, truncateCodePointSafe } from \"./whitespace.js\";\n\nexport interface ActiveMemoryMetadata {\n  type?: \"fact\" | \"preference\";\n  topic?: string;\n  updatedAt?: string;\n  sourceUri?: string;\n}\n\nexport interface ActiveMemorySearchResult {\n  id: string;\n  score: number;\n  text: string;\n  metadata?: ActiveMemoryMetadata;\n}\n\nexport interface ActiveMemorySearchOutput {\n  results: ActiveMemorySearchResult[];\n  truncated: boolean;\n}\n\nexport interface ActiveMemoryGetOutput {\n  id?: string;\n  text?: string;\n  metadata?: ActiveMemoryMetadata;\n  error?: \"not_found\";\n}\n\nexport interface ActiveMemoryRecallParams {\n  query: string;\n  limit?: number;\n  sessionKey: string;\n  filters?: Record<string, unknown>;\n  snippetMaxChars?: number;\n}\n\ninterface ActiveMemoryScopedOrchestrator {\n  config?: PluginConfig;\n  resolvePrincipal?: (sessionKey?: string) => string | undefined;\n  resolveSelfNamespace?: (sessionKey?: string) => string;\n}\n\ntype ActiveMemorySearchCandidate = {\n  id?: string;\n  score?: number;\n  snippet?: string;\n  text?: string;\n  path?: string;\n  metadata?: Record<string, unknown>;\n};\n\nfunction isArtifactPath(value: string | undefined): boolean {\n  return typeof value === \"string\" && /(?:^|[\\\\/])artifacts(?:[\\\\/]|$)/i.test(value);\n}\n\nfunction clampLimit(value: number | undefined): number {\n  if (typeof value !== \"number\" || !Number.isFinite(value)) return 8;\n  return Math.max(1, Math.min(50, Math.floor(value)));\n}\n\nfunction truncateSnippet(value: string, maxChars: number): string {\n  const compact = collapseWhitespace(value);\n  return truncateCodePointSafe(compact, maxChars);\n}\n\nfunction pickMetadata(value: Record<string, unknown> | undefined): ActiveMemoryMetadata | undefined {\n  if (!value) return undefined;\n  const metadata: ActiveMemoryMetadata = {};\n  if (typeof value.type === \"string\") metadata.type = value.type as ActiveMemoryMetadata[\"type\"];\n  if (typeof value.topic === \"string\") metadata.topic = value.topic;\n  if (typeof value.updatedAt === \"string\") metadata.updatedAt = value.updatedAt;\n  if (typeof value.sourceUri === \"string\") metadata.sourceUri = value.sourceUri;\n  return Object.keys(metadata).length > 0 ? metadata : undefined;\n}\n\nfunction resolveActiveMemoryNamespace(\n  orchestrator: ActiveMemoryScopedOrchestrator,\n  sessionKey: string | undefined,\n  requestedNamespace: string | undefined,\n): string {\n  const explicitNamespace =\n    typeof requestedNamespace === \"string\" && requestedNamespace.trim().length > 0\n      ? requestedNamespace.trim()\n      : undefined;\n  const config = orchestrator.config;\n\n  if (config?.namespacesEnabled === false) {\n    if (typeof orchestrator.resolveSelfNamespace === \"function\") {\n      return orchestrator.resolveSelfNamespace(sessionKey);\n    }\n    return \"default\";\n  }\n\n  if (!config) {\n    if (explicitNamespace) return explicitNamespace;\n    if (typeof orchestrator.resolveSelfNamespace === \"function\") {\n      return orchestrator.resolveSelfNamespace(sessionKey);\n    }\n    return \"default\";\n  }\n\n  const principal =\n    typeof orchestrator.resolvePrincipal === \"function\"\n      ? orchestrator.resolvePrincipal(sessionKey)\n      : resolvePrincipal(sessionKey, config);\n  if (config.namespacesEnabled && !principal) {\n    throw new Error(\"authentication required: namespaces are enabled and no principal was supplied\");\n  }\n  if (explicitNamespace) {\n    if (!canReadNamespace(principal, explicitNamespace, config)) {\n      throw new Error(`namespace ${explicitNamespace} is not readable for principal ${principal}`);\n    }\n    return explicitNamespace;\n  }\n  if (typeof orchestrator.resolveSelfNamespace === \"function\") {\n    return orchestrator.resolveSelfNamespace(sessionKey);\n  }\n  return defaultNamespaceForPrincipal(principal, config);\n}\n\nexport async function recallForActiveMemory(\n  orchestrator: {\n    config?: PluginConfig;\n    resolvePrincipal?: (sessionKey?: string) => string | undefined;\n    resolveSelfNamespace?: (sessionKey?: string) => string;\n    searchAcrossNamespaces: (params: {\n      query: string;\n      maxResults?: number;\n      namespaces?: string[];\n      mode?: string;\n    }) => Promise<ActiveMemorySearchCandidate[]>;\n  },\n  params: ActiveMemoryRecallParams,\n): Promise<ActiveMemorySearchOutput> {\n  const limit = clampLimit(params.limit);\n  const requestedResults = Math.min(200, limit + 20);\n  const snippetMaxChars =\n    typeof params.snippetMaxChars === \"number\" && Number.isFinite(params.snippetMaxChars)\n      ? Math.max(1, Math.min(4000, Math.floor(params.snippetMaxChars)))\n      : 600;\n  const namespace = resolveActiveMemoryNamespace(\n    orchestrator,\n    params.sessionKey,\n    typeof params.filters?.namespace === \"string\" ? params.filters.namespace : undefined,\n  );\n\n  const raw = await orchestrator.searchAcrossNamespaces({\n    query: params.query,\n    maxResults: requestedResults,\n    namespaces: [namespace],\n    mode: \"search\",\n  });\n  const visible = raw.filter((candidate) => !isArtifactPath(candidate.path));\n\n  return {\n    results: visible.slice(0, limit).map((candidate, index) => ({\n      id: candidate.id ?? candidate.path ?? `memory-${index + 1}`,\n      score: typeof candidate.score === \"number\" ? candidate.score : 0,\n      text: truncateSnippet(candidate.snippet ?? candidate.text ?? \"\", snippetMaxChars),\n      metadata: pickMetadata(candidate.metadata),\n    })),\n    truncated: visible.length > limit,\n  };\n}\n\nfunction buildActiveMemoryMetadataFromMemory(memory: MemoryFile): ActiveMemoryMetadata | undefined {\n  const metadata: ActiveMemoryMetadata = {};\n  if (typeof memory.frontmatter.category === \"string\") {\n    const category = memory.frontmatter.category;\n    if (category === \"fact\" || category === \"preference\") {\n      metadata.type = category;\n    }\n  }\n  if (Array.isArray(memory.frontmatter.tags) && memory.frontmatter.tags.length > 0) {\n    metadata.topic = memory.frontmatter.tags[0];\n  }\n  if (typeof memory.frontmatter.updated === \"string\") metadata.updatedAt = memory.frontmatter.updated;\n  if (typeof memory.frontmatter.source === \"string\") metadata.sourceUri = memory.frontmatter.source;\n  return Object.keys(metadata).length > 0 ? metadata : undefined;\n}\n\nexport async function getMemoryForActiveMemory(\n  orchestrator: {\n    config?: PluginConfig;\n    resolvePrincipal?: (sessionKey?: string) => string;\n    resolveSelfNamespace?: (sessionKey?: string) => string;\n    getStorageForNamespace?: (namespace: string) => Promise<{\n      getMemoryById?: (id: string) => Promise<MemoryFile | null>;\n    }>;\n    storage?: {\n      getMemoryById?: (id: string) => Promise<MemoryFile | null>;\n    };\n  },\n  id: string,\n  options: {\n    namespace?: string;\n    sessionKey?: string;\n  } = {},\n): Promise<ActiveMemoryGetOutput> {\n  const namespace = resolveActiveMemoryNamespace(\n    orchestrator,\n    options.sessionKey,\n    options.namespace,\n  );\n\n  const storage =\n    typeof orchestrator.getStorageForNamespace === \"function\"\n      ? await orchestrator.getStorageForNamespace(namespace)\n      : orchestrator.storage;\n\n  const memory = await storage?.getMemoryById?.(id);\n  if (!memory) return { error: \"not_found\" };\n  return {\n    id,\n    text: collapseWhitespace(memory.content),\n    metadata: buildActiveMemoryMetadataFromMemory(memory),\n  };\n}\n"],"mappings":"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","names":[]}

package/dist/{chunk-XDMLTNIG.js → chunk-NYV435HC.js}

@@ -369,7 +369,7 @@ import {
   defaultNamespaceForPrincipal,
   recallNamespacesForPrincipal,
   resolvePrincipal
-} from "./chunk-HWVTS5NO.js";
+} from "./chunk-UZYLX7M6.js";
 import {
   selectRouteRule
 } from "./chunk-U3PN77QT.js";
@@ -3999,6 +3999,10 @@ ${r.snippet.trim()}
     } else {
       options.abortSignal?.addEventListener("abort", onAbort, { once: true });
     }
+    const principal = typeof options.principalOverride === "string" && options.principalOverride.length > 0 ? options.principalOverride : resolvePrincipal(sessionKey, this.config);
+    if (this.config.namespacesEnabled && !principal) {
+      throw new Error("authentication required: namespaces are enabled and no principal was supplied");
+    }
     let initGateTimeoutHandle = null;
     let onInitGateAbort = null;
     if (this.initPromise) {
@@ -5148,6 +5152,9 @@ ${r.snippet.trim()}
       );
       const embeddingFetchLimit = computedFetchLimit;
       const principal = typeof options.principalOverride === "string" && options.principalOverride.length > 0 ? options.principalOverride : resolvePrincipal(sessionKey, this.config);
+      if (this.config.namespacesEnabled && !principal) {
+        throw new Error("authentication required: namespaces are enabled and no principal was supplied");
+      }
       const namespaceOverride = options.namespace?.trim() || void 0;
       const readableRecallNamespaces = recallNamespacesForPrincipal(
         principal,
@@ -12398,4 +12405,4 @@ export {
   resolvePersistedMemoryRelativePath,
   Orchestrator
 };
-//# sourceMappingURL=chunk-XDMLTNIG.js.map
+//# sourceMappingURL=chunk-NYV435HC.js.map