@compass-ai/nova 1.0.73 → 1.0.74

package/dist/ui/themes/ui-theme.js

@@ -0,0 +1,204 @@
+/**
+ * Centralized UI theme configuration for the CLI.
+ * Provides consistent colors, borders, and visual elements across all components.
+ *
+ * Design philosophy:
+ * - Use rounded borders for a modern, polished look
+ * - Cohesive indigo/purple accent palette
+ * - Subtle, non-distracting dividers
+ * - High contrast for readability
+ */
+import chalk from 'chalk';
+/**
+ * Primary color palette - indigo/purple tones for a modern look
+ */
+export const colors = {
+    // Primary accents
+    primary: '#6366f1', // Indigo-500
+    primaryBright: '#818cf8', // Indigo-400
+    primaryDim: '#4f46e5', // Indigo-600
+    // Secondary accents
+    secondary: '#8b5cf6', // Purple-500
+    secondaryBright: '#a78bfa', // Purple-400
+    // Status colors
+    success: '#22c55e', // Green-500
+    successBright: '#4ade80', // Green-400
+    warning: '#f59e0b', // Amber-500
+    warningBright: '#fbbf24', // Amber-400
+    error: '#ef4444', // Red-500
+    errorBright: '#f87171', // Red-400
+    info: '#06b6d4', // Cyan-500
+    infoBright: '#22d3ee', // Cyan-400
+    // Neutral tones
+    muted: '#6b7280', // Gray-500
+    mutedDim: '#4b5563', // Gray-600
+    border: '#374151', // Gray-700
+    borderLight: '#4b5563', // Gray-600
+    // Text
+    text: '#f9fafb', // Gray-50
+    textDim: '#9ca3af', // Gray-400
+    textMuted: '#6b7280', // Gray-500
+};
+/**
+ * Chalk-styled color functions for easy use in components
+ */
+export const styled = {
+    // Primary
+    primary: chalk.hex(colors.primary),
+    primaryBright: chalk.hex(colors.primaryBright),
+    primaryBold: chalk.hex(colors.primary).bold,
+    // Secondary
+    secondary: chalk.hex(colors.secondary),
+    secondaryBright: chalk.hex(colors.secondaryBright),
+    // Status
+    success: chalk.hex(colors.success),
+    successBright: chalk.hex(colors.successBright),
+    warning: chalk.hex(colors.warning),
+    warningBright: chalk.hex(colors.warningBright),
+    error: chalk.hex(colors.error),
+    errorBright: chalk.hex(colors.errorBright),
+    info: chalk.hex(colors.info),
+    infoBright: chalk.hex(colors.infoBright),
+    // Muted
+    muted: chalk.hex(colors.muted),
+    mutedDim: chalk.hex(colors.mutedDim),
+    // Text
+    text: chalk.hex(colors.text),
+    textDim: chalk.hex(colors.textDim),
+    textMuted: chalk.hex(colors.textMuted),
+};
+/**
+ * Border configuration
+ * Using 'round' style for modern, polished appearance
+ */
+export const borders = {
+    // Preferred border style - rounded corners look more polished
+    style: 'round',
+    // Alternative styles for specific use cases
+    styles: {
+        round: 'round',
+        single: 'single',
+        double: 'double',
+        bold: 'bold',
+    },
+    // Border colors
+    color: 'gray',
+    colorActive: 'cyan',
+    colorSuccess: 'green',
+    colorWarning: 'yellow',
+    colorError: 'red',
+};
+/**
+ * Divider characters and styles
+ */
+export const dividers = {
+    // Light horizontal line (most common)
+    light: '─',
+    // Heavy horizontal line (for emphasis)
+    heavy: '━',
+    // Dotted line (subtle separation)
+    dotted: '·',
+    // Double line (strong separation)
+    double: '═',
+    // Vertical separators
+    verticalLight: '│',
+    verticalHeavy: '┃',
+    // Corner pieces for custom boxes (rounded)
+    roundedTopLeft: '╭',
+    roundedTopRight: '╮',
+    roundedBottomLeft: '╰',
+    roundedBottomRight: '╯',
+    // Corner pieces (square)
+    squareTopLeft: '┌',
+    squareTopRight: '┐',
+    squareBottomLeft: '└',
+    squareBottomRight: '┘',
+};
+/**
+ * Creates a horizontal divider line
+ * @param width - Width in characters
+ * @param style - Divider style ('light', 'heavy', 'dotted', 'double')
+ */
+export function createDivider(width, style = 'light') {
+    const char = dividers[style];
+    return char.repeat(Math.max(1, width));
+}
+/**
+ * Creates a subtle divider with faded edges
+ * @param width - Total width including faded edges
+ */
+export function createSoftDivider(width) {
+    if (width < 5)
+        return dividers.light.repeat(width);
+    const fadeChar = '╶';
+    const mainWidth = Math.max(1, width - 2);
+    return fadeChar + dividers.light.repeat(mainWidth) + '╴';
+}
+/**
+ * Common UI symbols
+ */
+export const symbols = {
+    // Checkmarks and status
+    check: '✓',
+    cross: '✗',
+    bullet: '•',
+    circle: '○',
+    circleFilled: '●',
+    diamond: '◆',
+    star: '★',
+    starEmpty: '☆',
+    // Arrows and pointers
+    arrowRight: '→',
+    arrowLeft: '←',
+    arrowUp: '↑',
+    arrowDown: '↓',
+    pointer: '❯',
+    pointerSmall: '›',
+    triangleRight: '▶',
+    triangleDown: '▼',
+    // Spinners and progress
+    spinner: ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏'],
+    progress: ['░', '▒', '▓', '█'],
+    dots: ['⠁', '⠂', '⠄', '⡀', '⢀', '⠠', '⠐', '⠈'],
+    // Info and alerts
+    info: 'ℹ',
+    warning: '⚠',
+    error: '✖',
+    question: '?',
+    // Misc
+    ellipsis: '…',
+    middot: '·',
+    pipe: '│',
+};
+/**
+ * Mode indicators with consistent styling
+ */
+export const modeIndicators = {
+    auto: { symbol: '⚡', color: 'yellow' },
+    manual: { symbol: '✋', color: 'green' },
+    strict: { symbol: '🔒', color: 'red' },
+    smart: { symbol: '🧠', color: 'cyan' },
+};
+/**
+ * Standard spacing values (in characters/lines)
+ */
+export const spacing = {
+    none: 0,
+    xs: 1,
+    sm: 2,
+    md: 3,
+    lg: 4,
+    xl: 6,
+};
+export default {
+    colors,
+    styled,
+    borders,
+    dividers,
+    symbols,
+    modeIndicators,
+    spacing,
+    createDivider,
+    createSoftDivider,
+};
+//# sourceMappingURL=ui-theme.js.map

package/dist/ui/themes/ui-theme.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui-theme.js","sourceRoot":"","sources":["../../../src/ui/themes/ui-theme.ts"],"names":[],"mappings":"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"}

package/dist/utils/attachment-handler.d.ts

@@ -0,0 +1,129 @@
+/**
+ * Attachment Handler Utility
+ *
+ * This module provides utilities for validating, reading, and encoding file attachments
+ * (images and PDFs) for use with the Compass CLI. It handles file type detection,
+ * MIME type validation, base64 encoding, and size limits.
+ */
+import type { Attachment } from '../types/session.js';
+import type { ContentBlock } from '../types/anthropic.js';
+/**
+ * Attachment limits configuration
+ */
+export declare const ATTACHMENT_LIMITS: {
+    /** Maximum file size per attachment in bytes (20MB) */
+    readonly MAX_FILE_SIZE: number;
+    /** Maximum total size for all attachments in bytes (100MB) */
+    readonly MAX_TOTAL_SIZE: number;
+    /** Maximum number of attachments per message */
+    readonly MAX_ATTACHMENTS: 20;
+};
+/**
+ * Type guard for supported file extensions
+ */
+export declare function isSupportedAttachment(filePath: string): boolean;
+/**
+ * Check if a file is an image based on its extension
+ */
+export declare function isImageFile(filePath: string): boolean;
+/**
+ * Check if a file is a document (PDF) based on its extension
+ */
+export declare function isDocumentFile(filePath: string): boolean;
+/**
+ * Get MIME type for a file based on its extension
+ */
+export declare function getMimeType(filePath: string): string | null;
+/**
+ * Validate an attachment file
+ *
+ * @param filePath - Path to the file to validate
+ * @param projectRoot - Root directory of the project for resolving relative paths
+ * @returns Object with validation result and error message if invalid
+ */
+export declare function validateAttachment(filePath: string, projectRoot?: string): {
+    valid: boolean;
+    error?: string;
+    resolvedPath?: string;
+};
+/**
+ * Read and encode a file attachment
+ *
+ * @param filePath - Path to the file (will be resolved relative to projectRoot)
+ * @param projectRoot - Root directory for resolving relative paths
+ * @returns Promise that resolves to an Attachment object
+ * @throws Error if the file cannot be read or is invalid
+ */
+export declare function processAttachment(filePath: string, projectRoot?: string): Promise<Attachment>;
+/**
+ * Process multiple attachments with error collection
+ *
+ * @param filePaths - Array of file paths to process
+ * @param projectRoot - Root directory for resolving relative paths
+ * @returns Object with successful attachments and errors
+ */
+export declare function processAttachments(filePaths: string[], projectRoot?: string): Promise<{
+    attachments: Attachment[];
+    errors: Array<{
+        path: string;
+        error: string;
+    }>;
+}>;
+/**
+ * Build a ContentBlock from an Attachment for use with Anthropic API
+ *
+ * @param attachment - The attachment to convert
+ * @returns A ContentBlock suitable for the Anthropic API
+ */
+export declare function buildAttachmentContentBlock(attachment: Attachment): ContentBlock;
+/**
+ * Build ContentBlocks from multiple Attachments for use with Anthropic API
+ *
+ * @param attachments - Array of attachments to convert
+ * @returns Array of ContentBlocks suitable for the Anthropic API
+ */
+export declare function buildAttachmentContentBlocks(attachments: Attachment[]): ContentBlock[];
+/**
+ * Validate an attachment file (alias for validateAttachment)
+ *
+ * @param filePath - Path to the file to validate
+ * @param projectRoot - Root directory of the project for resolving relative paths
+ * @returns Object with validation result and error message if invalid
+ */
+export declare function validateAttachmentFile(filePath: string, projectRoot?: string): {
+    valid: boolean;
+    error?: string;
+    resolvedPath?: string;
+};
+/**
+ * Read and encode a file attachment (alias for processAttachment)
+ *
+ * @param filePath - Path to the file (will be resolved relative to projectRoot)
+ * @param projectRoot - Root directory for resolving relative paths
+ * @returns Promise that resolves to an Attachment object
+ * @throws Error if the file cannot be read or is invalid
+ */
+export declare function readAttachmentFile(filePath: string, projectRoot?: string): Promise<Attachment>;
+/**
+ * Build message content combining text and attachments
+ *
+ * @param text - The text content of the message
+ * @param attachments - Array of attachments to include
+ * @returns Array of ContentBlocks for the Anthropic API
+ */
+export declare function buildMessageContent(text: string, attachments?: Attachment[]): ContentBlock[];
+/**
+ * Format attachment information for display
+ *
+ * @param attachment - The attachment to format
+ * @returns A human-readable string describing the attachment
+ */
+export declare function formatAttachmentInfo(attachment: Attachment): string;
+/**
+ * Get a summary of multiple attachments
+ *
+ * @param attachments - Array of attachments
+ * @returns A human-readable summary string
+ */
+export declare function formatAttachmentsSummary(attachments: Attachment[]): string;
+//# sourceMappingURL=attachment-handler.d.ts.map

package/dist/utils/attachment-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attachment-handler.d.ts","sourceRoot":"","sources":["../../src/utils/attachment-handler.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAM1D;;GAEG;AACH,eAAO,MAAM,iBAAiB;IAC5B,uDAAuD;;IAEvD,8DAA8D;;IAE9D,gDAAgD;;CAExC,CAAC;AAgBX;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAG/D;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAGrD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAGxD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAG3D;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,MAAM,EAChB,WAAW,GAAE,MAAc,GAC1B;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAAE,CAkC3D;AAED;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,CACrC,QAAQ,EAAE,MAAM,EAChB,WAAW,GAAE,MAAc,GAC1B,OAAO,CAAC,UAAU,CAAC,CA4BrB;AAED;;;;;;GAMG;AACH,wBAAsB,kBAAkB,CACtC,SAAS,EAAE,MAAM,EAAE,EACnB,WAAW,GAAE,MAAc,GAC1B,OAAO,CAAC;IACT,WAAW,EAAE,UAAU,EAAE,CAAC;IAC1B,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAChD,CAAC,CAmCD;AAED;;;;;GAKG;AACH,wBAAgB,2BAA2B,CAAC,UAAU,EAAE,UAAU,GAAG,YAAY,CAqBhF;AAED;;;;;GAKG;AACH,wBAAgB,4BAA4B,CAC1C,WAAW,EAAE,UAAU,EAAE,GACxB,YAAY,EAAE,CAEhB;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,MAAM,EAChB,WAAW,GAAE,MAAc,GAC1B;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAAE,CAE3D;AAED;;;;;;;GAOG;AACH,wBAAsB,kBAAkB,CACtC,QAAQ,EAAE,MAAM,EAChB,WAAW,GAAE,MAAc,GAC1B,OAAO,CAAC,UAAU,CAAC,CAErB;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,MAAM,EACZ,WAAW,GAAE,UAAU,EAAO,GAC7B,YAAY,EAAE,CAchB;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,UAAU,GAAG,MAAM,CAGnE;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,WAAW,EAAE,UAAU,EAAE,GAAG,MAAM,CAmB1E"}

package/dist/utils/attachment-handler.js

@@ -0,0 +1,280 @@
+/**
+ * Attachment Handler Utility
+ *
+ * This module provides utilities for validating, reading, and encoding file attachments
+ * (images and PDFs) for use with the Compass CLI. It handles file type detection,
+ * MIME type validation, base64 encoding, and size limits.
+ */
+import { readFile } from 'fs/promises';
+import { existsSync, statSync } from 'fs';
+import { extname, basename, resolve, isAbsolute } from 'path';
+import { cwd } from 'process';
+/**
+ * Attachment limits configuration
+ */
+export const ATTACHMENT_LIMITS = {
+    /** Maximum file size per attachment in bytes (20MB) */
+    MAX_FILE_SIZE: 20 * 1024 * 1024,
+    /** Maximum total size for all attachments in bytes (100MB) */
+    MAX_TOTAL_SIZE: 100 * 1024 * 1024,
+    /** Maximum number of attachments per message */
+    MAX_ATTACHMENTS: 20,
+};
+/**
+ * Supported file extensions and their MIME types
+ */
+const SUPPORTED_FILE_TYPES = {
+    // Images
+    '.png': 'image/png',
+    '.jpg': 'image/jpeg',
+    '.jpeg': 'image/jpeg',
+    '.gif': 'image/gif',
+    '.webp': 'image/webp',
+    // Documents
+    '.pdf': 'application/pdf',
+};
+/**
+ * Type guard for supported file extensions
+ */
+export function isSupportedAttachment(filePath) {
+    const ext = extname(filePath).toLowerCase();
+    return ext in SUPPORTED_FILE_TYPES;
+}
+/**
+ * Check if a file is an image based on its extension
+ */
+export function isImageFile(filePath) {
+    const ext = extname(filePath).toLowerCase();
+    return ['.png', '.jpg', '.jpeg', '.gif', '.webp'].includes(ext);
+}
+/**
+ * Check if a file is a document (PDF) based on its extension
+ */
+export function isDocumentFile(filePath) {
+    const ext = extname(filePath).toLowerCase();
+    return ext === '.pdf';
+}
+/**
+ * Get MIME type for a file based on its extension
+ */
+export function getMimeType(filePath) {
+    const ext = extname(filePath).toLowerCase();
+    return SUPPORTED_FILE_TYPES[ext] || null;
+}
+/**
+ * Validate an attachment file
+ *
+ * @param filePath - Path to the file to validate
+ * @param projectRoot - Root directory of the project for resolving relative paths
+ * @returns Object with validation result and error message if invalid
+ */
+export function validateAttachment(filePath, projectRoot = cwd()) {
+    // Resolve the file path
+    const resolvedPath = isAbsolute(filePath) ? filePath : resolve(projectRoot, filePath);
+    // Check if file exists
+    if (!existsSync(resolvedPath)) {
+        return { valid: false, error: `File not found: ${filePath}` };
+    }
+    // Check if it's a file (not a directory)
+    const stats = statSync(resolvedPath);
+    if (!stats.isFile()) {
+        return { valid: false, error: `Not a file: ${filePath}` };
+    }
+    // Check file type
+    if (!isSupportedAttachment(resolvedPath)) {
+        return {
+            valid: false,
+            error: `Unsupported file type: ${extname(resolvedPath)}. Supported types: ${Object.keys(SUPPORTED_FILE_TYPES).join(', ')}`,
+        };
+    }
+    // Check file size
+    if (stats.size > ATTACHMENT_LIMITS.MAX_FILE_SIZE) {
+        const sizeMB = (stats.size / (1024 * 1024)).toFixed(2);
+        const limitMB = (ATTACHMENT_LIMITS.MAX_FILE_SIZE / (1024 * 1024)).toFixed(2);
+        return {
+            valid: false,
+            error: `File too large: ${sizeMB}MB (maximum ${limitMB}MB)`,
+        };
+    }
+    return { valid: true, resolvedPath };
+}
+/**
+ * Read and encode a file attachment
+ *
+ * @param filePath - Path to the file (will be resolved relative to projectRoot)
+ * @param projectRoot - Root directory for resolving relative paths
+ * @returns Promise that resolves to an Attachment object
+ * @throws Error if the file cannot be read or is invalid
+ */
+export async function processAttachment(filePath, projectRoot = cwd()) {
+    // Validate the file first
+    const validation = validateAttachment(filePath, projectRoot);
+    if (!validation.valid) {
+        throw new Error(validation.error);
+    }
+    const resolvedPath = validation.resolvedPath;
+    const mimeType = getMimeType(resolvedPath);
+    const filename = basename(resolvedPath);
+    // Read the file
+    const buffer = await readFile(resolvedPath);
+    // Encode to base64
+    const data = buffer.toString('base64');
+    // Determine attachment type
+    const type = isImageFile(resolvedPath) ? 'image' : 'document';
+    return {
+        type,
+        mimeType: mimeType,
+        data,
+        filename,
+        size: buffer.length,
+        filePath: resolvedPath,
+    };
+}
+/**
+ * Process multiple attachments with error collection
+ *
+ * @param filePaths - Array of file paths to process
+ * @param projectRoot - Root directory for resolving relative paths
+ * @returns Object with successful attachments and errors
+ */
+export async function processAttachments(filePaths, projectRoot = cwd()) {
+    const attachments = [];
+    const errors = [];
+    // Check attachment count limit
+    if (filePaths.length > ATTACHMENT_LIMITS.MAX_ATTACHMENTS) {
+        throw new Error(`Too many attachments: ${filePaths.length} (maximum ${ATTACHMENT_LIMITS.MAX_ATTACHMENTS})`);
+    }
+    // Process each file
+    for (const filePath of filePaths) {
+        try {
+            const attachment = await processAttachment(filePath, projectRoot);
+            attachments.push(attachment);
+        }
+        catch (error) {
+            errors.push({
+                path: filePath,
+                error: error instanceof Error ? error.message : String(error),
+            });
+        }
+    }
+    // Check total size limit
+    const totalSize = attachments.reduce((sum, a) => sum + a.size, 0);
+    if (totalSize > ATTACHMENT_LIMITS.MAX_TOTAL_SIZE) {
+        const totalMB = (totalSize / (1024 * 1024)).toFixed(2);
+        const limitMB = (ATTACHMENT_LIMITS.MAX_TOTAL_SIZE / (1024 * 1024)).toFixed(2);
+        throw new Error(`Total attachment size too large: ${totalMB}MB (maximum ${limitMB}MB)`);
+    }
+    return { attachments, errors };
+}
+/**
+ * Build a ContentBlock from an Attachment for use with Anthropic API
+ *
+ * @param attachment - The attachment to convert
+ * @returns A ContentBlock suitable for the Anthropic API
+ */
+export function buildAttachmentContentBlock(attachment) {
+    if (attachment.type === 'image') {
+        return {
+            type: 'image',
+            source: {
+                type: 'base64',
+                media_type: attachment.mimeType,
+                data: attachment.data,
+            },
+        };
+    }
+    else {
+        // attachment.type === 'document'
+        return {
+            type: 'document',
+            source: {
+                type: 'base64',
+                media_type: attachment.mimeType,
+                data: attachment.data,
+            },
+        };
+    }
+}
+/**
+ * Build ContentBlocks from multiple Attachments for use with Anthropic API
+ *
+ * @param attachments - Array of attachments to convert
+ * @returns Array of ContentBlocks suitable for the Anthropic API
+ */
+export function buildAttachmentContentBlocks(attachments) {
+    return attachments.map(buildAttachmentContentBlock);
+}
+/**
+ * Validate an attachment file (alias for validateAttachment)
+ *
+ * @param filePath - Path to the file to validate
+ * @param projectRoot - Root directory of the project for resolving relative paths
+ * @returns Object with validation result and error message if invalid
+ */
+export function validateAttachmentFile(filePath, projectRoot = cwd()) {
+    return validateAttachment(filePath, projectRoot);
+}
+/**
+ * Read and encode a file attachment (alias for processAttachment)
+ *
+ * @param filePath - Path to the file (will be resolved relative to projectRoot)
+ * @param projectRoot - Root directory for resolving relative paths
+ * @returns Promise that resolves to an Attachment object
+ * @throws Error if the file cannot be read or is invalid
+ */
+export async function readAttachmentFile(filePath, projectRoot = cwd()) {
+    return processAttachment(filePath, projectRoot);
+}
+/**
+ * Build message content combining text and attachments
+ *
+ * @param text - The text content of the message
+ * @param attachments - Array of attachments to include
+ * @returns Array of ContentBlocks for the Anthropic API
+ */
+export function buildMessageContent(text, attachments = []) {
+    const blocks = [];
+    // Add text block if present
+    if (text) {
+        blocks.push({ type: 'text', text });
+    }
+    // Add attachment blocks
+    for (const attachment of attachments) {
+        blocks.push(buildAttachmentContentBlock(attachment));
+    }
+    return blocks;
+}
+/**
+ * Format attachment information for display
+ *
+ * @param attachment - The attachment to format
+ * @returns A human-readable string describing the attachment
+ */
+export function formatAttachmentInfo(attachment) {
+    const sizeMB = (attachment.size / (1024 * 1024)).toFixed(2);
+    return `${attachment.filename} (${attachment.type}, ${attachment.mimeType}, ${sizeMB}MB)`;
+}
+/**
+ * Get a summary of multiple attachments
+ *
+ * @param attachments - Array of attachments
+ * @returns A human-readable summary string
+ */
+export function formatAttachmentsSummary(attachments) {
+    if (attachments.length === 0) {
+        return 'No attachments';
+    }
+    const totalSize = attachments.reduce((sum, a) => sum + a.size, 0);
+    const totalMB = (totalSize / (1024 * 1024)).toFixed(2);
+    const imageCount = attachments.filter(a => a.type === 'image').length;
+    const docCount = attachments.filter(a => a.type === 'document').length;
+    const parts = [];
+    if (imageCount > 0) {
+        parts.push(`${imageCount} image${imageCount > 1 ? 's' : ''}`);
+    }
+    if (docCount > 0) {
+        parts.push(`${docCount} document${docCount > 1 ? 's' : ''}`);
+    }
+    return `${parts.join(', ')} (${totalMB}MB total)`;
+}
+//# sourceMappingURL=attachment-handler.js.map

package/dist/utils/attachment-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"attachment-handler.js","sourceRoot":"","sources":["../../src/utils/attachment-handler.ts"],"names":[],"mappings":"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"}

package/dist/utils/backup-cleanup.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Backup cleanup utility for removing old and excess backup files.
+ *
+ * Provides two cleanup strategies:
+ * 1. Age-based: Deletes backup files older than the configured retention period
+ * 2. Count-based: Keeps only the most recent N backup files
+ *
+ * This utility operates directly on the filesystem (like log-cleanup.ts) and
+ * serves as a safety net for orphaned files not tracked by the BackupManager
+ * manifest. The BackupManager also performs its own manifest-aware cleanup.
+ *
+ * Uses file modification time (mtime) for age detection, matching the pattern
+ * established by log-cleanup.ts.
+ */
+/**
+ * Removes old and excess backup files from a directory.
+ * Only runs once per directory per process lifetime to avoid repeated I/O.
+ *
+ * Applies two pruning strategies in order:
+ * 1. Age-based: Remove files older than retentionDays
+ * 2. Count-based: Keep only the maxFiles most recent files
+ *
+ * @param backupsDir - The directory containing backup files
+ * @param retentionDays - Number of days to keep backups (default: BACKUP_RETENTION_DAYS)
+ * @param maxFiles - Maximum number of backup files to retain (default: MAX_BACKUP_FILES)
+ */
+export declare function cleanupOldBackups(backupsDir: string, retentionDays?: number, maxFiles?: number): Promise<void>;
+//# sourceMappingURL=backup-cleanup.d.ts.map

package/dist/utils/backup-cleanup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backup-cleanup.d.ts","sourceRoot":"","sources":["../../src/utils/backup-cleanup.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAYH;;;;;;;;;;;GAWG;AACH,wBAAsB,iBAAiB,CACrC,UAAU,EAAE,MAAM,EAClB,aAAa,GAAE,MAA8B,EAC7C,QAAQ,GAAE,MAAyB,GAClC,OAAO,CAAC,IAAI,CAAC,CAuEf"}