crewly 1.13.0 → 1.13.1

package/dist/cli/backend/src/services/agent/crewly-agent/types.js

@@ -0,0 +1,282 @@
+/**
+ * Crewly Agent Runtime Type Definitions
+ *
+ * Types for the in-process Crewly Agent runtime powered by Vercel AI SDK.
+ * Covers model configuration, conversation state, and agent lifecycle.
+ *
+ * @module services/agent/crewly-agent/types
+ */
+/**
+ * All valid model providers
+ */
+export const MODEL_PROVIDERS = [
+    'anthropic',
+    'openai',
+    'google',
+    'ollama',
+    'deepseek',
+];
+/**
+ * Tools that perform write/modify operations.
+ * Used by readOnlyMode to determine which tools to block.
+ */
+export const WRITE_TOOLS = [
+    'edit_file',
+    'write_file',
+    'start_agent',
+    'stop_agent',
+    'handle_agent_failure',
+    'delegate_task',
+    'send_message',
+    'reply_slack',
+    'broadcast',
+    'schedule_check',
+    'cancel_schedule',
+    'register_self',
+    'report_status',
+    'remember',
+    'complete_task',
+];
+/**
+ * Estimated context window sizes (in tokens) for known models.
+ * Used for budget tracking when the model doesn't report its own limit.
+ */
+export const MODEL_CONTEXT_WINDOWS = {
+    // Anthropic — current generation. These were missing, so every model the
+    // fleet actually runs fell through to `default: 128_000` while its real
+    // window is 1M. An 8x under-estimate makes `compactionThreshold` fire
+    // roughly 8x too early, which is expensive: each premature compaction is a
+    // whole extra model call.
+    'claude-fable-5': 1_000_000,
+    'claude-opus-5': 1_000_000,
+    'claude-opus-4-8': 1_000_000,
+    'claude-opus-4-7': 1_000_000,
+    'claude-opus-4-6': 1_000_000,
+    'claude-sonnet-5': 1_000_000,
+    'claude-sonnet-4-6': 1_000_000,
+    'claude-haiku-4-5': 200_000,
+    // Anthropic — older dated snapshots, kept so pinned configs still resolve.
+    'claude-opus-4-20250514': 200_000,
+    'claude-sonnet-4-20250514': 200_000,
+    'claude-haiku-4-20250506': 200_000,
+    // Google
+    'gemini-2.0-flash': 1_000_000,
+    'gemini-2.5-flash-preview-05-20': 1_000_000,
+    'gemini-3-flash-preview': 1_000_000,
+    // OpenAI
+    'gpt-4o': 128_000,
+    'gpt-4o-mini': 128_000,
+    'gpt-4-turbo': 128_000,
+    // DeepSeek — V3 chat and R1 reasoner both ship with a 64k context window.
+    // Without these entries the manager falls back to `default: 128_000`, which
+    // would let Crewly's compaction trigger (0.8 × budget) skip past the real
+    // 64k cap and let DeepSeek 4xx with context_length_exceeded.
+    'deepseek-chat': 64_000,
+    'deepseek-reasoner': 64_000,
+    // Fallback
+    default: 128_000,
+};
+/**
+ * Per-model floor on `maxOutputTokens` (the AI SDK's name for the
+ * `max_tokens` request param). Used to defend against a class of bugs where
+ * a low user-configured limit silently produces an empty response.
+ *
+ * Currently only `deepseek-reasoner` has a real floor: R1 mixes
+ * `reasoning_tokens` into the same `max_tokens` budget as `completion_tokens`,
+ * so a user value < ~200 can be entirely consumed by the reasoning trace,
+ * leaving `message.content = ""` (200 OK, no error).
+ *
+ * Models not listed here resolve to a floor of 0 (no clamp).
+ *
+ * Discovered 2026-05-03 via live smoke test D — see
+ * `.crewly/specs/2026-05-03-crewly-agent-deepseek-gap-list.md` (finding N5).
+ */
+export const MODEL_OUTPUT_TOKEN_FLOORS = {
+    'deepseek-reasoner': 1024,
+};
+/**
+ * Resolve the effective `maxOutputTokens` for a given model configuration,
+ * applying any per-model floor from `MODEL_OUTPUT_TOKEN_FLOORS`.
+ *
+ * If `config.maxTokens` is unset, falls back to the runtime default
+ * (`CREWLY_AGENT_DEFAULTS.DEFAULT_MODEL.maxTokens`). The result is always
+ * `>= floor` for the model, where `floor` defaults to 0.
+ *
+ * @param config - Model configuration (may have `maxTokens` undefined)
+ * @returns Effective max output tokens to pass to generateText/streamText
+ */
+export function resolveMaxOutputTokens(config) {
+    const requested = config.maxTokens ?? CREWLY_AGENT_DEFAULTS.DEFAULT_MODEL.maxTokens ?? 0;
+    const floor = MODEL_OUTPUT_TOKEN_FLOORS[config.modelId] ?? 0;
+    return Math.max(requested, floor);
+}
+/**
+ * Default configuration values for Crewly Agent
+ */
+export const CREWLY_AGENT_DEFAULTS = {
+    /** Default max reasoning steps per generateText call (high to mimic unlimited like Claude Code) */
+    MAX_STEPS: 500,
+    /** Maximum tool calls allowed per single response to prevent polling dead-loops */
+    MAX_TOOL_CALLS_PER_RESPONSE: 15,
+    /** Consecutive identical tool calls before aborting (loop detection) */
+    LOOP_DETECTION_THRESHOLD: 3,
+    /** Consecutive error responses (404, 4xx, 5xx) from the same tool before aborting */
+    ERROR_LOOP_THRESHOLD: 3,
+    /** Default API base URL */
+    API_BASE_URL: 'http://localhost:8787',
+    /** Default max history messages before compaction */
+    MAX_HISTORY_MESSAGES: 100,
+    /** Default compaction threshold (80% of context window) */
+    COMPACTION_THRESHOLD: 0.8,
+    /**
+     * Characters per token, used ONLY to size the context before the first
+     * response gives us a real measurement. Latin text runs about 4 chars per
+     * token; CJK about 1.5, so the two are counted separately — a single ratio
+     * would misjudge a Chinese system prompt by more than 2x.
+     */
+    CHARS_PER_TOKEN_LATIN: 4,
+    CHARS_PER_TOKEN_CJK: 1.5,
+    /** Default model configuration */
+    DEFAULT_MODEL: {
+        provider: 'google',
+        modelId: 'gemini-3-flash-preview',
+        temperature: 0.3,
+        maxTokens: 8192,
+    },
+    /** HTTP request timeout in milliseconds */
+    API_TIMEOUT_MS: 30_000,
+    /** Heartbeat interval in milliseconds for keeping in-process agent active between messages */
+    HEARTBEAT_INTERVAL_MS: 30_000,
+    /** Maximum time in milliseconds for a single message processing (generateText call) — hard abort.
+     *  Override via CREWLY_AGENT_MESSAGE_TIMEOUT_MS env var.
+     *
+     *  This is the **default** timeout used when the model has no entry in
+     *  `MODEL_TIMEOUT_MS`. Per-model overrides take precedence — see below. */
+    MESSAGE_TIMEOUT_MS: Number(process.env.CREWLY_AGENT_MESSAGE_TIMEOUT_MS) || 300_000,
+    /** I4 — Per-model hard-timeout overrides. Looked up by `modelId`.
+     *
+     *  When the runtime service is about to run a message, it checks
+     *  `MODEL_TIMEOUT_MS[config.model.modelId]` first; falls back to
+     *  `MESSAGE_TIMEOUT_MS` if no entry exists.
+     *
+     *  **Why per-model:** different models have radically different latency
+     *  characteristics. DeepSeek-R1 (`deepseek-reasoner`) emits chain-of-thought
+     *  reasoning_tokens which are slower to generate than plain content tokens.
+     *  Live smoke (2026-05-03) measured R1 single-step at avg 2.8s/max 4.8s, but
+     *  long-context (>32k) latency rises sharply per vendor docs, and multi-step
+     *  agentic loops can accumulate 30+ steps. 5min default is tight; 10min gives
+     *  safety margin without inviting runaway loops. See gap-list spec §I4 for
+     *  measurement evidence. */
+    /**
+     * Frozen at module load via `Object.freeze` — defensive guard against
+     * runtime mutation. `as const` is compile-time only and the
+     * `Record<string, number>` cast widens it back to mutable, so freeze
+     * is the only line of defense against accidental writes like
+     * `CREWLY_AGENT_DEFAULTS.MODEL_TIMEOUT_MS['x'] = 999` from elsewhere
+     * in the codebase. Per-model overrides should be added by editing this
+     * file (treat as a config table, not runtime state).
+     */
+    MODEL_TIMEOUT_MS: Object.freeze({
+        /** DeepSeek-R1: 2× default — reasoning chain-of-thought is slower per token. */
+        'deepseek-reasoner': 600_000,
+    }),
+    /** Soft warning threshold in milliseconds — logs a warning but does not kill the request.
+     *  Override via CREWLY_AGENT_MESSAGE_SOFT_WARNING_MS env var. */
+    MESSAGE_SOFT_WARNING_MS: Number(process.env.CREWLY_AGENT_MESSAGE_SOFT_WARNING_MS) || 240_000,
+    /** Grace period added on top of the agent's own run budget before the PARENT
+     *  gives up waiting on the child's IPC reply.
+     *
+     *  The child enforces the run budget itself and reports a clean error, so in
+     *  normal operation the parent timer never fires. It exists for the case the
+     *  child can no longer report at all — blocked event loop, broken stdout pipe,
+     *  SIGSTOP. The grace keeps the parent from racing the child and mislabelling
+     *  a normal in-budget timeout as a wedged runtime. */
+    IPC_RUN_TIMEOUT_GRACE_MS: 30_000,
+    /** Cooldown period in milliseconds after rate limit retries are exhausted */
+    RATE_LIMIT_COOLDOWN_MS: 300_000,
+    /** Maximum number of automatic retries for recoverable errors (429, 5xx, network) */
+    MAX_RETRIES: 3,
+    /** Base delay in milliseconds for exponential backoff between retries */
+    RETRY_BASE_DELAY_MS: 1_000,
+    /** Default Ollama API base URL for local LLM provider */
+    OLLAMA_BASE_URL: 'http://localhost:11434/api',
+    /** Default security policy */
+    SECURITY_POLICY: {
+        auditEnabled: true,
+        requireApproval: [],
+        blockedTools: [],
+        maxAuditEntries: 500,
+        readOnlyMode: false,
+    },
+    /** Default security guardrail configuration */
+    SECURITY_GUARDRAILS: {
+        outputFilterEnabled: true,
+        envIsolationEnabled: true,
+        promptGuardEnabled: true,
+        explicitEnvVars: [],
+    },
+};
+/**
+ * Type guard to check if a string is a valid ModelProvider
+ *
+ * @param value - String to check
+ * @returns True if the value is a valid ModelProvider
+ */
+export function isModelProvider(value) {
+    return MODEL_PROVIDERS.includes(value);
+}
+/**
+ * Supported models for the UI dropdown.
+ * Format: provider/modelId → display label
+ */
+export const SUPPORTED_MODELS = [
+    { id: 'google/gemini-3-flash-preview', label: 'Gemini 3 Flash (Preview)', provider: 'google' },
+    { id: 'google/gemini-2.5-flash-preview-05-20', label: 'Gemini 2.5 Flash', provider: 'google' },
+    { id: 'anthropic/claude-sonnet-4-20250514', label: 'Claude Sonnet 4', provider: 'anthropic' },
+    { id: 'anthropic/claude-haiku-4-20250514', label: 'Claude Haiku 4', provider: 'anthropic' },
+    { id: 'openai/gpt-4o', label: 'GPT-4o', provider: 'openai' },
+    { id: 'openai/gpt-4o-mini', label: 'GPT-4o Mini', provider: 'openai' },
+    { id: 'deepseek/deepseek-chat', label: 'DeepSeek V3', provider: 'deepseek' },
+    { id: 'deepseek/deepseek-reasoner', label: 'DeepSeek R1', provider: 'deepseek' },
+    { id: 'ollama/llama3', label: 'Llama 3 (Ollama)', provider: 'ollama' },
+];
+/**
+ * Parse a modelId string (provider/modelId) into a ModelConfig.
+ * Falls back to DEFAULT_MODEL if the input is invalid.
+ *
+ * @param modelId - Format: "provider/modelId" (e.g. "google/gemini-3-flash-preview")
+ * @returns Parsed ModelConfig
+ */
+export function parseModelId(modelId) {
+    if (!modelId || !modelId.includes('/')) {
+        return CREWLY_AGENT_DEFAULTS.DEFAULT_MODEL;
+    }
+    const slashIdx = modelId.indexOf('/');
+    const provider = modelId.substring(0, slashIdx);
+    const model = modelId.substring(slashIdx + 1);
+    if (!isModelProvider(provider) || !model) {
+        return CREWLY_AGENT_DEFAULTS.DEFAULT_MODEL;
+    }
+    return {
+        provider,
+        modelId: model,
+        temperature: CREWLY_AGENT_DEFAULTS.DEFAULT_MODEL.temperature,
+        maxTokens: CREWLY_AGENT_DEFAULTS.DEFAULT_MODEL.maxTokens,
+    };
+}
+/**
+ * Type guard to check if an object is a valid ModelConfig
+ *
+ * @param obj - Object to validate
+ * @returns True if the object has all required ModelConfig fields
+ */
+export function isModelConfig(obj) {
+    if (typeof obj !== 'object' || obj === null)
+        return false;
+    const candidate = obj;
+    return (typeof candidate.provider === 'string' &&
+        isModelProvider(candidate.provider) &&
+        typeof candidate.modelId === 'string' &&
+        candidate.modelId.length > 0);
+}
+//# sourceMappingURL=types.js.map

package/dist/cli/backend/src/services/agent/crewly-agent/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../../../backend/src/services/agent/crewly-agent/types.ts"],"names":[],"mappings":"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"}

package/dist/cli/backend/src/services/agent/disk-cleanup.service.d.ts

@@ -0,0 +1,100 @@
+/**
+ * Disk Cleanup Service
+ *
+ * Handles cleanup of temporary files when agents are suspended and
+ * system-level cleanup of Docker resources and log files.
+ *
+ * Agent cleanup targets:
+ * - `~/.claude/debug/` — debug log files
+ * - `~/.claude/shell-snapshots/` — shell state snapshots
+ *
+ * System cleanup targets:
+ * - Docker dangling images and build cache
+ * - Docker stopped containers and unused volumes
+ * - Crewly log files older than 7 days
+ *
+ * @module disk-cleanup-service
+ */
+/**
+ * Statistics returned after a cleanup run.
+ */
+export interface CleanupStats {
+    /** Number of debug log files deleted */
+    debugLogsDeleted: number;
+    /** Number of shell snapshot files deleted */
+    shellSnapshotsDeleted: number;
+    /** Total bytes freed (approximate) */
+    bytesFreed: number;
+}
+/**
+ * Statistics returned after a system-level cleanup run.
+ */
+export interface SystemCleanupStats {
+    /** Whether Docker cleanup was executed */
+    dockerCleaned: boolean;
+    /** Textual summary of Docker cleanup output */
+    dockerOutput: string;
+    /** Number of Crewly log files deleted */
+    crewlyLogsDeleted: number;
+    /** Total bytes freed from log cleanup (approximate) */
+    logBytesFreed: number;
+}
+/**
+ * Handles disk cleanup on agent suspension.
+ *
+ * Targets the Claude Code data directories:
+ * - `~/.claude/debug/` — debug log files
+ * - `~/.claude/shell-snapshots/` — shell state snapshots
+ */
+export declare class DiskCleanupService {
+    private static instance;
+    private logger;
+    private claudeDir;
+    private constructor();
+    /**
+     * Get the singleton instance.
+     *
+     * @param claudeDir - Optional override for the Claude data directory (testing)
+     * @returns The DiskCleanupService singleton
+     */
+    static getInstance(claudeDir?: string): DiskCleanupService;
+    /**
+     * Reset the singleton (for testing).
+     */
+    static resetInstance(): void;
+    /**
+     * Purge debug log files older than the configured threshold.
+     *
+     * @param maxAgeHours - Maximum age in hours before deletion
+     * @returns Object with count of deleted files and bytes freed
+     */
+    purgeDebugLogs(maxAgeHours?: number): {
+        deleted: number;
+        bytesFreed: number;
+    };
+    /**
+     * Clear shell snapshot files.
+     *
+     * @returns Object with count of deleted files and bytes freed
+     */
+    clearShellSnapshots(): {
+        deleted: number;
+        bytesFreed: number;
+    };
+    /**
+     * Run the full suspend cleanup pipeline.
+     * Called by AgentSuspendService when suspending an agent.
+     *
+     * @returns Aggregate cleanup statistics
+     */
+    runSuspendCleanup(): CleanupStats;
+    /**
+     * Delete files in a directory older than the given threshold.
+     *
+     * @param dirPath - Directory to scan
+     * @param maxAgeHours - Maximum file age in hours (0 = delete all)
+     * @returns Object with count and bytes
+     */
+    private purgeOldFiles;
+}
+//# sourceMappingURL=disk-cleanup.service.d.ts.map

package/dist/cli/backend/src/services/agent/disk-cleanup.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"disk-cleanup.service.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/agent/disk-cleanup.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAeH;;GAEG;AACH,MAAM,WAAW,YAAY;IAC5B,wCAAwC;IACxC,gBAAgB,EAAE,MAAM,CAAC;IACzB,6CAA6C;IAC7C,qBAAqB,EAAE,MAAM,CAAC;IAC9B,sCAAsC;IACtC,UAAU,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAClC,0CAA0C;IAC1C,aAAa,EAAE,OAAO,CAAC;IACvB,+CAA+C;IAC/C,YAAY,EAAE,MAAM,CAAC;IACrB,yCAAyC;IACzC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,uDAAuD;IACvD,aAAa,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;GAMG;AACH,qBAAa,kBAAkB;IAC9B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAmC;IAC1D,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,SAAS,CAAS;IAE1B,OAAO;IAKP;;;;;OAKG;IACH,MAAM,CAAC,WAAW,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,kBAAkB;IAO1D;;OAEG;IACH,MAAM,CAAC,aAAa,IAAI,IAAI;IAI5B;;;;;OAKG;IACH,cAAc,CACb,WAAW,GAAE,MAAwD,GACnE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE;IAK1C;;;;OAIG;IACH,mBAAmB,IAAI;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE;IAM9D;;;;;OAKG;IACH,iBAAiB,IAAI,YAAY;IAqBjC;;;;;;OAMG;IACH,OAAO,CAAC,aAAa;CA4CrB"}

package/dist/cli/backend/src/services/agent/disk-cleanup.service.js

@@ -0,0 +1,149 @@
+/**
+ * Disk Cleanup Service
+ *
+ * Handles cleanup of temporary files when agents are suspended and
+ * system-level cleanup of Docker resources and log files.
+ *
+ * Agent cleanup targets:
+ * - `~/.claude/debug/` — debug log files
+ * - `~/.claude/shell-snapshots/` — shell state snapshots
+ *
+ * System cleanup targets:
+ * - Docker dangling images and build cache
+ * - Docker stopped containers and unused volumes
+ * - Crewly log files older than 7 days
+ *
+ * @module disk-cleanup-service
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import * as os from 'os';
+import { LoggerService } from '../core/logger.service.js';
+import { AGENT_SUSPEND_CONSTANTS } from '../../constants.js';
+/** Maximum age (in hours) for Crewly log files before cleanup */
+const CREWLY_LOG_MAX_AGE_HOURS = 168; // 7 days
+/** Timeout for Docker CLI commands in milliseconds */
+const DOCKER_COMMAND_TIMEOUT_MS = 30_000;
+/**
+ * Handles disk cleanup on agent suspension.
+ *
+ * Targets the Claude Code data directories:
+ * - `~/.claude/debug/` — debug log files
+ * - `~/.claude/shell-snapshots/` — shell state snapshots
+ */
+export class DiskCleanupService {
+    static instance = null;
+    logger;
+    claudeDir;
+    constructor(claudeDir) {
+        this.logger = LoggerService.getInstance().createComponentLogger('DiskCleanup');
+        this.claudeDir = claudeDir ?? path.join(os.homedir(), '.claude');
+    }
+    /**
+     * Get the singleton instance.
+     *
+     * @param claudeDir - Optional override for the Claude data directory (testing)
+     * @returns The DiskCleanupService singleton
+     */
+    static getInstance(claudeDir) {
+        if (!DiskCleanupService.instance) {
+            DiskCleanupService.instance = new DiskCleanupService(claudeDir);
+        }
+        return DiskCleanupService.instance;
+    }
+    /**
+     * Reset the singleton (for testing).
+     */
+    static resetInstance() {
+        DiskCleanupService.instance = null;
+    }
+    /**
+     * Purge debug log files older than the configured threshold.
+     *
+     * @param maxAgeHours - Maximum age in hours before deletion
+     * @returns Object with count of deleted files and bytes freed
+     */
+    purgeDebugLogs(maxAgeHours = AGENT_SUSPEND_CONSTANTS.DEBUG_LOG_MAX_AGE_HOURS) {
+        const debugDir = path.join(this.claudeDir, 'debug');
+        return this.purgeOldFiles(debugDir, maxAgeHours);
+    }
+    /**
+     * Clear shell snapshot files.
+     *
+     * @returns Object with count of deleted files and bytes freed
+     */
+    clearShellSnapshots() {
+        const snapshotsDir = path.join(this.claudeDir, 'shell-snapshots');
+        // Shell snapshots are ephemeral — clear all of them on suspend
+        return this.purgeOldFiles(snapshotsDir, 0);
+    }
+    /**
+     * Run the full suspend cleanup pipeline.
+     * Called by AgentSuspendService when suspending an agent.
+     *
+     * @returns Aggregate cleanup statistics
+     */
+    runSuspendCleanup() {
+        this.logger.info('Running suspend disk cleanup...');
+        const debugResult = this.purgeDebugLogs();
+        const snapshotResult = this.clearShellSnapshots();
+        const stats = {
+            debugLogsDeleted: debugResult.deleted,
+            shellSnapshotsDeleted: snapshotResult.deleted,
+            bytesFreed: debugResult.bytesFreed + snapshotResult.bytesFreed,
+        };
+        this.logger.info('Suspend disk cleanup complete', {
+            debugLogsDeleted: stats.debugLogsDeleted,
+            shellSnapshotsDeleted: stats.shellSnapshotsDeleted,
+            bytesFreedMB: (stats.bytesFreed / (1024 * 1024)).toFixed(2),
+        });
+        return stats;
+    }
+    /**
+     * Delete files in a directory older than the given threshold.
+     *
+     * @param dirPath - Directory to scan
+     * @param maxAgeHours - Maximum file age in hours (0 = delete all)
+     * @returns Object with count and bytes
+     */
+    purgeOldFiles(dirPath, maxAgeHours) {
+        let deleted = 0;
+        let bytesFreed = 0;
+        if (!fs.existsSync(dirPath)) {
+            return { deleted, bytesFreed };
+        }
+        const cutoffMs = maxAgeHours * 60 * 60 * 1000;
+        const now = Date.now();
+        try {
+            const entries = fs.readdirSync(dirPath);
+            for (const entry of entries) {
+                const filePath = path.join(dirPath, entry);
+                try {
+                    const stat = fs.statSync(filePath);
+                    if (!stat.isFile())
+                        continue;
+                    // When maxAgeHours is 0, delete all files regardless of timing precision
+                    if (cutoffMs === 0 || (now - stat.mtimeMs) >= cutoffMs) {
+                        fs.unlinkSync(filePath);
+                        deleted++;
+                        bytesFreed += stat.size;
+                    }
+                }
+                catch (fileErr) {
+                    this.logger.debug('Failed to process file during cleanup', {
+                        filePath,
+                        error: fileErr instanceof Error ? fileErr.message : String(fileErr),
+                    });
+                }
+            }
+        }
+        catch (err) {
+            this.logger.warn('Failed to read directory for cleanup', {
+                dirPath,
+                error: err instanceof Error ? err.message : String(err),
+            });
+        }
+        return { deleted, bytesFreed };
+    }
+}
+//# sourceMappingURL=disk-cleanup.service.js.map

package/dist/cli/backend/src/services/agent/disk-cleanup.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"disk-cleanup.service.js","sourceRoot":"","sources":["../../../../../../backend/src/services/agent/disk-cleanup.service.ts"],"names":[],"mappings":"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"}