@alumbwe/anvil 1.0.0 → 1.0.1

package/src/utils/path-completion.ts

@@ -1,111 +0,0 @@
-import { existsSync, readdirSync, statSync } from 'fs'
-import os from 'os'
-import path from 'path'
-
-/**
- * Get path completions for tab completion.
- * Returns the completed path or null if no completion available.
- *
- * Behavior:
- * - Empty input returns null
- * - Expands ~ to home directory
- * - Single match: returns completed path with trailing slash
- * - Multiple matches: returns common prefix (no trailing slash)
- * - No matches: returns null
- * - Hidden directories are skipped unless user typed a dot
- */
-export function getPathCompletion(inputPath: string): string | null {
-  if (!inputPath) return null
-
-  // Expand ~ to home directory
-  let expandedPath = inputPath
-  const homeDir = os.homedir()
-  if (expandedPath.startsWith('~')) {
-    expandedPath = path.join(homeDir, expandedPath.slice(1))
-  }
-
-  // If the path ends with /, we're completing inside that directory
-  // Otherwise, we're completing the last component
-  let parentDir: string
-  let partial: string
-
-  if (expandedPath.endsWith(path.sep)) {
-    parentDir = expandedPath
-    partial = ''
-  } else {
-    parentDir = path.dirname(expandedPath)
-    partial = path.basename(expandedPath).toLowerCase()
-  }
-
-  // Check if parent directory exists
-  try {
-    if (!existsSync(parentDir) || !statSync(parentDir).isDirectory()) {
-      return null
-    }
-  } catch {
-    return null
-  }
-
-  // List directories in parent that match the partial
-  try {
-    const items = readdirSync(parentDir)
-    const matches: string[] = []
-
-    for (const item of items) {
-      // Skip hidden files unless user typed a dot
-      if (item.startsWith('.') && !partial.startsWith('.')) continue
-
-      const fullPath = path.join(parentDir, item)
-      try {
-        if (!statSync(fullPath).isDirectory()) continue
-      } catch {
-        continue
-      }
-
-      if (item.toLowerCase().startsWith(partial)) {
-        matches.push(item)
-      }
-    }
-
-    if (matches.length === 0) return null
-
-    // If exactly one match, complete to it with trailing slash
-    if (matches.length === 1) {
-      let completed = path.join(parentDir, matches[0]) + path.sep
-      // Convert back to ~ format if it was originally using ~
-      if (inputPath.startsWith('~') && completed.startsWith(homeDir)) {
-        completed = '~' + completed.slice(homeDir.length)
-      }
-      return completed
-    }
-
-    // Multiple matches - find common prefix
-    const sortedMatches = matches.sort()
-    const first = sortedMatches[0].toLowerCase()
-    const last = sortedMatches[sortedMatches.length - 1].toLowerCase()
-    let commonLength = partial.length
-
-    while (
-      commonLength < first.length &&
-      first[commonLength] === last[commonLength]
-    ) {
-      commonLength++
-    }
-
-    // If we can extend beyond what's already typed
-    if (commonLength > partial.length) {
-      // Use the case from the first match
-      const commonPrefix = sortedMatches[0].slice(0, commonLength)
-      let completed = path.join(parentDir, commonPrefix)
-      // Convert back to ~ format if it was originally using ~
-      if (inputPath.startsWith('~') && completed.startsWith(homeDir)) {
-        completed = '~' + completed.slice(homeDir.length)
-      }
-      return completed
-    }
-
-    return null
-  } catch {
-    return null
-  }
-}

package/src/utils/path-helpers.ts

@@ -1,38 +0,0 @@
-import os from 'os'
-import path from 'path'
-
-import { getCliEnv } from './env'
-import { getProjectRoot } from '../project-files'
-
-import type { CliEnv } from '../types/env'
-
-/**
- * Format a path for display, replacing home directory with ~
- * @param cwd - The path to format
- * @param env - Optional environment object (defaults to CLI env)
- */
-export function formatCwd(cwd: string | undefined, env?: CliEnv): string {
-  if (!cwd) return ''
-  const resolvedEnv = env ?? getCliEnv()
-  const homeDir = resolvedEnv.HOME || resolvedEnv.USERPROFILE || os.homedir()
-  if (homeDir && cwd.startsWith(homeDir)) {
-    return '~' + cwd.slice(homeDir.length)
-  }
-  return cwd
-}
-
-/**
- * Get relative path from the project root
- * e.g., "/Users/foo/project/src/utils/helper.ts" -> "src/utils/helper.ts"
- * If already relative or project root unavailable, returns the path as-is
- */
-export function getRelativePath(filePath: string): string {
-  // If it's already a relative path, return as-is
-  if (!filePath.startsWith('/')) return filePath
-
-  const projectRoot = getProjectRoot()
-  if (!projectRoot) return filePath
-
-  // Use Node's path.relative for proper relative path calculation
-  return path.relative(projectRoot, filePath)
-}

package/src/utils/pending-attachments.ts

@@ -1,360 +0,0 @@
-import { existsSync, readdirSync, readFileSync, statSync } from 'node:fs'
-import path from 'node:path'
-
-import { processImageFile, resolveFilePath, isImageFile } from './image-handler'
-import { useChatStore } from '../state/chat-store'
-import type { PendingAttachment } from '../types/store'
-
-/**
- * Exit image input mode if currently active.
- * Called after successfully adding an image via paste or path.
- */
-function exitImageModeIfActive(): void {
-  if (useChatStore.getState().inputMode === 'image') {
-    useChatStore.getState().setInputMode('default')
-  }
-}
-
-/**
- * Process an image file and add it to the pending images state.
- * This handles compression/resizing and caches the result so we don't
- * need to reprocess at send time.
- * 
- * @param replacePlaceholder - If provided, replaces an existing placeholder entry instead of adding new
- */
-export async function addPendingImageFromFile(
-  imagePath: string,
-  cwd: string,
-  replacePlaceholder?: string,
-): Promise<void> {
-  const filename = path.basename(imagePath)
-  
-  if (replacePlaceholder) {
-    // Replace existing placeholder with actual image info (still processing)
-    useChatStore.setState((state) => ({
-      pendingAttachments: state.pendingAttachments.map((att) =>
-        att.kind === 'image' && att.path === replacePlaceholder
-          ? { ...att, path: imagePath, filename }
-          : att
-      ),
-    }))
-  } else {
-    // Add to pending state immediately with processing status so user sees loading state
-    useChatStore.getState().addPendingImage({
-      path: imagePath,
-      filename,
-      status: 'processing',
-    })
-  }
-
-  // Process the image in background
-  const result = await processImageFile(imagePath, cwd)
-
-  // Update the pending image with processed data
-  useChatStore.setState((state) => ({
-    pendingAttachments: state.pendingAttachments.map((att) => {
-      if (att.kind !== 'image' || att.path !== imagePath) return att
-
-      if (result.success && result.imagePart) {
-        return {
-          ...att,
-          status: 'ready' as const,
-          size: result.imagePart.size,
-          width: result.imagePart.width,
-          height: result.imagePart.height,
-          note: result.wasCompressed ? 'compressed' : undefined,
-          processedImage: {
-            base64: result.imagePart.image,
-            mediaType: result.imagePart.mediaType,
-          },
-        }
-      }
-
-      return {
-        ...att,
-        status: 'error' as const,
-        note: result.error || 'failed',
-      }
-    }),
-  }))
-
-  // Exit image mode after successfully processing an image
-  if (result.success) {
-    exitImageModeIfActive()
-  }
-}
-
-/**
- * Process an image from base64 data and add it to the pending images state.
- */
-export async function addPendingImageFromBase64(
-  base64Data: string,
-  mediaType: string,
-  filename: string,
-  tempPath?: string,
-): Promise<void> {
-  // For base64 images (like clipboard), we already have the data
-  // Check size and add directly
-  const size = Math.round((base64Data.length * 3) / 4) // Approximate decoded size
-  
-  useChatStore.getState().addPendingImage({
-    path: tempPath || `clipboard:${filename}`,
-    filename,
-    status: 'ready',
-    size,
-    processedImage: {
-      base64: base64Data,
-      mediaType,
-    },
-  })
-}
-
-const AUTO_REMOVE_ERROR_DELAY_MS = 3000
-
-// Counter for generating unique placeholder IDs
-let clipboardPlaceholderCounter = 0
-
-// Map to store cleanup timers for error images, keyed by image path
-// This allows clearing the timer if the image is removed before the delay expires
-const errorImageTimers = new Map<string, ReturnType<typeof setTimeout>>()
-
-/**
- * Add a placeholder for a clipboard image immediately and return its path.
- * Use with addPendingImageFromFile's replacePlaceholder parameter.
- */
-export function addClipboardPlaceholder(): string {
-  const placeholderPath = `clipboard:pending-${++clipboardPlaceholderCounter}`
-  useChatStore.getState().addPendingImage({
-    path: placeholderPath,
-    filename: 'clipboard image',
-    status: 'processing',
-  })
-  return placeholderPath
-}
-
-/**
- * Add a pending image with an error note (e.g., unsupported format, not found).
- * Used when we want to show the image in the banner with an error state.
- * Error images are automatically removed after a short delay.
- * 
- * Error images are automatically removed after AUTO_REMOVE_ERROR_DELAY_MS.
- */
-export function addPendingImageWithError(
-  imagePath: string,
-  note: string,
-): void {
-  const filename = path.basename(imagePath)
-  useChatStore.getState().addPendingImage({
-    path: imagePath,
-    filename,
-    status: 'error',
-    note,
-  })
-  
-  // Clear any existing timer for this path (shouldn't happen, but be safe)
-  const existingTimer = errorImageTimers.get(imagePath)
-  if (existingTimer) {
-    clearTimeout(existingTimer)
-  }
-  
-  // Auto-remove error images after a delay
-  const timer = setTimeout(() => {
-    errorImageTimers.delete(imagePath)
-    useChatStore.getState().removePendingImage(imagePath)
-  }, AUTO_REMOVE_ERROR_DELAY_MS)
-  
-  errorImageTimers.set(imagePath, timer)
-}
-
-/**
- * Clear the auto-remove timer for an error image.
- * Call this when manually removing an image to prevent memory leaks.
- */
-export function clearErrorImageTimer(imagePath: string): void {
-  const timer = errorImageTimers.get(imagePath)
-  if (timer) {
-    clearTimeout(timer)
-    errorImageTimers.delete(imagePath)
-  }
-}
-
-/**
- * Validate and add an image from a file path.
- * Returns { success: true } if the image was added for processing,
- * or { success: false, error } if the file doesn't exist or isn't supported.
- */
-export async function validateAndAddImage(
-  imagePath: string,
-  cwd: string,
-): Promise<{ success: true } | { success: false; error: string }> {
-  const resolvedPath = resolveFilePath(imagePath, cwd)
-  
-  // Check if file exists
-  if (!existsSync(resolvedPath)) {
-    const error = 'file not found'
-    addPendingImageWithError(resolvedPath, `❌ ${error}`)
-    return { success: false, error }
-  }
-  
-  // Check if it's a supported format
-  if (!isImageFile(resolvedPath)) {
-    const ext = path.extname(imagePath).toLowerCase()
-    const error = ext ? `unsupported format ${ext}` : 'unsupported format'
-    addPendingImageWithError(resolvedPath, `❌ ${error}`)
-    return { success: false, error }
-  }
-  
-  // Process and add the image (addPendingImageFromFile handles exiting image mode on success)
-  await addPendingImageFromFile(resolvedPath, cwd)
-  return { success: true }
-}
-
-// ---------------------------------------------------------------------------
-// File / folder attachments
-// ---------------------------------------------------------------------------
-
-const MAX_FILE_READ_SIZE = 1024 * 1024 // 1 MB – don't read files larger than this
-const MAX_CONTENT_CHARS = 100 * 1024   // 100 KB of text content
-const MAX_DIR_ENTRIES = 100
-
-function formatFileSize(bytes: number): string {
-  if (bytes < 1024) return `${bytes} B`
-  const kb = bytes / 1024
-  if (kb < 1024) return `${kb.toFixed(1)} KB`
-  const mb = kb / 1024
-  return `${mb.toFixed(1)} MB`
-}
-
-function isBinaryBuffer(buffer: Buffer): boolean {
-  const sampleSize = Math.min(buffer.length, 8192)
-  for (let i = 0; i < sampleSize; i++) {
-    if (buffer[i] === 0) return true
-  }
-  return false
-}
-
-/**
- * Add a file or folder as a pending attachment.
- * Reads the content in the background and updates the store.
- */
-export function addPendingFileFromPath(
-  filePath: string,
-  isDirectory: boolean,
-): void {
-  const id = crypto.randomUUID()
-  const filename = path.basename(filePath) || filePath
-
-  useChatStore.getState().addPendingFileAttachment({
-    id,
-    path: filePath,
-    filename,
-    isDirectory,
-    content: '',
-    status: 'processing',
-  })
-
-  // Read content asynchronously (via setTimeout) so the UI shows immediately
-  setTimeout(() => {
-    try {
-      let content: string
-      let note: string
-
-      if (isDirectory) {
-        const entries = readdirSync(filePath, { withFileTypes: true })
-        const count = entries.length
-        note = `${count} item${count !== 1 ? 's' : ''}`
-
-        if (count === 0) {
-          content = '(empty directory)'
-        } else {
-          // Sort: directories first, then files, alphabetically within each group
-          const sorted = [...entries].sort((a, b) => {
-            const aIsDir = a.isDirectory()
-            const bIsDir = b.isDirectory()
-            if (aIsDir !== bIsDir) return aIsDir ? -1 : 1
-            return a.name.localeCompare(b.name)
-          })
-          const listing = sorted
-            .slice(0, MAX_DIR_ENTRIES)
-            .map((e) => (e.isDirectory() ? `${e.name}/` : e.name))
-            .join('\n')
-          content = listing
-          if (count > MAX_DIR_ENTRIES) {
-            content += `\n… and ${count - MAX_DIR_ENTRIES} more`
-          }
-        }
-      } else {
-        const stats = statSync(filePath)
-
-        if (stats.size === 0) {
-          content = '(empty file)'
-          note = '0 B'
-        } else if (stats.size > MAX_FILE_READ_SIZE) {
-          content = `(file too large to preview: ${formatFileSize(stats.size)})`
-          note = formatFileSize(stats.size)
-        } else {
-          const buffer = readFileSync(filePath)
-          if (isBinaryBuffer(buffer)) {
-            content = '(binary file)'
-            note = `${formatFileSize(stats.size)} (binary)`
-          } else {
-            const text = buffer.toString('utf-8')
-            if (text.length > MAX_CONTENT_CHARS) {
-              content = text.slice(0, MAX_CONTENT_CHARS) + '\n… (truncated)'
-              note = formatFileSize(stats.size)
-            } else {
-              content = text
-              note = formatFileSize(stats.size)
-            }
-          }
-        }
-      }
-
-      useChatStore.setState((state) => ({
-        pendingAttachments: state.pendingAttachments.map((att) => {
-          if (att.kind !== 'file' || att.id !== id) return att
-          return { ...att, content, status: 'ready' as const, note }
-        }),
-      }))
-    } catch {
-      useChatStore.setState((state) => ({
-        pendingAttachments: state.pendingAttachments.map((att) => {
-          if (att.kind !== 'file' || att.id !== id) return att
-          return { ...att, status: 'error' as const, note: 'Failed to read' }
-        }),
-      }))
-    }
-  }, 0)
-}
-
-/**
- * Check if any pending images are still processing.
- */
-export function hasProcessingImages(): boolean {
-  return useChatStore.getState().pendingAttachments.some(
-    (att) => att.kind === 'image' && att.status === 'processing',
-  )
-}
-
-/**
- * Check if any pending file attachments are still processing.
- */
-export function hasProcessingFiles(): boolean {
-  return useChatStore.getState().pendingAttachments.some(
-    (att) => att.kind === 'file' && att.status === 'processing',
-  )
-}
-
-/**
- * Capture and clear all pending attachments so they can be passed to the queue
- * without duplicating state handling logic in multiple callers.
- */
-export function capturePendingAttachments(): PendingAttachment[] {
-  const pendingAttachments = [...useChatStore.getState().pendingAttachments]
-  if (pendingAttachments.length > 0) {
-    useChatStore.getState().clearPendingAttachments()
-  }
-  return pendingAttachments
-}
-
-

package/src/utils/polling-backoff.ts

@@ -1,59 +0,0 @@
-export type RandomSource = () => number
-
-const FAILURE_BACKOFF_BASE_MS = 20_000
-const FAILURE_BACKOFF_MAX_MS = 300_000
-
-function unitInterval(random: RandomSource): number {
-  return Math.max(0, Math.min(1, random()))
-}
-
-/**
- * Exponential retry delay with equal jitter. Keeping the lower half of the
- * exponential window avoids immediate retry loops while still spreading a
- * large disconnected fleet across time.
- */
-export function failedPollDelayMs({
-  consecutiveFailures,
-  retryAfterMs,
-  random = Math.random,
-}: {
-  consecutiveFailures: number
-  retryAfterMs?: number
-  random?: RandomSource
-}): number {
-  const exponent = Math.max(0, consecutiveFailures - 1)
-  const cap = Math.min(
-    FAILURE_BACKOFF_MAX_MS,
-    FAILURE_BACKOFF_BASE_MS * 2 ** exponent,
-  )
-  const half = cap / 2
-  const backoffMs = Math.max(1, Math.round(half + half * unitInterval(random)))
-  if (retryAfterMs === undefined) return backoffMs
-
-  const boundedRetryAfterMs = Number.isFinite(retryAfterMs)
-    ? Math.max(0, Math.min(FAILURE_BACKOFF_MAX_MS, retryAfterMs))
-    : 0
-  const jitteredRetryAfterMs = Math.max(
-    1,
-    Math.round(boundedRetryAfterMs * (1 + 0.2 * unitInterval(random))),
-  )
-  return Math.min(
-    FAILURE_BACKOFF_MAX_MS,
-    Math.max(backoffMs, jitteredRetryAfterMs),
-  )
-}
-
-/** Add symmetric jitter to a successful polling cadence. */
-export function jitterPollIntervalMs({
-  intervalMs,
-  jitterRatio = 0.2,
-  random = Math.random,
-}: {
-  intervalMs: number
-  jitterRatio?: number
-  random?: RandomSource
-}): number {
-  const ratio = Math.max(0, Math.min(1, jitterRatio))
-  const multiplier = 1 - ratio + 2 * ratio * unitInterval(random)
-  return Math.max(1, Math.round(intervalMs * multiplier))
-}

package/src/utils/project-picker.ts

@@ -1,12 +0,0 @@
-import path from 'path'
-
-export function shouldShowProjectPicker(
-  startCwd: string,
-  homeDir: string,
-): boolean {
-  const relativeToHome = path.relative(startCwd, homeDir)
-  return (
-    relativeToHome === '' ||
-    (!relativeToHome.startsWith('..') && !path.isAbsolute(relativeToHome))
-  )
-}

package/src/utils/queue-panel-actions.ts

@@ -1,70 +0,0 @@
-import { isPlainEnterKey } from './terminal-enter-detection'
-
-import type { KeyEvent } from '@opentui/core'
-
-/**
- * What a keypress means inside the queue editor. Kept separate from the
- * component so the shortcut table is testable without a renderer, matching
- * how chat's own shortcuts are resolved.
- */
-export type QueuePanelAction =
-  | { type: 'close' }
-  | { type: 'cancel-edit' }
-  /** Move the cursor by `delta` rows. */
-  | { type: 'select'; delta: number }
-  /** Move the selected message by `delta` slots. */
-  | { type: 'move'; delta: number }
-  | { type: 'move-to-top' }
-  | { type: 'edit' }
-  | { type: 'delete' }
-  | { type: 'none' }
-
-export type QueuePanelKeyboardState = {
-  /** While an item is open for editing the MultilineInput owns the keyboard;
-   *  the panel only listens for the way out. */
-  editing: boolean
-}
-
-export function resolveQueuePanelAction(
-  key: KeyEvent,
-  state: QueuePanelKeyboardState,
-): QueuePanelAction {
-  const isEscape = key.name === 'escape'
-  const isCtrlC = key.ctrl && key.name === 'c'
-
-  if (state.editing) {
-    if (isEscape || isCtrlC) return { type: 'cancel-edit' }
-    return { type: 'none' }
-  }
-
-  // `q` covers ctrl+q too, so the shortcut that opened the panel also closes it.
-  if (isEscape || isCtrlC || key.name === 'q') return { type: 'close' }
-
-  // Terminals disagree about whether they report modified arrows at all, so
-  // reordering also answers to shift+J/K — a plain printable key every
-  // terminal delivers.
-  const reorder = key.shift || key.ctrl
-  if ((key.name === 'up' && reorder) || key.sequence === 'K') {
-    return { type: 'move', delta: -1 }
-  }
-  if ((key.name === 'down' && reorder) || key.sequence === 'J') {
-    return { type: 'move', delta: 1 }
-  }
-
-  if (key.name === 'up' || key.name === 'k') return { type: 'select', delta: -1 }
-  if (key.name === 'down' || key.name === 'j') return { type: 'select', delta: 1 }
-
-  if (key.name === 't') return { type: 'move-to-top' }
-
-  if (key.name === 'e' || isPlainEnterKey(key)) return { type: 'edit' }
-
-  if (
-    key.name === 'd' ||
-    key.name === 'delete' ||
-    (key.name === 'backspace' && !key.ctrl && !key.meta && !key.option)
-  ) {
-    return { type: 'delete' }
-  }
-
-  return { type: 'none' }
-}