@codeany/open-agent-sdk 0.2.1 → 0.2.3

package/src/utils/compact.ts

@@ -1,207 +0,0 @@
-/**
- * Context Compression / Auto-Compaction
- *
- * Summarizes long conversation histories when context window fills up.
- * Three-tier system:
- * 1. Auto-compact: triggered when tokens exceed threshold
- * 2. Micro-compact: cache-aware per-request optimization
- * 3. Session memory compaction: consolidates across sessions
- */
-
-import type { LLMProvider } from '../providers/types.js'
-import type { NormalizedMessageParam } from '../providers/types.js'
-import {
-  estimateMessagesTokens,
-  getAutoCompactThreshold,
-} from './tokens.js'
-
-/**
- * State for tracking auto-compaction across turns.
- */
-export interface AutoCompactState {
-  compacted: boolean
-  turnCounter: number
-  consecutiveFailures: number
-}
-
-/**
- * Create initial auto-compact state.
- */
-export function createAutoCompactState(): AutoCompactState {
-  return {
-    compacted: false,
-    turnCounter: 0,
-    consecutiveFailures: 0,
-  }
-}
-
-/**
- * Check if auto-compaction should trigger.
- */
-export function shouldAutoCompact(
-  messages: any[],
-  model: string,
-  state: AutoCompactState,
-): boolean {
-  if (state.consecutiveFailures >= 3) return false
-
-  const estimatedTokens = estimateMessagesTokens(messages)
-  const threshold = getAutoCompactThreshold(model)
-
-  return estimatedTokens >= threshold
-}
-
-/**
- * Compact conversation by summarizing with the LLM.
- *
- * Sends the entire conversation to the LLM for summarization,
- * then replaces the history with a compact summary.
- */
-export async function compactConversation(
-  provider: LLMProvider,
-  model: string,
-  messages: any[],
-  state: AutoCompactState,
-): Promise<{
-  compactedMessages: NormalizedMessageParam[]
-  summary: string
-  state: AutoCompactState
-}> {
-  try {
-    // Strip images before compacting to save tokens
-    const strippedMessages = stripImagesFromMessages(messages)
-
-    // Build compaction prompt
-    const compactionPrompt = buildCompactionPrompt(strippedMessages)
-
-    const response = await provider.createMessage({
-      model,
-      maxTokens: 8192,
-      system: 'You are a conversation summarizer. Create a detailed summary of the conversation that preserves all important context, decisions made, files modified, tool outputs, and current state. The summary should allow the conversation to continue seamlessly.',
-      messages: [
-        {
-          role: 'user',
-          content: compactionPrompt,
-        },
-      ],
-    })
-
-    const summary = response.content
-      .filter((b) => b.type === 'text')
-      .map((b) => (b as { type: 'text'; text: string }).text)
-      .join('\n')
-
-    // Replace messages with summary
-    const compactedMessages: NormalizedMessageParam[] = [
-      {
-        role: 'user',
-        content: `[Previous conversation summary]\n\n${summary}\n\n[End of summary - conversation continues below]`,
-      },
-      {
-        role: 'assistant',
-        content: 'I understand the context from the previous conversation. I\'ll continue from where we left off.',
-      },
-    ]
-
-    return {
-      compactedMessages,
-      summary,
-      state: {
-        compacted: true,
-        turnCounter: state.turnCounter,
-        consecutiveFailures: 0,
-      },
-    }
-  } catch (err: any) {
-    return {
-      compactedMessages: messages,
-      summary: '',
-      state: {
-        ...state,
-        consecutiveFailures: state.consecutiveFailures + 1,
-      },
-    }
-  }
-}
-
-/**
- * Strip images from messages for compaction safety.
- */
-function stripImagesFromMessages(
-  messages: any[],
-): any[] {
-  return messages.map((msg: any) => {
-    if (typeof msg.content === 'string') return msg
-
-    const filtered = (msg.content as any[]).filter((block: any) => {
-      return block.type !== 'image'
-    })
-
-    return { ...msg, content: filtered.length > 0 ? filtered : '[content removed for compaction]' }
-  })
-}
-
-/**
- * Build compaction prompt from messages.
- */
-function buildCompactionPrompt(messages: any[]): string {
-  const parts: string[] = ['Please summarize this conversation:\n']
-
-  for (const msg of messages) {
-    const role = msg.role === 'user' ? 'User' : 'Assistant'
-
-    if (typeof msg.content === 'string') {
-      parts.push(`${role}: ${msg.content.slice(0, 5000)}`)
-    } else if (Array.isArray(msg.content)) {
-      const texts: string[] = []
-      for (const block of msg.content as any[]) {
-        if (block.type === 'text') {
-          texts.push(block.text.slice(0, 3000))
-        } else if (block.type === 'tool_use') {
-          texts.push(`[Tool: ${block.name}]`)
-        } else if (block.type === 'tool_result') {
-          const content = typeof block.content === 'string'
-            ? block.content.slice(0, 1000)
-            : '[tool result]'
-          texts.push(`[Tool Result: ${content}]`)
-        }
-      }
-      if (texts.length > 0) {
-        parts.push(`${role}: ${texts.join('\n')}`)
-      }
-    }
-  }
-
-  return parts.join('\n\n')
-}
-
-/**
- * Micro-compact: optimize messages by truncating large tool results
- * to fit within token budgets.
- */
-export function microCompactMessages(
-  messages: any[],
-  maxToolResultChars: number = 50000,
-): any[] {
-  return messages.map((msg: any) => {
-    if (typeof msg.content === 'string') return msg
-    if (!Array.isArray(msg.content)) return msg
-
-    const content = (msg.content as any[]).map((block: any) => {
-      if (block.type === 'tool_result' && typeof block.content === 'string') {
-        if (block.content.length > maxToolResultChars) {
-          return {
-            ...block,
-            content:
-              block.content.slice(0, maxToolResultChars / 2) +
-              '\n...(truncated)...\n' +
-              block.content.slice(-maxToolResultChars / 2),
-          }
-        }
-      }
-      return block
-    })
-
-    return { ...msg, content }
-  })
-}

package/src/utils/context.ts

@@ -1,191 +0,0 @@
-/**
- * System & User Context
- *
- * Builds context for the system prompt:
- * - Git status injection (branch, commits, status)
- * - AGENT.md / project context discovery and injection
- * - Working directory info
- * - Date injection
- */
-
-import { execSync } from 'child_process'
-import { readFile, stat } from 'fs/promises'
-import { join, resolve } from 'path'
-
-// Memoization cache
-let cachedGitStatus: string | null = null
-let cachedGitStatusCwd: string | null = null
-
-/**
- * Get git status info for system prompt.
- * Memoized per cwd (cleared on new session).
- */
-export async function getGitStatus(cwd: string): Promise<string> {
-  if (cachedGitStatus && cachedGitStatusCwd === cwd) {
-    return cachedGitStatus
-  }
-
-  try {
-    const parts: string[] = []
-
-    const gitExec = (cmd: string, timeoutMs = 5000): string | null => {
-      try {
-        return execSync(cmd, {
-          cwd, timeout: timeoutMs, encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'],
-        }).trim()
-      } catch {
-        return null
-      }
-    }
-
-    // Check if this is a git repo at all
-    if (!gitExec('git rev-parse --git-dir')) return ''
-
-    // Current branch
-    const branch = gitExec('git rev-parse --abbrev-ref HEAD')
-    if (branch) parts.push(`Current branch: ${branch}`)
-
-    // Main branch detection
-    const mainBranch = detectMainBranch(cwd)
-    if (mainBranch) parts.push(`Main branch: ${mainBranch}`)
-
-    // Git user
-    const user = gitExec('git config user.name', 3000)
-    if (user) parts.push(`Git user: ${user}`)
-
-    // Status (staged + unstaged)
-    const status = gitExec('git status --short')
-    if (status) {
-      const truncated = status.length > 2000
-        ? status.slice(0, 2000) + '\n...(truncated)'
-        : status
-      parts.push(`Status:\n${truncated}`)
-    }
-
-    // Recent commits (only if HEAD exists)
-    const hasHead = gitExec('git rev-parse HEAD')
-    if (hasHead) {
-      const log = gitExec('git log --oneline -5 --no-decorate')
-      if (log) parts.push(`Recent commits:\n${log}`)
-    }
-
-    cachedGitStatus = parts.join('\n\n')
-    cachedGitStatusCwd = cwd
-
-    return cachedGitStatus
-  } catch {
-    return ''
-  }
-}
-
-/**
- * Detect the main branch name (main or master).
- */
-function detectMainBranch(cwd: string): string | null {
-  try {
-    const branches = execSync('git branch -l main master', {
-      cwd, timeout: 3000, encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'],
-    }).trim()
-    if (branches.includes('main')) return 'main'
-    if (branches.includes('master')) return 'master'
-    return null
-  } catch {
-    return null
-  }
-}
-
-/**
- * Discover project context files (AGENT.md, CLAUDE.md) in the project.
- */
-export async function discoverProjectContextFiles(cwd: string): Promise<string[]> {
-  const candidates = [
-    join(cwd, 'AGENT.md'),
-    join(cwd, 'CLAUDE.md'),
-    join(cwd, '.claude', 'CLAUDE.md'),
-    join(cwd, 'claude.md'),
-  ]
-
-  // Also check home directory
-  const home = process.env.HOME || process.env.USERPROFILE || ''
-  if (home) {
-    candidates.push(
-      join(home, '.claude', 'CLAUDE.md'),
-    )
-  }
-
-  const found: string[] = []
-  for (const path of candidates) {
-    try {
-      const s = await stat(path)
-      if (s.isFile()) {
-        found.push(path)
-      }
-    } catch {
-      // File doesn't exist
-    }
-  }
-
-  return found
-}
-
-/**
- * Read project context file content from discovered files.
- */
-export async function readProjectContextContent(cwd: string): Promise<string> {
-  const files = await discoverProjectContextFiles(cwd)
-  if (files.length === 0) return ''
-
-  const parts: string[] = []
-  for (const file of files) {
-    try {
-      const content = await readFile(file, 'utf-8')
-      if (content.trim()) {
-        parts.push(`# From ${file}:\n${content.trim()}`)
-      }
-    } catch {
-      // Skip unreadable files
-    }
-  }
-
-  return parts.join('\n\n')
-}
-
-/**
- * Get system context for the system prompt.
- */
-export async function getSystemContext(cwd: string): Promise<string> {
-  const parts: string[] = []
-
-  const gitStatus = await getGitStatus(cwd)
-  if (gitStatus) {
-    parts.push(`gitStatus: ${gitStatus}`)
-  }
-
-  return parts.join('\n\n')
-}
-
-/**
- * Get user context (AGENT.md, date, etc).
- */
-export async function getUserContext(cwd: string): Promise<string> {
-  const parts: string[] = []
-
-  // Current date
-  parts.push(`# currentDate\nToday's date is ${new Date().toISOString().split('T')[0]}.`)
-
-  // Project context files
-  const projectCtx = await readProjectContextContent(cwd)
-  if (projectCtx) {
-    parts.push(projectCtx)
-  }
-
-  return parts.join('\n\n')
-}
-
-/**
- * Clear memoized context (call between sessions).
- */
-export function clearContextCache(): void {
-  cachedGitStatus = null
-  cachedGitStatusCwd = null
-}

package/src/utils/fileCache.ts

@@ -1,148 +0,0 @@
-/**
- * File State LRU Cache
- *
- * Bounded cache for file contents with path normalization.
- * Used to track file states for compaction diffs and
- * avoiding redundant reads.
- */
-
-import { normalize, resolve } from 'path'
-
-/**
- * Cached file state.
- */
-export interface FileState {
-  content: string
-  timestamp: number
-  offset?: number
-  limit?: number
-  isPartialView?: boolean
-}
-
-/**
- * LRU file state cache with size limits.
- */
-export class FileStateCache {
-  private cache = new Map<string, FileState>()
-  private maxEntries: number
-  private maxSizeBytes: number
-  private currentSizeBytes = 0
-
-  constructor(maxEntries: number = 100, maxSizeBytes: number = 25 * 1024 * 1024) {
-    this.maxEntries = maxEntries
-    this.maxSizeBytes = maxSizeBytes
-  }
-
-  /**
-   * Normalize a file path for cache lookup.
-   */
-  private normalizePath(filePath: string): string {
-    return normalize(resolve(filePath))
-  }
-
-  /**
-   * Get a cached file state.
-   */
-  get(filePath: string): FileState | undefined {
-    const key = this.normalizePath(filePath)
-    const entry = this.cache.get(key)
-    if (entry) {
-      // Move to end (most recently used)
-      this.cache.delete(key)
-      this.cache.set(key, entry)
-    }
-    return entry
-  }
-
-  /**
-   * Set a cached file state.
-   */
-  set(filePath: string, state: FileState): void {
-    const key = this.normalizePath(filePath)
-
-    // Remove old entry if exists
-    const old = this.cache.get(key)
-    if (old) {
-      this.currentSizeBytes -= Buffer.byteLength(old.content, 'utf-8')
-      this.cache.delete(key)
-    }
-
-    const newSize = Buffer.byteLength(state.content, 'utf-8')
-
-    // Evict entries if necessary
-    while (
-      (this.cache.size >= this.maxEntries || this.currentSizeBytes + newSize > this.maxSizeBytes) &&
-      this.cache.size > 0
-    ) {
-      const firstKey = this.cache.keys().next().value
-      if (firstKey) {
-        const entry = this.cache.get(firstKey)
-        if (entry) {
-          this.currentSizeBytes -= Buffer.byteLength(entry.content, 'utf-8')
-        }
-        this.cache.delete(firstKey)
-      }
-    }
-
-    this.cache.set(key, state)
-    this.currentSizeBytes += newSize
-  }
-
-  /**
-   * Delete a cached entry.
-   */
-  delete(filePath: string): boolean {
-    const key = this.normalizePath(filePath)
-    const entry = this.cache.get(key)
-    if (entry) {
-      this.currentSizeBytes -= Buffer.byteLength(entry.content, 'utf-8')
-      this.cache.delete(key)
-      return true
-    }
-    return false
-  }
-
-  /**
-   * Clear all cached entries.
-   */
-  clear(): void {
-    this.cache.clear()
-    this.currentSizeBytes = 0
-  }
-
-  /**
-   * Get the number of cached entries.
-   */
-  get size(): number {
-    return this.cache.size
-  }
-
-  /**
-   * Get all cached file paths.
-   */
-  keys(): string[] {
-    return Array.from(this.cache.keys())
-  }
-
-  /**
-   * Clone the cache.
-   */
-  clone(): FileStateCache {
-    const clone = new FileStateCache(this.maxEntries, this.maxSizeBytes)
-    for (const [key, value] of this.cache) {
-      clone.cache.set(key, { ...value })
-    }
-    clone.currentSizeBytes = this.currentSizeBytes
-    return clone
-  }
-}
-
-/**
- * Create a file state cache with default limits.
- */
-export function createFileStateCache(
-  maxEntries: number = 100,
-  maxSizeBytes: number = 25 * 1024 * 1024,
-): FileStateCache {
-  return new FileStateCache(maxEntries, maxSizeBytes)
-}