@aigne/core 1.72.0 → 1.74.0-beta

package/dist/prompt/agent-session.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-session.mjs","names":[],"sources":["../../src/prompt/agent-session.ts"],"sourcesContent":["import type { AFS, AFSEntry } from \"@aigne/afs\";\nimport { AFSHistory } from \"@aigne/afs-history\";\nimport { v7 } from \"@aigne/uuid\";\nimport { joinURL } from \"ufo\";\nimport { stringify } from \"yaml\";\nimport type { AgentInvokeOptions } from \"../agents/agent.js\";\nimport type { ChatModelInputMessage } from \"../agents/chat-model.js\";\nimport { logger } from \"../utils/logger.js\";\nimport { estimateTokens } from \"../utils/token-estimator.js\";\nimport { isNonNullable } from \"../utils/type-utils.js\";\nimport {\n  type CompactConfig,\n  type CompactContent,\n  DEFAULT_COMPACT_ASYNC,\n  DEFAULT_COMPACT_MODE,\n  DEFAULT_KEEP_RECENT_RATIO,\n  DEFAULT_MAX_TOKENS,\n  DEFAULT_MEMORY_QUERY_LIMIT,\n  DEFAULT_MEMORY_RATIO,\n  DEFAULT_SESSION_MEMORY_ASYNC,\n  DEFAULT_SESSION_MEMORY_MODE,\n  DEFAULT_SESSION_MODE,\n  DEFAULT_USER_MEMORY_ASYNC,\n  DEFAULT_USER_MEMORY_MODE,\n  type EntryContent,\n  type MemoryFact,\n  type SessionMemoryConfig,\n  type SessionMode,\n  type UserMemoryConfig,\n} from \"./compact/types.js\";\n\nexport * from \"./compact/types.js\";\n\nexport interface AgentSessionOptions {\n  sessionId: string;\n  userId?: string;\n  agentId?: string;\n  afs?: AFS;\n\n  /**\n   * Session mode\n   * - \"auto\": Enable history recording, compaction, and memory extraction\n   * - \"disabled\": Disable all session features (history, compaction, memory)\n   *\n   * **Should be \"disabled\" for internal utility agents** (extractors, compactors, etc.)\n   * to avoid recursive memory extraction and unnecessary overhead.\n   *\n   * @default DEFAULT_SESSION_MODE (\"auto\")\n   */\n  mode?: SessionMode;\n\n  /**\n   * Compaction configuration\n   */\n  compact?: CompactConfig;\n\n  /**\n   * Session memory configuration\n   */\n  sessionMemory?: SessionMemoryConfig;\n\n  /**\n   * User memory configuration\n   */\n  userMemory?: UserMemoryConfig;\n}\n\ninterface RuntimeState {\n  systemMessages?: ChatModelInputMessage[];\n  sessionMemory?: AFSEntry<MemoryFact>[];\n  userMemory?: AFSEntry<MemoryFact>[];\n  historyCompact?: CompactContent;\n  historyEntries: AFSEntry<EntryContent>[];\n  currentEntry: EntryContent | null;\n  currentEntryCompact?: CompactContent & {\n    compressedCount: number;\n  };\n}\n\nexport class AgentSession {\n  readonly sessionId: string;\n  readonly userId?: string;\n  readonly agentId?: string;\n\n  private afs?: AFS;\n  private historyModulePath?: string;\n  private mode: SessionMode;\n  private compactConfig: CompactConfig;\n  private sessionMemoryConfig: SessionMemoryConfig;\n  private userMemoryConfig: UserMemoryConfig;\n  private runtimeState: RuntimeState;\n  private initialized?: Promise<void>;\n  private compactionPromise?: Promise<void>;\n  private sessionMemoryUpdatePromise?: Promise<void>;\n  private userMemoryUpdatePromise?: Promise<void>;\n\n  constructor(options: AgentSessionOptions) {\n    this.sessionId = options.sessionId;\n    this.userId = options.userId;\n    this.agentId = options.agentId;\n    this.afs = options.afs;\n    this.mode = options.mode ?? DEFAULT_SESSION_MODE;\n    this.compactConfig = options.compact ?? {};\n    this.sessionMemoryConfig = options.sessionMemory ?? {};\n    this.userMemoryConfig = options.userMemory ?? {};\n\n    this.runtimeState = {\n      historyEntries: [],\n      currentEntry: null,\n    };\n  }\n\n  /**\n   * Check if memory extraction is enabled\n   * Memory extraction requires mode to be \"auto\" AND AFS history module to be available\n   */\n  private get isMemoryEnabled(): boolean {\n    return this.mode === \"auto\" && !!this.afs && !!this.historyModulePath;\n  }\n\n  async setSystemMessages(...messages: ChatModelInputMessage[]): Promise<void> {\n    await this.ensureInitialized();\n\n    this.runtimeState.systemMessages = messages;\n  }\n\n  async getMessages(): Promise<ChatModelInputMessage[]> {\n    await this.ensureInitialized();\n\n    const {\n      systemMessages,\n      userMemory,\n      sessionMemory,\n      historyCompact,\n      historyEntries,\n      currentEntry,\n      currentEntryCompact,\n    } = this.runtimeState;\n\n    let currentMessages: ChatModelInputMessage[] = [];\n    if (currentEntry?.messages?.length) {\n      if (currentEntryCompact) {\n        const { compressedCount, summary } = currentEntryCompact;\n\n        const summaryMessage = {\n          role: \"user\" as const,\n          content: `[Earlier messages in this conversation (${compressedCount} messages compressed)]\\n${summary}`,\n        };\n        const remainingMessages = currentEntry.messages.slice(compressedCount);\n\n        currentMessages = [summaryMessage, ...remainingMessages];\n      } else {\n        currentMessages = currentEntry.messages;\n      }\n    }\n\n    // Flatten history entries messages once\n    const historyMessages = historyEntries.flatMap((entry) => entry.content?.messages ?? []);\n\n    // Check if there's an Agent Skill in current uncompressed messages\n    const hasSkillInCurrentMessages = [...historyMessages, ...currentMessages].some(\n      (msg) =>\n        msg.role === \"user\" &&\n        Array.isArray(msg.content) &&\n        msg.content.some((block) => block.type === \"text\" && block.isAgentSkill === true),\n    );\n\n    // Prefer currentEntryCompact's lastAgentSkill over historyCompact's (newer takes priority)\n    const lastAgentSkillToInject =\n      currentEntryCompact?.lastAgentSkill ?? historyCompact?.lastAgentSkill;\n\n    const messages = [\n      ...(systemMessages ?? []),\n      ...(userMemory && userMemory.length > 0 ? [this.formatUserMemory(userMemory)] : []),\n      ...(sessionMemory && sessionMemory.length > 0\n        ? [this.formatSessionMemory(sessionMemory)]\n        : []),\n      ...(historyCompact?.summary\n        ? [\n            {\n              role: \"system\" as const,\n              content: `Previous conversation summary:\\n${historyCompact.summary}`,\n            },\n          ]\n        : []),\n      // Only inject lastAgentSkill if there's no skill in current messages\n      ...(lastAgentSkillToInject && !hasSkillInCurrentMessages\n        ? [\n            {\n              role: \"user\" as const,\n              content: [\n                {\n                  type: \"text\" as const,\n                  text: lastAgentSkillToInject.content,\n                },\n              ],\n            },\n          ]\n        : []),\n      ...historyMessages,\n      ...currentMessages,\n    ];\n\n    // Filter out thinking messages and truncate large messages\n    return messages\n      .map((msg) => {\n        if (!msg.content || typeof msg.content === \"string\") {\n          return msg;\n        }\n        // Filter out thinking from UnionContent[]\n        const filteredContent = msg.content.filter((c) => !(c.type === \"text\" && c.isThinking));\n        if (filteredContent.length === 0) return null;\n        return { ...msg, content: filteredContent };\n      })\n      .filter(isNonNullable)\n      .map((msg) => this.truncateLargeMessage(msg));\n  }\n\n  /**\n   * Format user memory facts into a system message\n   * Applies token budget limit to ensure memory injection fits within constraints\n   */\n  private formatUserMemory(memoryEntries: AFSEntry<MemoryFact>[]): ChatModelInputMessage {\n    const memoryRatio = this.userMemoryConfig.memoryRatio ?? DEFAULT_MEMORY_RATIO;\n    const maxTokens = Math.floor(\n      (this.compactConfig.maxTokens ?? DEFAULT_MAX_TOKENS) * memoryRatio,\n    );\n    const header = \"[User Memory Facts]\";\n    let currentTokens = estimateTokens(header);\n\n    const facts: string[] = [];\n\n    for (const entry of memoryEntries) {\n      const fact = entry.content?.fact;\n      if (!fact) continue;\n\n      const factTokens = estimateTokens(fact);\n\n      // Check if adding this fact would exceed token budget\n      if (currentTokens + factTokens > maxTokens) {\n        break; // Stop adding facts\n      }\n\n      facts.push(fact);\n      currentTokens += factTokens;\n    }\n\n    return {\n      role: \"system\",\n      content: this.formatMemoryTemplate({ header, data: facts }),\n    };\n  }\n\n  /**\n   * Format session memory facts into a system message\n   * Applies token budget limit to ensure memory injection fits within constraints\n   */\n  private formatSessionMemory(memoryEntries: AFSEntry<MemoryFact>[]): ChatModelInputMessage {\n    const memoryRatio = this.sessionMemoryConfig.memoryRatio ?? DEFAULT_MEMORY_RATIO;\n    const maxTokens = Math.floor(\n      (this.compactConfig.maxTokens ?? DEFAULT_MAX_TOKENS) * memoryRatio,\n    );\n    const header = \"[Session Memory Facts]\";\n    let currentTokens = estimateTokens(header);\n\n    const facts: string[] = [];\n\n    for (const entry of memoryEntries) {\n      const fact = entry.content?.fact;\n      if (!fact) continue;\n\n      const factTokens = estimateTokens(fact);\n\n      // Check if adding this fact would exceed token budget\n      if (currentTokens + factTokens > maxTokens) {\n        break; // Stop adding facts\n      }\n\n      facts.push(fact);\n      currentTokens += factTokens;\n    }\n\n    return {\n      role: \"system\",\n      content: this.formatMemoryTemplate({ header, data: facts }),\n    };\n  }\n\n  private formatMemoryTemplate({ header, data }: { header: string; data: unknown }): string {\n    return `\\\n${header}\n\n${\"```yaml\"}\n${stringify(data)}\n${\"```\"}\n`;\n  }\n\n  async startMessage(\n    input: unknown,\n    message: ChatModelInputMessage,\n    options: AgentInvokeOptions,\n  ): Promise<void> {\n    await this.ensureInitialized();\n\n    // Only run compact if mode is not disabled\n    if (this.mode !== \"disabled\") {\n      await this.maybeAutoCompact(options);\n\n      // Always wait for compaction to complete before starting a new message\n      // This ensures data consistency even in async compact mode\n      if (this.compactionPromise) await this.compactionPromise;\n    }\n\n    this.runtimeState.currentEntryCompact = undefined;\n    this.runtimeState.currentEntry = { input, messages: [message] };\n  }\n\n  async endMessage(\n    output: unknown,\n    message: ChatModelInputMessage | undefined,\n    options: AgentInvokeOptions,\n  ): Promise<void> {\n    await this.ensureInitialized();\n\n    if (\n      !this.runtimeState.currentEntry?.input ||\n      !this.runtimeState.currentEntry.messages?.length\n    ) {\n      throw new Error(\"No current entry to end. Call startMessage() first.\");\n    }\n\n    if (message) this.runtimeState.currentEntry.messages.push(message);\n    this.runtimeState.currentEntry.output = output;\n\n    let newEntry: AFSEntry<EntryContent>;\n\n    // Only persist to AFS if mode is not disabled\n    if (this.mode !== \"disabled\" && this.afs && this.historyModulePath) {\n      newEntry = (\n        await this.afs.write(joinURL(this.historyModulePath, \"by-session\", this.sessionId, \"new\"), {\n          userId: this.userId,\n          sessionId: this.sessionId,\n          agentId: this.agentId,\n          content: this.runtimeState.currentEntry,\n        })\n      ).data;\n    } else {\n      // Create in-memory entry for runtime state\n      const id = v7();\n\n      newEntry = {\n        id,\n        path: `/history/${id}`,\n        userId: this.userId,\n        sessionId: this.sessionId,\n        agentId: this.agentId,\n        content: this.runtimeState.currentEntry,\n      };\n    }\n\n    this.runtimeState.historyEntries.push(newEntry);\n    this.runtimeState.currentEntry = null;\n    this.runtimeState.currentEntryCompact = undefined;\n\n    // Only run compact and memory extraction if mode is not disabled\n    if (this.mode !== \"disabled\") {\n      await Promise.all([\n        // Check if auto-compact should be triggered\n        this.maybeAutoCompact(options),\n        // Check if auto-update session memory should be triggered\n        this.maybeAutoUpdateSessionMemory(options),\n      ]);\n    }\n  }\n\n  /**\n   * Manually trigger compaction\n   */\n  async compact(options: AgentInvokeOptions): Promise<void> {\n    await this.ensureInitialized();\n\n    // If compaction is already in progress, wait for it to complete\n    if (this.compactionPromise) {\n      return this.compactionPromise;\n    }\n\n    // Start new compaction task\n    this.compactionPromise = this.doCompact(options).finally(() => {\n      this.compactionPromise = undefined;\n    });\n\n    const isAsync = this.compactConfig.async ?? DEFAULT_COMPACT_ASYNC;\n\n    if (!isAsync) await this.compactionPromise;\n  }\n\n  /**\n   * Internal method that performs the actual compaction\n   */\n  private async doCompact(options: AgentInvokeOptions): Promise<void> {\n    const { compactor } = this.compactConfig ?? {};\n    if (!compactor) {\n      throw new Error(\"Cannot compact without a compactor agent configured.\");\n    }\n\n    const historyEntries = this.runtimeState.historyEntries;\n    if (historyEntries.length === 0) return;\n\n    const maxTokens = this.maxTokens;\n\n    // Target to keep only 50% of keepRecentTokens to leave buffer room\n    // This avoids triggering compression again shortly after compaction\n    // Similar to compactCurrentEntry, we compress more aggressively to leave headroom\n    //\n    // Note: We don't subtract systemTokens or currentEntry tokens because:\n    // 1. keepRecentTokens is already a relative ratio (e.g., 50% of maxTokens)\n    // 2. systemTokens overhead is typically small (~1-2k, ~1-2% of maxTokens)\n    // 3. currentEntry is still being constructed (not yet added to history)\n    // 4. In tool use scenarios, currentEntry can be very large (many tool calls)\n    // 5. Subtracting them would complicate logic without significant benefit\n    // 6. Total token limit is enforced by maybeAutoCompact trigger condition\n    const keepRecentTokens = this.keepRecentTokens * 0.5;\n\n    // Find split point by iterating backwards from most recent entry\n    // The split point divides history into: [compact] | [keep]\n    let splitIndex = historyEntries.length; // Default: keep all (no compaction)\n    let accumulatedTokens = 0;\n\n    for (let i = historyEntries.length - 1; i >= 0; i--) {\n      const entry = historyEntries[i];\n      if (!entry) continue;\n\n      const entryTokens = this.estimateMessagesTokens(entry.content?.messages ?? []);\n\n      // Check if adding this entry would exceed token budget\n      if (accumulatedTokens + entryTokens > keepRecentTokens) {\n        // Would exceed budget, split here (this entry and earlier ones will be compacted)\n        splitIndex = i + 1;\n        break;\n      }\n\n      // Can keep this entry, accumulate and continue\n      accumulatedTokens += entryTokens;\n      splitIndex = i;\n    }\n\n    // Split history at the found point\n    const entriesToCompact = historyEntries.slice(0, splitIndex);\n    const entriesToKeep = historyEntries.slice(splitIndex);\n\n    // If nothing to compact, return\n    if (entriesToCompact.length === 0) {\n      return;\n    }\n\n    const latestCompactedEntry = entriesToCompact.at(-1);\n    if (!latestCompactedEntry) return;\n\n    // Split into batches to avoid context overflow\n    const batches = this.splitIntoBatches(entriesToCompact, maxTokens);\n\n    // Process batches incrementally, each summary becomes input for the next\n    let currentSummary = this.runtimeState.historyCompact?.summary;\n    for (const batch of batches) {\n      const messages = batch\n        .flatMap((e) => e.content?.messages ?? [])\n        .filter(isNonNullable)\n        .map((msg) => this.truncateLargeMessage(msg));\n\n      const result = await options.context.invoke(compactor, {\n        previousSummary: [currentSummary].filter(isNonNullable),\n        messages,\n      });\n      currentSummary = result.summary;\n    }\n\n    // Extract last Agent Skill from entries to compact\n    let lastAgentSkill = this.findLastAgentSkill(entriesToCompact);\n\n    // If no skill found in entries to compact, inherit from previous compact\n    if (!lastAgentSkill && this.runtimeState.historyCompact?.lastAgentSkill) {\n      lastAgentSkill = this.runtimeState.historyCompact.lastAgentSkill;\n    }\n\n    // Create compact content\n    const historyCompact: CompactContent = {\n      summary: currentSummary ?? \"\",\n      lastAgentSkill,\n    };\n\n    // Write compact entry to AFS\n    if (this.afs && this.historyModulePath) {\n      await this.afs.write(\n        joinURL(this.historyModulePath, \"by-session\", this.sessionId, \"@metadata/compact/new\"),\n        {\n          userId: this.userId,\n          agentId: this.agentId,\n          content: historyCompact,\n          metadata: {\n            latestEntryId: latestCompactedEntry.id,\n          },\n        },\n      );\n    }\n\n    // Update runtime state: keep the summary and recent entries\n    this.runtimeState.historyCompact = historyCompact;\n    this.runtimeState.historyEntries = entriesToKeep;\n  }\n\n  private async compactCurrentEntry(options: AgentInvokeOptions): Promise<void> {\n    const { compactor } = this.compactConfig ?? {};\n    if (!compactor) return;\n\n    const currentEntry = this.runtimeState.currentEntry;\n    if (!currentEntry?.messages?.length) return;\n\n    const alreadyCompressedCount = this.runtimeState.currentEntryCompact?.compressedCount ?? 0;\n    const uncompressedMessages = currentEntry.messages.slice(alreadyCompressedCount);\n\n    if (uncompressedMessages.length === 0) return;\n\n    // Target to keep only 50% of keepTokenBudget to leave buffer room\n    // This avoids frequent small-batch compressions in tool use scenarios\n    const keepTokenBudget = this.keepRecentTokens * 0.5;\n\n    let splitIndex = uncompressedMessages.length;\n    let accumulatedTokens = 0;\n\n    for (let i = uncompressedMessages.length - 1; i >= 0; i--) {\n      const msg = uncompressedMessages[i];\n      if (!msg) continue;\n\n      const msgTokens = this.estimateMessagesTokens([msg]);\n\n      if (accumulatedTokens + msgTokens > keepTokenBudget) {\n        splitIndex = i + 1;\n        break;\n      }\n\n      accumulatedTokens += msgTokens;\n      splitIndex = i;\n    }\n\n    const keptMessages = uncompressedMessages.slice(splitIndex);\n    const requiredToolCallIds = new Set<string>();\n\n    for (const msg of keptMessages) {\n      if (msg.role === \"tool\" && msg.toolCallId) {\n        requiredToolCallIds.add(msg.toolCallId);\n      }\n    }\n\n    if (requiredToolCallIds.size > 0) {\n      for (let i = splitIndex - 1; i >= 0; i--) {\n        const msg = uncompressedMessages[i];\n        if (!msg?.toolCalls) continue;\n\n        for (const toolCall of msg.toolCalls) {\n          if (requiredToolCallIds.has(toolCall.id)) {\n            splitIndex = i;\n            break;\n          }\n        }\n      }\n    }\n\n    const messagesToCompact = uncompressedMessages\n      .slice(0, splitIndex)\n      .map((msg) => this.truncateLargeMessage(msg));\n\n    if (messagesToCompact.length === 0) return;\n\n    const result = await options.context.invoke(compactor, {\n      previousSummary: this.runtimeState.currentEntryCompact?.summary\n        ? [this.runtimeState.currentEntryCompact.summary]\n        : undefined,\n      messages: messagesToCompact,\n    });\n\n    // Find last Agent Skill from messages being compacted\n    const lastAgentSkill =\n      this.findLastAgentSkillFromMessages(messagesToCompact) ??\n      this.runtimeState.currentEntryCompact?.lastAgentSkill;\n\n    this.runtimeState.currentEntryCompact = {\n      summary: result.summary,\n      lastAgentSkill,\n      compressedCount: alreadyCompressedCount + messagesToCompact.length,\n    };\n  }\n\n  private async maybeCompactCurrentEntry(options: AgentInvokeOptions): Promise<void> {\n    const currentEntry = this.runtimeState.currentEntry;\n    if (!currentEntry?.messages?.length) return;\n\n    const compressedCount = this.runtimeState.currentEntryCompact?.compressedCount ?? 0;\n    const uncompressedMessages = currentEntry.messages.slice(compressedCount);\n\n    const threshold = this.keepRecentTokens;\n    const currentTokens = this.estimateMessagesTokens(uncompressedMessages);\n\n    if (currentTokens > threshold) {\n      await this.compactCurrentEntry(options);\n    }\n  }\n\n  private async maybeAutoCompact(options: AgentInvokeOptions): Promise<void> {\n    if (this.compactionPromise) await this.compactionPromise;\n\n    const mode = this.compactConfig.mode ?? DEFAULT_COMPACT_MODE;\n    if (mode === \"disabled\") return;\n\n    const { compactor } = this.compactConfig;\n    if (!compactor) return;\n\n    const maxTokens = this.maxTokens;\n\n    const messages = await this.getMessages();\n    const currentTokens = this.estimateMessagesTokens(messages);\n\n    if (currentTokens >= maxTokens) {\n      await this.compact(options);\n    }\n  }\n\n  /**\n   * Estimate token count for messages\n   * Applies singleMessageLimit to each text block individually\n   * Non-text tokens (images, tool calls) are always counted in full\n   */\n  private estimateMessagesTokens(\n    messages: ChatModelInputMessage[],\n    singleMessageLimit: number = this.singleMessageLimit,\n  ): number {\n    let totalTokens = 0;\n\n    for (const msg of messages) {\n      // 1. Estimate content tokens\n      if (typeof msg.content === \"string\") {\n        const textTokens = estimateTokens(msg.content);\n        const effectiveTokens = textTokens > singleMessageLimit ? singleMessageLimit : textTokens;\n        totalTokens += effectiveTokens;\n      } else if (Array.isArray(msg.content)) {\n        for (const block of msg.content) {\n          if (block.type === \"text\" && typeof block.text === \"string\") {\n            // Text tokens (can be truncated) - apply limit to each block individually\n            const textTokens = estimateTokens(block.text);\n            const effectiveTokens =\n              textTokens > singleMessageLimit ? singleMessageLimit : textTokens;\n            totalTokens += effectiveTokens;\n          } else {\n            // Non-text blocks - always counted in full\n            totalTokens += 1000;\n          }\n        }\n      }\n\n      // 2. Estimate tool calls tokens (cannot be truncated)\n      if (msg.toolCalls && msg.toolCalls.length > 0) {\n        for (const toolCall of msg.toolCalls) {\n          // Function name + arguments + overhead\n          totalTokens += estimateTokens(toolCall.function.name);\n          totalTokens += estimateTokens(\n            stringify(toolCall.function.arguments).replace(/\\s+/g, \" \"),\n          );\n          totalTokens += 10; // Structure overhead\n        }\n      }\n    }\n\n    return totalTokens;\n  }\n\n  /**\n   * Split entries into batches based on token limit\n   * Each batch will not exceed the specified maxTokens\n   */\n  private splitIntoBatches(\n    entries: AFSEntry<EntryContent>[],\n    maxTokens: number,\n  ): AFSEntry<EntryContent>[][] {\n    const batches: AFSEntry<EntryContent>[][] = [];\n    let currentBatch: AFSEntry<EntryContent>[] = [];\n    let currentTokens = 0;\n\n    for (const entry of entries) {\n      const entryTokens = this.estimateMessagesTokens(entry.content?.messages ?? []);\n\n      // If adding this entry exceeds limit and we have entries in current batch, start new batch\n      if (currentTokens + entryTokens > maxTokens && currentBatch.length > 0) {\n        batches.push(currentBatch);\n        currentBatch = [entry];\n        currentTokens = entryTokens;\n      } else {\n        currentBatch.push(entry);\n        currentTokens += entryTokens;\n      }\n    }\n\n    // Add remaining entries\n    if (currentBatch.length > 0) {\n      batches.push(currentBatch);\n    }\n\n    return batches;\n  }\n\n  async appendCurrentMessages(\n    messages: ChatModelInputMessage | ChatModelInputMessage[],\n    options: AgentInvokeOptions,\n  ): Promise<void> {\n    await this.ensureInitialized();\n\n    if (!this.runtimeState.currentEntry || !this.runtimeState.currentEntry.messages?.length) {\n      throw new Error(\"No current entry to append messages. Call startMessage() first.\");\n    }\n\n    this.runtimeState.currentEntry.messages.push(...[messages].flat());\n\n    await this.maybeCompactCurrentEntry(options);\n  }\n\n  /**\n   * Truncate text content to fit within target token limit\n   * @param text The text to truncate\n   * @param currentTokens Current token count of the text\n   * @param targetTokens Target token count after truncation\n   * @returns Truncated text\n   */\n  private truncateText(text: string, currentTokens: number, targetTokens: number): string {\n    if (currentTokens <= targetTokens) return text;\n\n    const keepRatio = (targetTokens / currentTokens) * 0.9;\n    const keepLength = Math.floor(text.length * keepRatio);\n    const headLength = Math.floor(keepLength * 0.7);\n    const tailLength = Math.floor(keepLength * 0.3);\n\n    return (\n      text.slice(0, headLength) +\n      `\\n\\n[... truncated ${currentTokens - targetTokens} tokens ...]\\n\\n` +\n      text.slice(-tailLength)\n    );\n  }\n\n  private truncateLargeMessage(msg: ChatModelInputMessage): ChatModelInputMessage {\n    const singleMessageLimit = this.singleMessageLimit;\n\n    // Handle string content\n    if (typeof msg.content === \"string\") {\n      const tokens = estimateTokens(msg.content);\n      if (tokens <= singleMessageLimit) return msg;\n\n      const truncated = this.truncateText(msg.content, tokens, singleMessageLimit);\n      return { ...msg, content: truncated };\n    }\n\n    // Handle array content (UnionContent[])\n    if (Array.isArray(msg.content)) {\n      // Truncate each text block individually if it exceeds the limit\n      const truncatedContent = msg.content.map((block) => {\n        // Keep non-text blocks unchanged\n        if (block.type !== \"text\" || typeof block.text !== \"string\") {\n          return block;\n        }\n\n        // Check if this text block needs truncation\n        const blockTokens = estimateTokens(block.text);\n        if (blockTokens <= singleMessageLimit) {\n          return block;\n        }\n\n        // Truncate this text block independently\n        const truncatedText = this.truncateText(block.text, blockTokens, singleMessageLimit);\n        return { ...block, text: truncatedText };\n      });\n\n      return { ...msg, content: truncatedContent };\n    }\n\n    // Unknown content type, return as-is\n    return msg;\n  }\n\n  private async ensureInitialized(): Promise<void> {\n    this.initialized ??= this.initialize();\n    await this.initialized;\n  }\n\n  private async initialize(): Promise<void> {\n    if (this.initialized) return;\n\n    await this.initializeDefaultCompactor();\n    await this.initializeDefaultSessionMemoryExtractor();\n    await this.initializeDefaultUserMemoryExtractor();\n\n    const historyModule = (await this.afs?.listModules())?.find(\n      (m) => m.module instanceof AFSHistory,\n    );\n\n    this.historyModulePath = historyModule?.path;\n\n    if (this.afs && this.historyModulePath) {\n      // Load user memory, session memory, and session history in parallel\n      const [userMemory, sessionMemory, sessionHistory] = await Promise.all([\n        this.loadUserMemory(),\n        this.loadSessionMemory(),\n        this.loadSessionHistory(),\n      ]);\n\n      // Update runtime state with loaded data\n      this.runtimeState.userMemory = userMemory;\n      this.runtimeState.sessionMemory = sessionMemory;\n      this.runtimeState.historyCompact = sessionHistory.historyCompact;\n      this.runtimeState.historyEntries = sessionHistory.historyEntries;\n    }\n  }\n\n  /**\n   * Load session memory facts\n   * @returns Array of memory fact entries for the current session\n   */\n  private async loadSessionMemory(): Promise<AFSEntry<MemoryFact>[]> {\n    if (!this.afs || !this.historyModulePath) return [];\n\n    // Check if session memory is disabled\n    const mode = this.sessionMemoryConfig.mode ?? DEFAULT_SESSION_MEMORY_MODE;\n    if (mode === \"disabled\") return [];\n\n    const sessionMemoryPath = joinURL(\n      this.historyModulePath,\n      \"by-session\",\n      this.sessionId,\n      \"@metadata/memory\",\n    );\n\n    const queryLimit = this.sessionMemoryConfig.queryLimit ?? DEFAULT_MEMORY_QUERY_LIMIT;\n\n    const memoryResult = await this.afs.list(sessionMemoryPath, {\n      filter: { userId: this.userId, agentId: this.agentId },\n      orderBy: [[\"updatedAt\", \"desc\"]],\n      limit: queryLimit,\n    });\n\n    // Filter out entries without content\n    const facts = memoryResult.data\n      .reverse()\n      .filter((entry: AFSEntry) => isNonNullable(entry.content)) as AFSEntry<MemoryFact>[];\n\n    return facts;\n  }\n\n  /**\n   * Load user memory facts\n   * @returns Array of memory fact entries for the current user\n   */\n  private async loadUserMemory(): Promise<AFSEntry<MemoryFact>[]> {\n    if (!this.afs || !this.historyModulePath || !this.userId) return [];\n\n    // Check if user memory is disabled\n    const mode = this.userMemoryConfig.mode ?? DEFAULT_USER_MEMORY_MODE;\n    if (mode === \"disabled\") return [];\n\n    const userMemoryPath = joinURL(\n      this.historyModulePath,\n      \"by-user\",\n      this.userId,\n      \"@metadata/memory\",\n    );\n\n    const queryLimit = this.userMemoryConfig.queryLimit ?? DEFAULT_MEMORY_QUERY_LIMIT;\n\n    const memoryResult = await this.afs.list(userMemoryPath, {\n      filter: { userId: this.userId, agentId: this.agentId },\n      orderBy: [[\"updatedAt\", \"desc\"]],\n      limit: queryLimit,\n    });\n\n    // Filter out entries without content\n    const facts = memoryResult.data\n      .reverse()\n      .filter((entry: AFSEntry) => isNonNullable(entry.content)) as AFSEntry<MemoryFact>[];\n\n    return facts;\n  }\n\n  /**\n   * Load session history including compact content and history entries\n   * @returns Object containing history compact and history entries\n   */\n  private async loadSessionHistory(): Promise<{\n    historyCompact?: CompactContent;\n    historyEntries: AFSEntry<EntryContent>[];\n  }> {\n    if (!this.afs || !this.historyModulePath) {\n      return { historyEntries: [] };\n    }\n\n    // Load latest compact entry if exists\n    const compactPath = joinURL(\n      this.historyModulePath,\n      \"by-session\",\n      this.sessionId,\n      \"@metadata/compact\",\n    );\n\n    const compactResult = await this.afs.list(compactPath, {\n      filter: { userId: this.userId, agentId: this.agentId },\n      orderBy: [[\"createdAt\", \"desc\"]],\n      limit: 1,\n    });\n\n    const latestCompact = compactResult.data[0] as\n      | (AFSEntry & { content?: CompactContent; metadata?: { latestEntryId?: string } })\n      | undefined;\n\n    const historyCompact = latestCompact?.content;\n\n    // Load history entries (after compact point if exists)\n    const afsEntries: AFSEntry[] = (\n      await this.afs.list(joinURL(this.historyModulePath, \"by-session\", this.sessionId), {\n        filter: {\n          userId: this.userId,\n          agentId: this.agentId,\n          // Only load entries after the latest compact\n          after: latestCompact?.createdAt?.toISOString(),\n        },\n        orderBy: [[\"createdAt\", \"desc\"]],\n        // Set a very large limit to load all history entries\n        // The default limit is 10 which would cause history truncation\n        limit: 10000,\n      })\n    ).data;\n\n    const historyEntries = afsEntries.reverse().filter((entry) => isNonNullable(entry.content));\n\n    return {\n      historyCompact,\n      historyEntries,\n    };\n  }\n\n  /**\n   * Manually trigger session memory update\n   */\n  async updateSessionMemory(options: AgentInvokeOptions): Promise<void> {\n    await this.ensureInitialized();\n\n    this.sessionMemoryUpdatePromise ??= this.doUpdateSessionMemory(options)\n      .then(() => {\n        // After session memory update succeeds, potentially trigger user memory consolidation\n        this.maybeAutoUpdateUserMemory(options).catch((err) => {\n          logger.error(\"User memory update failed:\", err);\n        });\n      })\n      .finally(() => {\n        this.sessionMemoryUpdatePromise = undefined;\n      });\n\n    return this.sessionMemoryUpdatePromise;\n  }\n\n  private async maybeAutoUpdateSessionMemory(options: AgentInvokeOptions): Promise<void> {\n    // Check if memory extraction is enabled (requires AFS history module)\n    if (!this.isMemoryEnabled) return;\n\n    // Check if mode is disabled\n    const mode = this.sessionMemoryConfig.mode ?? DEFAULT_SESSION_MEMORY_MODE;\n    if (mode === \"disabled\") return;\n\n    // Trigger session memory update\n    this.updateSessionMemory(options).catch((err) => {\n      logger.error(\"Session memory update failed:\", err);\n    });\n\n    const isAsync = this.sessionMemoryConfig.async ?? DEFAULT_SESSION_MEMORY_ASYNC;\n\n    if (!isAsync) await this.sessionMemoryUpdatePromise;\n  }\n\n  private async maybeAutoUpdateUserMemory(options: AgentInvokeOptions): Promise<void> {\n    // Check if memory extraction is enabled (requires AFS history module)\n    if (!this.isMemoryEnabled || !this.userId) return;\n\n    // Check if mode is disabled\n    const mode = this.userMemoryConfig.mode ?? DEFAULT_USER_MEMORY_MODE;\n    if (mode === \"disabled\") return;\n\n    // Trigger user memory consolidation\n    this.updateUserMemory(options).catch((err) => {\n      logger.error(\"User memory update failed:\", err);\n    });\n\n    const isAsync = this.userMemoryConfig.async ?? DEFAULT_USER_MEMORY_ASYNC;\n\n    if (!isAsync) await this.userMemoryUpdatePromise;\n  }\n\n  /**\n   * Internal method that performs the actual session memory update\n   */\n  private async doUpdateSessionMemory(options: AgentInvokeOptions): Promise<void> {\n    const { extractor } = this.sessionMemoryConfig ?? {};\n    if (!extractor) {\n      throw new Error(\"Cannot update session memory without an extractor agent configured.\");\n    }\n\n    // Get latestEntryId from the most recent memory entry's metadata\n    // This tells us which history entries have already been processed\n    const latestEntryId = this.runtimeState.sessionMemory?.at(-1)?.metadata?.latestEntryId as\n      | string\n      | undefined;\n\n    // Filter unextracted entries based on latestEntryId\n    // Similar to compact mechanism, we find the position of the last extracted entry\n    // and only process entries after that point\n    const lastExtractedIndex = latestEntryId\n      ? this.runtimeState.historyEntries.findIndex((e) => e.id === latestEntryId)\n      : -1;\n\n    const unextractedEntries =\n      lastExtractedIndex >= 0\n        ? this.runtimeState.historyEntries.slice(lastExtractedIndex + 1)\n        : this.runtimeState.historyEntries;\n\n    if (unextractedEntries.length === 0) return;\n\n    // Get recent conversation messages for extraction\n    const recentMessages = unextractedEntries\n      .flatMap((entry) => entry.content?.messages ?? [])\n      .filter(isNonNullable);\n\n    if (recentMessages.length === 0) return;\n\n    // Get existing session memory facts for context\n    const existingFacts =\n      this.runtimeState.sessionMemory?.map((entry) => entry.content).filter(isNonNullable) ?? [];\n\n    // Get user memory facts to avoid duplication\n    const existingUserFacts =\n      this.runtimeState.userMemory?.map((entry) => entry.content).filter(isNonNullable) ?? [];\n\n    // Extract new facts from conversation\n    const result = await options.context.invoke(extractor, {\n      existingUserFacts,\n      existingFacts,\n      messages: recentMessages,\n    });\n\n    // If no changes, nothing to do\n    if (!result.newFacts.length && !result.removeFacts?.length) {\n      return;\n    }\n\n    // Get the last entry to record its ID for metadata\n    const latestExtractedEntry = unextractedEntries.at(-1);\n\n    if (this.afs && this.historyModulePath) {\n      // Handle fact removal\n      if (result.removeFacts?.length && this.runtimeState.sessionMemory) {\n        const entriesToRemove: AFSEntry<MemoryFact>[] = [];\n\n        for (const label of result.removeFacts) {\n          const entry = this.runtimeState.sessionMemory.find((e) => e.content?.label === label);\n          if (entry) entriesToRemove.push(entry);\n        }\n\n        // Remove from AFS storage and runtime state\n        for (const entryToRemove of entriesToRemove) {\n          // Delete from AFS storage\n          const memoryEntryPath = joinURL(\n            this.historyModulePath,\n            \"by-session\",\n            this.sessionId,\n            \"@metadata/memory\",\n            entryToRemove.id,\n          );\n          await this.afs.delete(memoryEntryPath);\n\n          // Remove from runtime state\n          const index = this.runtimeState.sessionMemory.indexOf(entryToRemove);\n          if (index !== -1) {\n            this.runtimeState.sessionMemory.splice(index, 1);\n          }\n        }\n      }\n\n      // Handle new facts\n      if (result.newFacts.length) {\n        const sessionMemoryPath = joinURL(\n          this.historyModulePath,\n          \"by-session\",\n          this.sessionId,\n          \"@metadata/memory/new\",\n        );\n\n        for (const fact of result.newFacts) {\n          const newEntry = await this.afs.write(sessionMemoryPath, {\n            userId: this.userId,\n            sessionId: this.sessionId,\n            agentId: this.agentId,\n            content: fact,\n            metadata: {\n              latestEntryId: latestExtractedEntry?.id,\n            },\n          });\n\n          // Add to runtime state\n          this.runtimeState.sessionMemory ??= [];\n          this.runtimeState.sessionMemory.push(newEntry.data);\n        }\n      }\n    }\n  }\n\n  /**\n   * Manually trigger user memory update\n   */\n  async updateUserMemory(options: AgentInvokeOptions): Promise<void> {\n    await this.ensureInitialized();\n\n    // Start new user memory update task\n    this.userMemoryUpdatePromise ??= this.doUpdateUserMemory(options).finally(() => {\n      this.userMemoryUpdatePromise = undefined;\n    });\n\n    return this.userMemoryUpdatePromise;\n  }\n\n  /**\n   * Internal method that performs the actual user memory extraction\n   */\n  private async doUpdateUserMemory(options: AgentInvokeOptions): Promise<void> {\n    const { extractor } = this.userMemoryConfig ?? {};\n    if (!extractor) {\n      throw new Error(\"Cannot update user memory without an extractor agent configured.\");\n    }\n\n    // Get session memory facts as the source for consolidation\n    const sessionFacts =\n      this.runtimeState.sessionMemory?.map((entry) => entry.content).filter(isNonNullable) ?? [];\n\n    if (sessionFacts.length === 0) return;\n\n    // Get existing user memory facts for context and deduplication\n    const existingUserFacts =\n      this.runtimeState.userMemory?.map((entry) => entry.content).filter(isNonNullable) ?? [];\n\n    // Extract user memory facts from session memory\n    const result = await options.context.invoke(extractor, {\n      sessionFacts,\n      existingUserFacts,\n    });\n\n    // If no changes, nothing to do\n    if (!result.newFacts.length && !result.removeFacts?.length) {\n      return;\n    }\n\n    if (this.afs && this.historyModulePath && this.userId) {\n      // Handle fact removal\n      if (result.removeFacts?.length && this.runtimeState.userMemory) {\n        const entriesToRemove: AFSEntry<MemoryFact>[] = [];\n\n        for (const label of result.removeFacts) {\n          const entry = this.runtimeState.userMemory.find((e) => e.content?.label === label);\n          if (entry) entriesToRemove.push(entry);\n        }\n\n        // Remove from AFS storage and runtime state\n        for (const entryToRemove of entriesToRemove) {\n          const memoryEntryPath = joinURL(\n            this.historyModulePath,\n            \"by-user\",\n            this.userId,\n            \"@metadata/memory\",\n            entryToRemove.id,\n          );\n          await this.afs.delete(memoryEntryPath);\n\n          const index = this.runtimeState.userMemory.indexOf(entryToRemove);\n          if (index !== -1) {\n            this.runtimeState.userMemory.splice(index, 1);\n          }\n        }\n      }\n\n      // Handle new/updated facts\n      // For user memory, labels are unique - replace existing facts with same label\n      if (result.newFacts.length) {\n        const userMemoryPath = joinURL(\n          this.historyModulePath,\n          \"by-user\",\n          this.userId,\n          \"@metadata/memory/new\",\n        );\n\n        for (const fact of result.newFacts) {\n          // Check if fact with same label already exists\n          const existingEntry = this.runtimeState.userMemory?.find(\n            (e) => e.content?.label === fact.label,\n          );\n\n          if (existingEntry) {\n            // Delete old entry\n            const oldEntryPath = joinURL(\n              this.historyModulePath,\n              \"by-user\",\n              this.userId,\n              \"@metadata/memory\",\n              existingEntry.id,\n            );\n            await this.afs.delete(oldEntryPath);\n\n            // Remove from runtime state\n            if (this.runtimeState.userMemory) {\n              const index = this.runtimeState.userMemory.indexOf(existingEntry);\n              if (index !== -1) {\n                this.runtimeState.userMemory.splice(index, 1);\n              }\n            }\n          }\n\n          // Create new entry\n          const newEntry = await this.afs.write(userMemoryPath, {\n            userId: this.userId,\n            agentId: this.agentId,\n            content: fact,\n          });\n\n          // Add to runtime state\n          this.runtimeState.userMemory ??= [];\n          this.runtimeState.userMemory.push(newEntry.data);\n        }\n      }\n    }\n  }\n\n  /**\n   * Find Agent Skill content from a single message\n   * @param msg - Message to search in\n   * @returns The skill content text if found, undefined otherwise\n   */\n  private findSkillContentInMessage(msg: ChatModelInputMessage): string | undefined {\n    if (msg.role === \"user\" && Array.isArray(msg.content)) {\n      const skillBlock = msg.content.find(\n        (block) => block.type === \"text\" && block.isAgentSkill === true,\n      );\n\n      if (skillBlock && skillBlock.type === \"text\") {\n        return skillBlock.text;\n      }\n    }\n    return undefined;\n  }\n\n  /**\n   * Find the last Agent Skill from a list of messages\n   * @param messages - Messages to search through\n   * @returns The last Agent Skill found, or undefined if none found\n   */\n  private findLastAgentSkillFromMessages(\n    messages: ChatModelInputMessage[],\n  ): CompactContent[\"lastAgentSkill\"] | undefined {\n    // Search backwards through messages to find the last Agent Skill\n    for (let i = messages.length - 1; i >= 0; i--) {\n      const msg = messages[i];\n      if (!msg) continue;\n\n      const skillContent = this.findSkillContentInMessage(msg);\n      if (skillContent) {\n        return {\n          content: skillContent,\n        };\n      }\n    }\n\n    return undefined;\n  }\n\n  /**\n   * Find the last Agent Skill from a list of history entries\n   * @param entries - History entries to search through\n   * @returns The last Agent Skill found, or undefined if none found\n   */\n  private findLastAgentSkill(\n    entries: AFSEntry<EntryContent>[],\n  ): CompactContent[\"lastAgentSkill\"] | undefined {\n    // Flatten all messages from entries\n    const allMessages = entries.flatMap((entry) => entry.content?.messages ?? []);\n    return this.findLastAgentSkillFromMessages(allMessages);\n  }\n\n  private async initializeDefaultCompactor() {\n    this.compactConfig.compactor ??= await import(\"./compact/compactor.js\").then(\n      (m) => new m.AISessionCompactor(),\n    );\n  }\n\n  private async initializeDefaultSessionMemoryExtractor() {\n    this.sessionMemoryConfig.extractor ??= await import(\n      \"./compact/session-memory-extractor.js\"\n    ).then((m) => new m.AISessionMemoryExtractor());\n  }\n\n  private async initializeDefaultUserMemoryExtractor() {\n    this.userMemoryConfig.extractor ??= await import(\"./compact/user-memory-extractor.js\").then(\n      (m) => new m.AIUserMemoryExtractor(),\n    );\n  }\n\n  private get maxTokens(): number {\n    return this.compactConfig?.maxTokens ?? DEFAULT_MAX_TOKENS;\n  }\n\n  private get keepRecentRatio(): number {\n    return this.compactConfig?.keepRecentRatio ?? DEFAULT_KEEP_RECENT_RATIO;\n  }\n\n  private get keepRecentTokens(): number {\n    return Math.floor(this.maxTokens * this.keepRecentRatio);\n  }\n\n  private get singleMessageLimit(): number {\n    return this.keepRecentTokens * 0.5;\n  }\n}\n"],"mappings":"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"}

package/dist/prompt/compact/compactor.cjs

@@ -0,0 +1,50 @@
+const require_rolldown_runtime = require('../../_virtual/rolldown_runtime.cjs');
+const require_utils_type_utils = require('../../utils/type-utils.cjs');
+const require_ai_agent = require('../../agents/ai-agent.cjs');
+let zod = require("zod");
+
+//#region src/prompt/compact/compactor.ts
+const COMPACTOR_INSTRUCTIONS = `\
+You are a conversation summarizer. Your task is to create a concise but comprehensive summary of the conversation history provided.
+
+## Conversation history
+
+\`\`\`yaml alt="previous-summary"
+{{ previousSummary | yaml.stringify }}
+\`\`\`
+
+
+\`\`\`yaml alt="conversation-histories"
+{{ messages | yaml.stringify }}
+\`\`\`
+
+## Guidelines
+
+1. Preserve key information, decisions, and context that would be needed for future conversation continuity
+2. Include important facts, names, dates, and specific details mentioned
+3. Summarize the user's goals and preferences expressed in the conversation
+4. Note any pending tasks or follow-up items
+5. Keep the summary focused and avoid unnecessary verbosity
+6. Write in a neutral, factual tone
+
+Output a single summary that captures the essence of the conversation.`;
+var AISessionCompactor = class extends require_ai_agent.AIAgent {
+	constructor(options) {
+		super({
+			name: "SessionCompactor",
+			description: "Generates conversation summaries for session compaction",
+			inputSchema: zod.z.object({
+				previousSummary: (0, zod.optional)(zod.z.array(zod.z.string()).describe("List of previous conversation summaries")),
+				messages: zod.z.array(zod.z.any())
+			}),
+			outputSchema: zod.z.object({ summary: zod.z.string().describe("A comprehensive summary of the conversation history") }),
+			instructions: COMPACTOR_INSTRUCTIONS,
+			taskRenderMode: "hide",
+			...require_utils_type_utils.omitBy(options ?? {}, (v) => require_utils_type_utils.isNil(v)),
+			session: { mode: "disabled" }
+		});
+	}
+};
+
+//#endregion
+exports.AISessionCompactor = AISessionCompactor;

package/dist/prompt/compact/compactor.mjs

@@ -0,0 +1,50 @@
+import { isNil, omitBy } from "../../utils/type-utils.mjs";
+import { AIAgent } from "../../agents/ai-agent.mjs";
+import { optional, z as z$1 } from "zod";
+
+//#region src/prompt/compact/compactor.ts
+const COMPACTOR_INSTRUCTIONS = `\
+You are a conversation summarizer. Your task is to create a concise but comprehensive summary of the conversation history provided.
+
+## Conversation history
+
+\`\`\`yaml alt="previous-summary"
+{{ previousSummary | yaml.stringify }}
+\`\`\`
+
+
+\`\`\`yaml alt="conversation-histories"
+{{ messages | yaml.stringify }}
+\`\`\`
+
+## Guidelines
+
+1. Preserve key information, decisions, and context that would be needed for future conversation continuity
+2. Include important facts, names, dates, and specific details mentioned
+3. Summarize the user's goals and preferences expressed in the conversation
+4. Note any pending tasks or follow-up items
+5. Keep the summary focused and avoid unnecessary verbosity
+6. Write in a neutral, factual tone
+
+Output a single summary that captures the essence of the conversation.`;
+var AISessionCompactor = class extends AIAgent {
+	constructor(options) {
+		super({
+			name: "SessionCompactor",
+			description: "Generates conversation summaries for session compaction",
+			inputSchema: z$1.object({
+				previousSummary: optional(z$1.array(z$1.string()).describe("List of previous conversation summaries")),
+				messages: z$1.array(z$1.any())
+			}),
+			outputSchema: z$1.object({ summary: z$1.string().describe("A comprehensive summary of the conversation history") }),
+			instructions: COMPACTOR_INSTRUCTIONS,
+			taskRenderMode: "hide",
+			...omitBy(options ?? {}, (v) => isNil(v)),
+			session: { mode: "disabled" }
+		});
+	}
+};
+
+//#endregion
+export { AISessionCompactor };
+//# sourceMappingURL=compactor.mjs.map

package/dist/prompt/compact/compactor.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"compactor.mjs","names":["z"],"sources":["../../../src/prompt/compact/compactor.ts"],"sourcesContent":["import { optional, z } from \"zod\";\nimport { AIAgent, type AIAgentOptions } from \"../../agents/ai-agent.js\";\nimport { isNil, omitBy } from \"../../utils/type-utils.js\";\nimport type { CompactContent, CompactorInput } from \"./types.js\";\n\nconst COMPACTOR_INSTRUCTIONS = `\\\nYou are a conversation summarizer. Your task is to create a concise but comprehensive summary of the conversation history provided.\n\n## Conversation history\n\n${\"```\"}yaml alt=\"previous-summary\"\n{{ previousSummary | yaml.stringify }}\n${\"```\"}\n\n\n${\"```\"}yaml alt=\"conversation-histories\"\n{{ messages | yaml.stringify }}\n${\"```\"}\n\n## Guidelines\n\n1. Preserve key information, decisions, and context that would be needed for future conversation continuity\n2. Include important facts, names, dates, and specific details mentioned\n3. Summarize the user's goals and preferences expressed in the conversation\n4. Note any pending tasks or follow-up items\n5. Keep the summary focused and avoid unnecessary verbosity\n6. Write in a neutral, factual tone\n\nOutput a single summary that captures the essence of the conversation.`;\n\nexport interface CreateCompactorOptions extends AIAgentOptions<CompactorInput, CompactContent> {}\n\nexport class AISessionCompactor extends AIAgent<CompactorInput, CompactContent> {\n  constructor(options?: CreateCompactorOptions) {\n    super({\n      name: \"SessionCompactor\",\n      description: \"Generates conversation summaries for session compaction\",\n      inputSchema: z.object({\n        previousSummary: optional(\n          z.array(z.string()).describe(\"List of previous conversation summaries\"),\n        ),\n        messages: z.array(z.any()),\n      }),\n      outputSchema: z.object({\n        summary: z.string().describe(\"A comprehensive summary of the conversation history\"),\n      }),\n      instructions: COMPACTOR_INSTRUCTIONS,\n      taskRenderMode: \"hide\",\n      ...omitBy(options ?? {}, (v) => isNil(v)),\n      session: {\n        mode: \"disabled\",\n      },\n    });\n  }\n}\n"],"mappings":";;;;;AAKA,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;AA2B/B,IAAa,qBAAb,cAAwC,QAAwC;CAC9E,YAAY,SAAkC;AAC5C,QAAM;GACJ,MAAM;GACN,aAAa;GACb,aAAaA,IAAE,OAAO;IACpB,iBAAiB,SACfA,IAAE,MAAMA,IAAE,QAAQ,CAAC,CAAC,SAAS,0CAA0C,CACxE;IACD,UAAUA,IAAE,MAAMA,IAAE,KAAK,CAAC;IAC3B,CAAC;GACF,cAAcA,IAAE,OAAO,EACrB,SAASA,IAAE,QAAQ,CAAC,SAAS,sDAAsD,EACpF,CAAC;GACF,cAAc;GACd,gBAAgB;GAChB,GAAG,OAAO,WAAW,EAAE,GAAG,MAAM,MAAM,EAAE,CAAC;GACzC,SAAS,EACP,MAAM,YACP;GACF,CAAC"}

package/dist/prompt/compact/session-memory-extractor.cjs

@@ -0,0 +1,137 @@
+const require_rolldown_runtime = require('../../_virtual/rolldown_runtime.cjs');
+const require_utils_type_utils = require('../../utils/type-utils.cjs');
+const require_ai_agent = require('../../agents/ai-agent.cjs');
+let zod = require("zod");
+
+//#region src/prompt/compact/session-memory-extractor.ts
+const EXTRACTOR_INSTRUCTIONS = `\
+You are a session memory fact extractor. Your task is to extract facts that help continue THIS SESSION's work.
+
+**Key Principle**: Extract WORK CONTEXT (tasks, decisions, blockers), NOT PROJECT DOCUMENTATION (tech stack, code structure, implementation details).
+
+Session memory is for remembering:
+- What we're trying to accomplish
+- Why we made certain choices
+- What problems we encountered
+- Important context for continuing the work
+
+Session memory is NOT for documenting:
+- What the code does (visible in code)
+- How the project is structured (can explore directly)
+- What technologies are used (obvious from files)
+
+## User Memory Facts (Long-term, cross-session)
+
+\`\`\`yaml alt="user-memory-facts"
+{{ existingUserFacts | yaml.stringify }}
+\`\`\`
+
+## Existing Session Memory Facts
+
+\`\`\`yaml alt="existing-facts"
+{{ existingFacts | yaml.stringify }}
+\`\`\`
+
+## Recent Conversation
+
+\`\`\`yaml alt="recent-messages"
+{{ messages | yaml.stringify }}
+\`\`\`
+
+## Guidelines
+
+1. **Avoid duplicating User Memory (CRITICAL)**:
+   - User Memory contains long-term, cross-session facts about the user
+   - DO NOT extract facts that are already covered in User Memory
+   - Focus on session-specific information that User Memory doesn't capture
+   - Example: If User Memory has "User prefers TypeScript", don't add "User is using TypeScript" to session memory
+
+2. **Output only changes (CRITICAL)**:
+   - Only output facts that need to be added or updated
+   - DO NOT output facts that already exist and don't need changes
+   - Each label in newFacts must be unique
+   - When a label already exists in session memory:
+     - Include it in newFacts ONLY if conversation provides new information to update it
+     - Omit it from newFacts if it doesn't need changes
+
+3. **What to extract** (Session context, NOT project documentation):
+   - **Current tasks and goals**: What the user is trying to accomplish in this session
+   - **Important decisions**: Key choices made and WHY (not just WHAT was chosen)
+   - **Session-specific constraints**: Temporary requirements or limitations for this work
+   - **Blockers and context**: Issues encountered and relevant background
+   - **Session-specific user preferences**: Only if different from User Memory for this session
+
+4. **What NOT to extract** (Can be inferred from code or documentation):
+   - ❌ Tech stack details (e.g., "Project uses React") - obvious from package.json
+   - ❌ Code structure facts (e.g., "Code is in /src") - can be seen directly
+   - ❌ Implementation details (e.g., "Function X does Y") - visible in code
+   - ❌ Architecture documentation - should be in actual docs, not memory
+   - ❌ Generic project facts that don't help with current work
+
+5. **When to output a fact in newFacts**:
+   - **New fact**: Learning something new about current work context not in existing session memory
+   - **Updated fact**: New information about current tasks or decisions
+   - **DO NOT output**: Facts already in session memory, facts covered by User Memory, or obvious code facts
+   - Example: Extract "User is fixing the memory duplication bug to optimize token usage" ✓
+   - Example: Don't extract "Project uses TypeScript" ❌ (obvious from code)
+
+6. **Remove outdated facts** by including their labels in removeFacts:
+   - Facts that are no longer relevant to current session
+   - Facts that have been superseded by new information
+
+7. **Label naming conventions**:
+   - Use short, descriptive, kebab-case labels
+   - Focus on: "task-*" (current tasks), "decision-*" (key decisions), "ctx-*" (context), "blocker-*" (blockers)
+   - Examples: "task-fix-memory-bug", "decision-use-incremental-updates", "ctx-working-on-compact-module", "blocker-type-error"
+
+8. **Fact content guidelines**:
+   - Write concise, actionable facts (1-2 sentences max)
+   - Focus on WHY and WHAT (goals, decisions, context), not HOW (implementation details)
+   - Information should help continue the work, not document the codebase
+
+9. **Extraction criteria**:
+   - Only extract if there's clear, explicit information in the conversation
+   - The information should be useful for continuing the current work
+   - Don't make assumptions or infer beyond what's stated
+   - When in doubt about whether something changed, don't output it
+
+Output only the new or updated facts in newFacts, and any labels to remove in removeFacts.`;
+var AISessionMemoryExtractor = class extends require_ai_agent.AIAgent {
+	constructor(options) {
+		super({
+			name: "SessionMemoryExtractor",
+			description: "Extracts and maintains session memory facts from conversations",
+			inputSchema: zod.z.object({
+				existingUserFacts: (0, zod.optional)(zod.z.array(zod.z.object({
+					label: zod.z.string(),
+					fact: zod.z.string(),
+					confidence: (0, zod.optional)(zod.z.number()),
+					tags: (0, zod.optional)(zod.z.array(zod.z.string()))
+				})).describe("User memory facts (long-term, cross-session) to avoid duplication")),
+				existingFacts: (0, zod.optional)(zod.z.array(zod.z.object({
+					label: zod.z.string(),
+					fact: zod.z.string(),
+					confidence: (0, zod.optional)(zod.z.number()),
+					tags: (0, zod.optional)(zod.z.array(zod.z.string()))
+				})).describe("Existing session memory facts for context and deduplication")),
+				messages: zod.z.array(zod.z.any()).describe("Recent conversation messages")
+			}),
+			outputSchema: zod.z.object({
+				newFacts: zod.z.array(zod.z.object({
+					label: zod.z.string().describe("Short, semantic label for the fact"),
+					fact: zod.z.string().describe("The fact content"),
+					confidence: (0, zod.optional)(zod.z.number().min(0).max(1).describe("Confidence score (0-1)")),
+					tags: (0, zod.optional)(zod.z.array(zod.z.string()).describe("Classification tags"))
+				})).describe("Facts to add or update in session memory. Only include facts that are new or need updates. Do not include unchanged facts."),
+				removeFacts: (0, zod.optional)(zod.z.array(zod.z.string()).describe("Labels of facts to remove from memory"))
+			}),
+			instructions: EXTRACTOR_INSTRUCTIONS,
+			taskRenderMode: "hide",
+			...require_utils_type_utils.omitBy(options ?? {}, (v) => require_utils_type_utils.isNil(v)),
+			session: { mode: "disabled" }
+		});
+	}
+};
+
+//#endregion
+exports.AISessionMemoryExtractor = AISessionMemoryExtractor;

package/dist/prompt/compact/session-memory-extractor.mjs

@@ -0,0 +1,137 @@
+import { isNil, omitBy } from "../../utils/type-utils.mjs";
+import { AIAgent } from "../../agents/ai-agent.mjs";
+import { optional, z as z$1 } from "zod";
+
+//#region src/prompt/compact/session-memory-extractor.ts
+const EXTRACTOR_INSTRUCTIONS = `\
+You are a session memory fact extractor. Your task is to extract facts that help continue THIS SESSION's work.
+
+**Key Principle**: Extract WORK CONTEXT (tasks, decisions, blockers), NOT PROJECT DOCUMENTATION (tech stack, code structure, implementation details).
+
+Session memory is for remembering:
+- What we're trying to accomplish
+- Why we made certain choices
+- What problems we encountered
+- Important context for continuing the work
+
+Session memory is NOT for documenting:
+- What the code does (visible in code)
+- How the project is structured (can explore directly)
+- What technologies are used (obvious from files)
+
+## User Memory Facts (Long-term, cross-session)
+
+\`\`\`yaml alt="user-memory-facts"
+{{ existingUserFacts | yaml.stringify }}
+\`\`\`
+
+## Existing Session Memory Facts
+
+\`\`\`yaml alt="existing-facts"
+{{ existingFacts | yaml.stringify }}
+\`\`\`
+
+## Recent Conversation
+
+\`\`\`yaml alt="recent-messages"
+{{ messages | yaml.stringify }}
+\`\`\`
+
+## Guidelines
+
+1. **Avoid duplicating User Memory (CRITICAL)**:
+   - User Memory contains long-term, cross-session facts about the user
+   - DO NOT extract facts that are already covered in User Memory
+   - Focus on session-specific information that User Memory doesn't capture
+   - Example: If User Memory has "User prefers TypeScript", don't add "User is using TypeScript" to session memory
+
+2. **Output only changes (CRITICAL)**:
+   - Only output facts that need to be added or updated
+   - DO NOT output facts that already exist and don't need changes
+   - Each label in newFacts must be unique
+   - When a label already exists in session memory:
+     - Include it in newFacts ONLY if conversation provides new information to update it
+     - Omit it from newFacts if it doesn't need changes
+
+3. **What to extract** (Session context, NOT project documentation):
+   - **Current tasks and goals**: What the user is trying to accomplish in this session
+   - **Important decisions**: Key choices made and WHY (not just WHAT was chosen)
+   - **Session-specific constraints**: Temporary requirements or limitations for this work
+   - **Blockers and context**: Issues encountered and relevant background
+   - **Session-specific user preferences**: Only if different from User Memory for this session
+
+4. **What NOT to extract** (Can be inferred from code or documentation):
+   - ❌ Tech stack details (e.g., "Project uses React") - obvious from package.json
+   - ❌ Code structure facts (e.g., "Code is in /src") - can be seen directly
+   - ❌ Implementation details (e.g., "Function X does Y") - visible in code
+   - ❌ Architecture documentation - should be in actual docs, not memory
+   - ❌ Generic project facts that don't help with current work
+
+5. **When to output a fact in newFacts**:
+   - **New fact**: Learning something new about current work context not in existing session memory
+   - **Updated fact**: New information about current tasks or decisions
+   - **DO NOT output**: Facts already in session memory, facts covered by User Memory, or obvious code facts
+   - Example: Extract "User is fixing the memory duplication bug to optimize token usage" ✓
+   - Example: Don't extract "Project uses TypeScript" ❌ (obvious from code)
+
+6. **Remove outdated facts** by including their labels in removeFacts:
+   - Facts that are no longer relevant to current session
+   - Facts that have been superseded by new information
+
+7. **Label naming conventions**:
+   - Use short, descriptive, kebab-case labels
+   - Focus on: "task-*" (current tasks), "decision-*" (key decisions), "ctx-*" (context), "blocker-*" (blockers)
+   - Examples: "task-fix-memory-bug", "decision-use-incremental-updates", "ctx-working-on-compact-module", "blocker-type-error"
+
+8. **Fact content guidelines**:
+   - Write concise, actionable facts (1-2 sentences max)
+   - Focus on WHY and WHAT (goals, decisions, context), not HOW (implementation details)
+   - Information should help continue the work, not document the codebase
+
+9. **Extraction criteria**:
+   - Only extract if there's clear, explicit information in the conversation
+   - The information should be useful for continuing the current work
+   - Don't make assumptions or infer beyond what's stated
+   - When in doubt about whether something changed, don't output it
+
+Output only the new or updated facts in newFacts, and any labels to remove in removeFacts.`;
+var AISessionMemoryExtractor = class extends AIAgent {
+	constructor(options) {
+		super({
+			name: "SessionMemoryExtractor",
+			description: "Extracts and maintains session memory facts from conversations",
+			inputSchema: z$1.object({
+				existingUserFacts: optional(z$1.array(z$1.object({
+					label: z$1.string(),
+					fact: z$1.string(),
+					confidence: optional(z$1.number()),
+					tags: optional(z$1.array(z$1.string()))
+				})).describe("User memory facts (long-term, cross-session) to avoid duplication")),
+				existingFacts: optional(z$1.array(z$1.object({
+					label: z$1.string(),
+					fact: z$1.string(),
+					confidence: optional(z$1.number()),
+					tags: optional(z$1.array(z$1.string()))
+				})).describe("Existing session memory facts for context and deduplication")),
+				messages: z$1.array(z$1.any()).describe("Recent conversation messages")
+			}),
+			outputSchema: z$1.object({
+				newFacts: z$1.array(z$1.object({
+					label: z$1.string().describe("Short, semantic label for the fact"),
+					fact: z$1.string().describe("The fact content"),
+					confidence: optional(z$1.number().min(0).max(1).describe("Confidence score (0-1)")),
+					tags: optional(z$1.array(z$1.string()).describe("Classification tags"))
+				})).describe("Facts to add or update in session memory. Only include facts that are new or need updates. Do not include unchanged facts."),
+				removeFacts: optional(z$1.array(z$1.string()).describe("Labels of facts to remove from memory"))
+			}),
+			instructions: EXTRACTOR_INSTRUCTIONS,
+			taskRenderMode: "hide",
+			...omitBy(options ?? {}, (v) => isNil(v)),
+			session: { mode: "disabled" }
+		});
+	}
+};
+
+//#endregion
+export { AISessionMemoryExtractor };
+//# sourceMappingURL=session-memory-extractor.mjs.map

package/dist/prompt/compact/session-memory-extractor.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-memory-extractor.mjs","names":["z"],"sources":["../../../src/prompt/compact/session-memory-extractor.ts"],"sourcesContent":["import { optional, z } from \"zod\";\nimport { AIAgent, type AIAgentOptions } from \"../../agents/ai-agent.js\";\nimport { isNil, omitBy } from \"../../utils/type-utils.js\";\nimport type { MemoryExtractorInput, MemoryExtractorOutput } from \"./types.js\";\n\nconst EXTRACTOR_INSTRUCTIONS = `\\\nYou are a session memory fact extractor. Your task is to extract facts that help continue THIS SESSION's work.\n\n**Key Principle**: Extract WORK CONTEXT (tasks, decisions, blockers), NOT PROJECT DOCUMENTATION (tech stack, code structure, implementation details).\n\nSession memory is for remembering:\n- What we're trying to accomplish\n- Why we made certain choices\n- What problems we encountered\n- Important context for continuing the work\n\nSession memory is NOT for documenting:\n- What the code does (visible in code)\n- How the project is structured (can explore directly)\n- What technologies are used (obvious from files)\n\n## User Memory Facts (Long-term, cross-session)\n\n${\"```\"}yaml alt=\"user-memory-facts\"\n{{ existingUserFacts | yaml.stringify }}\n${\"```\"}\n\n## Existing Session Memory Facts\n\n${\"```\"}yaml alt=\"existing-facts\"\n{{ existingFacts | yaml.stringify }}\n${\"```\"}\n\n## Recent Conversation\n\n${\"```\"}yaml alt=\"recent-messages\"\n{{ messages | yaml.stringify }}\n${\"```\"}\n\n## Guidelines\n\n1. **Avoid duplicating User Memory (CRITICAL)**:\n   - User Memory contains long-term, cross-session facts about the user\n   - DO NOT extract facts that are already covered in User Memory\n   - Focus on session-specific information that User Memory doesn't capture\n   - Example: If User Memory has \"User prefers TypeScript\", don't add \"User is using TypeScript\" to session memory\n\n2. **Output only changes (CRITICAL)**:\n   - Only output facts that need to be added or updated\n   - DO NOT output facts that already exist and don't need changes\n   - Each label in newFacts must be unique\n   - When a label already exists in session memory:\n     - Include it in newFacts ONLY if conversation provides new information to update it\n     - Omit it from newFacts if it doesn't need changes\n\n3. **What to extract** (Session context, NOT project documentation):\n   - **Current tasks and goals**: What the user is trying to accomplish in this session\n   - **Important decisions**: Key choices made and WHY (not just WHAT was chosen)\n   - **Session-specific constraints**: Temporary requirements or limitations for this work\n   - **Blockers and context**: Issues encountered and relevant background\n   - **Session-specific user preferences**: Only if different from User Memory for this session\n\n4. **What NOT to extract** (Can be inferred from code or documentation):\n   - ❌ Tech stack details (e.g., \"Project uses React\") - obvious from package.json\n   - ❌ Code structure facts (e.g., \"Code is in /src\") - can be seen directly\n   - ❌ Implementation details (e.g., \"Function X does Y\") - visible in code\n   - ❌ Architecture documentation - should be in actual docs, not memory\n   - ❌ Generic project facts that don't help with current work\n\n5. **When to output a fact in newFacts**:\n   - **New fact**: Learning something new about current work context not in existing session memory\n   - **Updated fact**: New information about current tasks or decisions\n   - **DO NOT output**: Facts already in session memory, facts covered by User Memory, or obvious code facts\n   - Example: Extract \"User is fixing the memory duplication bug to optimize token usage\" ✓\n   - Example: Don't extract \"Project uses TypeScript\" ❌ (obvious from code)\n\n6. **Remove outdated facts** by including their labels in removeFacts:\n   - Facts that are no longer relevant to current session\n   - Facts that have been superseded by new information\n\n7. **Label naming conventions**:\n   - Use short, descriptive, kebab-case labels\n   - Focus on: \"task-*\" (current tasks), \"decision-*\" (key decisions), \"ctx-*\" (context), \"blocker-*\" (blockers)\n   - Examples: \"task-fix-memory-bug\", \"decision-use-incremental-updates\", \"ctx-working-on-compact-module\", \"blocker-type-error\"\n\n8. **Fact content guidelines**:\n   - Write concise, actionable facts (1-2 sentences max)\n   - Focus on WHY and WHAT (goals, decisions, context), not HOW (implementation details)\n   - Information should help continue the work, not document the codebase\n\n9. **Extraction criteria**:\n   - Only extract if there's clear, explicit information in the conversation\n   - The information should be useful for continuing the current work\n   - Don't make assumptions or infer beyond what's stated\n   - When in doubt about whether something changed, don't output it\n\nOutput only the new or updated facts in newFacts, and any labels to remove in removeFacts.`;\n\nexport interface CreateSessionMemoryExtractorOptions\n  extends AIAgentOptions<MemoryExtractorInput, MemoryExtractorOutput> {}\n\nexport class AISessionMemoryExtractor extends AIAgent<MemoryExtractorInput, MemoryExtractorOutput> {\n  constructor(options?: CreateSessionMemoryExtractorOptions) {\n    super({\n      name: \"SessionMemoryExtractor\",\n      description: \"Extracts and maintains session memory facts from conversations\",\n      inputSchema: z.object({\n        existingUserFacts: optional(\n          z\n            .array(\n              z.object({\n                label: z.string(),\n                fact: z.string(),\n                confidence: optional(z.number()),\n                tags: optional(z.array(z.string())),\n              }),\n            )\n            .describe(\"User memory facts (long-term, cross-session) to avoid duplication\"),\n        ),\n        existingFacts: optional(\n          z\n            .array(\n              z.object({\n                label: z.string(),\n                fact: z.string(),\n                confidence: optional(z.number()),\n                tags: optional(z.array(z.string())),\n              }),\n            )\n            .describe(\"Existing session memory facts for context and deduplication\"),\n        ),\n        messages: z.array(z.any()).describe(\"Recent conversation messages\"),\n      }),\n      outputSchema: z.object({\n        newFacts: z\n          .array(\n            z.object({\n              label: z.string().describe(\"Short, semantic label for the fact\"),\n              fact: z.string().describe(\"The fact content\"),\n              confidence: optional(z.number().min(0).max(1).describe(\"Confidence score (0-1)\")),\n              tags: optional(z.array(z.string()).describe(\"Classification tags\")),\n            }),\n          )\n          .describe(\n            \"Facts to add or update in session memory. Only include facts that are new or need updates. Do not include unchanged facts.\",\n          ),\n        removeFacts: optional(\n          z.array(z.string()).describe(\"Labels of facts to remove from memory\"),\n        ),\n      }),\n      instructions: EXTRACTOR_INSTRUCTIONS,\n      taskRenderMode: \"hide\",\n      ...omitBy(options ?? {}, (v) => isNil(v)),\n      session: {\n        mode: \"disabled\",\n      },\n    });\n  }\n}\n"],"mappings":";;;;;AAKA,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAgG/B,IAAa,2BAAb,cAA8C,QAAqD;CACjG,YAAY,SAA+C;AACzD,QAAM;GACJ,MAAM;GACN,aAAa;GACb,aAAaA,IAAE,OAAO;IACpB,mBAAmB,SACjBA,IACG,MACCA,IAAE,OAAO;KACP,OAAOA,IAAE,QAAQ;KACjB,MAAMA,IAAE,QAAQ;KAChB,YAAY,SAASA,IAAE,QAAQ,CAAC;KAChC,MAAM,SAASA,IAAE,MAAMA,IAAE,QAAQ,CAAC,CAAC;KACpC,CAAC,CACH,CACA,SAAS,oEAAoE,CACjF;IACD,eAAe,SACbA,IACG,MACCA,IAAE,OAAO;KACP,OAAOA,IAAE,QAAQ;KACjB,MAAMA,IAAE,QAAQ;KAChB,YAAY,SAASA,IAAE,QAAQ,CAAC;KAChC,MAAM,SAASA,IAAE,MAAMA,IAAE,QAAQ,CAAC,CAAC;KACpC,CAAC,CACH,CACA,SAAS,8DAA8D,CAC3E;IACD,UAAUA,IAAE,MAAMA,IAAE,KAAK,CAAC,CAAC,SAAS,+BAA+B;IACpE,CAAC;GACF,cAAcA,IAAE,OAAO;IACrB,UAAUA,IACP,MACCA,IAAE,OAAO;KACP,OAAOA,IAAE,QAAQ,CAAC,SAAS,qCAAqC;KAChE,MAAMA,IAAE,QAAQ,CAAC,SAAS,mBAAmB;KAC7C,YAAY,SAASA,IAAE,QAAQ,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,SAAS,yBAAyB,CAAC;KACjF,MAAM,SAASA,IAAE,MAAMA,IAAE,QAAQ,CAAC,CAAC,SAAS,sBAAsB,CAAC;KACpE,CAAC,CACH,CACA,SACC,6HACD;IACH,aAAa,SACXA,IAAE,MAAMA,IAAE,QAAQ,CAAC,CAAC,SAAS,wCAAwC,CACtE;IACF,CAAC;GACF,cAAc;GACd,gBAAgB;GAChB,GAAG,OAAO,WAAW,EAAE,GAAG,MAAM,MAAM,EAAE,CAAC;GACzC,SAAS,EACP,MAAM,YACP;GACF,CAAC"}

package/dist/prompt/compact/types.cjs

@@ -0,0 +1,59 @@
+
+//#region src/prompt/compact/types.ts
+/**
+* Default session mode
+*/
+const DEFAULT_SESSION_MODE = "auto";
+/**
+* Default compaction mode
+*/
+const DEFAULT_COMPACT_MODE = "auto";
+/**
+* Default maximum tokens before triggering compaction
+*/
+const DEFAULT_MAX_TOKENS = 8e4;
+/**
+* Default ratio of maxTokens to reserve for keeping recent messages
+*/
+const DEFAULT_KEEP_RECENT_RATIO = .5;
+/**
+* Default async mode for compaction
+*/
+const DEFAULT_COMPACT_ASYNC = true;
+/**
+* Default ratio of maxTokens to allocate for user memory
+*/
+const DEFAULT_MEMORY_RATIO = .04;
+/**
+* Default query limit for loading memory facts
+*/
+const DEFAULT_MEMORY_QUERY_LIMIT = 200;
+/**
+* Default session memory mode
+*/
+const DEFAULT_SESSION_MEMORY_MODE = "auto";
+/**
+* Default async mode for session memory extraction
+*/
+const DEFAULT_SESSION_MEMORY_ASYNC = true;
+/**
+* Default user memory mode
+*/
+const DEFAULT_USER_MEMORY_MODE = "auto";
+/**
+* Default async mode for user memory consolidation
+*/
+const DEFAULT_USER_MEMORY_ASYNC = true;
+
+//#endregion
+exports.DEFAULT_COMPACT_ASYNC = DEFAULT_COMPACT_ASYNC;
+exports.DEFAULT_COMPACT_MODE = DEFAULT_COMPACT_MODE;
+exports.DEFAULT_KEEP_RECENT_RATIO = DEFAULT_KEEP_RECENT_RATIO;
+exports.DEFAULT_MAX_TOKENS = DEFAULT_MAX_TOKENS;
+exports.DEFAULT_MEMORY_QUERY_LIMIT = DEFAULT_MEMORY_QUERY_LIMIT;
+exports.DEFAULT_MEMORY_RATIO = DEFAULT_MEMORY_RATIO;
+exports.DEFAULT_SESSION_MEMORY_ASYNC = DEFAULT_SESSION_MEMORY_ASYNC;
+exports.DEFAULT_SESSION_MEMORY_MODE = DEFAULT_SESSION_MEMORY_MODE;
+exports.DEFAULT_SESSION_MODE = DEFAULT_SESSION_MODE;
+exports.DEFAULT_USER_MEMORY_ASYNC = DEFAULT_USER_MEMORY_ASYNC;
+exports.DEFAULT_USER_MEMORY_MODE = DEFAULT_USER_MEMORY_MODE;