Function forceCompact

src/core/compaction.ts:285–308

(
  session: ISessionStore,
  summarize: (prompt: string) => Promise<string>,
)

 * Returns token count before compaction, or null if session was empty.
 */
export async function forceCompact(
  session: ISessionStore,
  summarize: (prompt: string) => Promise<string>,
): Promise<{ preTokens: number } | null> {
  const allEntries = await session.readAll()
  const activeEntries = getActiveEntries(allEntries)
  if (activeEntries.length === 0) return null

  const currentTokens = estimateSessionTokens(activeEntries)
  console.log(`compaction: manual compact for session ${session.id} (~${currentTokens} tokens, ${activeEntries.length} entries)`)

  const prompt = buildSummarizationPrompt(activeEntries)
  const summaryText = await summarize(prompt)

  const lastEntry = allEntries[allEntries.length - 1]
  const boundary = createCompactBoundary('manual', currentTokens, session.id, lastEntry?.uuid ?? null)
  const summary = createSummaryEntry(summaryText, session.id, boundary.uuid)

  await session.appendRaw(boundary)
  await session.appendRaw(summary)

  console.log(`compaction: manual compact done. ${activeEntries.length} entries → summary`)
  return { preTokens: currentTokens }
}