@remnic/core 1.1.1 → 1.1.3

package/dist/index.js

@@ -1,3 +1,17 @@
+import "./chunk-3LCWFNVS.js";
+import {
+  PEERS_DIR_NAME,
+  PEER_ID_MAX_LENGTH,
+  PEER_ID_PATTERN,
+  appendInteractionLog,
+  assertValidPeerId,
+  listPeers,
+  readInteractionLogRaw,
+  readPeer,
+  readPeerProfile,
+  writePeer,
+  writePeerProfile
+} from "./chunk-TUFG6VXY.js";
 import {
   buildTokenEntry,
   commitTokenEntry,
@@ -9,7 +23,7 @@ import {
   resolveConnectorFromToken,
   revokeToken,
   saveTokenStore
-} from "./chunk-O5ETUNBT.js";
+} from "./chunk-VTU2B4VF.js";
 import {
   runGraphRecall
 } from "./chunk-DGVM5SFL.js";
@@ -23,6 +37,9 @@ import {
   isNodeType,
   queryGraph
 } from "./chunk-64NJRYU2.js";
+import {
+  buildEvidencePack
+} from "./chunk-74WWN7ZW.js";
 import {
   clearBulkImportSources,
   clearTrainingExportAdapters,
@@ -34,26 +51,33 @@ import {
   listBulkImportSources,
   listTrainingExportAdapters,
   parseIsoTimestamp,
-  parseStrictCliDate,
   registerBulkImportSource,
   registerTrainingExportAdapter,
   runBulkImportCliCommand,
   runBulkImportPipeline,
   validateImportTurn
-} from "./chunk-INXV5JBT.js";
-import "./chunk-VDX363PS.js";
-import "./chunk-KUB6JU6H.js";
+} from "./chunk-ZGXSCMQN.js";
+import "./chunk-34F3PLWZ.js";
+import {
+  clearAuthTokenSecretCache,
+  isAgentAccessSecretRef,
+  resolveAgentAccessAuthToken
+} from "./chunk-MXC3AP5I.js";
+import "./chunk-47WOM4YW.js";
 import {
   parseXrayBudgetFlag,
   parseXrayCliOptions
-} from "./chunk-PVPWZSSI.js";
-import "./chunk-B5WXLVDY.js";
+} from "./chunk-SMA4IMHV.js";
+import {
+  parseStrictCliDate
+} from "./chunk-AJA46VX5.js";
+import "./chunk-7GCMLT7J.js";
 import "./chunk-HL4DB7TO.js";
-import "./chunk-ULYOGL6R.js";
 import "./chunk-ZPKBYX2F.js";
 import "./chunk-3SLRNYNG.js";
 import "./chunk-LIRZNNUP.js";
 import "./chunk-Y4Z4I6WK.js";
+import "./chunk-5HRY2WRF.js";
 import {
   reportBufferSurpriseDistribution
 } from "./chunk-ASAITVLA.js";
@@ -79,35 +103,37 @@ import {
   getTaxonomyFilePath,
   loadTaxonomy,
   migrateFromEngram,
-  normalizeOriginUrl,
   projectNamespaceName,
   resolveCodingNamespaceOverlay,
-  resolveGitContext,
   rollbackFromEngramMigration,
   sanitizeSessionKeyForFilename,
   saveTaxonomy,
-  stableHash,
   validateSlug,
   validateTaxonomy
-} from "./chunk-VYM3VWOF.js";
-import "./chunk-RGLL5SPU.js";
-import "./chunk-UHGBNIOS.js";
+} from "./chunk-IM3JSE73.js";
+import "./chunk-LVYGDT5V.js";
+import "./chunk-CK5NTM2S.js";
 import "./chunk-FSFEQI74.js";
-import "./chunk-W6SL7OFG.js";
 import "./chunk-Z5AAYHUC.js";
-import "./chunk-S75M5ZRK.js";
+import {
+  computeTierValueScore,
+  decideTierTransition
+} from "./chunk-S75M5ZRK.js";
 import "./chunk-TPB3I2AC.js";
-import "./chunk-JR4ZC3G4.js";
-import "./chunk-ZEM3OK2K.js";
+import "./chunk-UHGBNIOS.js";
+import "./chunk-B2TL6GA2.js";
 import "./chunk-ETOW6ACV.js";
+import "./chunk-ZTSE2ZJ6.js";
+import "./chunk-MDYG7VI7.js";
+import "./chunk-JR4ZC3G4.js";
+import "./chunk-5IZL4DCV.js";
+import "./chunk-X7XN6YU4.js";
 import "./chunk-5NPGSAVB.js";
 import "./chunk-C7VW7C3F.js";
 import "./chunk-K4FLSOR5.js";
 import "./chunk-V3RXWQIE.js";
-import "./chunk-5IZL4DCV.js";
-import "./chunk-VBVG2M5G.js";
-import "./chunk-KVBLZUKV.js";
-import "./chunk-X7XN6YU4.js";
+import "./chunk-7DHTMOND.js";
+import "./chunk-WPGJYVUH.js";
 import {
   DEFAULT_REASONING_TRACE_BOOST,
   applyReasoningTraceBoost,
@@ -115,10 +141,8 @@ import {
   looksLikeProblemSolvingQuery
 } from "./chunk-ZZTOURJI.js";
 import "./chunk-YDBIWGNI.js";
-import "./chunk-7DHTMOND.js";
 import "./chunk-YCN4BVDK.js";
 import "./chunk-D654IBA6.js";
-import "./chunk-H63EDPFJ.js";
 import {
   applyMemoryWorthFilter,
   buildMemoryWorthCounterMap
@@ -126,6 +150,13 @@ import {
 import {
   computeMemoryWorth
 } from "./chunk-IISBCCWR.js";
+import {
+  builtInLiveConnectorDefinitions,
+  hasEnabledLiveConnector,
+  runLiveConnectorsOnce
+} from "./chunk-ASIQZXYO.js";
+import "./chunk-H63EDPFJ.js";
+import "./chunk-YAZNBMNF.js";
 import {
   hasBroadGraphIntent,
   inferIntentFromText,
@@ -133,8 +164,6 @@ import {
   isTaskInitiationIntent,
   planRecallMode
 } from "./chunk-GGD5W7TB.js";
-import "./chunk-YAZNBMNF.js";
-import "./chunk-AJU4PJGY.js";
 import "./chunk-DF3RVK3X.js";
 import {
   clearVerdictCache,
@@ -148,12 +177,16 @@ import {
 } from "./chunk-C4SQJZAF.js";
 import {
   ExtractionEngine
-} from "./chunk-S3EEFKNY.js";
-import "./chunk-NZLQTHS5.js";
+} from "./chunk-N7X62G74.js";
+import "./chunk-WW3QQF4H.js";
 import "./chunk-54V4BZWP.js";
 import "./chunk-NBNN5GOB.js";
 import "./chunk-FEMOX5AD.js";
-import "./chunk-JL2PU6AI.js";
+import "./chunk-R2XRID2N.js";
+import {
+  buildExtensionsFooterForSummary,
+  loadDaySummaryPrompt
+} from "./chunk-GZCUW5IC.js";
 import "./chunk-VEWZZM3H.js";
 import {
   resolveCategory
@@ -162,57 +195,82 @@ import {
   FILTER_LABELS,
   isDirectAnswerEligible
 } from "./chunk-Y4FHOFJ2.js";
-import "./chunk-ALXMCZEU.js";
+import "./chunk-Z2E7VW55.js";
 import {
   buildEntityRecallSection
-} from "./chunk-FVA6TGI3.js";
-import {
-  buildExtensionsFooterForSummary,
-  loadDaySummaryPrompt
-} from "./chunk-GZCUW5IC.js";
-import {
-  expandTildePath
-} from "./chunk-EPQJM2GC.js";
+} from "./chunk-Y3WQ4ZWK.js";
+import "./chunk-2NMMFZ5T.js";
+import "./chunk-VTJVUHRK.js";
 import "./chunk-PYXS46O7.js";
 import "./chunk-3QKK7QOS.js";
-import "./chunk-CUPFXL3J.js";
+import "./chunk-DHRQHX36.js";
 import "./chunk-JRNQ3RNA.js";
-import "./chunk-SPI27QT6.js";
+import "./chunk-L5IIGA5V.js";
 import "./chunk-CULXMQJH.js";
 import "./chunk-E6K4NIEU.js";
+import "./chunk-EABGC2TL.js";
+import "./chunk-LOBRX7VD.js";
 import {
   LanceDbBackend,
   MeilisearchBackend,
   OramaBackend
-} from "./chunk-7I7FKFZH.js";
+} from "./chunk-R2L7SUX2.js";
 import "./chunk-YRMVARQP.js";
 import {
   QmdClient
-} from "./chunk-YNQKWQT4.js";
+} from "./chunk-WSZIHQBK.js";
 import {
   LEGACY_PLUGIN_ID,
   PLUGIN_ID,
   resolveRemnicPluginEntry
 } from "./chunk-U66YHYC7.js";
-import "./chunk-EABGC2TL.js";
-import "./chunk-LOBRX7VD.js";
+import {
+  DEFAULT_POLL_INTERVAL_MS,
+  GOOGLE_DRIVE_CONNECTOR_ID,
+  GOOGLE_DRIVE_CURSOR_KIND,
+  LiveConnectorRegistry,
+  LiveConnectorRegistryError,
+  NOTION_CONNECTOR_ID,
+  NOTION_CURSOR_KIND,
+  NOTION_DEFAULT_POLL_INTERVAL_MS,
+  createGoogleDriveConnector,
+  createNotionConnector,
+  defaultGoogleDriveClientFactory,
+  validateGoogleDriveConfig,
+  validateNotionConfig
+} from "./chunk-L2IO2QPY.js";
+import {
+  CONNECTOR_ID_PATTERN,
+  isValidConnectorId,
+  listConnectorStates,
+  readConnectorState,
+  writeConnectorState
+} from "./chunk-6TBWYBJ3.js";
 import "./chunk-HMDCOMYU.js";
 import "./chunk-JXS5PDQ7.js";
-import "./chunk-LK6SGL53.js";
-import "./chunk-7SEAZFFB.js";
 import "./chunk-K6WK37A6.js";
+import "./chunk-AJU4PJGY.js";
+import "./chunk-7SEAZFFB.js";
 import {
   coerceInstallExtension,
   parseConfig
-} from "./chunk-BK2EFTE2.js";
+} from "./chunk-JWSENLQI.js";
 import "./chunk-Z5LAYHGJ.js";
+import {
+  CONNECTORS_OUTPUT_FORMATS,
+  parseConnectorsFormat,
+  parseConnectorsListOptions,
+  parseConnectorsRunName,
+  parseConnectorsStatusOptions,
+  renderConnectorsList,
+  renderConnectorsRunResult,
+  runConnectorPollOnce
+} from "./chunk-OZHRDTDX.js";
 import "./chunk-C6QPK5GG.js";
-import "./chunk-C2EFFULQ.js";
 import {
   CODEX_THREAD_KEY_PREFIX
 } from "./chunk-3PG3H5TD.js";
 import "./chunk-FYIYMQ5N.js";
-import "./chunk-2NMMFZ5T.js";
 import "./chunk-KVE7R4CG.js";
 import "./chunk-4WMCPJWX.js";
 import {
@@ -227,7 +285,7 @@ import {
   materializeForNamespace,
   runCodexMaterialize,
   runPostConsolidationMaterialize
-} from "./chunk-BGJGXLZ7.js";
+} from "./chunk-55FXRRSJ.js";
 import {
   REMNIC_EXTENSIONS_TOTAL_TOKEN_LIMIT,
   discoverMemoryExtensions,
@@ -237,8 +295,8 @@ import {
 } from "./chunk-EJI5XIBB.js";
 import {
   FallbackLlmClient
-} from "./chunk-3GXCSUXR.js";
-import "./chunk-XZ2TIKGC.js";
+} from "./chunk-CRU27Q4J.js";
+import "./chunk-Q7FJ5ZHM.js";
 import "./chunk-ODWDQNRE.js";
 import "./chunk-Y27UJK6V.js";
 import "./chunk-UZB5KHKX.js";
@@ -253,23 +311,27 @@ import "./chunk-PVGDJXVK.js";
 import "./chunk-NGAVDO7E.js";
 import {
   EngramAccessHttpServer
-} from "./chunk-DFTTJYSO.js";
+} from "./chunk-AKUCB2OG.js";
 import {
   EngramMcpServer
-} from "./chunk-HK3FGIEW.js";
+} from "./chunk-4PLGJRBV.js";
 import {
   buildCitationGuidance,
   formatOaiMemCitation,
   parseOaiMemCitation,
   sanitizeNoteForCitation
 } from "./chunk-IQT3XTKW.js";
-import "./chunk-MARWOCVP.js";
 import {
   EngramAccessInputError,
   EngramAccessService,
   computeProcedureStats,
   formatProcedureStatsText
-} from "./chunk-GKFXUTJ2.js";
+} from "./chunk-DR7MCMPS.js";
+import {
+  importCapsule
+} from "./chunk-3KIS4VGT.js";
+import "./chunk-BT7NVCML.js";
+import "./chunk-H7XKCNR6.js";
 import {
   RECALL_XRAY_FORMATS,
   parseXrayFormat,
@@ -277,28 +339,45 @@ import {
   renderXrayJson,
   renderXrayMarkdown,
   renderXrayText
-} from "./chunk-ZAIM4TUE.js";
+} from "./chunk-LW2NMHDW.js";
 import "./chunk-SOBJ6NEY.js";
-import "./chunk-3OGMS3PE.js";
+import {
+  normalizeOriginUrl,
+  resolveGitContext,
+  stableHash
+} from "./chunk-NN3TS5BM.js";
 import {
   isTrustZoneName
 } from "./chunk-EQINRHYR.js";
+import "./chunk-USFPPRAF.js";
+import "./chunk-LZRYQK6L.js";
 import {
   memoryWorthOutcomeEligibleCategories,
   recordMemoryOutcome
 } from "./chunk-EIR5VLIH.js";
+import {
+  expandTildePath
+} from "./chunk-IXEJRKCZ.js";
+import "./chunk-PCUKNJAZ.js";
+import "./chunk-3FPTCC3Z.js";
+import "./chunk-2LGMW3DJ.js";
 import "./chunk-EEQLFRUM.js";
+import {
+  launchProcessSync
+} from "./chunk-OR64ZGRZ.js";
 import {
   buildProcedureMarkdownBody,
   parseProcedureStepsFromBody
 } from "./chunk-QDW3E4RD.js";
-import "./chunk-3FPTCC3Z.js";
-import "./chunk-2LGMW3DJ.js";
 import {
   CrossNamespaceBudget,
   DEFAULT_CROSS_NAMESPACE_BUDGET
 } from "./chunk-GDFS42HT.js";
-import "./chunk-RBBWYEFJ.js";
+import "./chunk-RK2Y4XOM.js";
+import "./chunk-2LSZVONP.js";
+import "./chunk-WIICJPET.js";
+import "./chunk-G2WADRQ3.js";
+import "./chunk-74EMIVE4.js";
 import "./chunk-DT5TVLJE.js";
 import {
   resolvePrincipal
@@ -316,11 +395,11 @@ import {
   renderBriefingMarkdown,
   resolveBriefingSaveDir,
   validateBriefingFormat
-} from "./chunk-WVVA7F5A.js";
+} from "./chunk-SS253RXF.js";
 import {
   StorageManager
-} from "./chunk-F5VP6YCB.js";
-import "./chunk-LTCGGW2D.js";
+} from "./chunk-DCE6SQLA.js";
+import "./chunk-YNJHCGDT.js";
 import {
   CITATION_UNKNOWN,
   DEFAULT_CITATION_FORMAT,
@@ -332,15 +411,20 @@ import {
   parseCitation,
   stripCitation
 } from "./chunk-4KAN3GZ3.js";
-import "./chunk-6PFRXT4K.js";
-import "./chunk-TP4FZJIZ.js";
+import {
+  DEFAULT_RECALL_DISCLOSURE,
+  RECALL_DISCLOSURE_LEVELS,
+  isRecallDisclosure
+} from "./chunk-43EKP2UK.js";
+import "./chunk-PFV5C235.js";
+import "./chunk-RULE4VG5.js";
 import "./chunk-SCU65EZI.js";
 import "./chunk-BOUYNNYD.js";
 import "./chunk-DM2T26WE.js";
 import "./chunk-QSVPYQPG.js";
 import "./chunk-M62O4P4T.js";
 import "./chunk-4DJQYKMN.js";
-import "./chunk-X6GF3FX2.js";
+import "./chunk-G7D6GZ5J.js";
 import {
   createVersion,
   diffVersions,
@@ -348,6 +432,11 @@ import {
   listVersions,
   revertToVersion
 } from "./chunk-FAAFWE4G.js";
+import {
+  mergeEnv,
+  readEnvVar,
+  resolveHomeDir
+} from "./chunk-MARWOCVP.js";
 import {
   initLogger,
   log
@@ -371,7 +460,21 @@ import {
   recallRequestSchema,
   suggestionSubmitRequestSchema,
   validateRequest
-} from "./chunk-WCLICCGB.js";
+} from "./chunk-RILIVK4O.js";
+import "./chunk-IYY4MCPG.js";
+import {
+  assertIsDirectoryNotSymlink,
+  assertRealpathInsideRoot
+} from "./chunk-457A4P3L.js";
+import {
+  CAPSULE_ID_PATTERN
+} from "./chunk-OA3L7BFR.js";
+import "./chunk-KNKUID7G.js";
+import "./chunk-BJMBJZ2Y.js";
+import "./chunk-UKJAGEXH.js";
+import "./chunk-FP2373TW.js";
+import "./chunk-A6XUJE5D.js";
+import "./chunk-PZ5AY32C.js";
 
 // src/coding/review-context.ts
 var REVIEW_KEYWORD_PATTERNS = [
@@ -2435,7 +2538,6 @@ function hashContent3(content) {
 import fs8 from "fs";
 import path13 from "path";
 import os from "os";
-import { spawnSync } from "child_process";
 import { createRequire } from "module";
 import { fileURLToPath } from "url";
 
@@ -2984,7 +3086,8 @@ var BUILTIN_CONNECTORS = [
 ];
 var REGISTRY_DIR_NAME = ".engram-connectors";
 function getRegistryPath() {
-  const configDir = process.env.XDG_CONFIG_HOME ? path13.join(process.env.XDG_CONFIG_HOME, "engram") : path13.join(process.env.HOME ?? "~", ".config", "engram");
+  const xdgConfigHome = readEnvVar("XDG_CONFIG_HOME");
+  const configDir = xdgConfigHome ? path13.join(xdgConfigHome, "engram") : path13.join(resolveHomeDir(), ".config", "engram");
   return path13.join(configDir, REGISTRY_DIR_NAME, "registry.json");
 }
 function loadRegistry() {
@@ -3723,7 +3826,7 @@ function sanitizeHermesProfile(profile) {
 }
 function hermesConfigPath(profile) {
   const safeProfile = sanitizeHermesProfile(profile);
-  const profilesRoot = path13.resolve(process.env.HOME ?? os.homedir(), ".hermes", "profiles");
+  const profilesRoot = path13.resolve(resolveHomeDir(), ".hermes", "profiles");
   const cfgPath = path13.resolve(profilesRoot, safeProfile, "config.yaml");
   const rel = path13.relative(profilesRoot, cfgPath);
   if (rel.startsWith("..") || path13.isAbsolute(rel)) {
@@ -3921,13 +4024,14 @@ function checkDaemonHealth(host, port, authToken) {
     const bareHost = host.startsWith("[") && host.endsWith("]") ? host.slice(1, -1) : host;
     const script = [
       "const http = require('http');",
+      "const env = process['env'];",
       "const headers = {};",
-      "if (process.env.REMNIC_HEALTH_TOKEN) {",
-      "  headers['authorization'] = 'Bearer ' + process.env.REMNIC_HEALTH_TOKEN;",
+      "if (env.REMNIC_HEALTH_TOKEN) {",
+      "  headers['authorization'] = 'Bearer ' + env.REMNIC_HEALTH_TOKEN;",
       "}",
       "const req = http.get({",
-      "  host: process.env.REMNIC_HEALTH_HOST,",
-      "  port: parseInt(process.env.REMNIC_HEALTH_PORT, 10),",
+      "  host: env.REMNIC_HEALTH_HOST,",
+      "  port: parseInt(env.REMNIC_HEALTH_PORT, 10),",
       "  path: '/engram/v1/health',",
       "  headers,",
       "  timeout: 3000,",
@@ -3935,16 +4039,16 @@ function checkDaemonHealth(host, port, authToken) {
       "req.on('error', () => process.exit(1));",
       "req.on('timeout', () => { req.destroy(); process.exit(1); });"
     ].join("\n");
-    const env = {
-      ...process.env,
+    const env = mergeEnv({
       REMNIC_HEALTH_HOST: bareHost,
       REMNIC_HEALTH_PORT: String(safePort)
-    };
+    });
     if (authToken) {
       env.REMNIC_HEALTH_TOKEN = authToken;
     }
-    const spawnOpts = { timeout: 4e3, env };
-    const result = spawnSync(process.execPath, ["-e", script], spawnOpts);
+    const processPath = process.execPath;
+    const launchOptions = { timeout: 4e3, env };
+    const result = launchProcessSync(processPath, ["-e", script], launchOptions);
     if (result.status === HEALTH_EXIT_OK) {
       return true;
     }
@@ -3952,11 +4056,11 @@ function checkDaemonHealth(host, port, authToken) {
       console.error(
         "[remnic/connectors] health probe got 401 \u2014 retrying after token cache TTL..."
       );
-      spawnSync(process.execPath, ["-e", "setTimeout(() => {}, 6000)"], {
+      launchProcessSync(processPath, ["-e", "setTimeout(() => {}, 6000)"], {
         timeout: 7e3,
         env: {}
       });
-      const retry = spawnSync(process.execPath, ["-e", script], spawnOpts);
+      const retry = launchProcessSync(processPath, ["-e", script], launchOptions);
       return retry.status === HEALTH_EXIT_OK;
     }
     return false;
@@ -4022,11 +4126,11 @@ function resolveCodexHome(override) {
   if (override && typeof override === "string" && override.trim().length > 0) {
     return path13.resolve(override.trim());
   }
-  const envHome = process.env.CODEX_HOME;
+  const envHome = readEnvVar("CODEX_HOME");
   if (envHome && envHome.trim().length > 0) {
     return path13.resolve(envHome.trim());
   }
-  const home = process.env.HOME ?? process.env.USERPROFILE ?? "~";
+  const home = readEnvVar("HOME") || readEnvVar("USERPROFILE") || resolveHomeDir();
   return path13.resolve(home, ".codex");
 }
 function resolveCodexMemoryExtensionPaths(codexHomeOverride) {
@@ -4240,17 +4344,18 @@ function removeCodexMemoryExtension(options = {}) {
   return { ...paths, removed };
 }
 function getConnectorsDir() {
-  const configDir = process.env.XDG_CONFIG_HOME ? path13.join(process.env.XDG_CONFIG_HOME, "engram") : path13.join(process.env.HOME ?? "~", ".config", "engram");
+  const xdgConfigHome = readEnvVar("XDG_CONFIG_HOME");
+  const configDir = xdgConfigHome ? path13.join(xdgConfigHome, "engram") : path13.join(resolveHomeDir(), ".config", "engram");
   return path13.join(configDir, REGISTRY_DIR_NAME, "connectors");
 }
 var WECLONE_PROXY_CONFIG_DIRNAME = ".remnic";
 var WECLONE_PROXY_CONFIG_FILENAME = "weclone.json";
 function resolveWeCloneProxyConfigPath() {
-  const override = process.env.REMNIC_HOME ?? process.env.ENGRAM_HOME;
+  const override = readEnvVar("REMNIC_HOME") ?? readEnvVar("ENGRAM_HOME");
   if (override && override.length > 0) {
     return path13.resolve(override, "connectors", WECLONE_PROXY_CONFIG_FILENAME);
   }
-  const envHome = process.env.HOME;
+  const envHome = readEnvVar("HOME");
   const home = envHome && envHome.length > 0 ? envHome : os.homedir();
   return path13.resolve(
     home,
@@ -4387,7 +4492,7 @@ import path14 from "path";
 import crypto6 from "crypto";
 var MANIFEST_VERSION = 1;
 function getSpacesDir(baseDir) {
-  const homeDir = baseDir ?? process.env.HOME ?? "~";
+  const homeDir = baseDir ?? resolveHomeDir();
   return path14.join(homeDir, ".config", "engram", "spaces");
 }
 function getManifestPath(baseDir) {
@@ -4414,10 +4519,10 @@ function saveManifest(manifest, baseDir) {
   fs9.writeFileSync(manifestPath2, JSON.stringify(manifest, null, 2) + "\n");
 }
 function createPersonalSpace(baseDir, memoryDirOverride) {
-  const homeDir = baseDir ?? process.env.HOME ?? "~";
+  const homeDir = baseDir ?? resolveHomeDir();
   const standalonePath = path14.join(homeDir, ".engram", "memory");
   const openclawPath = path14.join(homeDir, ".openclaw", "workspace", "memory", "local");
-  const memoryDir = memoryDirOverride ?? process.env.ENGRAM_MEMORY_DIR ?? (fs9.existsSync(standalonePath) ? standalonePath : fs9.existsSync(openclawPath) ? openclawPath : standalonePath);
+  const memoryDir = memoryDirOverride ?? readEnvVar("ENGRAM_MEMORY_DIR") ?? (fs9.existsSync(standalonePath) ? standalonePath : fs9.existsSync(openclawPath) ? openclawPath : standalonePath);
   const now = (/* @__PURE__ */ new Date()).toISOString();
   return {
     id: "personal",
@@ -4427,7 +4532,7 @@ function createPersonalSpace(baseDir, memoryDirOverride) {
     memoryDir,
     createdAt: now,
     updatedAt: now,
-    owner: process.env.USER
+    owner: readEnvVar("USER")
   };
 }
 function listSpaces(baseDir) {
@@ -4463,7 +4568,7 @@ function createSpace(options) {
     memoryDir,
     createdAt: now,
     updatedAt: now,
-    owner: process.env.USER,
+    owner: readEnvVar("USER"),
     parentSpaceId: options.parentSpaceId
   };
   fs9.mkdirSync(memoryDir, { recursive: true });
@@ -4847,13 +4952,12 @@ var CodexMemoryExtensionPublisher = class {
     readPathTemplate: true
   };
   async resolveExtensionRoot(env) {
-    const e = env ?? process.env;
-    const codexHome = e.CODEX_HOME?.trim() || path15.join(e.HOME ?? os2.homedir(), ".codex");
+    const codexHome = env === void 0 ? readEnvVar("CODEX_HOME")?.trim() || path15.join(resolveHomeDir(), ".codex") : env.CODEX_HOME?.trim() || path15.join(env.HOME ?? env.USERPROFILE ?? os2.homedir(), ".codex");
     return path15.join(codexHome, "memories_extensions", REMNIC_EXTENSION_DIR_NAME2);
   }
   async isHostAvailable() {
     try {
-      const home = process.env.CODEX_HOME?.trim() || path15.join(process.env.HOME ?? os2.homedir(), ".codex");
+      const home = readEnvVar("CODEX_HOME")?.trim() || path15.join(resolveHomeDir(), ".codex");
       return fs10.existsSync(home);
     } catch {
       return false;
@@ -5396,12 +5500,128 @@ async function defaultWriteMemoriesToOrchestrator(target, memories) {
   await target.ingestBulkImportBatch(turns);
   return { memoriesIngested: memories.length };
 }
+
+// src/transfer/capsule-fork.ts
+import { lstat, mkdir as mkdir2, readFile as readFile2, realpath, writeFile } from "fs/promises";
+import path17 from "path";
+async function forkCapsule(opts) {
+  validateForkId(opts.forkId);
+  const rootAbs = path17.resolve(opts.targetRoot);
+  await assertIsDirectoryNotSymlink(rootAbs, "forkCapsule", "targetRoot");
+  const forkDirAbs = path17.join(rootAbs, "forks", opts.forkId);
+  const forkEntryExists = await pathEntryExists(forkDirAbs);
+  if (forkEntryExists) {
+    throw new Error(
+      `forkCapsule: fork path already exists \u2014 forkId "${opts.forkId}" is already in use at: ${forkDirAbs}`
+    );
+  }
+  const archiveAbs = path17.resolve(opts.sourceArchive);
+  const importResult = await importCapsule({
+    archivePath: archiveAbs,
+    root: rootAbs,
+    mode: "fork",
+    now: opts.now
+  });
+  const manifest = importResult.manifest;
+  const sourceCapsule = manifest.capsule;
+  const forkedAt = new Date(opts.now ?? Date.now()).toISOString();
+  const parent = {
+    capsuleId: sourceCapsule.id,
+    version: sourceCapsule.version,
+    forkRoot: `forks/${sourceCapsule.id}`
+  };
+  const lineage = {
+    forkId: opts.forkId,
+    forkedAt,
+    parent,
+    importedRecords: importResult.imported.length,
+    skippedRecords: importResult.skipped.length
+  };
+  const lineagePath = path17.join(forkDirAbs, "lineage.json");
+  const rootReal = await realpath(rootAbs);
+  await assertRealpathInsideRoot(rootReal, lineagePath, `forks/${opts.forkId}/lineage.json`, "forkCapsule");
+  await mkdir2(path17.dirname(lineagePath), { recursive: true });
+  await writeFile(lineagePath, JSON.stringify(lineage, null, 2) + "\n", "utf-8");
+  return {
+    archivePath: archiveAbs,
+    manifest,
+    importResult,
+    lineage,
+    lineagePath
+  };
+}
+async function readForkLineage(targetRoot, forkId) {
+  if (typeof forkId !== "string" || forkId.length === 0 || forkId.length > 64 || !CAPSULE_ID_PATTERN.test(forkId)) {
+    return null;
+  }
+  const rootAbs = path17.resolve(targetRoot);
+  const rootReal = await realpath(rootAbs).catch(() => rootAbs);
+  const lineagePath = path17.join(rootReal, "forks", forkId, "lineage.json");
+  const rel = path17.relative(rootReal, lineagePath);
+  if (rel.startsWith("..") || path17.isAbsolute(rel)) {
+    return null;
+  }
+  if (!await isLineagePathContained(rootReal, lineagePath)) {
+    return null;
+  }
+  const raw = await readFile2(lineagePath, "utf-8").catch(() => null);
+  if (raw === null) return null;
+  try {
+    const parsed = JSON.parse(raw);
+    if (typeof parsed !== "object" || parsed === null || typeof parsed.forkId !== "string") {
+      return null;
+    }
+    return parsed;
+  } catch {
+    return null;
+  }
+}
+function validateForkId(forkId) {
+  if (typeof forkId !== "string") {
+    throw new Error("forkCapsule: forkId must be a string");
+  }
+  if (forkId.length === 0) {
+    throw new Error("forkCapsule: forkId must not be empty");
+  }
+  if (forkId.length > 64) {
+    throw new Error("forkCapsule: forkId must be 64 characters or fewer");
+  }
+  if (!CAPSULE_ID_PATTERN.test(forkId)) {
+    throw new Error(
+      `forkCapsule: invalid forkId "${forkId}". Expected alphanumeric with single dashes (no leading/trailing dashes, no consecutive dashes).`
+    );
+  }
+}
+async function pathEntryExists(absPath) {
+  const st = await lstat(absPath).catch(() => null);
+  return st !== null;
+}
+async function isLineagePathContained(rootReal, lineagePath) {
+  let existing = lineagePath;
+  const suffix = [];
+  while (existing !== path17.dirname(existing)) {
+    const st = await lstat(existing).catch(() => null);
+    if (st !== null) break;
+    suffix.unshift(path17.basename(existing));
+    existing = path17.dirname(existing);
+  }
+  const existingReal = await realpath(existing).catch(() => existing);
+  const targetReal = suffix.length > 0 ? path17.join(existingReal, ...suffix) : existingReal;
+  const rel = path17.relative(rootReal, targetReal);
+  if (rel === "") return true;
+  if (rel === "..") return false;
+  if (rel.startsWith(`..${path17.sep}`)) return false;
+  if (path17.isAbsolute(rel)) return false;
+  return true;
+}
 export {
   AccessAuditAdapter,
   BRIEFING_FORMAT_ALLOWED,
   BootstrapEngine,
   CITATION_UNKNOWN,
   CODEX_THREAD_KEY_PREFIX,
+  CONNECTORS_OUTPUT_FORMATS,
+  CONNECTOR_ID_PATTERN,
   ClaudeCodeMemoryExtensionPublisher,
   CodexMemoryExtensionPublisher,
   CrossNamespaceBudget,
@@ -5415,6 +5635,7 @@ export {
   DEFAULT_PPR_ITERATIONS,
   DEFAULT_PPR_TOLERANCE,
   DEFAULT_REASONING_TRACE_BOOST,
+  DEFAULT_RECALL_DISCLOSURE,
   DEFAULT_SCAN_PATTERNS,
   DEFAULT_SURPRISE_K,
   DEFAULT_TAXONOMY,
@@ -5428,19 +5649,31 @@ export {
   FallbackLlmClient,
   FileCalendarSource,
   FilesystemBackend,
+  GOOGLE_DRIVE_CONNECTOR_ID,
+  GOOGLE_DRIVE_CURSOR_KIND,
+  DEFAULT_POLL_INTERVAL_MS as GOOGLE_DRIVE_DEFAULT_POLL_INTERVAL_MS,
   HermesMemoryExtensionPublisher,
   LEGACY_PLUGIN_ID,
   LanceDbBackend,
+  LiveConnectorRegistry,
+  LiveConnectorRegistryError,
   MARKETPLACE_MANIFEST_FILENAME,
   MARKETPLACE_SCHEMA_VERSION,
   MATERIALIZE_VERSION,
   MeilisearchBackend,
+  NOTION_CONNECTOR_ID,
+  NOTION_CURSOR_KIND,
+  NOTION_DEFAULT_POLL_INTERVAL_MS,
   NoneBackend,
   OramaBackend,
   Orchestrator,
+  PEERS_DIR_NAME,
+  PEER_ID_MAX_LENGTH,
+  PEER_ID_PATTERN,
   PLUGIN_ID,
   PUBLISHERS,
   QmdClient,
+  RECALL_DISCLOSURE_LEVELS,
   RECALL_XRAY_FORMATS,
   REMNIC_CITATION_FORMAT,
   REMNIC_EXTENSIONS_TOTAL_TOKEN_LIMIT,
@@ -5452,21 +5685,26 @@ export {
   StorageManager,
   WebSearchProvider,
   appendAuditEntry,
+  appendInteractionLog,
   applyMemoryWorthFilter,
   applyReasoningTraceBoost,
+  assertValidPeerId,
   attachCitation,
   branchNamespaceName,
   briefingFilename,
   buildBriefing,
   buildCitationGuidance,
   buildEntityRecallSection,
+  buildEvidencePack,
   buildExtensionsBlockForConsolidation,
   buildExtensionsFooterForSummary,
   buildGraphFromMemories,
   buildMemoryWorthCounterMap,
   buildProcedureMarkdownBody,
   buildProcedureRecallSection,
+  builtInLiveConnectorDefinitions,
   checkMarketplaceManifest,
+  clearAuthTokenSecretCache,
   clearBulkImportSources,
   clearTrainingExportAdapters,
   clearVerdictCache,
@@ -5474,14 +5712,19 @@ export {
   computeMemoryWorth,
   computeProcedureStats,
   computeSurprise,
+  computeTierValueScore,
   convertMemoriesToRecords,
   createBackend,
+  createGoogleDriveConnector,
+  createNotionConnector,
   createSpace,
   createVerdictCache,
   createVersion,
   curate,
   decideSemanticDedup,
+  decideTierTransition,
   defaultEnrichmentPipelineConfig,
+  defaultGoogleDriveClientFactory,
   defaultWorkspaceDir,
   defaultWriteMemoriesToOrchestrator,
   deleteSpace,
@@ -5500,6 +5743,7 @@ export {
   findDuplicates,
   focusMatchesEntity,
   focusMatchesMemory,
+  forkCapsule,
   formatBatchTranscript,
   formatCitation,
   formatOaiMemCitation,
@@ -5524,6 +5768,7 @@ export {
   getVersion,
   hasBroadGraphIntent,
   hasCitation,
+  hasEnabledLiveConnector,
   hostIdForConnector,
   importedMemoryToTurn,
   inferIntentFromText,
@@ -5531,19 +5776,24 @@ export {
   installConnector,
   installFromMarketplace,
   intentCompatibilityScore,
+  isAgentAccessSecretRef,
   isDirectAnswerEligible,
   isDurableVerdict,
   isEdgeType,
   isImportRole,
   isNodeType,
   isReasoningTracePath,
+  isRecallDisclosure,
   isReviewPrompt,
   isTaskInitiationIntent,
   isTrustZoneName,
   isValidCachedVerdict,
+  isValidConnectorId,
   judgeFactDurability,
   listBulkImportSources,
+  listConnectorStates,
   listConnectors,
+  listPeers,
   listReviewItems,
   listSpaces,
   listTokens,
@@ -5575,6 +5825,10 @@ export {
   parseBriefingWindow,
   parseCitation,
   parseConfig,
+  parseConnectorsFormat,
+  parseConnectorsListOptions,
+  parseConnectorsRunName,
+  parseConnectorsStatusOptions,
   parseIsoTimestamp,
   parseOaiMemCitation,
   parseProcedureStepsFromBody,
@@ -5594,7 +5848,12 @@ export {
   queryGraph,
   rankReviewCandidates,
   readAuditLog,
+  readConnectorState,
+  readForkLineage,
+  readInteractionLogRaw,
   readManifest,
+  readPeer,
+  readPeerProfile,
   recallForActiveMemory,
   recallRequestSchema,
   recordMemoryOutcome,
@@ -5603,6 +5862,8 @@ export {
   registerTrainingExportAdapter,
   removeConnector,
   renderBriefingMarkdown,
+  renderConnectorsList,
+  renderConnectorsRunResult,
   renderExtensionsBlock,
   renderExtensionsFooter,
   renderXray,
@@ -5610,6 +5871,7 @@ export {
   renderXrayMarkdown,
   renderXrayText,
   reportBufferSurpriseDistribution,
+  resolveAgentAccessAuthToken,
   resolveBriefingSaveDir,
   resolveCategory,
   resolveCodingNamespaceOverlay,
@@ -5625,9 +5887,11 @@ export {
   runBulkImportCliCommand,
   runBulkImportPipeline,
   runCodexMaterialize,
+  runConnectorPollOnce,
   runEnrichmentPipeline,
   runGraphRecall,
   runImporter,
+  runLiveConnectorsOnce,
   runPostConsolidationMaterialize,
   sanitizeNoteForCitation,
   sanitizeSessionKeyForFilename,
@@ -5643,16 +5907,21 @@ export {
   switchSpace,
   syncChanges,
   validateBriefingFormat,
+  validateGoogleDriveConfig,
   validateImportBatchSize,
   validateImportRateLimit,
   validateImportTurn,
   validateMarketplaceManifest,
+  validateNotionConfig,
   validateRequest,
   validateSlug,
   validateTaxonomy,
   verdictCacheSize,
   watchForChanges,
+  writeConnectorState,
   writeManifest,
-  writeMarketplaceManifest
+  writeMarketplaceManifest,
+  writePeer,
+  writePeerProfile
 };
 //# sourceMappingURL=index.js.map