@remnic/core 9.54.5 → 9.54.7

package/dist/chunk-2PNXOQ4P.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/active-memory-bridge.ts"],"sourcesContent":["import { resolveNamespaceCapabilities } from \"./capabilities.js\";\nimport { canReadNamespace, defaultNamespaceForPrincipal, resolvePrincipal } from \"./namespaces/principal.js\";\nimport type { MemoryFile, PluginConfig, QmdSearchResult } from \"./types.js\";\nimport { collapseWhitespace, truncateCodePointSafe } from \"./whitespace.js\";\nimport { isHandleToken } from \"./recall-handles.js\";\nimport { isSupportPassportPrivateMemory } from \"./support-passport/card-projection.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  getStorageForNamespace?: (namespace: string) => Promise<{\n    readMemoryByPath?: (path: string) => Promise<MemoryFile | null>;\n    getMemoryById?: (id: string) => Promise<MemoryFile | null>;\n  }>;\n  filterPrivateSearchResults?: (\n    results: QmdSearchResult[],\n    namespaces?: readonly string[],\n    preserveUnresolved?: boolean,\n    visibilityCache?: Map<string, boolean>,\n  ) => Promise<QmdSearchResult[]>;\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\nasync function filterVisibleActiveMemoryCandidates(\n  orchestrator: ActiveMemoryScopedOrchestrator,\n  namespace: string,\n  storage: Awaited<ReturnType<NonNullable<ActiveMemoryScopedOrchestrator[\"getStorageForNamespace\"]>>> | undefined,\n  candidates: ActiveMemorySearchCandidate[],\n  visibilityCache?: Map<string, boolean>,\n): Promise<ActiveMemorySearchCandidate[]> {\n  const visible = new Set<ActiveMemorySearchCandidate>();\n  const pathCandidates = candidates.filter(\n    (candidate) => typeof candidate.path === \"string\" && !isArtifactPath(candidate.path),\n  );\n  if (pathCandidates.length > 0 && typeof orchestrator.filterPrivateSearchResults === \"function\") {\n    const qmdCandidates = pathCandidates.map((candidate): QmdSearchResult => ({\n      docid: candidate.id ?? candidate.path!,\n      path: candidate.path!,\n      snippet: candidate.snippet ?? candidate.text ?? \"\",\n      score: typeof candidate.score === \"number\" ? candidate.score : 0,\n      namespace,\n    }));\n    const filtered = await orchestrator.filterPrivateSearchResults(\n      qmdCandidates,\n      [namespace],\n      false,\n      visibilityCache,\n    );\n    const visibleKeys = new Set(filtered.map((candidate) => `${candidate.docid}\\0${candidate.path}`));\n    qmdCandidates.forEach((candidate, index) => {\n      if (visibleKeys.has(`${candidate.docid}\\0${candidate.path}`)) visible.add(pathCandidates[index]!);\n    });\n  }\n\n  const idCandidates = candidates.filter(\n    (candidate) => candidate.path === undefined && typeof candidate.id === \"string\",\n  );\n  if (storage) {\n    const idVisibility = await Promise.all(\n      idCandidates.map(async (candidate) => {\n        const memory = await storage.getMemoryById?.(candidate.id!);\n        return memory !== null && memory !== undefined && !isSupportPassportPrivateMemory(memory);\n      }),\n    );\n    idCandidates.forEach((candidate, index) => {\n      if (idVisibility[index]) visible.add(candidate);\n    });\n  }\n  return candidates.filter((candidate) => visible.has(candidate));\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 (resolveNamespaceCapabilities(config).namespaces && !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    getStorageForNamespace?: ActiveMemoryScopedOrchestrator[\"getStorageForNamespace\"];\n    filterPrivateSearchResults?: ActiveMemoryScopedOrchestrator[\"filterPrivateSearchResults\"];\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 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 storage = await orchestrator.getStorageForNamespace?.(namespace);\n  const candidateCap = 25_000;\n  let requestedResults = Math.min(candidateCap, limit + 20);\n  let raw: ActiveMemorySearchCandidate[] = [];\n  let visible: ActiveMemorySearchCandidate[] = [];\n  const privateVisibilityCache = new Map<string, boolean>();\n  for (;;) {\n    raw = await orchestrator.searchAcrossNamespaces({\n      query: params.query,\n      maxResults: requestedResults,\n      namespaces: [namespace],\n      mode: \"search\",\n    });\n    visible = await filterVisibleActiveMemoryCandidates(\n      orchestrator,\n      namespace,\n      storage,\n      raw,\n      privateVisibilityCache,\n    );\n    if (visible.length > limit || raw.length < requestedResults || requestedResults >= candidateCap) break;\n    requestedResults = Math.min(candidateCap, requestedResults * 2);\n  }\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 || (raw.length === requestedResults && requestedResults >= candidateCap),\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    /** Issue #1582 — resolves a `[m:xxxx]` handle to a memory id (orchestrator). */\n    resolveMemoryIdOrHandle?: (ref: string, sessionKey?: string) => string;\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  // Issue #1582 — resolve a `[m:xxxx]` handle to its memory id against the\n  // caller's session before the storage read, so OpenClaw active-memory agents\n  // can cite injected handles through the SAME shared path as memory_get /\n  // correction (cursor review). Raw ids pass through unchanged.\n  //\n  // A handle that misses, collides, or has no session key becomes not_found —\n  // the SAME behavior a bad raw id yields below — instead of throwing, so an\n  // active-memory caller gets a uniform not-found contract (cursor review).\n  let resolvedId = id;\n  if (isHandleToken(id) && typeof orchestrator.resolveMemoryIdOrHandle === \"function\") {\n    try {\n      resolvedId = orchestrator.resolveMemoryIdOrHandle(id, options.sessionKey);\n    } catch {\n      return { error: \"not_found\" };\n    }\n  }\n  const memory = await storage?.getMemoryById?.(resolvedId);\n  if (!memory || isSupportPassportPrivateMemory(memory)) return { error: \"not_found\" };\n  return {\n    id: resolvedId,\n    text: collapseWhitespace(memory.content),\n    metadata: buildActiveMemoryMetadataFromMemory(memory),\n  };\n}\n"],"mappings":"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","names":[]}