@remnic/core 1.0.0

package/dist/chunk-M5KEYE5E.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/boxes.ts"],"sourcesContent":["/**\n * Memory Boxes + Trace Weaving (v8.0 Phase 2A)\n *\n * Implements the Membox concept: a sliding topic window that forms an \"open box\"\n * accumulating related memories. The box is sealed on topic shift or time gap,\n * then written to memory/boxes/YYYY-MM-DD/box-<id>.md.\n *\n * Trace Weaving links recurring topic boxes with a shared traceId so that\n * cross-session continuity on the same topics is preserved and discoverable.\n */\n\nimport { mkdir, writeFile, readFile, readdir } from \"node:fs/promises\";\nimport type { Dirent } from \"node:fs\";\nimport path from \"node:path\";\nimport { createHash } from \"node:crypto\";\nimport { log } from \"./logger.js\";\n\nexport const BOX_DIR = \"boxes\";\nconst STATE_DIR = \"state\";\nconst TRACES_FILE = \"traces.json\";\nconst OPEN_BOX_STATE_FILE = \"open-box.json\";\n\n// ── Types ─────────────────────────────────────────────────────────────────\n\nexport interface BoxFrontmatter {\n  id: string;\n  memoryKind: \"box\";\n  createdAt: string;\n  sealedAt: string;\n  sealReason: SealReason;\n  sessionKey?: string;\n  topics: string[];\n  memoryIds: string[];\n  traceId?: string;\n  /** High-level task goal for this episode (REMem-inspired). */\n  goal?: string;\n  /** Tools invoked during this episode. */\n  toolsUsed?: string[];\n  /** Episode outcome: success, failure, partial, or unknown. */\n  outcome?: \"success\" | \"failure\" | \"partial\" | \"unknown\";\n}\n\nexport type SealReason = \"topic_shift\" | \"time_gap\" | \"max_memories\" | \"forced\" | \"flush\";\n\ninterface OpenBoxState {\n  id: string;\n  createdAt: string;\n  lastActivityAt: string;\n  topics: string[];\n  memoryIds: string[];\n  goal?: string;\n  toolsUsed?: string[];\n}\n\ninterface TraceIndex {\n  /** traceId → list of box IDs */\n  traces: Record<string, string[]>;\n  /** boxId → traceId */\n  boxToTrace: Record<string, string>;\n  /** traceId → canonical topic fingerprint for matching */\n  traceTopics: Record<string, string[]>;\n  /** traceId → ISO timestamp of last box added (for lookback filtering) */\n  traceLastSeen: Record<string, string>;\n}\n\nexport interface BoxBuilderConfig {\n  memoryBoxesEnabled: boolean;\n  traceWeaverEnabled: boolean;\n  /** Jaccard threshold below which topic shift triggers seal (0-1, default 0.35) */\n  boxTopicShiftThreshold: number;\n  /** Time gap in ms before sealing an open box (default 30 min) */\n  boxTimeGapMs: number;\n  /** Max memories in one box before forced seal */\n  boxMaxMemories: number;\n  /** Days back to look for trace links */\n  traceWeaverLookbackDays: number;\n  /** Minimum topic overlap to assign same traceId (0-1, default 0.4) */\n  traceWeaverOverlapThreshold: number;\n}\n\ninterface ExtractionEvent {\n  topics: string[];\n  memoryIds: string[];\n  timestamp: string;\n  goal?: string;\n  toolsUsed?: string[];\n}\n\n// ── Utility ───────────────────────────────────────────────────────────────\n\n/**\n * Jaccard similarity between two topic arrays.\n * Returns 0.0 for empty inputs.\n */\nexport function topicOverlapScore(a: string[], b: string[]): number {\n  if (a.length === 0 || b.length === 0) return 0.0;\n  const setA = new Set(a.map((t) => t.toLowerCase()));\n  const setB = new Set(b.map((t) => t.toLowerCase()));\n  const intersection = [...setA].filter((t) => setB.has(t)).length;\n  const union = new Set([...setA, ...setB]).size;\n  return union === 0 ? 0.0 : intersection / union;\n}\n\nfunction makeBoxId(): string {\n  return `box-${Date.now()}-${Math.random().toString(36).slice(2, 6)}`;\n}\n\nfunction makeTraceId(topics: string[]): string {\n  const key = topics.slice().sort().join(\",\");\n  return `trace-${createHash(\"sha256\").update(key).digest(\"hex\").slice(0, 8)}`;\n}\n\n// ── Frontmatter serialization ──────────────────────────────────────────────\n\nfunction serializeBoxFrontmatter(fm: BoxFrontmatter): string {\n  const lines = [\n    \"---\",\n    `id: ${fm.id}`,\n    `memoryKind: ${fm.memoryKind}`,\n    `createdAt: ${fm.createdAt}`,\n    `sealedAt: ${fm.sealedAt}`,\n    `sealReason: ${fm.sealReason}`,\n    `topics: [${fm.topics.map((t) => `\"${t}\"`).join(\", \")}]`,\n    `memoryIds: [${fm.memoryIds.map((m) => `\"${m}\"`).join(\", \")}]`,\n  ];\n  if (fm.sessionKey) lines.push(`sessionKey: ${fm.sessionKey}`);\n  if (fm.traceId) lines.push(`traceId: ${fm.traceId}`);\n  if (fm.goal) lines.push(`goal: ${fm.goal.replace(/[\\r\\n]+/g, \" \")}`);\n  if (fm.toolsUsed?.length) lines.push(`toolsUsed: [${fm.toolsUsed.map((t) => `\"${t}\"`).join(\", \")}]`);\n  if (fm.outcome) lines.push(`outcome: ${fm.outcome}`);\n  lines.push(\"---\");\n  return lines.join(\"\\n\");\n}\n\nexport function parseBoxFrontmatter(raw: string): BoxFrontmatter | null {\n  const match = raw.match(/^---\\n([\\s\\S]*?)\\n---/);\n  if (!match) return null;\n\n  const fmBlock = match[1];\n  const fm: Record<string, string> = {};\n  for (const line of fmBlock.split(\"\\n\")) {\n    const colonIdx = line.indexOf(\":\");\n    if (colonIdx === -1) continue;\n    fm[line.slice(0, colonIdx).trim()] = line.slice(colonIdx + 1).trim();\n  }\n\n  const parseArray = (val: string | undefined): string[] => {\n    if (!val) return [];\n    const m = val.match(/\\[(.*)]/);\n    if (!m) return [];\n    return m[1].split(\",\").map((s) => s.trim().replace(/^\"|\"$/g, \"\")).filter(Boolean);\n  };\n\n  const outcome = fm.outcome as BoxFrontmatter[\"outcome\"];\n  return {\n    id: fm.id ?? \"\",\n    memoryKind: \"box\",\n    createdAt: fm.createdAt ?? \"\",\n    sealedAt: fm.sealedAt ?? \"\",\n    sealReason: (fm.sealReason ?? \"forced\") as SealReason,\n    sessionKey: fm.sessionKey,\n    topics: parseArray(fm.topics),\n    memoryIds: parseArray(fm.memoryIds),\n    traceId: fm.traceId,\n    goal: fm.goal || undefined,\n    toolsUsed: fm.toolsUsed ? parseArray(fm.toolsUsed) : undefined,\n    outcome: outcome && [\"success\", \"failure\", \"partial\", \"unknown\"].includes(outcome) ? outcome : undefined,\n  };\n}\n\n// ── BoxBuilder ────────────────────────────────────────────────────────────\n\nexport class BoxBuilder {\n  private baseDir: string;\n  private cfg: BoxBuilderConfig;\n  private openBox: OpenBoxState | null = null;\n  private stateLoaded = false;\n\n  constructor(baseDir: string, cfg: BoxBuilderConfig) {\n    this.baseDir = baseDir;\n    this.cfg = cfg;\n  }\n\n  private get boxBaseDir(): string {\n    return path.join(this.baseDir, BOX_DIR);\n  }\n\n  private get stateDir(): string {\n    return path.join(this.baseDir, STATE_DIR);\n  }\n\n  private get openBoxStatePath(): string {\n    return path.join(this.stateDir, OPEN_BOX_STATE_FILE);\n  }\n\n  private get tracesPath(): string {\n    return path.join(this.stateDir, TRACES_FILE);\n  }\n\n  // ── State persistence ────────────────────────────────────────────────────\n\n  private async loadOpenBox(): Promise<void> {\n    if (this.stateLoaded) return;\n    this.stateLoaded = true;\n    try {\n      const raw = await readFile(this.openBoxStatePath, \"utf-8\");\n      this.openBox = JSON.parse(raw) as OpenBoxState;\n    } catch {\n      this.openBox = null;\n    }\n  }\n\n  private async saveOpenBox(): Promise<void> {\n    await mkdir(this.stateDir, { recursive: true });\n    if (this.openBox) {\n      await writeFile(this.openBoxStatePath, JSON.stringify(this.openBox, null, 2), \"utf-8\");\n    } else {\n      // Clear open box state\n      try { await writeFile(this.openBoxStatePath, \"null\", \"utf-8\"); } catch { /* ok */ }\n    }\n  }\n\n  private async loadTraceIndex(): Promise<TraceIndex> {\n    try {\n      const raw = await readFile(this.tracesPath, \"utf-8\");\n      const parsed = JSON.parse(raw) as TraceIndex;\n      // Backfill missing field for indexes written before this field was added\n      parsed.traceLastSeen ??= {};\n      return parsed;\n    } catch {\n      return { traces: {}, boxToTrace: {}, traceTopics: {}, traceLastSeen: {} };\n    }\n  }\n\n  private async saveTraceIndex(idx: TraceIndex): Promise<void> {\n    try {\n      await mkdir(this.stateDir, { recursive: true });\n      await writeFile(this.tracesPath, JSON.stringify(idx, null, 2), \"utf-8\");\n    } catch (err) {\n      log.warn(`[engram/boxes] Failed to save trace index: ${(err as Error).message}`);\n    }\n  }\n\n  // ── Core logic ────────────────────────────────────────────────────────────\n\n  /**\n   * Called after each extraction run.\n   * Decides whether to seal the current open box and/or start a new one.\n   */\n  async onExtraction(event: ExtractionEvent): Promise<void> {\n    if (!this.cfg.memoryBoxesEnabled) return;\n\n    await this.loadOpenBox();\n\n    const newTopics = event.topics.filter(Boolean);\n    const now = new Date(event.timestamp);\n    const nowMs = now.getTime();\n\n    if (this.openBox) {\n      // Check seal conditions\n      const lastActivity = new Date(this.openBox.lastActivityAt).getTime();\n      const timeGapMs = nowMs - lastActivity;\n      const overlap = topicOverlapScore(this.openBox.topics, newTopics);\n      const topicShifted = newTopics.length > 0 && overlap < this.cfg.boxTopicShiftThreshold;\n      const timeExpired = timeGapMs >= this.cfg.boxTimeGapMs;\n      const tooManyMemories =\n        this.openBox.memoryIds.length + event.memoryIds.length > this.cfg.boxMaxMemories;\n\n      if (tooManyMemories) {\n        // Merge topics and add current batch then seal\n        const topicSet = new Set([...this.openBox.topics, ...newTopics]);\n        this.openBox.topics = [...topicSet];\n        this.openBox.memoryIds.push(...event.memoryIds);\n        if (event.toolsUsed?.length) {\n          const toolSet = new Set([...(this.openBox.toolsUsed ?? []), ...event.toolsUsed]);\n          this.openBox.toolsUsed = [...toolSet];\n        }\n        await this.sealCurrent(\"max_memories\");\n      } else if (topicShifted) {\n        await this.sealCurrent(\"topic_shift\");\n        this.openBox = this.newBox(event, now.toISOString());\n        await this.saveOpenBox();\n      } else if (timeExpired) {\n        await this.sealCurrent(\"time_gap\");\n        this.openBox = this.newBox(event, now.toISOString());\n        await this.saveOpenBox();\n      } else {\n        // Accumulate\n        this.openBox.memoryIds.push(...event.memoryIds);\n        // Merge new topics (union)\n        const topicSet = new Set([...this.openBox.topics, ...newTopics]);\n        this.openBox.topics = [...topicSet];\n        this.openBox.lastActivityAt = now.toISOString();\n        // Merge toolsUsed (union)\n        if (event.toolsUsed?.length) {\n          const toolSet = new Set([...(this.openBox.toolsUsed ?? []), ...event.toolsUsed]);\n          this.openBox.toolsUsed = [...toolSet];\n        }\n        await this.saveOpenBox();\n      }\n    } else {\n      // No open box — start one\n      this.openBox = this.newBox(event, now.toISOString());\n      // If this initial batch already exceeds max, seal immediately\n      if (this.openBox.memoryIds.length > this.cfg.boxMaxMemories) {\n        await this.sealCurrent(\"max_memories\");\n      } else {\n        await this.saveOpenBox();\n      }\n    }\n  }\n\n  private newBox(event: ExtractionEvent, ts: string): OpenBoxState {\n    return {\n      id: makeBoxId(),\n      createdAt: ts,\n      lastActivityAt: ts,\n      topics: event.topics.filter(Boolean),\n      memoryIds: [...event.memoryIds],\n      goal: event.goal,\n      toolsUsed: event.toolsUsed?.length ? [...event.toolsUsed] : undefined,\n    };\n  }\n\n  /**\n   * Seal the current open box and write it to disk.\n   * Also runs trace weaving if enabled.\n   */\n  async sealCurrent(reason: SealReason): Promise<string | null> {\n    await this.loadOpenBox();\n    if (!this.openBox) return null;\n\n    const box = this.openBox;\n    this.openBox = null;\n\n    if (box.memoryIds.length === 0 && box.topics.length === 0) {\n      await this.saveOpenBox();\n      return null;\n    }\n\n    const sealedAt = new Date().toISOString();\n    const day = sealedAt.slice(0, 10);\n    const dir = path.join(this.boxBaseDir, day);\n    await mkdir(dir, { recursive: true });\n\n    let traceId: string | undefined;\n    if (this.cfg.traceWeaverEnabled && box.topics.length > 0) {\n      traceId = await this.resolveTrace(box.id, box.topics);\n    }\n\n    const fm: BoxFrontmatter = {\n      id: box.id,\n      memoryKind: \"box\",\n      createdAt: box.createdAt,\n      sealedAt,\n      sealReason: reason,\n      topics: box.topics,\n      memoryIds: box.memoryIds,\n      traceId,\n      goal: box.goal,\n      toolsUsed: box.toolsUsed?.length ? box.toolsUsed : undefined,\n      outcome: \"unknown\",\n    };\n\n    const content = `${serializeBoxFrontmatter(fm)}\\n\\n<!-- Topics: ${box.topics.join(\", \")} | Memories: ${box.memoryIds.length} -->\\n`;\n    const filePath = path.join(dir, `${box.id}.md`);\n    await writeFile(filePath, content, \"utf-8\");\n    log.debug(`[boxes] sealed box ${box.id} (${reason}): ${box.memoryIds.length} memories, topics=[${box.topics.join(\",\")}]`);\n\n    await this.saveOpenBox();\n    return box.id;\n  }\n\n  // ── Trace Weaving ─────────────────────────────────────────────────────────\n\n  /**\n   * Find an existing trace that matches box topics, or create a new trace.\n   * Returns the traceId to assign to this box.\n   */\n  private async resolveTrace(boxId: string, topics: string[]): Promise<string> {\n    const idx = await this.loadTraceIndex();\n\n    // Filter to traces active within the lookback window\n    const lookbackMs = this.cfg.traceWeaverLookbackDays * 24 * 60 * 60 * 1000;\n    const cutoff = new Date(Date.now() - lookbackMs);\n\n    let bestTraceId: string | undefined;\n    let bestScore = 0;\n\n    for (const [tid, traceTopics] of Object.entries(idx.traceTopics)) {\n      const lastSeen = idx.traceLastSeen[tid];\n      if (lastSeen && new Date(lastSeen) < cutoff) continue; // outside lookback window\n      const score = topicOverlapScore(topics, traceTopics);\n      if (score >= this.cfg.traceWeaverOverlapThreshold && score > bestScore) {\n        bestScore = score;\n        bestTraceId = tid;\n      }\n    }\n\n    const traceId = bestTraceId ?? makeTraceId(topics);\n    const now = new Date().toISOString();\n\n    // Update trace index\n    if (!idx.traces[traceId]) idx.traces[traceId] = [];\n    idx.traces[traceId].push(boxId);\n    idx.boxToTrace[boxId] = traceId;\n    idx.traceLastSeen[traceId] = now;\n\n    // Update canonical topics for this trace (merge)\n    if (idx.traceTopics[traceId]) {\n      const merged = new Set([...idx.traceTopics[traceId], ...topics]);\n      idx.traceTopics[traceId] = [...merged];\n    } else {\n      idx.traceTopics[traceId] = [...topics];\n    }\n\n    await this.saveTraceIndex(idx);\n    return traceId;\n  }\n\n  // ── Recall ────────────────────────────────────────────────────────────────\n\n  /**\n   * Read all sealed boxes from the last N days for recall injection.\n   */\n  async readRecentBoxes(days: number): Promise<BoxFrontmatter[]> {\n    const cutoff = new Date(Date.now() - days * 24 * 60 * 60 * 1000);\n    const cutoffDateStr = cutoff.toISOString().slice(0, 10); // \"YYYY-MM-DD\"\n\n    let topEntries: Dirent<string>[];\n    try {\n      topEntries = await readdir(this.boxBaseDir, { withFileTypes: true, encoding: \"utf-8\" });\n    } catch {\n      return [];\n    }\n\n    // Filter day directories by name (YYYY-MM-DD) — skip dirs older than cutoff\n    // without reading a single file from them.\n    const recentDirs = topEntries\n      .filter((e) => e.isDirectory() && /^\\d{4}-\\d{2}-\\d{2}$/.test(e.name) && e.name >= cutoffDateStr)\n      .map((e) => path.join(this.boxBaseDir, e.name));\n\n    // Also include legacy flat entries at the root level (non-date dirs and .md files)\n    const legacyEntries = topEntries.filter(\n      (e) => !e.isDirectory() || !/^\\d{4}-\\d{2}-\\d{2}$/.test(e.name),\n    );\n\n    // Read all files in each recent day directory in parallel (per dir)\n    const boxes: BoxFrontmatter[] = [];\n\n    const readDir = async (dir: string) => {\n      let files: string[];\n      try {\n        files = (await readdir(dir)).filter((f) => f.endsWith(\".md\"));\n      } catch {\n        return;\n      }\n      const results = await Promise.all(\n        files.map(async (f) => {\n          try {\n            const raw = await readFile(path.join(dir, f), \"utf-8\");\n            const parsed = parseBoxFrontmatter(raw);\n            return parsed && new Date(parsed.sealedAt) >= cutoff ? parsed : null;\n          } catch {\n            return null;\n          }\n        }),\n      );\n      for (const r of results) {\n        if (r !== null) boxes.push(r);\n      }\n    };\n\n    // Day dirs in parallel\n    await Promise.all(recentDirs.map(readDir));\n\n    // Legacy non-date entries (walk sub-dirs sequentially but read files in parallel)\n    for (const e of legacyEntries) {\n      const full = path.join(this.boxBaseDir, e.name);\n      if (e.isDirectory()) {\n        await readDir(full);\n      } else if (e.name.endsWith(\".md\")) {\n        try {\n          const raw = await readFile(full, \"utf-8\");\n          const parsed = parseBoxFrontmatter(raw);\n          if (parsed && new Date(parsed.sealedAt) >= cutoff) boxes.push(parsed);\n        } catch { /* corrupt file — skip */ }\n      }\n    }\n\n    // Sort newest-first so slice(0, N) gives the most recent boxes\n    boxes.sort((a, b) => new Date(b.sealedAt).getTime() - new Date(a.sealedAt).getTime());\n    return boxes;\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/chunk-M62O4P4T.js

@@ -0,0 +1,41 @@
+// src/sanitize.ts
+var INJECTION_PATTERNS = [
+  /ignore\s+(all\s+)?(previous|prior|above)\s+(instructions?|prompts?|context)/i,
+  /forget\s+(everything|all|previous|what)/i,
+  /new\s+(system\s+)?prompt:/i,
+  /\[system\]/i,
+  /<\s*system\s*>/i,
+  /you\s+are\s+now\s+(?!called|named)/i,
+  /disregard\s+(all\s+)?(previous|prior)/i,
+  /override\s+(previous\s+)?(instructions?|prompt)/i,
+  /act\s+as\s+(?:an?\s+)?(?:AI|assistant|ChatGPT|GPT|Claude|LLM)\s+(?:without|that\s+ignores)/i,
+  /do\s+not\s+(?:follow|obey)\s+(?:previous|prior|your)\s+instructions/i,
+  /pretend\s+(?:you\s+)?(?:have\s+no|you\s+don.?t\s+have)\s+(restrictions|guidelines|rules)/i
+];
+var REDACTED_PLACEHOLDER = "[content removed: possible prompt injection]";
+function sanitizeMemoryContent(text) {
+  const source = typeof text === "string" ? text : "";
+  const violations = [];
+  for (const pattern of INJECTION_PATTERNS) {
+    if (pattern.test(source)) {
+      violations.push(pattern.source);
+    }
+  }
+  if (violations.length === 0) {
+    return { clean: true, text: source, violations: [] };
+  }
+  return {
+    clean: false,
+    text: REDACTED_PLACEHOLDER,
+    violations
+  };
+}
+function isSafeMemoryContent(text) {
+  return sanitizeMemoryContent(text).clean;
+}
+
+export {
+  sanitizeMemoryContent,
+  isSafeMemoryContent
+};
+//# sourceMappingURL=chunk-M62O4P4T.js.map

package/dist/chunk-M62O4P4T.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/sanitize.ts"],"sourcesContent":["const INJECTION_PATTERNS: RegExp[] = [\n  /ignore\\s+(all\\s+)?(previous|prior|above)\\s+(instructions?|prompts?|context)/i,\n  /forget\\s+(everything|all|previous|what)/i,\n  /new\\s+(system\\s+)?prompt:/i,\n  /\\[system\\]/i,\n  /<\\s*system\\s*>/i,\n  /you\\s+are\\s+now\\s+(?!called|named)/i,\n  /disregard\\s+(all\\s+)?(previous|prior)/i,\n  /override\\s+(previous\\s+)?(instructions?|prompt)/i,\n  /act\\s+as\\s+(?:an?\\s+)?(?:AI|assistant|ChatGPT|GPT|Claude|LLM)\\s+(?:without|that\\s+ignores)/i,\n  /do\\s+not\\s+(?:follow|obey)\\s+(?:previous|prior|your)\\s+instructions/i,\n  /pretend\\s+(?:you\\s+)?(?:have\\s+no|you\\s+don.?t\\s+have)\\s+(restrictions|guidelines|rules)/i,\n];\n\nexport type SanitizeResult = {\n  clean: boolean;\n  text: string;\n  violations: string[];\n};\n\nconst REDACTED_PLACEHOLDER = \"[content removed: possible prompt injection]\";\n\nexport function sanitizeMemoryContent(text: string): SanitizeResult {\n  const source = typeof text === \"string\" ? text : \"\";\n  const violations: string[] = [];\n\n  for (const pattern of INJECTION_PATTERNS) {\n    if (pattern.test(source)) {\n      violations.push(pattern.source);\n    }\n  }\n\n  if (violations.length === 0) {\n    return { clean: true, text: source, violations: [] };\n  }\n\n  return {\n    clean: false,\n    text: REDACTED_PLACEHOLDER,\n    violations,\n  };\n}\n\nexport function isSafeMemoryContent(text: string): boolean {\n  return sanitizeMemoryContent(text).clean;\n}\n\n"],"mappings":";AAAA,IAAM,qBAA+B;AAAA,EACnC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAQA,IAAM,uBAAuB;AAEtB,SAAS,sBAAsB,MAA8B;AAClE,QAAM,SAAS,OAAO,SAAS,WAAW,OAAO;AACjD,QAAM,aAAuB,CAAC;AAE9B,aAAW,WAAW,oBAAoB;AACxC,QAAI,QAAQ,KAAK,MAAM,GAAG;AACxB,iBAAW,KAAK,QAAQ,MAAM;AAAA,IAChC;AAAA,EACF;AAEA,MAAI,WAAW,WAAW,GAAG;AAC3B,WAAO,EAAE,OAAO,MAAM,MAAM,QAAQ,YAAY,CAAC,EAAE;AAAA,EACrD;AAEA,SAAO;AAAA,IACL,OAAO;AAAA,IACP,MAAM;AAAA,IACN;AAAA,EACF;AACF;AAEO,SAAS,oBAAoB,MAAuB;AACzD,SAAO,sBAAsB,IAAI,EAAE;AACrC;","names":[]}

package/dist/chunk-MARWOCVP.js

@@ -0,0 +1,48 @@
+// src/runtime/env.ts
+import os from "os";
+var REMNIC_ENGRAM_PREFIX_PAIRS = [
+  ["REMNIC_", "ENGRAM_"],
+  ["ENGRAM_", "REMNIC_"]
+];
+function getEnvMap() {
+  const runtimeProcess = globalThis.process;
+  return runtimeProcess?.["env"];
+}
+function legacyEnvCandidates(name) {
+  const candidates = [name];
+  for (const [primary, legacy] of REMNIC_ENGRAM_PREFIX_PAIRS) {
+    if (name.startsWith(primary)) {
+      candidates.push(`${legacy}${name.slice(primary.length)}`);
+    }
+  }
+  return candidates;
+}
+function readEnvVar(name) {
+  const env = getEnvMap();
+  for (const candidate of legacyEnvCandidates(name)) {
+    const value = env?.[candidate];
+    if (typeof value === "string") return value;
+  }
+  return void 0;
+}
+function resolveHomeDir() {
+  return readEnvVar("HOME") || os.homedir();
+}
+function cloneEnv() {
+  return { ...getEnvMap() ?? {} };
+}
+function mergeEnv(overrides) {
+  const merged = cloneEnv();
+  for (const [key, value] of Object.entries(overrides)) {
+    if (typeof value === "string") merged[key] = value;
+    else delete merged[key];
+  }
+  return merged;
+}
+
+export {
+  readEnvVar,
+  resolveHomeDir,
+  mergeEnv
+};
+//# sourceMappingURL=chunk-MARWOCVP.js.map

package/dist/chunk-MARWOCVP.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/runtime/env.ts"],"sourcesContent":["import os from \"node:os\";\n\ntype EnvMap = Record<string, string | undefined>;\nconst REMNIC_ENGRAM_PREFIX_PAIRS: Array<[string, string]> = [\n  [\"REMNIC_\", \"ENGRAM_\"],\n  [\"ENGRAM_\", \"REMNIC_\"],\n];\n\nfunction getEnvMap(): EnvMap | undefined {\n  const runtimeProcess = globalThis.process as { env?: EnvMap } | undefined;\n  return runtimeProcess?.[\"env\"];\n}\n\nfunction legacyEnvCandidates(name: string): string[] {\n  const candidates = [name];\n  for (const [primary, legacy] of REMNIC_ENGRAM_PREFIX_PAIRS) {\n    if (name.startsWith(primary)) {\n      candidates.push(`${legacy}${name.slice(primary.length)}`);\n    }\n  }\n  return candidates;\n}\n\nexport function readEnvVar(name: string): string | undefined {\n  const env = getEnvMap();\n  for (const candidate of legacyEnvCandidates(name)) {\n    const value = env?.[candidate];\n    if (typeof value === \"string\") return value;\n  }\n  return undefined;\n}\n\nexport function resolveHomeDir(): string {\n  return readEnvVar(\"HOME\") || os.homedir();\n}\n\nfunction cloneEnv(): NodeJS.ProcessEnv {\n  return { ...(getEnvMap() ?? {}) };\n}\n\nexport function mergeEnv(overrides: Record<string, string | undefined>): NodeJS.ProcessEnv {\n  const merged = cloneEnv();\n  for (const [key, value] of Object.entries(overrides)) {\n    if (typeof value === \"string\") merged[key] = value;\n    else delete merged[key];\n  }\n  return merged;\n}\n"],"mappings":";AAAA,OAAO,QAAQ;AAGf,IAAM,6BAAsD;AAAA,EAC1D,CAAC,WAAW,SAAS;AAAA,EACrB,CAAC,WAAW,SAAS;AACvB;AAEA,SAAS,YAAgC;AACvC,QAAM,iBAAiB,WAAW;AAClC,SAAO,iBAAiB,KAAK;AAC/B;AAEA,SAAS,oBAAoB,MAAwB;AACnD,QAAM,aAAa,CAAC,IAAI;AACxB,aAAW,CAAC,SAAS,MAAM,KAAK,4BAA4B;AAC1D,QAAI,KAAK,WAAW,OAAO,GAAG;AAC5B,iBAAW,KAAK,GAAG,MAAM,GAAG,KAAK,MAAM,QAAQ,MAAM,CAAC,EAAE;AAAA,IAC1D;AAAA,EACF;AACA,SAAO;AACT;AAEO,SAAS,WAAW,MAAkC;AAC3D,QAAM,MAAM,UAAU;AACtB,aAAW,aAAa,oBAAoB,IAAI,GAAG;AACjD,UAAM,QAAQ,MAAM,SAAS;AAC7B,QAAI,OAAO,UAAU,SAAU,QAAO;AAAA,EACxC;AACA,SAAO;AACT;AAEO,SAAS,iBAAyB;AACvC,SAAO,WAAW,MAAM,KAAK,GAAG,QAAQ;AAC1C;AAEA,SAAS,WAA8B;AACrC,SAAO,EAAE,GAAI,UAAU,KAAK,CAAC,EAAG;AAClC;AAEO,SAAS,SAAS,WAAkE;AACzF,QAAM,SAAS,SAAS;AACxB,aAAW,CAAC,KAAK,KAAK,KAAK,OAAO,QAAQ,SAAS,GAAG;AACpD,QAAI,OAAO,UAAU,SAAU,QAAO,GAAG,IAAI;AAAA,QACxC,QAAO,OAAO,GAAG;AAAA,EACxB;AACA,SAAO;AACT;","names":[]}