@remnic/core 1.1.30 → 9.3.515

package/dist/chunk-A6D7A2FW.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/transcript.ts"],"sourcesContent":["import { appendFile, mkdir, readdir, readFile, stat, unlink, writeFile } from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { log } from \"./logger.js\";\nimport type { TranscriptEntry, Checkpoint, PluginConfig } from \"./types.js\";\nimport { analyzeSessionIntegrity, type SessionIntegrityReport } from \"./session-integrity.js\";\nimport {\n  encodeStoragePathSegment,\n  encodeStoragePathSegmentWithHash,\n  isSafeLegacyPathSegment,\n  resolveSafeStoragePath,\n  storagePathHash,\n} from \"./storage-paths.js\";\n\ntype DirectorySessionStatus = \"missing\" | \"empty\" | \"matches\" | \"occupied\";\ntype DirectoryOwnershipCacheEntry = {\n  status: \"empty\" | \"matches\";\n  fileSizes: Map<string, number>;\n};\n\nfunction legacyTranscriptDirFor(\n  channelType: string,\n  channelId: string,\n  encodedDir: string,\n): string | undefined {\n  if (!isSafeLegacyPathSegment(channelType) || !isSafeLegacyPathSegment(channelId)) {\n    return undefined;\n  }\n  const legacyDir = path.join(channelType, channelId);\n  return legacyDir === encodedDir ? undefined : legacyDir;\n}\n\n/**\n * Manages conversation transcript storage, checkpointing, and recall formatting.\n *\n * Transcripts are stored as JSONL files in a hierarchical structure:\n *   transcripts/{channelType}/{channelId}.jsonl\n *\n * Channel types are extracted from sessionKey (discord, slack, cron, main, etc.)\n * Checkpoints are used to preserve conversation context across compaction events.\n */\nexport class TranscriptManager {\n  private transcriptsDir: string;\n  private checkpointPath: string;\n  private stateDir: string;\n  private toolUsageDir: string;\n  private config: PluginConfig;\n  private sessionFootprintCache = new Map<\n    string,\n    { totalBytes: number; fileBytes: Map<string, number>; fileSizes: Map<string, number> }\n  >();\n  private directoryOwnershipCache = new Map<string, DirectoryOwnershipCacheEntry>();\n\n  /** Default checkpoint TTL in hours */\n  private static readonly DEFAULT_CHECKPOINT_TTL_HOURS = 24;\n  /** Approximate characters per token for rough estimation */\n  private static readonly CHARS_PER_TOKEN = 4;\n\n  constructor(config: PluginConfig) {\n    this.config = config;\n    this.transcriptsDir = path.join(config.memoryDir, \"transcripts\");\n    this.stateDir = path.join(config.memoryDir, \"state\");\n    this.checkpointPath = path.join(this.stateDir, \"checkpoint.json\");\n    this.toolUsageDir = path.join(this.stateDir, \"tool-usage\");\n  }\n\n  /**\n   * Parse a sessionKey to extract channel type and ID.\n   *\n   * SessionKey patterns:\n   *   - agent:<agent-id>:main → type=\"main\", id=\"default\"\n   *   - agent:<agent-id>:discord:channel:<channel-id> → type=\"discord\", id=\"<channel-id>\"\n   *   - agent:<agent-id>:cron:<job-id> → type=\"cron\", id=\"<job-id>\"\n   *   - agent:<agent-id>:slack:channel:<channel-id> → type=\"slack\", id=\"<channel-id>\"\n   *\n   * @returns Object with raw channel identifiers and encoded storage path pieces.\n   */\n  getTranscriptPath(sessionKey: string): {\n    dir: string;\n    file: string;\n    channelType: string;\n    channelId: string;\n    alternateDir: string;\n    legacyDir?: string;\n  } {\n    const parts = sessionKey.split(\":\");\n\n    // Default fallback\n    let channelType = \"other\";\n    let channelId = \"default\";\n\n    if (parts.length >= 3) {\n      // parts[0] = \"agent\", parts[1] = agent name, parts[2] = channel type\n      channelType = parts[2];\n\n      // Extract channel ID based on pattern\n      if (channelType === \"main\") {\n        channelId = \"default\";\n      } else if (channelType === \"discord\" && parts.length >= 5 && parts[3] === \"channel\") {\n        channelId = parts[4];\n      } else if (channelType === \"slack\" && parts.length >= 5 && parts[3] === \"channel\") {\n        channelId = parts[4];\n      } else if (channelType === \"cron\" && parts.length >= 4) {\n        channelId = parts[3];\n      } else if (parts.length >= 4) {\n        // For other types, use the 4th part as ID if available\n        channelId = parts[3];\n      }\n    }\n\n    // Daily rotation: transcripts/{channelType}/{channelId}/YYYY-MM-DD.jsonl\n    const today = new Date().toISOString().slice(0, 10);\n    const dir = path.join(\n      encodeStoragePathSegment(channelType),\n      encodeStoragePathSegment(channelId),\n    );\n    const alternateDir = path.join(\n      encodeStoragePathSegmentWithHash(channelType),\n      `${encodeStoragePathSegmentWithHash(channelId)}--session-${storagePathHash(sessionKey)}`,\n    );\n    return {\n      dir,\n      file: `${today}.jsonl`,\n      channelType,\n      channelId,\n      alternateDir,\n      legacyDir: legacyTranscriptDirFor(channelType, channelId, dir),\n    };\n  }\n\n  /**\n   * Initialize the transcript manager by ensuring directories exist.\n   */\n  async initialize(): Promise<void> {\n    await mkdir(this.transcriptsDir, { recursive: true });\n    await mkdir(this.stateDir, { recursive: true });\n    await mkdir(this.toolUsageDir, { recursive: true });\n    log.info(\"transcript manager initialized\");\n  }\n\n  /**\n   * Best-effort list of sessionKeys that have transcript files on disk.\n   * This is used by cron-style tooling (hourly summaries, conversation indexing)\n   * to iterate across \"active\" sessions.\n   */\n  async listSessionKeys(): Promise<string[]> {\n    const transcriptDir = this.transcriptsDir;\n    const sessionKeys = new Set<string>();\n\n    try {\n      const typeEntries = await readdir(transcriptDir, { withFileTypes: true });\n      for (const typeEnt of typeEntries) {\n        if (!typeEnt.isDirectory()) continue;\n        const typeDir = path.join(transcriptDir, typeEnt.name);\n        const idEntries = await readdir(typeDir, { withFileTypes: true });\n        for (const idEnt of idEntries) {\n          if (!idEnt.isDirectory()) continue;\n          const chanDir = path.join(typeDir, idEnt.name);\n          const files = (await readdir(chanDir)).filter((f) => f.endsWith(\".jsonl\")).sort();\n          const last = files[files.length - 1];\n          if (!last) continue;\n          try {\n            const raw = await readFile(path.join(chanDir, last), \"utf-8\");\n            const firstLine = raw.split(\"\\n\").find((l) => l.trim().length > 0);\n            if (!firstLine) continue;\n            const entry = JSON.parse(firstLine) as TranscriptEntry;\n            if (typeof entry.sessionKey === \"string\" && entry.sessionKey.length > 0) {\n              sessionKeys.add(entry.sessionKey);\n            }\n          } catch {\n            // ignore\n          }\n        }\n      }\n    } catch {\n      return [];\n    }\n\n    return Array.from(sessionKeys);\n  }\n\n  getToolUsagePath(sessionKey: string): {\n    dir: string;\n    file: string;\n    alternateDir: string;\n    legacyDir?: string;\n  } {\n    const p = this.getTranscriptPath(sessionKey);\n    return { dir: p.dir, file: p.file, alternateDir: p.alternateDir, legacyDir: p.legacyDir };\n  }\n\n  private async selectStorageDirForWrite(\n    root: string,\n    dir: string,\n    legacyDir?: string,\n    sessionKey?: string,\n    alternateDir?: string,\n  ): Promise<{ dir: string; channelDir: string }> {\n    const channelDir = await resolveSafeStoragePath(root, dir);\n    const encodedStatus = await this.directorySessionStatus(root, dir, sessionKey);\n    if (encodedStatus === \"matches\" || encodedStatus === \"empty\") return { dir, channelDir };\n\n    if (legacyDir) {\n      const legacyChannelDir = await resolveSafeStoragePath(root, legacyDir);\n      if ((await this.directorySessionStatus(root, legacyDir, sessionKey)) === \"matches\") {\n        return { dir: legacyDir, channelDir: legacyChannelDir };\n      }\n    }\n\n    if (encodedStatus === \"missing\") return { dir, channelDir };\n\n    if (alternateDir) {\n      const alternateChannelDir = await resolveSafeStoragePath(root, alternateDir);\n      const alternateStatus = await this.directorySessionStatus(root, alternateDir, sessionKey);\n      if (\n        alternateStatus === \"missing\" ||\n        alternateStatus === \"empty\" ||\n        alternateStatus === \"matches\"\n      ) {\n        return { dir: alternateDir, channelDir: alternateChannelDir };\n      }\n    }\n\n    throw new Error(`transcript storage path collision for session: ${sessionKey ?? \"(unknown)\"}`);\n  }\n\n  private async directorySessionStatus(\n    root: string,\n    dir: string,\n    sessionKey?: string,\n  ): Promise<DirectorySessionStatus> {\n    let channelDir: string;\n    try {\n      channelDir = await resolveSafeStoragePath(root, dir);\n      if (!(await stat(channelDir)).isDirectory()) return \"occupied\";\n    } catch (err) {\n      const code =\n        err && typeof err === \"object\" && \"code\" in err\n          ? (err as { code?: string }).code\n          : undefined;\n      if (code === \"ENOENT\") return \"missing\";\n      throw err;\n    }\n\n    let names: string[];\n    try {\n      names = (await readdir(channelDir)).filter((file) => file.endsWith(\".jsonl\"));\n    } catch {\n      return \"occupied\";\n    }\n\n    const fileSizes = await this.directoryJsonlFileSizes(root, dir, names);\n    if (!fileSizes) return \"occupied\";\n\n    if (!sessionKey) return \"matches\";\n    const cacheKey = this.directoryOwnershipCacheKey(root, dir, sessionKey);\n    const cached = this.directoryOwnershipCache.get(cacheKey);\n    if (cached && this.sameFileSizes(cached.fileSizes, fileSizes)) {\n      return cached.status;\n    }\n\n    let hasEntries = false;\n    let hasMatchingEntry = false;\n\n    for (const name of names) {\n      const filePath = await resolveSafeStoragePath(root, dir, name).catch(() => null);\n      if (filePath === null) return \"occupied\";\n      try {\n        const raw = await readFile(filePath, \"utf-8\");\n        for (const line of raw.split(\"\\n\")) {\n          if (!line.trim()) continue;\n          hasEntries = true;\n          try {\n            const obj = JSON.parse(line) as { sessionKey?: string };\n            if (obj.sessionKey === sessionKey) {\n              hasMatchingEntry = true;\n            } else {\n              return \"occupied\";\n            }\n          } catch {\n            return \"occupied\";\n          }\n        }\n      } catch {\n        return \"occupied\";\n      }\n    }\n\n    const status = hasMatchingEntry ? \"matches\" : hasEntries ? \"occupied\" : \"empty\";\n    if (status === \"matches\" || status === \"empty\") {\n      this.directoryOwnershipCache.set(cacheKey, { status, fileSizes });\n    }\n    return status;\n  }\n\n  private directoryOwnershipCacheKey(root: string, dir: string, sessionKey: string): string {\n    return `${path.resolve(root)}\\0${dir}\\0${sessionKey}`;\n  }\n\n  private sameFileSizes(left: Map<string, number>, right: Map<string, number>): boolean {\n    if (left.size !== right.size) return false;\n    for (const [name, size] of left) {\n      if (right.get(name) !== size) return false;\n    }\n    return true;\n  }\n\n  private async directoryJsonlFileSizes(\n    root: string,\n    dir: string,\n    names: string[],\n  ): Promise<Map<string, number> | null> {\n    const fileSizes = new Map<string, number>();\n    for (const name of names) {\n      const filePath = await resolveSafeStoragePath(root, dir, name).catch(() => null);\n      if (filePath === null) return null;\n      const fileInfo = await stat(filePath).catch(() => null);\n      if (!fileInfo?.isFile()) return null;\n      fileSizes.set(name, Math.max(0, fileInfo.size));\n    }\n    return fileSizes;\n  }\n\n  private async rememberDirectoryOwnership(\n    root: string,\n    dir: string,\n    sessionKey: string,\n  ): Promise<void> {\n    try {\n      const channelDir = await resolveSafeStoragePath(root, dir);\n      const names = (await readdir(channelDir)).filter((file) => file.endsWith(\".jsonl\"));\n      const fileSizes = await this.directoryJsonlFileSizes(root, dir, names);\n      if (!fileSizes) return;\n      this.directoryOwnershipCache.set(\n        this.directoryOwnershipCacheKey(root, dir, sessionKey),\n        { status: \"matches\", fileSizes },\n      );\n    } catch {\n      // Cache refresh is best-effort; write path correctness does not depend on it.\n    }\n  }\n\n  private async getSessionStorageFiles(\n    root: string,\n    dir: string,\n    legacyDir?: string,\n    alternateDir?: string,\n  ): Promise<Array<{ cacheKey: string; name: string; path: string }>> {\n    const files: Array<{ cacheKey: string; name: string; path: string }> = [];\n    const seenDirs = new Set<string>();\n\n    for (const candidateDir of [dir, alternateDir, legacyDir]) {\n      if (!candidateDir || seenDirs.has(candidateDir)) continue;\n      seenDirs.add(candidateDir);\n\n      let channelDir: string;\n      try {\n        channelDir = await resolveSafeStoragePath(root, candidateDir);\n      } catch {\n        continue;\n      }\n\n      let names: string[];\n      try {\n        names = (await readdir(channelDir)).filter((file) => file.endsWith(\".jsonl\")).sort();\n      } catch {\n        continue;\n      }\n\n      for (const name of names) {\n        const filePath = await resolveSafeStoragePath(root, candidateDir, name).catch(() => null);\n        if (filePath === null) continue;\n        files.push({\n          cacheKey: path.join(candidateDir, name),\n          name,\n          path: filePath,\n        });\n      }\n    }\n\n    return files.sort((a, b) => a.cacheKey.localeCompare(b.cacheKey));\n  }\n\n  async appendToolUse(entry: { timestamp: string; sessionKey: string; tool: string }): Promise<void> {\n    const { dir, file, alternateDir, legacyDir } = this.getToolUsagePath(entry.sessionKey);\n    const { dir: writeDir, channelDir } = await this.selectStorageDirForWrite(\n      this.toolUsageDir,\n      dir,\n      legacyDir,\n      entry.sessionKey,\n      alternateDir,\n    );\n    await mkdir(channelDir, { recursive: true });\n    const filePath = await resolveSafeStoragePath(this.toolUsageDir, writeDir, file);\n    await appendFile(filePath, JSON.stringify(entry) + \"\\n\", \"utf-8\");\n    await this.rememberDirectoryOwnership(this.toolUsageDir, writeDir, entry.sessionKey);\n  }\n\n  async readToolUse(\n    sessionKey: string,\n    startTime: Date,\n    endTime: Date,\n  ): Promise<Array<{ timestamp: string; sessionKey: string; tool: string }>> {\n    const { dir, alternateDir, legacyDir } = this.getToolUsagePath(sessionKey);\n    try {\n      const files = await this.getSessionStorageFiles(this.toolUsageDir, dir, legacyDir, alternateDir);\n      const out: Array<{ timestamp: string; sessionKey: string; tool: string }> = [];\n      for (const file of files) {\n        const raw = await readFile(file.path, \"utf-8\");\n        for (const line of raw.split(\"\\n\")) {\n          if (!line.trim()) continue;\n          try {\n            const obj = JSON.parse(line) as any;\n            const ts = new Date(String(obj.timestamp ?? \"\")).getTime();\n            if (!Number.isFinite(ts)) continue;\n            if (ts >= startTime.getTime() && ts < endTime.getTime()) {\n              if (typeof obj.tool === \"string\" && typeof obj.sessionKey === \"string\") {\n                if (obj.sessionKey === sessionKey) {\n                  out.push({ timestamp: obj.timestamp, sessionKey: obj.sessionKey, tool: obj.tool });\n                }\n              }\n            }\n          } catch {\n            // ignore\n          }\n        }\n      }\n      return out;\n    } catch {\n      return [];\n    }\n  }\n\n  async estimateSessionFootprint(sessionKey: string): Promise<{ bytes: number; tokens: number }> {\n    const { dir, alternateDir, legacyDir } = this.getTranscriptPath(sessionKey);\n    let bytes = 0;\n\n    try {\n      const files = await this.getSessionStorageFiles(this.transcriptsDir, dir, legacyDir, alternateDir);\n      const cached = this.sessionFootprintCache.get(sessionKey);\n      if (!cached) {\n        const fileBytes = new Map<string, number>();\n        const fileSizes = new Map<string, number>();\n        for (const file of files) {\n          try {\n            const fileInfo = await stat(file.path);\n            const sessionBytes = await this.estimateSessionBytesInFile(\n              file.path,\n              sessionKey,\n            );\n            fileBytes.set(file.cacheKey, sessionBytes);\n            fileSizes.set(file.cacheKey, Math.max(0, fileInfo.size));\n            bytes += sessionBytes;\n          } catch {\n            // fail-open\n          }\n        }\n        this.sessionFootprintCache.set(sessionKey, { totalBytes: bytes, fileBytes, fileSizes });\n      } else {\n        bytes = cached.totalBytes;\n        const seen = new Set(files.map((file) => file.cacheKey));\n\n        // Drop removed files from the cached total.\n        for (const [cachedFile, cachedSessionBytes] of cached.fileBytes.entries()) {\n          if (!seen.has(cachedFile)) {\n            bytes -= cachedSessionBytes;\n            cached.fileBytes.delete(cachedFile);\n            cached.fileSizes.delete(cachedFile);\n          }\n        }\n\n        // Read only newly discovered files.\n        for (const file of files) {\n          if (cached.fileBytes.has(file.cacheKey)) continue;\n          try {\n            const fileInfo = await stat(file.path);\n            const sessionBytes = await this.estimateSessionBytesInFile(file.path, sessionKey);\n            cached.fileBytes.set(file.cacheKey, sessionBytes);\n            cached.fileSizes.set(file.cacheKey, Math.max(0, fileInfo.size));\n            bytes += sessionBytes;\n          } catch {\n            // fail-open\n          }\n        }\n\n        // Recompute any shard whose file size changed. A session can have both\n        // encoded and legacy directories during migration, so path ordering does\n        // not reliably identify the file that can grow.\n        for (const file of files) {\n          try {\n            const fileInfo = await stat(file.path);\n            const size = Math.max(0, fileInfo.size);\n            const previousSessionBytes = cached.fileBytes.get(file.cacheKey) ?? 0;\n            const previousSize = cached.fileSizes.get(file.cacheKey) ?? -1;\n            if (size !== previousSize) {\n              const sessionBytes = await this.estimateSessionBytesInFile(file.path, sessionKey);\n              cached.fileBytes.set(file.cacheKey, sessionBytes);\n              cached.fileSizes.set(file.cacheKey, size);\n              bytes += sessionBytes - previousSessionBytes;\n            }\n          } catch {\n            // fail-open\n          }\n        }\n\n        if (bytes < 0) bytes = 0;\n        cached.totalBytes = bytes;\n      }\n    } catch {\n      // fail-open\n      this.sessionFootprintCache.delete(sessionKey);\n    }\n\n    return {\n      bytes,\n      tokens: Math.floor(bytes / TranscriptManager.CHARS_PER_TOKEN),\n    };\n  }\n\n  private async estimateSessionBytesInFile(filePath: string, sessionKey: string): Promise<number> {\n    try {\n      const raw = await readFile(filePath, \"utf-8\");\n      let total = 0;\n      for (const line of raw.split(\"\\n\")) {\n        if (!line.trim()) continue;\n        try {\n          const parsed = JSON.parse(line) as { sessionKey?: string };\n          if (parsed.sessionKey === sessionKey) {\n            total += Buffer.byteLength(`${line}\\n`, \"utf-8\");\n          }\n        } catch {\n          // fail-open for malformed lines\n        }\n      }\n      return total;\n    } catch {\n      return 0;\n    }\n  }\n\n  /**\n   * Check if a file is a legacy flat transcript file (YYYY-MM-DD.jsonl format).\n   */\n  private isLegacyTranscriptFile(filename: string): boolean {\n    return /^\\d{4}-\\d{2}-\\d{2}\\.jsonl$/.test(filename);\n  }\n\n  /**\n   * Append a turn to the appropriate transcript file.\n   * Files are stored hierarchically: transcripts/{channelType}/{channelId}.jsonl\n   *\n   * Skips channel types in config.transcriptSkipChannelTypes (e.g., \"cron\").\n   */\n  async append(entry: TranscriptEntry): Promise<void> {\n    try {\n      const { dir, file, channelType, alternateDir, legacyDir } = this.getTranscriptPath(entry.sessionKey);\n\n      // Skip if this channel type is in the skip list\n      if (this.config.transcriptSkipChannelTypes.includes(channelType)) {\n        return;\n      }\n\n      const { dir: writeDir, channelDir } = await this.selectStorageDirForWrite(\n        this.transcriptsDir,\n        dir,\n        legacyDir,\n        entry.sessionKey,\n        alternateDir,\n      );\n      const filePath = await resolveSafeStoragePath(this.transcriptsDir, writeDir, file);\n\n      // Ensure channel directory exists\n      await mkdir(channelDir, { recursive: true });\n\n      const line = JSON.stringify(entry) + \"\\n\";\n      await appendFile(filePath, line, \"utf-8\");\n      await this.rememberDirectoryOwnership(this.transcriptsDir, writeDir, entry.sessionKey);\n      log.debug(`appended transcript entry for ${entry.sessionKey}: ${entry.turnId}`);\n    } catch (err) {\n      log.error(\"failed to append transcript entry:\", err);\n      throw err;\n    }\n  }\n\n  /**\n   * Get all transcript files from the hierarchical directory structure.\n   * Recursively finds all .jsonl files in transcripts/{channelType}/{channelId}/ subdirectories.\n   */\n  private async getAllTranscriptFiles(): Promise<string[]> {\n    const files: string[] = [];\n\n    try {\n      const entries = await readdir(this.transcriptsDir, { withFileTypes: true });\n\n      for (const entry of entries) {\n        if (entry.isDirectory()) {\n          // This is a channel type directory (discord, slack, cron, main, etc.)\n          const channelTypeDir = path.join(this.transcriptsDir, entry.name);\n          try {\n            const channelTypeEntries = await readdir(channelTypeDir, { withFileTypes: true });\n\n            for (const channelTypeEntry of channelTypeEntries) {\n              if (channelTypeEntry.isDirectory()) {\n                // This is a channel ID directory - contains daily transcript files\n                const channelDir = path.join(channelTypeDir, channelTypeEntry.name);\n                try {\n                  const channelFiles = await readdir(channelDir);\n                  for (const file of channelFiles) {\n                    if (file.endsWith(\".jsonl\")) {\n                      files.push(path.join(entry.name, channelTypeEntry.name, file));\n                    }\n                  }\n                } catch {\n                  // Skip unreadable directories\n                }\n              } else if (channelTypeEntry.isFile() && channelTypeEntry.name.endsWith(\".jsonl\")) {\n                // Legacy: channel type dir contains .jsonl files directly\n                files.push(path.join(entry.name, channelTypeEntry.name));\n              }\n            }\n          } catch {\n            // Skip unreadable directories\n          }\n        } else if (entry.isFile() && entry.name.endsWith(\".jsonl\")) {\n          // Legacy flat file - still include for backward compatibility\n          files.push(entry.name);\n        }\n      }\n    } catch {\n      // Directory doesn't exist or is unreadable\n    }\n\n    return files;\n  }\n\n  /**\n   * Read transcript entries for a date range.\n   * Returns entries within the time range, optionally filtered by sessionKey.\n   * Reads from all channel subdirectories in the hierarchical structure.\n   */\n  async readRange(startTime: string, endTime: string, sessionKey?: string): Promise<TranscriptEntry[]> {\n    const start = new Date(startTime);\n    const end = new Date(endTime);\n    const entries: TranscriptEntry[] = [];\n\n    try {\n      // Get all transcript files from the hierarchical structure\n      const transcriptFiles = await this.getAllTranscriptFiles();\n\n      // Read each relevant file\n      for (const relativePath of transcriptFiles) {\n        const filePath = path.join(this.transcriptsDir, relativePath);\n        try {\n          const content = await readFile(filePath, \"utf-8\");\n          const lines = content.trim().split(\"\\n\").filter(Boolean);\n\n          for (const line of lines) {\n            try {\n              const entry = JSON.parse(line) as TranscriptEntry;\n              const entryTime = new Date(entry.timestamp);\n\n              // Check if entry is within time range\n              if (entryTime >= start && entryTime < end) {\n                // Filter by sessionKey if provided\n                if (!sessionKey || entry.sessionKey === sessionKey) {\n                  entries.push(entry);\n                }\n              }\n            } catch {\n              // Skip malformed lines\n              log.debug(`skipped malformed transcript line in ${relativePath}`);\n            }\n          }\n        } catch {\n          // File doesn't exist or is unreadable - skip\n        }\n      }\n\n      // Sort by timestamp\n      entries.sort((a, b) => new Date(a.timestamp).getTime() - new Date(b.timestamp).getTime());\n\n      log.debug(`read ${entries.length} transcript entries from ${transcriptFiles.length} file(s)`);\n      return entries;\n    } catch (err) {\n      log.error(\"failed to read transcript range:\", err);\n      return [];\n    }\n  }\n\n  /**\n   * Read the last N hours of transcript.\n   *\n   * Fast path: when sessionKey is given, reads only the 1-2 daily files for that\n   * specific channel instead of scanning all 95+ transcript files across all channels.\n   */\n  async readRecent(hours: number, sessionKey?: string): Promise<TranscriptEntry[]> {\n    const end = new Date();\n    const start = new Date(end.getTime() - hours * 60 * 60 * 1000);\n\n    if (sessionKey) {\n      return this.readRecentForSession(start, end, sessionKey);\n    }\n    return this.readRange(start.toISOString(), end.toISOString(), undefined);\n  }\n\n  /**\n   * Optimized read for a specific session: only looks in that session's channel\n   * directory and only reads files whose date falls within the lookback window.\n   */\n  private async readRecentForSession(\n    start: Date,\n    end: Date,\n    sessionKey: string,\n  ): Promise<TranscriptEntry[]> {\n    const { dir, alternateDir, legacyDir } = this.getTranscriptPath(sessionKey);\n\n    // Build set of date strings that overlap with [start, end].\n    // Always include end's date to handle midnight-crossing lookbacks\n    // (e.g. start=23:30 yesterday, end=00:30 today).\n    const dateStrings = new Set<string>();\n    const cursor = new Date(start);\n    while (cursor <= end) {\n      dateStrings.add(cursor.toISOString().slice(0, 10));\n      cursor.setDate(cursor.getDate() + 1);\n    }\n    dateStrings.add(end.toISOString().slice(0, 10));\n\n    const entries: TranscriptEntry[] = [];\n    const files = await this.getSessionStorageFiles(this.transcriptsDir, dir, legacyDir, alternateDir);\n\n    for (const file of files) {\n      // Only read files whose date is within the window\n      const dateStr = file.name.slice(0, 10);\n      if (!dateStrings.has(dateStr)) continue;\n\n      try {\n        const content = await readFile(file.path, \"utf-8\");\n        for (const line of content.split(\"\\n\")) {\n          if (!line.trim()) continue;\n          try {\n            const entry = JSON.parse(line) as TranscriptEntry;\n            const ts = new Date(entry.timestamp);\n            if (ts >= start && ts < end && entry.sessionKey === sessionKey) {\n              entries.push(entry);\n            }\n          } catch {\n            // skip malformed line\n          }\n        }\n      } catch {\n        // skip unreadable file\n      }\n    }\n\n    entries.sort((a, b) => new Date(a.timestamp).getTime() - new Date(b.timestamp).getTime());\n    log.debug(`readRecentForSession: ${entries.length} entries from ${files.length} file(s) in ${dir}`);\n    return entries;\n  }\n\n  /**\n   * Cleanup old transcript entries that are older than retentionDays.\n   * For hierarchical structure, reads each file and rewrites without old entries.\n   * Legacy flat files are deleted if their date is older than retentionDays.\n   * Returns the number of files processed (cleaned or deleted).\n   */\n  async cleanup(retentionDays: number): Promise<number> {\n    if (retentionDays <= 0) {\n      log.warn(\"cleanup called with invalid retentionDays:\", retentionDays);\n      return 0;\n    }\n\n    const cutoff = new Date();\n    cutoff.setDate(cutoff.getDate() - retentionDays);\n    cutoff.setHours(0, 0, 0, 0);\n\n    let processed = 0;\n\n    try {\n      const entries = await readdir(this.transcriptsDir, { withFileTypes: true });\n\n      for (const entry of entries) {\n        if (entry.isDirectory()) {\n          // This is a channel type directory (discord, slack, cron, main, etc.)\n          const channelTypeDir = path.join(this.transcriptsDir, entry.name);\n          try {\n            const channelTypeEntries = await readdir(channelTypeDir, { withFileTypes: true });\n\n            for (const channelTypeEntry of channelTypeEntries) {\n              if (channelTypeEntry.isDirectory()) {\n                // This is a channel ID directory - contains daily transcript files\n                const channelDir = path.join(channelTypeDir, channelTypeEntry.name);\n                try {\n                  const channelFiles = await readdir(channelDir);\n                  for (const file of channelFiles) {\n                    if (!file.endsWith(\".jsonl\")) continue;\n\n                    const filePath = path.join(channelDir, file);\n\n                    // Check if file is a daily transcript file (YYYY-MM-DD.jsonl)\n                    if (this.isLegacyTranscriptFile(file)) {\n                      const dateStr = file.slice(0, 10);\n                      const fileDate = new Date(dateStr);\n\n                      if (!isNaN(fileDate.getTime()) && fileDate < cutoff) {\n                        try {\n                          await unlink(filePath);\n                          processed++;\n                          log.debug(`deleted old daily transcript file: ${entry.name}/${channelTypeEntry.name}/${file}`);\n                        } catch (err) {\n                          log.error(`failed to delete transcript file ${filePath}:`, err);\n                        }\n                      }\n                    } else {\n                      // Legacy file in new structure - clean up old entries\n                      const cleaned = await this.cleanupTranscriptFile(filePath, cutoff);\n                      if (cleaned) {\n                        processed++;\n                      }\n                    }\n                  }\n                } catch (err) {\n                  log.debug(`failed to process channel directory ${entry.name}/${channelTypeEntry.name}:`, err);\n                }\n              } else if (channelTypeEntry.isFile() && channelTypeEntry.name.endsWith(\".jsonl\")) {\n                // Legacy: channel type dir contains .jsonl files directly\n                const filePath = path.join(channelTypeDir, channelTypeEntry.name);\n                const cleaned = await this.cleanupTranscriptFile(filePath, cutoff);\n                if (cleaned) {\n                  processed++;\n                }\n              }\n            }\n          } catch (err) {\n            log.debug(`failed to process channel type directory ${entry.name}:`, err);\n          }\n        } else if (entry.isFile() && entry.name.endsWith(\".jsonl\")) {\n          // Handle legacy flat files - delete if older than retentionDays\n          if (this.isLegacyTranscriptFile(entry.name)) {\n            const dateStr = entry.name.slice(0, 10);\n            const fileDate = new Date(dateStr);\n\n            if (!isNaN(fileDate.getTime()) && fileDate < cutoff) {\n              const filePath = path.join(this.transcriptsDir, entry.name);\n              try {\n                await unlink(filePath);\n                processed++;\n                log.debug(`deleted old legacy transcript file: ${entry.name}`);\n              } catch (err) {\n                log.error(`failed to delete legacy transcript file ${entry.name}:`, err);\n              }\n            }\n          }\n        }\n      }\n\n      if (processed > 0) {\n        log.info(`cleaned up ${processed} transcript file(s) older than ${retentionDays} days`);\n      }\n\n      return processed;\n    } catch (err) {\n      log.error(\"failed to cleanup old transcripts:\", err);\n      return 0;\n    }\n  }\n\n  /**\n   * Clean up old entries from a single transcript file.\n   * Reads the file, filters out entries older than cutoff, and rewrites if needed.\n   * Returns true if the file was processed (cleaned or deleted).\n   */\n  private async cleanupTranscriptFile(filePath: string, cutoff: Date): Promise<boolean> {\n    try {\n      const content = await readFile(filePath, \"utf-8\");\n      const lines = content.trim().split(\"\\n\").filter(Boolean);\n\n      const validLines: string[] = [];\n      let hasOldEntries = false;\n\n      for (const line of lines) {\n        try {\n          const entry = JSON.parse(line) as TranscriptEntry;\n          const entryTime = new Date(entry.timestamp);\n\n          if (entryTime >= cutoff) {\n            validLines.push(line);\n          } else {\n            hasOldEntries = true;\n          }\n        } catch {\n          // Keep malformed lines to avoid data loss\n          validLines.push(line);\n        }\n      }\n\n      if (validLines.length === 0) {\n        // No valid entries left, delete the file\n        try {\n          await unlink(filePath);\n          log.debug(`deleted empty transcript file: ${filePath}`);\n          return true;\n        } catch (err) {\n          log.error(`failed to delete empty transcript file ${filePath}:`, err);\n          return false;\n        }\n      }\n\n      if (hasOldEntries) {\n        // Rewrite file without old entries\n        await writeFile(filePath, validLines.join(\"\\n\") + \"\\n\", \"utf-8\");\n        log.debug(`cleaned old entries from transcript file: ${filePath}`);\n        return true;\n      }\n\n      // No old entries found, no action needed\n      return false;\n    } catch (err) {\n      // File doesn't exist or is unreadable\n      return false;\n    }\n  }\n\n  /**\n   * Save a checkpoint to preserve conversation context.\n   * Called when compaction is detected.\n   */\n  async saveCheckpoint(checkpoint: Checkpoint): Promise<void> {\n    try {\n      await writeFile(this.checkpointPath, JSON.stringify(checkpoint, null, 2), \"utf-8\");\n      log.info(`saved checkpoint for session ${checkpoint.sessionKey} with ${checkpoint.turns.length} turn(s)`);\n    } catch (err) {\n      log.error(\"failed to save checkpoint:\", err);\n      throw err;\n    }\n  }\n\n  /**\n   * Load a checkpoint if one exists and is not expired.\n   * Returns null if no checkpoint exists or if it has expired.\n   */\n  async loadCheckpoint(sessionKey?: string): Promise<Checkpoint | null> {\n    try {\n      const raw = await readFile(this.checkpointPath, \"utf-8\");\n      const checkpoint = JSON.parse(raw) as Checkpoint;\n\n      // Validate checkpoint structure\n      if (!checkpoint.sessionKey || !checkpoint.capturedAt || !checkpoint.ttl || !Array.isArray(checkpoint.turns)) {\n        log.warn(\"checkpoint file has invalid structure\");\n        return null;\n      }\n\n      // Check if checkpoint is for the requested session (if specified)\n      if (sessionKey && checkpoint.sessionKey !== sessionKey) {\n        log.debug(`checkpoint session mismatch: ${checkpoint.sessionKey} vs ${sessionKey}`);\n        return null;\n      }\n\n      // Check if checkpoint has expired\n      const ttl = new Date(checkpoint.ttl);\n      if (isNaN(ttl.getTime())) {\n        log.warn(\"checkpoint has invalid TTL format\");\n        return null;\n      }\n\n      if (ttl < new Date()) {\n        log.info(`checkpoint expired at ${checkpoint.ttl}`);\n        return null;\n      }\n\n      log.info(`loaded checkpoint with ${checkpoint.turns.length} turn(s), expires at ${checkpoint.ttl}`);\n      return checkpoint;\n    } catch (err) {\n      // File doesn't exist or is unreadable - that's fine\n      log.debug(\"no valid checkpoint found\");\n      return null;\n    }\n  }\n\n  /**\n   * Clear (delete) the checkpoint file.\n   * Called after successful injection of checkpoint context.\n   */\n  async clearCheckpoint(): Promise<void> {\n    try {\n      await unlink(this.checkpointPath);\n      log.info(\"cleared checkpoint\");\n    } catch (err) {\n      // File doesn't exist - that's fine\n      log.debug(\"no checkpoint to clear\");\n    }\n  }\n\n  /**\n   * Format entries for recall injection.\n   * Returns a formatted string suitable for injecting into agent context.\n   *\n   * Format:\n   * ## Recent Conversation (last X hours)\n   * [10:32] User: message content\n   * [10:33] Assistant: response content\n   *\n   * Content is trimmed to approximately maxTokens.\n   */\n  formatForRecall(entries: TranscriptEntry[], maxTokens: number): string {\n    if (entries.length === 0) {\n      return \"\";\n    }\n\n    const maxChars = maxTokens * TranscriptManager.CHARS_PER_TOKEN;\n    const lines: string[] = [];\n\n    // Calculate time range for header\n    const firstEntry = new Date(entries[0].timestamp);\n    const lastEntry = new Date(entries[entries.length - 1].timestamp);\n    const hoursDiff = Math.round((lastEntry.getTime() - firstEntry.getTime()) / (60 * 60 * 1000));\n\n    // Add header\n    if (hoursDiff < 1) {\n      lines.push(\"## Recent Conversation (last few minutes)\");\n    } else {\n      lines.push(`## Recent Conversation (last ${hoursDiff} hour${hoursDiff === 1 ? \"\" : \"s\"})`);\n    }\n    lines.push(\"\");\n\n    // Format each entry\n    const formattedEntries: string[] = [];\n    for (const entry of entries) {\n      const time = new Date(entry.timestamp);\n      const timeStr = time.toLocaleTimeString(\"en-US\", {\n        hour: \"2-digit\",\n        minute: \"2-digit\",\n        hour12: false,\n      });\n      const roleLabel = entry.role === \"user\" ? \"User\" : \"Assistant\";\n      formattedEntries.push(`[${timeStr}] ${roleLabel}: ${entry.content}`);\n    }\n\n    // Build output, trimming from the beginning if too long\n    // (we want to keep the most recent context)\n    let totalChars = lines.join(\"\\n\").length;\n    const selectedEntries: string[] = [];\n\n    for (let i = formattedEntries.length - 1; i >= 0; i--) {\n      const entry = formattedEntries[i];\n      const entryChars = entry.length + 1; // +1 for newline\n\n      if (totalChars + entryChars > maxChars && selectedEntries.length > 0) {\n        // Adding this entry would exceed limit, and we have some entries already\n        break;\n      }\n\n      selectedEntries.unshift(entry);\n      totalChars += entryChars;\n    }\n\n    lines.push(...selectedEntries);\n    lines.push(\"\"); // Trailing newline\n\n    const result = lines.join(\"\\n\");\n    log.debug(`formatted ${selectedEntries.length}/${entries.length} transcript entries for recall (~${result.length} chars)`);\n\n    return result;\n  }\n\n  /**\n   * Create a checkpoint from the current buffer state.\n   * Helper method for creating checkpoints before compaction.\n   */\n  createCheckpoint(sessionKey: string, turns: TranscriptEntry[], ttlHours?: number): Checkpoint {\n    const ttl = ttlHours ?? TranscriptManager.DEFAULT_CHECKPOINT_TTL_HOURS;\n    const expiresAt = new Date();\n    expiresAt.setHours(expiresAt.getHours() + ttl);\n\n    return {\n      sessionKey,\n      capturedAt: new Date().toISOString(),\n      turns: [...turns], // Copy turns to avoid mutation\n      ttl: expiresAt.toISOString(),\n    };\n  }\n\n  /**\n   * Get statistics about stored transcripts.\n   * Returns counts from the hierarchical directory structure.\n   */\n  async getStats(): Promise<{\n    totalFiles: number;\n    totalEntries: number;\n    oldestFile: string | null;\n    newestFile: string | null;\n    channelTypes: Record<string, number>;\n  }> {\n    try {\n      const allFiles = await this.getAllTranscriptFiles();\n\n      if (allFiles.length === 0) {\n        return {\n          totalFiles: 0,\n          totalEntries: 0,\n          oldestFile: null,\n          newestFile: null,\n          channelTypes: {},\n        };\n      }\n\n      // Sort files by path\n      const sortedFiles = allFiles.sort();\n\n      let totalEntries = 0;\n      const channelTypes: Record<string, number> = {};\n\n      for (const relativePath of allFiles) {\n        const filePath = path.join(this.transcriptsDir, relativePath);\n        try {\n          const content = await readFile(filePath, \"utf-8\");\n          const lines = content.trim().split(\"\\n\").filter(Boolean);\n          totalEntries += lines.length;\n\n          // Count by channel type (first directory in path)\n          const channelType = relativePath.includes(path.sep)\n            ? relativePath.split(path.sep)[0]\n            : \"legacy\";\n          channelTypes[channelType] = (channelTypes[channelType] || 0) + 1;\n        } catch {\n          // Skip unreadable files\n        }\n      }\n\n      return {\n        totalFiles: allFiles.length,\n        totalEntries,\n        oldestFile: sortedFiles[0],\n        newestFile: sortedFiles[sortedFiles.length - 1],\n        channelTypes,\n      };\n    } catch (err) {\n      log.error(\"failed to get transcript stats:\", err);\n      return {\n        totalFiles: 0,\n        totalEntries: 0,\n        oldestFile: null,\n        newestFile: null,\n        channelTypes: {},\n      };\n    }\n  }\n\n  async analyzeIntegrity(): Promise<SessionIntegrityReport> {\n    return analyzeSessionIntegrity({ memoryDir: this.config.memoryDir });\n  }\n\n  async getRecoverySummary(sessionKey?: string): Promise<{\n    generatedAt: string;\n    sessionKey?: string;\n    healthy: boolean;\n    issueCount: number;\n    incompleteTurns: number;\n    brokenChains: number;\n    checkpointHealthy: boolean;\n  }> {\n    const report = await this.analyzeIntegrity();\n    const selectedSessions = sessionKey\n      ? report.sessions.filter((session) => session.sessionKey === sessionKey)\n      : report.sessions;\n    const incompleteTurns = selectedSessions.reduce((sum, session) => sum + session.incompleteTurns, 0);\n    const brokenChains = selectedSessions.reduce((sum, session) => sum + session.brokenChains, 0);\n    const filteredIssues = report.issues.filter((issue) => !sessionKey || issue.sessionKey === sessionKey);\n    const issueCount = filteredIssues.length;\n    const severeIssueCount = filteredIssues.filter((issue) => issue.severity !== \"info\").length;\n    return {\n      generatedAt: report.generatedAt,\n      sessionKey,\n      healthy: sessionKey ? severeIssueCount === 0 && report.checkpoint.healthy : report.healthy,\n      issueCount,\n      incompleteTurns,\n      brokenChains,\n      checkpointHealthy: report.checkpoint.healthy,\n    };\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/{chunk-FAAFWE4G.js → chunk-ALEPI75L.js}

@@ -46,18 +46,36 @@ async function fileExists(p) {
 }
 async function readManifest(memoryDir, sidecar, pagePath) {
   const mp = manifestPath(memoryDir, sidecar, pagePath);
+  if (!await fileExists(mp)) {
+    return { pagePath, versions: [], currentVersion: "0" };
+  }
   try {
     const raw = await readFile(mp, "utf-8");
     const parsed = JSON.parse(raw);
     if (typeof parsed !== "object" || parsed === null) {
-      return { pagePath, versions: [], currentVersion: "0" };
+      throw new Error("manifest root must be an object");
     }
     const obj = parsed;
-    const versions = Array.isArray(obj.versions) ? obj.versions : [];
-    const currentVersion = typeof obj.currentVersion === "string" ? obj.currentVersion : "0";
+    if (!Array.isArray(obj.versions)) {
+      throw new Error("manifest versions must be an array");
+    }
+    const versions = obj.versions.map((entry, index) => {
+      if (!entry || typeof entry !== "object" || Array.isArray(entry)) {
+        throw new Error(`manifest version ${index} must be an object`);
+      }
+      const version = entry;
+      if (typeof version.versionId !== "string" || !/^\d+$/.test(version.versionId) || typeof version.timestamp !== "string" || typeof version.contentHash !== "string" || typeof version.sizeBytes !== "number" || !Number.isFinite(version.sizeBytes) || !["write", "consolidation", "revert", "manual"].includes(String(version.trigger))) {
+        throw new Error(`manifest version ${index} has invalid shape`);
+      }
+      return version;
+    });
+    if (typeof obj.currentVersion !== "string" || !/^\d+$/.test(obj.currentVersion)) {
+      throw new Error("manifest currentVersion must be a numeric string");
+    }
+    const currentVersion = obj.currentVersion;
     return { pagePath: typeof obj.pagePath === "string" ? obj.pagePath : pagePath, versions, currentVersion };
-  } catch {
-    return { pagePath, versions: [], currentVersion: "0" };
+  } catch (error) {
+    throw new Error(`page-versioning: invalid manifest ${mp}: ${error instanceof Error ? error.message : String(error)}`);
   }
 }
 async function writeManifest(memoryDir, sidecar, pagePath, history) {
@@ -243,4 +261,4 @@ export {
   revertToVersion,
   diffVersions
 };
-//# sourceMappingURL=chunk-FAAFWE4G.js.map
+//# sourceMappingURL=chunk-ALEPI75L.js.map

package/dist/chunk-ALEPI75L.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/page-versioning.ts"],"sourcesContent":["/**\n * Page-level versioning with history and revert (issue #371).\n *\n * Provides snapshot-based versioning for memory files using a sidecar\n * directory layout.  Each memory page gets a `.versions/<pageName>/`\n * subdirectory containing numbered snapshots and a `manifest.json` that\n * records the version history.\n *\n * Storage layout:\n *   memoryDir/\n *     facts/preferences.md              <- current file\n *     .versions/\n *       facts__preferences/\n *         manifest.json                  <- VersionHistory\n *         1.md                           <- version 1 snapshot\n *         2.md                           <- version 2 snapshot\n */\n\nimport { createHash } from \"node:crypto\";\nimport path from \"node:path\";\nimport {\n  access,\n  mkdir,\n  readFile,\n  writeFile,\n  unlink,\n} from \"node:fs/promises\";\n\n// ---------------------------------------------------------------------------\n// Public interfaces\n// ---------------------------------------------------------------------------\n\nexport interface PageVersion {\n  versionId: string;\n  timestamp: string;\n  contentHash: string;\n  sizeBytes: number;\n  trigger: VersionTrigger;\n  note?: string;\n}\n\nexport type VersionTrigger = \"write\" | \"consolidation\" | \"revert\" | \"manual\";\n\nexport interface VersionHistory {\n  pagePath: string;\n  versions: PageVersion[];\n  currentVersion: string;\n}\n\nexport interface VersioningConfig {\n  enabled: boolean;\n  maxVersionsPerPage: number;\n  sidecarDir: string;\n}\n\n// ---------------------------------------------------------------------------\n// Logger interface (minimal, avoids coupling to the host logger)\n// ---------------------------------------------------------------------------\n\nexport interface VersioningLogger {\n  debug(msg: string): void;\n  warn(msg: string): void;\n}\n\nconst NOOP_LOGGER: VersioningLogger = {\n  debug: () => {},\n  warn: () => {},\n};\n\n// ---------------------------------------------------------------------------\n// Per-page write lock (promise-chain pattern, see gotcha #40)\n// ---------------------------------------------------------------------------\n\nconst writeLocks = new Map<string, Promise<void>>();\n\nfunction withPageLock<T>(pageKey: string, fn: () => Promise<T>): Promise<T> {\n  const prev = writeLocks.get(pageKey) ?? Promise.resolve();\n  const next = prev.then(fn, fn); // run fn after previous completes, even if previous failed\n  writeLocks.set(pageKey, next.then(() => {}, () => {})); // recover chain per gotcha #40\n  return next;\n}\n\n// ---------------------------------------------------------------------------\n// Internal helpers\n// ---------------------------------------------------------------------------\n\nfunction contentHash(content: string): string {\n  return createHash(\"sha256\").update(content, \"utf-8\").digest(\"hex\");\n}\n\n/**\n * Derive a filesystem-safe sidecar key from a page path relative to memoryDir.\n *\n * `facts/2026-01-15/pref-001.md` -> `facts__2026-01-15__pref-001`\n *\n * Exported so the `remnic doctor` consolidation-provenance check (issue\n * #561 PR 4) resolves snapshot locations using the canonical algorithm\n * without re-implementing it — preventing silent drift if the key\n * format ever changes.\n */\nexport function sidecarKey(pagePath: string): string {\n  const withoutExt = pagePath.replace(/\\.md$/i, \"\");\n  return withoutExt.replace(/[\\\\/]/g, \"__\");\n}\n\nfunction sidecarDir(memoryDir: string, sidecar: string, pagePath: string): string {\n  return path.join(memoryDir, sidecar, sidecarKey(pagePath));\n}\n\nfunction manifestPath(memoryDir: string, sidecar: string, pagePath: string): string {\n  return path.join(sidecarDir(memoryDir, sidecar, pagePath), \"manifest.json\");\n}\n\nasync function fileExists(p: string): Promise<boolean> {\n  try {\n    await access(p);\n    return true;\n  } catch {\n    return false;\n  }\n}\n\nasync function readManifest(\n  memoryDir: string,\n  sidecar: string,\n  pagePath: string,\n): Promise<VersionHistory> {\n  const mp = manifestPath(memoryDir, sidecar, pagePath);\n  if (!(await fileExists(mp))) {\n    return { pagePath, versions: [], currentVersion: \"0\" };\n  }\n  try {\n    const raw = await readFile(mp, \"utf-8\");\n    const parsed: unknown = JSON.parse(raw);\n    if (typeof parsed !== \"object\" || parsed === null) {\n      throw new Error(\"manifest root must be an object\");\n    }\n    const obj = parsed as Record<string, unknown>;\n    if (!Array.isArray(obj.versions)) {\n      throw new Error(\"manifest versions must be an array\");\n    }\n    const versions = obj.versions.map((entry, index) => {\n      if (!entry || typeof entry !== \"object\" || Array.isArray(entry)) {\n        throw new Error(`manifest version ${index} must be an object`);\n      }\n      const version = entry as Record<string, unknown>;\n      if (\n        typeof version.versionId !== \"string\" ||\n        !/^\\d+$/.test(version.versionId) ||\n        typeof version.timestamp !== \"string\" ||\n        typeof version.contentHash !== \"string\" ||\n        typeof version.sizeBytes !== \"number\" ||\n        !Number.isFinite(version.sizeBytes) ||\n        ![\"write\", \"consolidation\", \"revert\", \"manual\"].includes(String(version.trigger))\n      ) {\n        throw new Error(`manifest version ${index} has invalid shape`);\n      }\n      return version as unknown as PageVersion;\n    });\n    if (typeof obj.currentVersion !== \"string\" || !/^\\d+$/.test(obj.currentVersion)) {\n      throw new Error(\"manifest currentVersion must be a numeric string\");\n    }\n    const currentVersion = obj.currentVersion;\n    return { pagePath: typeof obj.pagePath === \"string\" ? obj.pagePath : pagePath, versions, currentVersion };\n  } catch (error) {\n    throw new Error(`page-versioning: invalid manifest ${mp}: ${error instanceof Error ? error.message : String(error)}`);\n  }\n}\n\nasync function writeManifest(\n  memoryDir: string,\n  sidecar: string,\n  pagePath: string,\n  history: VersionHistory,\n): Promise<void> {\n  const dir = sidecarDir(memoryDir, sidecar, pagePath);\n  await mkdir(dir, { recursive: true });\n  const mp = manifestPath(memoryDir, sidecar, pagePath);\n  await writeFile(mp, JSON.stringify(history, null, 2) + \"\\n\", \"utf-8\");\n}\n\n// ---------------------------------------------------------------------------\n// Public API\n// ---------------------------------------------------------------------------\n\n/**\n * Create a new version snapshot for a page.\n *\n * Call this BEFORE overwriting the current file so the previous content is\n * preserved. If the file does not exist yet (first write), the provided\n * `content` is snapshotted as version 1.\n *\n * Pruning: when the number of versions exceeds `config.maxVersionsPerPage`,\n * the oldest snapshots (and their files) are removed.\n */\nexport async function createVersion(\n  pagePath: string,\n  content: string,\n  trigger: VersionTrigger,\n  config: VersioningConfig,\n  log: VersioningLogger = NOOP_LOGGER,\n  note?: string,\n  memoryDir?: string,\n): Promise<PageVersion> {\n  const { sidecarDir: sidecar, maxVersionsPerPage } = config;\n  const resolvedMemoryDir = memoryDir ?? resolveMemoryDir(pagePath);\n  const mPath = manifestPath(resolvedMemoryDir, sidecar, relPath(pagePath, resolvedMemoryDir));\n\n  return withPageLock(mPath, async () => {\n    const history = await readManifest(resolvedMemoryDir, sidecar, relPath(pagePath, resolvedMemoryDir));\n    const nextId = String(history.versions.length > 0\n      ? Math.max(...history.versions.map((v) => Number(v.versionId))) + 1\n      : 1);\n\n    const hash = contentHash(content);\n    const version: PageVersion = {\n      versionId: nextId,\n      timestamp: new Date().toISOString(),\n      contentHash: hash,\n      sizeBytes: Buffer.byteLength(content, \"utf-8\"),\n      trigger,\n      ...(note !== undefined ? { note } : {}),\n    };\n\n    // Write snapshot file\n    const dir = sidecarDir(resolvedMemoryDir, sidecar, relPath(pagePath, resolvedMemoryDir));\n    await mkdir(dir, { recursive: true });\n    const ext = path.extname(pagePath) || \".md\";\n    const snapshotPath = path.join(dir, `${nextId}${ext}`);\n    await writeFile(snapshotPath, content, \"utf-8\");\n\n    history.versions.push(version);\n    history.currentVersion = nextId;\n\n    // Prune old versions if exceeding max\n    if (maxVersionsPerPage > 0 && history.versions.length > maxVersionsPerPage) {\n      const toRemove = history.versions.splice(0, history.versions.length - maxVersionsPerPage);\n      for (const old of toRemove) {\n        const oldPath = path.join(dir, `${old.versionId}${ext}`);\n        try {\n          await unlink(oldPath);\n        } catch {\n          log.debug(`page-versioning: could not remove old snapshot ${oldPath}`);\n        }\n      }\n    }\n\n    await writeManifest(resolvedMemoryDir, sidecar, relPath(pagePath, resolvedMemoryDir), history);\n    log.debug(`page-versioning: created version ${nextId} for ${pagePath} (trigger=${trigger})`);\n\n    return version;\n  });\n}\n\n/**\n * List all versions for a page.\n */\nexport async function listVersions(\n  pagePath: string,\n  config: VersioningConfig,\n  memoryDir?: string,\n): Promise<VersionHistory> {\n  const resolvedMemoryDir = memoryDir ?? resolveMemoryDir(pagePath);\n  const rel = relPath(pagePath, resolvedMemoryDir);\n  const history = await readManifest(resolvedMemoryDir, config.sidecarDir, rel);\n  // Sort ascending by versionId (numeric)\n  history.versions.sort((a, b) => Number(a.versionId) - Number(b.versionId));\n  return history;\n}\n\n/**\n * Read the content of a specific version.\n */\nexport async function getVersion(\n  pagePath: string,\n  versionId: string,\n  config: VersioningConfig,\n  memoryDir?: string,\n): Promise<string> {\n  const resolvedMemoryDir = memoryDir ?? resolveMemoryDir(pagePath);\n  const rel = relPath(pagePath, resolvedMemoryDir);\n  const ext = path.extname(pagePath) || \".md\";\n  const dir = sidecarDir(resolvedMemoryDir, config.sidecarDir, rel);\n  const snapshotPath = path.join(dir, `${versionId}${ext}`);\n\n  if (!(await fileExists(snapshotPath))) {\n    throw new Error(`Version ${versionId} not found for ${pagePath}`);\n  }\n\n  return readFile(snapshotPath, \"utf-8\");\n}\n\n/**\n * Revert a page to a previous version.\n *\n * 1. Reads the target version's content.\n * 2. Snapshots the CURRENT content as a new version (trigger: \"revert\").\n * 3. Writes the reverted content to the page file.\n *\n * Returns the newly created version entry for the revert snapshot.\n */\nexport async function revertToVersion(\n  pagePath: string,\n  versionId: string,\n  config: VersioningConfig,\n  log: VersioningLogger = NOOP_LOGGER,\n  memoryDir?: string,\n): Promise<PageVersion> {\n  const resolvedMemoryDir = memoryDir ?? resolveMemoryDir(pagePath);\n\n  // Read target version content\n  const targetContent = await getVersion(pagePath, versionId, config, resolvedMemoryDir);\n\n  // Snapshot current content before overwriting\n  let currentContent = \"\";\n  try {\n    currentContent = await readFile(pagePath, \"utf-8\");\n  } catch {\n    // File may not exist; that's okay\n  }\n\n  const version = await createVersion(\n    pagePath,\n    currentContent,\n    \"revert\",\n    config,\n    log,\n    `reverted to version ${versionId}`,\n    resolvedMemoryDir,\n  );\n\n  // Write the reverted content to the actual page\n  await writeFile(pagePath, targetContent, \"utf-8\");\n  log.debug(`page-versioning: reverted ${pagePath} to version ${versionId}`);\n\n  return version;\n}\n\n/**\n * Simple line-based diff between two versions.\n *\n * Returns a unified-style diff string showing added (+) and removed (-) lines.\n */\nexport async function diffVersions(\n  pagePath: string,\n  v1: string,\n  v2: string,\n  config: VersioningConfig,\n  memoryDir?: string,\n): Promise<string> {\n  const resolvedMemoryDir = memoryDir ?? resolveMemoryDir(pagePath);\n  const content1 = await getVersion(pagePath, v1, config, resolvedMemoryDir);\n  const content2 = await getVersion(pagePath, v2, config, resolvedMemoryDir);\n\n  const lines1 = content1.split(\"\\n\");\n  const lines2 = content2.split(\"\\n\");\n\n  const result: string[] = [];\n  result.push(`--- version ${v1}`);\n  result.push(`+++ version ${v2}`);\n\n  // Simple LCS-based diff\n  const lcs = computeLCS(lines1, lines2);\n  let i = 0;\n  let j = 0;\n  let k = 0;\n\n  while (k < lcs.length) {\n    // Emit removed lines before the next common line\n    while (i < lines1.length && lines1[i] !== lcs[k]) {\n      result.push(`-${lines1[i]}`);\n      i++;\n    }\n    // Emit added lines before the next common line\n    while (j < lines2.length && lines2[j] !== lcs[k]) {\n      result.push(`+${lines2[j]}`);\n      j++;\n    }\n    // Common line\n    result.push(` ${lcs[k]}`);\n    i++;\n    j++;\n    k++;\n  }\n  // Remaining removed lines\n  while (i < lines1.length) {\n    result.push(`-${lines1[i]}`);\n    i++;\n  }\n  // Remaining added lines\n  while (j < lines2.length) {\n    result.push(`+${lines2[j]}`);\n    j++;\n  }\n\n  return result.join(\"\\n\");\n}\n\n// ---------------------------------------------------------------------------\n// LCS helper for diffVersions\n// ---------------------------------------------------------------------------\n\nfunction computeLCS(a: string[], b: string[]): string[] {\n  const m = a.length;\n  const n = b.length;\n  // Build DP table\n  const dp: number[][] = Array.from({ length: m + 1 }, () => new Array<number>(n + 1).fill(0));\n  for (let i = 1; i <= m; i++) {\n    for (let j = 1; j <= n; j++) {\n      if (a[i - 1] === b[j - 1]) {\n        dp[i][j] = dp[i - 1][j - 1] + 1;\n      } else {\n        dp[i][j] = Math.max(dp[i - 1][j], dp[i][j - 1]);\n      }\n    }\n  }\n  // Backtrack to build LCS\n  const result: string[] = [];\n  let i = m;\n  let j = n;\n  while (i > 0 && j > 0) {\n    if (a[i - 1] === b[j - 1]) {\n      result.unshift(a[i - 1]);\n      i--;\n      j--;\n    } else if (dp[i - 1][j] > dp[i][j - 1]) {\n      i--;\n    } else {\n      j--;\n    }\n  }\n  return result;\n}\n\n// ---------------------------------------------------------------------------\n// Path helpers\n// ---------------------------------------------------------------------------\n\n/**\n * Legacy fallback: given an absolute page path, heuristically resolve the\n * memory directory by walking up past known subdirectory names.\n *\n * Callers should always pass an explicit `memoryDir` instead of relying on\n * this heuristic.  It is retained only for backward compatibility when the\n * optional `memoryDir` parameter is omitted.\n */\nfunction resolveMemoryDir(pagePath: string): string {\n  const knownSubdirs = new Set([\n    \"facts\",\n    \"corrections\",\n    \"entities\",\n    \"state\",\n    \"artifacts\",\n    \"questions\",\n    \"profiles\",\n  ]);\n\n  let dir = path.dirname(pagePath);\n  // Walk up past date directories (YYYY-MM-DD) and known subdirs\n  for (let depth = 0; depth < 5; depth++) {\n    const base = path.basename(dir);\n    if (knownSubdirs.has(base) || /^\\d{4}-\\d{2}-\\d{2}$/.test(base)) {\n      dir = path.dirname(dir);\n    } else {\n      break;\n    }\n  }\n  return dir;\n}\n\n/**\n * Compute relative path of a page within its memory directory.\n */\nfunction relPath(pagePath: string, memoryDir: string): string {\n  return path.relative(memoryDir, pagePath);\n}\n"],"mappings":"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","names":["i","j"]}

package/dist/{chunk-3SLRNYNG.js → chunk-AUDJPF4N.js}

@@ -3,6 +3,12 @@ import {
 } from "./chunk-Y4Z4I6WK.js";
 
 // src/graph-dashboard-diff.ts
+function compareGraphEdges(a, b) {
+  return a.type.localeCompare(b.type) || a.from.localeCompare(b.from) || a.to.localeCompare(b.to);
+}
+function edgeFieldsChanged(previous, next) {
+  return previous.weight !== next.weight || (previous.confidence ?? 1) !== (next.confidence ?? 1) || (previous.lastReinforcedAt ?? null) !== (next.lastReinforcedAt ?? null);
+}
 function diffGraphSnapshots(previous, next) {
   const prevNodeSet = new Set(previous.nodes.map((node) => node.id));
   const nextNodeSet = new Set(next.nodes.map((node) => node.id));
@@ -10,17 +16,22 @@ function diffGraphSnapshots(previous, next) {
   const nextEdges = new Map(next.edges.map((edge) => [graphEdgeKey(edge), edge]));
   const addedNodes = [...nextNodeSet].filter((id) => !prevNodeSet.has(id)).sort((a, b) => a.localeCompare(b));
   const removedNodes = [...prevNodeSet].filter((id) => !nextNodeSet.has(id)).sort((a, b) => a.localeCompare(b));
-  const addedEdges = [...nextEdges.entries()].filter(([key]) => !prevEdges.has(key)).map(([, edge]) => edge).sort((a, b) => a.type.localeCompare(b.type) || a.from.localeCompare(b.from) || a.to.localeCompare(b.to));
-  const removedEdges = [...prevEdges.entries()].filter(([key]) => !nextEdges.has(key)).map(([, edge]) => edge).sort((a, b) => a.type.localeCompare(b.type) || a.from.localeCompare(b.from) || a.to.localeCompare(b.to));
+  const addedEdges = [...nextEdges.entries()].filter(([key]) => !prevEdges.has(key)).map(([, edge]) => edge).sort(compareGraphEdges);
+  const removedEdges = [...prevEdges.entries()].filter(([key]) => !nextEdges.has(key)).map(([, edge]) => edge).sort(compareGraphEdges);
+  const updatedEdges = [...nextEdges.entries()].flatMap(([key, nextEdge]) => {
+    const previousEdge = prevEdges.get(key);
+    return previousEdge && edgeFieldsChanged(previousEdge, nextEdge) ? [{ previous: previousEdge, next: nextEdge }] : [];
+  }).sort((a, b) => compareGraphEdges(a.next, b.next));
   return {
     addedNodes,
     removedNodes,
     addedEdges,
-    removedEdges
+    removedEdges,
+    updatedEdges
   };
 }
 
 export {
   diffGraphSnapshots
 };
-//# sourceMappingURL=chunk-3SLRNYNG.js.map
+//# sourceMappingURL=chunk-AUDJPF4N.js.map

package/dist/chunk-AUDJPF4N.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/graph-dashboard-diff.ts"],"sourcesContent":["import type { GraphEdge } from \"./graph.js\";\nimport { graphEdgeKey } from \"./graph-dashboard-key.js\";\nimport type { GraphSnapshot } from \"./graph-dashboard-parser.js\";\n\nexport interface GraphPatch {\n  addedNodes: string[];\n  removedNodes: string[];\n  addedEdges: GraphEdge[];\n  removedEdges: GraphEdge[];\n  updatedEdges: Array<{ previous: GraphEdge; next: GraphEdge }>;\n}\n\nfunction compareGraphEdges(a: GraphEdge, b: GraphEdge): number {\n  return a.type.localeCompare(b.type) || a.from.localeCompare(b.from) || a.to.localeCompare(b.to);\n}\n\nfunction edgeFieldsChanged(previous: GraphEdge, next: GraphEdge): boolean {\n  return (\n    previous.weight !== next.weight ||\n    (previous.confidence ?? 1) !== (next.confidence ?? 1) ||\n    (previous.lastReinforcedAt ?? null) !== (next.lastReinforcedAt ?? null)\n  );\n}\n\nexport function diffGraphSnapshots(previous: GraphSnapshot, next: GraphSnapshot): GraphPatch {\n  const prevNodeSet = new Set(previous.nodes.map((node) => node.id));\n  const nextNodeSet = new Set(next.nodes.map((node) => node.id));\n  const prevEdges = new Map(previous.edges.map((edge) => [graphEdgeKey(edge), edge]));\n  const nextEdges = new Map(next.edges.map((edge) => [graphEdgeKey(edge), edge]));\n\n  const addedNodes = [...nextNodeSet].filter((id) => !prevNodeSet.has(id)).sort((a, b) => a.localeCompare(b));\n  const removedNodes = [...prevNodeSet].filter((id) => !nextNodeSet.has(id)).sort((a, b) => a.localeCompare(b));\n  const addedEdges = [...nextEdges.entries()]\n    .filter(([key]) => !prevEdges.has(key))\n    .map(([, edge]) => edge)\n    .sort(compareGraphEdges);\n  const removedEdges = [...prevEdges.entries()]\n    .filter(([key]) => !nextEdges.has(key))\n    .map(([, edge]) => edge)\n    .sort(compareGraphEdges);\n  const updatedEdges = [...nextEdges.entries()]\n    .flatMap(([key, nextEdge]) => {\n      const previousEdge = prevEdges.get(key);\n      return previousEdge && edgeFieldsChanged(previousEdge, nextEdge)\n        ? [{ previous: previousEdge, next: nextEdge }]\n        : [];\n    })\n    .sort((a, b) => compareGraphEdges(a.next, b.next));\n\n  return {\n    addedNodes,\n    removedNodes,\n    addedEdges,\n    removedEdges,\n    updatedEdges,\n  };\n}\n"],"mappings":";;;;;AAYA,SAAS,kBAAkB,GAAc,GAAsB;AAC7D,SAAO,EAAE,KAAK,cAAc,EAAE,IAAI,KAAK,EAAE,KAAK,cAAc,EAAE,IAAI,KAAK,EAAE,GAAG,cAAc,EAAE,EAAE;AAChG;AAEA,SAAS,kBAAkB,UAAqB,MAA0B;AACxE,SACE,SAAS,WAAW,KAAK,WACxB,SAAS,cAAc,QAAQ,KAAK,cAAc,OAClD,SAAS,oBAAoB,WAAW,KAAK,oBAAoB;AAEtE;AAEO,SAAS,mBAAmB,UAAyB,MAAiC;AAC3F,QAAM,cAAc,IAAI,IAAI,SAAS,MAAM,IAAI,CAAC,SAAS,KAAK,EAAE,CAAC;AACjE,QAAM,cAAc,IAAI,IAAI,KAAK,MAAM,IAAI,CAAC,SAAS,KAAK,EAAE,CAAC;AAC7D,QAAM,YAAY,IAAI,IAAI,SAAS,MAAM,IAAI,CAAC,SAAS,CAAC,aAAa,IAAI,GAAG,IAAI,CAAC,CAAC;AAClF,QAAM,YAAY,IAAI,IAAI,KAAK,MAAM,IAAI,CAAC,SAAS,CAAC,aAAa,IAAI,GAAG,IAAI,CAAC,CAAC;AAE9E,QAAM,aAAa,CAAC,GAAG,WAAW,EAAE,OAAO,CAAC,OAAO,CAAC,YAAY,IAAI,EAAE,CAAC,EAAE,KAAK,CAAC,GAAG,MAAM,EAAE,cAAc,CAAC,CAAC;AAC1G,QAAM,eAAe,CAAC,GAAG,WAAW,EAAE,OAAO,CAAC,OAAO,CAAC,YAAY,IAAI,EAAE,CAAC,EAAE,KAAK,CAAC,GAAG,MAAM,EAAE,cAAc,CAAC,CAAC;AAC5G,QAAM,aAAa,CAAC,GAAG,UAAU,QAAQ,CAAC,EACvC,OAAO,CAAC,CAAC,GAAG,MAAM,CAAC,UAAU,IAAI,GAAG,CAAC,EACrC,IAAI,CAAC,CAAC,EAAE,IAAI,MAAM,IAAI,EACtB,KAAK,iBAAiB;AACzB,QAAM,eAAe,CAAC,GAAG,UAAU,QAAQ,CAAC,EACzC,OAAO,CAAC,CAAC,GAAG,MAAM,CAAC,UAAU,IAAI,GAAG,CAAC,EACrC,IAAI,CAAC,CAAC,EAAE,IAAI,MAAM,IAAI,EACtB,KAAK,iBAAiB;AACzB,QAAM,eAAe,CAAC,GAAG,UAAU,QAAQ,CAAC,EACzC,QAAQ,CAAC,CAAC,KAAK,QAAQ,MAAM;AAC5B,UAAM,eAAe,UAAU,IAAI,GAAG;AACtC,WAAO,gBAAgB,kBAAkB,cAAc,QAAQ,IAC3D,CAAC,EAAE,UAAU,cAAc,MAAM,SAAS,CAAC,IAC3C,CAAC;AAAA,EACP,CAAC,EACA,KAAK,CAAC,GAAG,MAAM,kBAAkB,EAAE,MAAM,EAAE,IAAI,CAAC;AAEnD,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF;AACF;","names":[]}

package/dist/chunk-B5XMS73R.js

@@ -0,0 +1,145 @@
+import {
+  readEnvVar
+} from "./chunk-JUC24CTX.js";
+import {
+  log
+} from "./chunk-2ODBA7MQ.js";
+
+// src/resolve-provider-secret.ts
+import path from "path";
+var _resolveApiKeyForProviderForTest = null;
+var _getRuntimeAuthForModelForTest = null;
+var resolvedCache = /* @__PURE__ */ new Map();
+var cacheObjectIds = /* @__PURE__ */ new WeakMap();
+var nextCacheObjectId = 1;
+var NON_LITERAL_AUTH_MARKERS = /* @__PURE__ */ new Set([
+  "secretref-managed",
+  "lm-studio"
+]);
+var ENV_VAR_MARKER_RE = /^[A-Z][A-Z0-9_]*(?:_API_KEY|_ACCESS_TOKEN|_TOKEN|_SECRET|_CREDENTIALS|_CREDENTIALS_JSON)$/;
+function isNonLiteralAuthMarker(value) {
+  return NON_LITERAL_AUTH_MARKERS.has(value) || value.endsWith("-oauth") || value.endsWith("-local") || value.startsWith("gcp-") || ENV_VAR_MARKER_RE.test(value);
+}
+function resolveFromNamedEnvVar(marker) {
+  if (!ENV_VAR_MARKER_RE.test(marker)) return void 0;
+  const value = readEnvVar(marker);
+  return value && value.trim().length > 0 ? value.trim() : void 0;
+}
+function cacheIdentity(value) {
+  if (value === null) return "null";
+  if (value === void 0) return "undefined";
+  if (typeof value === "string") return `string:${value}`;
+  if (typeof value === "number") return `number:${String(value)}`;
+  if (typeof value === "boolean") return `boolean:${String(value)}`;
+  if (typeof value === "bigint") return `bigint:${String(value)}`;
+  if (typeof value === "symbol") return typeof value;
+  if (typeof value === "function") return cacheObjectIdentity(value);
+  if (typeof value === "object") {
+    return cacheObjectIdentity(value);
+  }
+  return String(value);
+}
+function cacheObjectIdentity(value) {
+  const existingId = cacheObjectIds.get(value);
+  if (existingId !== void 0) return `object:${existingId}`;
+  const newId = nextCacheObjectId++;
+  cacheObjectIds.set(value, newId);
+  return `object:${newId}`;
+}
+function providerSecretCacheKey(providerId, resolvedAgentDir, apiKeyValue, gatewayConfig, resolverContext) {
+  return [
+    `provider:${providerId}`,
+    `agentDir:${resolvedAgentDir}`,
+    `apiKey:${cacheIdentity(apiKeyValue)}`,
+    `cfg:${cacheIdentity(gatewayConfig)}`,
+    `resolver:${cacheIdentity(resolverContext)}`
+  ].join(":");
+}
+async function resolveProviderApiKey(providerId, apiKeyValue, gatewayConfig, agentDir, options = {}) {
+  const resolvedAgentDir = agentDir ? path.resolve(agentDir) : "";
+  let resolved;
+  if (typeof apiKeyValue === "string" && apiKeyValue.trim().length > 0) {
+    const trimmedApiKeyValue = apiKeyValue.trim();
+    if (isNonLiteralAuthMarker(trimmedApiKeyValue)) {
+      const markerEnvValue = resolveFromNamedEnvVar(trimmedApiKeyValue);
+      if (markerEnvValue) {
+        return markerEnvValue;
+      }
+    } else {
+      return trimmedApiKeyValue;
+    }
+  }
+  const resolver = options.resolveApiKeyForProvider ?? _resolveApiKeyForProviderForTest;
+  const cacheKey = providerSecretCacheKey(
+    providerId,
+    resolvedAgentDir,
+    apiKeyValue,
+    gatewayConfig,
+    resolver ?? null
+  );
+  if (resolvedCache.has(cacheKey)) {
+    return resolvedCache.get(cacheKey);
+  }
+  if (resolver) {
+    try {
+      const auth = await resolver({ provider: providerId, cfg: gatewayConfig, agentDir: resolvedAgentDir });
+      if (auth?.apiKey) {
+        resolved = auth.apiKey;
+        log.debug(`resolved API key for provider "${providerId}" via host auth (source: ${auth.source ?? "unknown"}, mode: ${auth.mode ?? "unknown"})`);
+        resolvedCache.set(cacheKey, resolved);
+        return resolved;
+      }
+    } catch (err) {
+      log.debug(
+        `host auth resolution failed for provider "${providerId}": ${err instanceof Error ? err.message : String(err)}`
+      );
+    }
+  }
+  resolved = resolveFromEnv(providerId);
+  if (resolved) {
+    log.debug(`resolved API key for provider "${providerId}" from environment variable`);
+  } else {
+    log.debug(`could not resolve API key for provider "${providerId}" \u2014 skipping`);
+  }
+  if (resolved) {
+    resolvedCache.set(cacheKey, resolved);
+  }
+  return resolved;
+}
+function resolveFromEnv(providerId) {
+  const normalized = providerId.toUpperCase().replace(/[^A-Z0-9]/g, "_");
+  const candidates = [
+    `${normalized}_API_KEY`,
+    `${normalized}_TOKEN`
+  ];
+  for (const envVar of candidates) {
+    const value = readEnvVar(envVar);
+    if (value && value.trim().length > 0) {
+      return value.trim();
+    }
+  }
+  return void 0;
+}
+async function getGatewayRuntimeAuthForModel(options = {}) {
+  return options.getRuntimeAuthForModel ?? _getRuntimeAuthForModelForTest;
+}
+function clearSecretCache() {
+  resolvedCache.clear();
+  _resolveApiKeyForProviderForTest = null;
+  _getRuntimeAuthForModelForTest = null;
+}
+function __setGatewayResolverForTest(resolver) {
+  _resolveApiKeyForProviderForTest = resolver;
+}
+function __setGatewayRuntimeAuthForModelForTest(resolver) {
+  _getRuntimeAuthForModelForTest = resolver;
+}
+
+export {
+  resolveProviderApiKey,
+  getGatewayRuntimeAuthForModel,
+  clearSecretCache,
+  __setGatewayResolverForTest,
+  __setGatewayRuntimeAuthForModelForTest
+};
+//# sourceMappingURL=chunk-B5XMS73R.js.map

package/dist/chunk-B5XMS73R.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/resolve-provider-secret.ts"],"sourcesContent":["import { log } from \"./logger.js\";\nimport { readEnvVar } from \"./runtime/env.js\";\nimport path from \"node:path\";\n\n/**\n * Resolve provider API keys while keeping core host-agnostic.\n *\n * Plain-text API keys and provider-derived environment variables are handled\n * directly. Host-specific secret references are resolved only when the caller\n * supplies the host's native resolver. Core must not discover OpenClaw, Hermes,\n * or any other runtime on its own.\n *\n * Results are cached per provider and resolver context for the process lifetime.\n */\n\nexport type ResolveApiKeyFn = (params: {\n  provider: string;\n  cfg?: unknown;\n  agentDir?: string;\n}) => Promise<{ apiKey?: string; source?: string; mode?: string } | null>;\n\n/**\n * Resolve request-ready auth for a model, including provider-owned transforms\n * (e.g., OAuth token exchange, base URL override for openai-codex).\n */\nexport type GetRuntimeAuthForModelFn = (params: {\n  model: { provider: string; id: string; api?: string; baseUrl?: string };\n  cfg?: unknown;\n  workspaceDir?: string;\n}) => Promise<{\n  apiKey?: string;\n  baseUrl?: string;\n  source?: string;\n  mode?: string;\n  profileId?: string;\n} | null>;\n\nexport interface ProviderSecretResolutionOptions {\n  resolveApiKeyForProvider?: ResolveApiKeyFn | null;\n}\n\nexport interface RuntimeAuthResolutionOptions {\n  getRuntimeAuthForModel?: GetRuntimeAuthForModelFn | null;\n}\n\nlet _resolveApiKeyForProviderForTest: ResolveApiKeyFn | null = null;\nlet _getRuntimeAuthForModelForTest: GetRuntimeAuthForModelFn | null = null;\nconst resolvedCache = new Map<string, string | undefined>();\nconst cacheObjectIds = new WeakMap<object, number>();\nlet nextCacheObjectId = 1;\nconst NON_LITERAL_AUTH_MARKERS = new Set([\n  \"secretref-managed\",\n  \"lm-studio\",\n]);\nconst ENV_VAR_MARKER_RE =\n  /^[A-Z][A-Z0-9_]*(?:_API_KEY|_ACCESS_TOKEN|_TOKEN|_SECRET|_CREDENTIALS|_CREDENTIALS_JSON)$/;\n\nfunction isNonLiteralAuthMarker(value: string): boolean {\n  return (\n    NON_LITERAL_AUTH_MARKERS.has(value) ||\n    value.endsWith(\"-oauth\") ||\n    value.endsWith(\"-local\") ||\n    value.startsWith(\"gcp-\") ||\n    ENV_VAR_MARKER_RE.test(value)\n  );\n}\n\nfunction resolveFromNamedEnvVar(marker: string): string | undefined {\n  if (!ENV_VAR_MARKER_RE.test(marker)) return undefined;\n  const value = readEnvVar(marker);\n  return value && value.trim().length > 0 ? value.trim() : undefined;\n}\n\nfunction cacheIdentity(value: unknown): string {\n  if (value === null) return \"null\";\n  if (value === undefined) return \"undefined\";\n  if (typeof value === \"string\") return `string:${value}`;\n  if (typeof value === \"number\") return `number:${String(value)}`;\n  if (typeof value === \"boolean\") return `boolean:${String(value)}`;\n  if (typeof value === \"bigint\") return `bigint:${String(value)}`;\n  if (typeof value === \"symbol\") return typeof value;\n  if (typeof value === \"function\") return cacheObjectIdentity(value as object);\n  if (typeof value === \"object\") {\n    return cacheObjectIdentity(value);\n  }\n  return String(value);\n}\n\nfunction cacheObjectIdentity(value: object): string {\n  const existingId = cacheObjectIds.get(value);\n  if (existingId !== undefined) return `object:${existingId}`;\n  const newId = nextCacheObjectId++;\n  cacheObjectIds.set(value, newId);\n  return `object:${newId}`;\n}\n\nfunction providerSecretCacheKey(\n  providerId: string,\n  resolvedAgentDir: string,\n  apiKeyValue: unknown,\n  gatewayConfig: unknown,\n  resolverContext: unknown,\n): string {\n  return [\n    `provider:${providerId}`,\n    `agentDir:${resolvedAgentDir}`,\n    `apiKey:${cacheIdentity(apiKeyValue)}`,\n    `cfg:${cacheIdentity(gatewayConfig)}`,\n    `resolver:${cacheIdentity(resolverContext)}`,\n  ].join(\":\");\n}\n\n/**\n * Resolve a provider API key from literal values, environment markers, or an\n * injected host resolver.\n *\n * Resolution order:\n * 1. Plain-text string → returned immediately\n * 2. Injected host resolveApiKeyForProvider → handles host secret ref formats\n * 3. Environment variable fallback (PROVIDER_NAME_API_KEY)\n * 4. undefined → provider is skipped in the fallback chain\n */\nexport async function resolveProviderApiKey(\n  providerId: string,\n  apiKeyValue: unknown,\n  gatewayConfig?: unknown,\n  agentDir?: string,\n  options: ProviderSecretResolutionOptions = {},\n): Promise<string | undefined> {\n  const resolvedAgentDir = agentDir ? path.resolve(agentDir) : \"\";\n\n  let resolved: string | undefined;\n\n  // Fast path: plain-text string that looks like an actual API key\n  if (typeof apiKeyValue === \"string\" && apiKeyValue.trim().length > 0) {\n    const trimmedApiKeyValue = apiKeyValue.trim();\n    // Skip known non-API-key markers used by the gateway for auth modes,\n    // plus env-var-shaped markers such as OPENAI_API_KEY.\n    if (isNonLiteralAuthMarker(trimmedApiKeyValue)) {\n      const markerEnvValue = resolveFromNamedEnvVar(trimmedApiKeyValue);\n      if (markerEnvValue) {\n        return markerEnvValue;\n      }\n      // Fall through to gateway resolver / env var fallback\n    } else {\n      return trimmedApiKeyValue;\n    }\n  }\n\n  const resolver = options.resolveApiKeyForProvider ?? _resolveApiKeyForProviderForTest;\n  const cacheKey = providerSecretCacheKey(\n    providerId,\n    resolvedAgentDir,\n    apiKeyValue,\n    gatewayConfig,\n    resolver ?? null,\n  );\n  if (resolvedCache.has(cacheKey)) {\n    return resolvedCache.get(cacheKey);\n  }\n\n  // The API key is either a SecretRef object, \"secretref-managed\", or empty.\n  // Try the host-supplied auth resolution system first.\n  if (resolver) {\n    try {\n      const auth = await resolver({ provider: providerId, cfg: gatewayConfig, agentDir: resolvedAgentDir });\n      if (auth?.apiKey) {\n        resolved = auth.apiKey;\n        log.debug(`resolved API key for provider \"${providerId}\" via host auth (source: ${auth.source ?? \"unknown\"}, mode: ${auth.mode ?? \"unknown\"})`);\n        resolvedCache.set(cacheKey, resolved);\n        return resolved;\n      }\n    } catch (err) {\n      log.debug(\n        `host auth resolution failed for provider \"${providerId}\": ${err instanceof Error ? err.message : String(err)}`,\n      );\n    }\n  }\n\n  // Environment variable fallback\n  resolved = resolveFromEnv(providerId);\n  if (resolved) {\n    log.debug(`resolved API key for provider \"${providerId}\" from environment variable`);\n  } else {\n    log.debug(`could not resolve API key for provider \"${providerId}\" — skipping`);\n  }\n\n  // Only cache successful resolutions — failures are retried on next call\n  // so providers can recover after transient issues (e.g., 1Password agent restart)\n  if (resolved) {\n    resolvedCache.set(cacheKey, resolved);\n  }\n  return resolved;\n}\n\n/**\n * Try to resolve an API key from environment variables.\n */\nfunction resolveFromEnv(providerId: string): string | undefined {\n  const normalized = providerId.toUpperCase().replace(/[^A-Z0-9]/g, \"_\");\n  const candidates = [\n    `${normalized}_API_KEY`,\n    `${normalized}_TOKEN`,\n  ];\n  for (const envVar of candidates) {\n    const value = readEnvVar(envVar);\n    if (value && value.trim().length > 0) {\n      return value.trim();\n    }\n  }\n  return undefined;\n}\n\n/**\n * Get a host-supplied getRuntimeAuthForModel function, if available.\n * This resolves request-ready auth including provider-owned transforms\n * (OAuth token exchange, base URL override for codex/copilot/etc.).\n */\nexport async function getGatewayRuntimeAuthForModel(\n  options: RuntimeAuthResolutionOptions = {},\n): Promise<GetRuntimeAuthForModelFn | null> {\n  return options.getRuntimeAuthForModel ?? _getRuntimeAuthForModelForTest;\n}\n\n/**\n * Clear the resolution cache (useful for testing or key rotation).\n */\nexport function clearSecretCache(): void {\n  resolvedCache.clear();\n  _resolveApiKeyForProviderForTest = null;\n  _getRuntimeAuthForModelForTest = null;\n}\n\nexport function __setGatewayResolverForTest(resolver: ResolveApiKeyFn | null): void {\n  _resolveApiKeyForProviderForTest = resolver;\n}\n\nexport function __setGatewayRuntimeAuthForModelForTest(\n  resolver: GetRuntimeAuthForModelFn | null,\n): void {\n  _getRuntimeAuthForModelForTest = resolver;\n}\n"],"mappings":"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","names":[]}

package/dist/{chunk-HXXBL2KD.js → chunk-BECQDWBA.js}

@@ -1,6 +1,6 @@
 import {
   isValidConnectorId
-} from "./chunk-LPMVBPA3.js";
+} from "./chunk-CWWMTTQE.js";
 
 // src/connectors/live/registry.ts
 var LiveConnectorRegistryError = class extends Error {
@@ -858,15 +858,22 @@ async function incrementalSync(fetchFn, config, payload, signal) {
       let cutoffMidPage = false;
       for (const notionPage of pageResp.results ?? []) {
         throwIfAborted2(signal);
-        totalConsumed++;
         const pageId = notionPage.id;
         const lastEdited = notionPage.last_edited_time;
         if (typeof pageId !== "string" || typeof lastEdited !== "string") continue;
         const knownRevision = payload.pages[pageId];
         if (knownRevision && knownRevision >= lastEdited) {
           skippedUnchanged++;
+          if (!latestInDb || lastEdited > latestInDb) {
+            latestInDb = lastEdited;
+          }
           continue;
         }
+        if (totalConsumed >= MAX_PAGES_PER_PASS) {
+          cutoffMidPage = true;
+          break;
+        }
+        totalConsumed++;
         const doc = await fetchPageDocument(
           fetchFn,
           config.token,
@@ -877,9 +884,15 @@ async function incrementalSync(fetchFn, config, payload, signal) {
         if (doc === "too-large") {
           skippedTooLarge++;
           updatedPages[pageId] = lastEdited;
+          if (!latestInDb || lastEdited > latestInDb) {
+            latestInDb = lastEdited;
+          }
         } else if (doc === "empty") {
           skippedEmpty++;
           updatedPages[pageId] = lastEdited;
+          if (!latestInDb || lastEdited > latestInDb) {
+            latestInDb = lastEdited;
+          }
         } else if (doc !== null) {
           newDocs.push(doc);
           updatedPages[pageId] = lastEdited;
@@ -888,6 +901,9 @@ async function incrementalSync(fetchFn, config, payload, signal) {
           }
         } else {
           updatedPages[pageId] = lastEdited;
+          if (!latestInDb || lastEdited > latestInDb) {
+            latestInDb = lastEdited;
+          }
         }
         if (totalConsumed >= MAX_PAGES_PER_PASS) {
           cutoffMidPage = true;
@@ -1934,7 +1950,10 @@ async function fetchAndFilterComments(fetchFn, token, firstPageUrl, repo, kind,
     for (const item of data) {
       if (consumed >= remainingBudget) break;
       throwIfAborted4(signal);
-      const comment = item;
+      const comment = normalizeGitHubComment(item, kind);
+      if (!comment) {
+        continue;
+      }
       if (since && comment.updated_at < since) {
         continue;
       }
@@ -1982,6 +2001,27 @@ async function fetchAndFilterComments(fetchFn, token, firstPageUrl, repo, kind,
   }
   return { docs, skippedOtherAuthor, skippedEmpty, skippedTooLarge, consumed, latestWatermark, newSeenIds };
 }
+function normalizeGitHubComment(item, kind) {
+  if (typeof item !== "object" || item === null) {
+    return null;
+  }
+  if (kind !== "discussion") {
+    return item;
+  }
+  const discussion = item;
+  const updatedAt = discussion.updatedAt ?? discussion.createdAt;
+  if (typeof discussion.id !== "number" || typeof updatedAt !== "string") {
+    return null;
+  }
+  return {
+    id: discussion.id,
+    body: discussion.body,
+    user: discussion.author,
+    created_at: discussion.createdAt ?? updatedAt,
+    updated_at: updatedAt,
+    html_url: discussion.url
+  };
+}
 function advancePageUrl(url) {
   try {
     const u = new URL(url);
@@ -2037,4 +2077,4 @@ export {
   validateGitHubConfig,
   createGitHubConnector
 };
-//# sourceMappingURL=chunk-HXXBL2KD.js.map
+//# sourceMappingURL=chunk-BECQDWBA.js.map