@remnic/core 9.3.700 → 9.3.702

package/dist/chunk-XJNBEDFE.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/summary-snapshot.ts"],"sourcesContent":["import {\n  mkdir,\n  open,\n  readFile,\n  stat,\n  unlink,\n  utimes,\n  writeFile,\n} from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { z } from \"zod\";\nimport {\n  encodeStoragePathSegment,\n  resolvePathInsideStorageRoot,\n} from \"./storage-paths.js\";\nimport type { HourlySummary } from \"./types.js\";\n\nconst summarySnapshotSchemaVersion = 1;\n\nconst SummarySnapshotItemSchema = z.object({\n  hour: z.string(),\n  sessionKey: z.string(),\n  bullets: z.array(z.string()),\n  turnCount: z.number().int().nonnegative(),\n  generatedAt: z.string(),\n});\n\nconst SummarySnapshotSchema = z.object({\n  schemaVersion: z.number().default(summarySnapshotSchemaVersion),\n  sessionKey: z.string(),\n  generatedAt: z.string().datetime({ offset: true }),\n  summaries: z.array(SummarySnapshotItemSchema),\n});\n\ntype SummarySnapshot = z.infer<typeof SummarySnapshotSchema>;\n\nconst summarySnapshotUpserts = new Map<string, Promise<void>>();\nconst summarySnapshotLockTimeoutMs = 5_000;\nconst summarySnapshotLockStaleMs = 30_000;\nconst summarySnapshotLockHeartbeatMs = Math.max(\n  1_000,\n  Math.floor(summarySnapshotLockStaleMs / 3),\n);\n\nexport function summarySnapshotPath(\n  memoryDir: string,\n  sessionKey: string,\n): string {\n  return resolveSummarySnapshotPath(memoryDir, sessionKey, \"json\");\n}\n\nfunction summarySnapshotLockPath(memoryDir: string, sessionKey: string): string {\n  return resolveSummarySnapshotPath(memoryDir, sessionKey, \"lock\");\n}\n\nfunction summarySnapshotRoot(memoryDir: string): string {\n  return resolvePathInsideStorageRoot(memoryDir, \"state\", \"summaries\");\n}\n\nfunction resolveSummarySnapshotPath(\n  memoryDir: string,\n  sessionKey: string,\n  extension: \"json\" | \"lock\",\n): string {\n  const safeSessionKey = encodeStoragePathSegment(sessionKey, \"session\");\n  return resolvePathInsideStorageRoot(\n    summarySnapshotRoot(memoryDir),\n    `${safeSessionKey}.${extension}`,\n  );\n}\n\nfunction legacySummarySnapshotPath(\n  memoryDir: string,\n  sessionKey: string,\n): string | null {\n  if (sessionKey.includes(\"\\0\")) {\n    return null;\n  }\n  try {\n    return resolvePathInsideStorageRoot(\n      summarySnapshotRoot(memoryDir),\n      `${sessionKey}.json`,\n    );\n  } catch {\n    return null;\n  }\n}\n\nexport async function readSummarySnapshot(\n  memoryDir: string,\n  sessionKey: string,\n): Promise<HourlySummary[] | null> {\n  const filePath = summarySnapshotPath(memoryDir, sessionKey);\n  const snapshot = await readSummarySnapshotFile(filePath, sessionKey);\n  if (snapshot !== null) return snapshot;\n\n  const legacyPath = legacySummarySnapshotPath(memoryDir, sessionKey);\n  if (legacyPath === null || legacyPath === filePath) return null;\n  return readSummarySnapshotFile(legacyPath, sessionKey);\n}\n\nasync function readSummarySnapshotFile(\n  filePath: string,\n  sessionKey: string,\n): Promise<HourlySummary[] | null> {\n  try {\n    const raw = await readFile(filePath, \"utf-8\");\n    const data = SummarySnapshotSchema.parse(JSON.parse(raw));\n    if (data.sessionKey !== sessionKey) return null;\n    return data.summaries;\n  } catch {\n    return null;\n  }\n}\n\nexport async function writeSummarySnapshot(\n  memoryDir: string,\n  sessionKey: string,\n  summaries: HourlySummary[],\n): Promise<void> {\n  const filePath = summarySnapshotPath(memoryDir, sessionKey);\n  await mkdir(path.dirname(filePath), { recursive: true });\n  const payload: SummarySnapshot = {\n    schemaVersion: summarySnapshotSchemaVersion,\n    sessionKey,\n    generatedAt: new Date().toISOString(),\n    summaries: summaries\n      .map((summary) => ({\n        hour: summary.hour,\n        sessionKey: summary.sessionKey,\n        bullets: summary.bullets,\n        turnCount: summary.turnCount,\n        generatedAt: summary.generatedAt,\n      }))\n      .sort((a, b) => new Date(b.hour).getTime() - new Date(a.hour).getTime()),\n  };\n  await writeFile(filePath, JSON.stringify(payload, null, 2), \"utf-8\");\n}\n\nasync function withSummarySnapshotLock<T>(\n  memoryDir: string,\n  sessionKey: string,\n  work: () => Promise<T>,\n): Promise<T> {\n  const previous = summarySnapshotUpserts.get(sessionKey) ?? Promise.resolve();\n  let release!: () => void;\n  const current = new Promise<void>((resolve) => {\n    release = resolve;\n  });\n  const chained = previous.then(() => current);\n  summarySnapshotUpserts.set(sessionKey, chained);\n\n  await previous;\n  try {\n    return await withExclusiveSummarySnapshotFileLock(\n      summarySnapshotLockPath(memoryDir, sessionKey),\n      work,\n    );\n  } finally {\n    release();\n    if (summarySnapshotUpserts.get(sessionKey) === chained) {\n      summarySnapshotUpserts.delete(sessionKey);\n    }\n  }\n}\n\nexport async function upsertSummarySnapshot(\n  memoryDir: string,\n  summary: HourlySummary,\n): Promise<void> {\n  await withSummarySnapshotLock(memoryDir, summary.sessionKey, async () => {\n    const existing = await readSummarySnapshot(memoryDir, summary.sessionKey);\n    const byHour = new Map<string, HourlySummary>();\n    for (const item of existing ?? []) {\n      byHour.set(item.hour, {\n        ...item,\n        generatedAt: item.generatedAt || new Date().toISOString(),\n        sessionKey: summary.sessionKey,\n      });\n    }\n    byHour.set(summary.hour, summary);\n    const next = Array.from(byHour.values()).sort(\n      (a, b) => new Date(b.hour).getTime() - new Date(a.hour).getTime(),\n    );\n    await writeSummarySnapshot(memoryDir, summary.sessionKey, next);\n  });\n}\n\nasync function withExclusiveSummarySnapshotFileLock<T>(\n  lockPath: string,\n  callback: () => Promise<T>,\n): Promise<T> {\n  await mkdir(path.dirname(lockPath), { recursive: true });\n  const startedAt = Date.now();\n\n  while (true) {\n    try {\n      const handle = await open(lockPath, \"wx\");\n      let heartbeat: NodeJS.Timeout | null = null;\n      if (summarySnapshotLockHeartbeatMs > 0) {\n        heartbeat = setInterval(() => {\n          void utimes(lockPath, new Date(), new Date()).catch(() => undefined);\n        }, summarySnapshotLockHeartbeatMs);\n        heartbeat.unref?.();\n      }\n      try {\n        return await callback();\n      } finally {\n        if (heartbeat) clearInterval(heartbeat);\n        await handle.close().catch(() => undefined);\n        await unlink(lockPath).catch(() => undefined);\n      }\n    } catch (error) {\n      if (!isAlreadyExistsError(error)) throw error;\n      try {\n        const lockStat = await stat(lockPath);\n        if (Date.now() - lockStat.mtimeMs > summarySnapshotLockStaleMs) {\n          await unlink(lockPath).catch(() => undefined);\n          continue;\n        }\n      } catch {\n        continue;\n      }\n      if (Date.now() - startedAt > summarySnapshotLockTimeoutMs) {\n        throw new Error(\"timed out acquiring summary snapshot lock\");\n      }\n      await sleep(10);\n    }\n  }\n}\n\nfunction isAlreadyExistsError(error: unknown): boolean {\n  return typeof error === \"object\" && error !== null && \"code\" in error && error.code === \"EEXIST\";\n}\n\nfunction sleep(ms: number): Promise<void> {\n  return new Promise((resolve) => setTimeout(resolve, ms));\n}\n"],"mappings":"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","names":[]}