@codeany/open-agent-sdk 0.2.2 → 0.2.4

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)
-}

package/src/utils/messages.ts

@@ -1,195 +0,0 @@
-/**
- * Message Utilities
- *
- * Message creation factories, normalization for API,
- * synthetic placeholders, and content processing.
- */
-
-import type { Message, UserMessage, AssistantMessage, TokenUsage } from '../types.js'
-
-/**
- * Create a user message.
- */
-export function createUserMessage(
-  content: string | any[],
-  options?: {
-    uuid?: string
-    isMeta?: boolean
-    toolUseResult?: unknown
-  },
-): UserMessage {
-  return {
-    type: 'user',
-    message: {
-      role: 'user',
-      content,
-    },
-    uuid: options?.uuid || crypto.randomUUID(),
-    timestamp: new Date().toISOString(),
-  }
-}
-
-/**
- * Create an assistant message.
- */
-export function createAssistantMessage(
-  content: any[],
-  usage?: TokenUsage,
-): AssistantMessage {
-  return {
-    type: 'assistant',
-    message: {
-      role: 'assistant',
-      content,
-    },
-    uuid: crypto.randomUUID(),
-    timestamp: new Date().toISOString(),
-    usage,
-  }
-}
-
-/**
- * Normalize messages for the LLM API.
- * Ensures proper message format, strips internal metadata,
- * and fixes tool result pairing.
- */
-export function normalizeMessagesForAPI(
-  messages: Array<{ role: string; content: any }>,
-): Array<{ role: string; content: any }> {
-  const normalized: Array<{ role: string; content: any }> = []
-
-  for (let i = 0; i < messages.length; i++) {
-    const msg = messages[i]
-
-    // Ensure alternating user/assistant messages
-    if (normalized.length > 0) {
-      const last = normalized[normalized.length - 1]
-      if (last.role === msg.role) {
-        // Merge same-role messages
-        if (msg.role === 'user') {
-          // Combine content
-          const lastContent = typeof last.content === 'string'
-            ? [{ type: 'text' as const, text: last.content }]
-            : last.content as any[]
-          const newContent = typeof msg.content === 'string'
-            ? [{ type: 'text' as const, text: msg.content }]
-            : msg.content as any[]
-          normalized[normalized.length - 1] = {
-            role: 'user',
-            content: [...lastContent, ...newContent],
-          }
-          continue
-        }
-      }
-    }
-
-    normalized.push({ ...msg })
-  }
-
-  // Ensure tool results are properly paired with tool_use
-  return fixToolResultPairing(normalized)
-}
-
-/**
- * Fix tool result pairing: ensure every tool_result has a
- * matching tool_use in the previous assistant message.
- */
-function fixToolResultPairing(
-  messages: Array<{ role: string; content: any }>,
-): Array<{ role: string; content: any }> {
-  const result: Array<{ role: string; content: any }> = []
-
-  for (let i = 0; i < messages.length; i++) {
-    const msg = messages[i]
-
-    if (msg.role === 'user' && Array.isArray(msg.content)) {
-      // Check for tool_result blocks
-      const toolResults = (msg.content as any[]).filter(
-        (block: any) => block.type === 'tool_result',
-      )
-
-      if (toolResults.length > 0 && result.length > 0) {
-        // Find the previous assistant message
-        const prevAssistant = result[result.length - 1]
-        if (prevAssistant.role === 'assistant' && Array.isArray(prevAssistant.content)) {
-          const toolUseIds = new Set(
-            (prevAssistant.content as any[])
-              .filter((b: any) => b.type === 'tool_use')
-              .map((b: any) => b.id),
-          )
-
-          // Filter out orphaned tool results
-          const validContent = (msg.content as any[]).filter((block: any) => {
-            if (block.type === 'tool_result') {
-              return toolUseIds.has(block.tool_use_id)
-            }
-            return true
-          })
-
-          if (validContent.length > 0) {
-            result.push({ ...msg, content: validContent })
-          }
-          continue
-        }
-      }
-    }
-
-    result.push(msg)
-  }
-
-  return result
-}
-
-/**
- * Strip images from messages (for compaction).
- */
-export function stripImagesFromMessages(
-  messages: Array<{ role: string; content: any }>,
-): Array<{ role: string; content: any }> {
-  return messages.map((msg) => {
-    if (typeof msg.content === 'string') return msg
-    if (!Array.isArray(msg.content)) return msg
-
-    const filtered = (msg.content as any[]).filter(
-      (block: any) => block.type !== 'image',
-    )
-
-    return {
-      ...msg,
-      content: filtered.length > 0 ? filtered : '[content removed]',
-    }
-  })
-}
-
-/**
- * Extract text from message content blocks.
- */
-export function extractTextFromContent(
-  content: any[] | string,
-): string {
-  if (typeof content === 'string') return content
-
-  return content
-    .filter((b: any) => b.type === 'text')
-    .map((b: any) => b.text)
-    .join('')
-}
-
-/**
- * Create a system message for compact boundary.
- */
-export function createCompactBoundaryMessage(): { role: string; content: string } {
-  return {
-    role: 'user',
-    content: '[Previous context has been summarized above. Continuing conversation.]',
-  }
-}
-
-/**
- * Truncate text to max length with ellipsis.
- */
-export function truncateText(text: string, maxLength: number): string {
-  if (text.length <= maxLength) return text
-  const half = Math.floor(maxLength / 2)
-  return text.slice(0, half) + '\n...(truncated)...\n' + text.slice(-half)
-}

package/src/utils/retry.ts

@@ -1,140 +0,0 @@
-/**
- * Retry Logic with Exponential Backoff
- *
- * Handles API retries for rate limits, overloaded servers,
- * and transient failures.
- */
-
-/**
- * Retry configuration.
- */
-export interface RetryConfig {
-  maxRetries: number
-  baseDelayMs: number
-  maxDelayMs: number
-  retryableStatusCodes: number[]
-}
-
-/**
- * Default retry configuration.
- */
-export const DEFAULT_RETRY_CONFIG: RetryConfig = {
-  maxRetries: 3,
-  baseDelayMs: 2000,
-  maxDelayMs: 30000,
-  retryableStatusCodes: [429, 500, 502, 503, 529],
-}
-
-/**
- * Check if an error is retryable.
- */
-export function isRetryableError(err: any, config: RetryConfig = DEFAULT_RETRY_CONFIG): boolean {
-  if (err?.status && config.retryableStatusCodes.includes(err.status)) {
-    return true
-  }
-
-  // Network errors
-  if (err?.code === 'ECONNRESET' || err?.code === 'ETIMEDOUT' || err?.code === 'ECONNREFUSED') {
-    return true
-  }
-
-  // API overloaded
-  if (err?.error?.type === 'overloaded_error') {
-    return true
-  }
-
-  return false
-}
-
-/**
- * Calculate delay for exponential backoff.
- */
-export function getRetryDelay(attempt: number, config: RetryConfig = DEFAULT_RETRY_CONFIG): number {
-  const delay = config.baseDelayMs * Math.pow(2, attempt)
-  // Add jitter (±25%)
-  const jitter = delay * 0.25 * (Math.random() * 2 - 1)
-  return Math.min(delay + jitter, config.maxDelayMs)
-}
-
-/**
- * Execute a function with retries.
- */
-export async function withRetry<T>(
-  fn: () => Promise<T>,
-  config: RetryConfig = DEFAULT_RETRY_CONFIG,
-  abortSignal?: AbortSignal,
-): Promise<T> {
-  let lastError: any
-
-  for (let attempt = 0; attempt <= config.maxRetries; attempt++) {
-    if (abortSignal?.aborted) {
-      throw new Error('Aborted')
-    }
-
-    try {
-      return await fn()
-    } catch (err: any) {
-      lastError = err
-
-      if (!isRetryableError(err, config)) {
-        throw err
-      }
-
-      if (attempt === config.maxRetries) {
-        throw err
-      }
-
-      // Wait before retry
-      const delay = getRetryDelay(attempt, config)
-      await new Promise((resolve) => setTimeout(resolve, delay))
-    }
-  }
-
-  throw lastError
-}
-
-/**
- * Check if an error is a "prompt too long" error.
- */
-export function isPromptTooLongError(err: any): boolean {
-  if (err?.status === 400) {
-    const message = err?.error?.error?.message || err?.message || ''
-    return message.includes('prompt is too long') ||
-      message.includes('max_tokens') ||
-      message.includes('context length')
-  }
-  return false
-}
-
-/**
- * Check if error is an auth error.
- */
-export function isAuthError(err: any): boolean {
-  return err?.status === 401 || err?.status === 403
-}
-
-/**
- * Check if error is a rate limit error.
- */
-export function isRateLimitError(err: any): boolean {
-  return err?.status === 429
-}
-
-/**
- * Format an API error for display.
- */
-export function formatApiError(err: any): string {
-  if (isAuthError(err)) {
-    return 'Authentication failed. Check your CODEANY_API_KEY.'
-  }
-  if (isRateLimitError(err)) {
-    return 'Rate limit exceeded. Please retry after a short wait.'
-  }
-  if (err?.status === 529) {
-    return 'API overloaded. Please retry later.'
-  }
-  if (isPromptTooLongError(err)) {
-    return 'Prompt too long. Auto-compacting conversation...'
-  }
-  return `API error: ${err.message || err}`
-}