@calliopelabs/cli 0.8.20 → 2.0.2

package/dist/checkpoint.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Calliope CLI - Checkpoint/Restore Module (#20)
+ *
+ * Saves file content before overwrites so users can restore previous versions.
+ * Checkpoints are stored as individual JSON files in ~/.calliope-cli/checkpoints/
+ * organized by session date.
+ */
+export interface Checkpoint {
+    filePath: string;
+    content: string;
+    timestamp: string;
+    sessionId?: string;
+}
+export interface CheckpointSummary {
+    file: string;
+    filePath: string;
+    timestamp: string;
+    sessionId?: string;
+    size: number;
+}
+/**
+ * Returns the checkpoint directory path (~/.calliope-cli/checkpoints/).
+ */
+export declare function getCheckpointDir(): string;
+/**
+ * Create a checkpoint for a file before it gets overwritten.
+ * If content is provided, uses that; otherwise reads current content from disk.
+ * Returns the checkpoint filename on success, or undefined if the file doesn't exist
+ * and no content was provided.
+ */
+export declare function createCheckpoint(filePath: string, content?: string, sessionId?: string): string | undefined;
+/**
+ * Restore a file from its most recent checkpoint (or a specific index).
+ * Index 0 = most recent, 1 = second most recent, etc.
+ * Returns the restored content, or undefined if no checkpoint found.
+ */
+export declare function restoreCheckpoint(filePath: string, index?: number): string | undefined;
+/**
+ * List available checkpoints, optionally filtered by file path.
+ * Returns summaries sorted newest-first.
+ */
+export declare function listCheckpoints(filePath?: string): CheckpointSummary[];
+/**
+ * Clean up old checkpoints. If olderThanDays is provided, removes checkpoints
+ * older than that many days. If omitted, removes all checkpoints.
+ * Returns the number of checkpoints removed.
+ */
+export declare function clearCheckpoints(olderThanDays?: number): number;
+//# sourceMappingURL=checkpoint.d.ts.map

package/dist/checkpoint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkpoint.d.ts","sourceRoot":"","sources":["../src/checkpoint.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAUH,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;CACd;AAMD;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CAMzC;AA0BD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CA2C3G;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,GAAE,MAAU,GAAG,MAAM,GAAG,SAAS,CAiBzF;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,iBAAiB,EAAE,CAsCtE;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,MAAM,CAiC/D"}

package/dist/checkpoint.js

@@ -0,0 +1,219 @@
+/**
+ * Calliope CLI - Checkpoint/Restore Module (#20)
+ *
+ * Saves file content before overwrites so users can restore previous versions.
+ * Checkpoints are stored as individual JSON files in ~/.calliope-cli/checkpoints/
+ * organized by session date.
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import * as os from 'os';
+// ============================================================================
+// Directory Management
+// ============================================================================
+/**
+ * Returns the checkpoint directory path (~/.calliope-cli/checkpoints/).
+ */
+export function getCheckpointDir() {
+    const dir = path.join(os.homedir(), '.calliope-cli', 'checkpoints');
+    if (!fs.existsSync(dir)) {
+        fs.mkdirSync(dir, { recursive: true });
+    }
+    return dir;
+}
+let checkpointCounter = 0;
+/** Auto-cleanup: remove checkpoints older than this many days */
+const AUTO_CLEANUP_DAYS = 7;
+/** Minimum interval between auto-cleanup runs (1 hour in ms) */
+const AUTO_CLEANUP_INTERVAL = 60 * 60 * 1000;
+/** Timestamp of last auto-cleanup run */
+let lastAutoCleanup = 0;
+/**
+ * Generate a unique checkpoint filename from a timestamp.
+ */
+function makeFilename(timestamp) {
+    // Replace colons and dots for filesystem safety + add counter to avoid same-millisecond collisions
+    const counter = String(checkpointCounter++).padStart(4, '0');
+    return `checkpoint-${timestamp.replace(/[:\.]/g, '-')}-${counter}.json`;
+}
+// ============================================================================
+// Core API
+// ============================================================================
+/**
+ * Create a checkpoint for a file before it gets overwritten.
+ * If content is provided, uses that; otherwise reads current content from disk.
+ * Returns the checkpoint filename on success, or undefined if the file doesn't exist
+ * and no content was provided.
+ */
+export function createCheckpoint(filePath, content, sessionId) {
+    // Auto-cleanup old checkpoints periodically (at most once per hour)
+    const now = Date.now();
+    if (now - lastAutoCleanup > AUTO_CLEANUP_INTERVAL) {
+        lastAutoCleanup = now;
+        try {
+            clearCheckpoints(AUTO_CLEANUP_DAYS);
+        }
+        catch {
+            // Don't let cleanup errors block checkpoint creation
+        }
+    }
+    const absPath = path.resolve(filePath);
+    // Determine content to save
+    let fileContent;
+    if (content !== undefined) {
+        fileContent = content;
+    }
+    else {
+        try {
+            if (!fs.existsSync(absPath)) {
+                return undefined;
+            }
+            fileContent = fs.readFileSync(absPath, 'utf-8');
+        }
+        catch {
+            return undefined;
+        }
+    }
+    const timestamp = new Date().toISOString();
+    const checkpoint = {
+        filePath: absPath,
+        content: fileContent,
+        timestamp,
+        ...(sessionId ? { sessionId } : {}),
+    };
+    const dir = getCheckpointDir();
+    const filename = makeFilename(timestamp);
+    const fullPath = path.join(dir, filename);
+    fs.writeFileSync(fullPath, JSON.stringify(checkpoint, null, 2));
+    return filename;
+}
+/**
+ * Restore a file from its most recent checkpoint (or a specific index).
+ * Index 0 = most recent, 1 = second most recent, etc.
+ * Returns the restored content, or undefined if no checkpoint found.
+ */
+export function restoreCheckpoint(filePath, index = 0) {
+    const absPath = path.resolve(filePath);
+    const checkpoints = getCheckpointsForFile(absPath);
+    if (index < 0 || index >= checkpoints.length) {
+        return undefined;
+    }
+    const checkpoint = checkpoints[index];
+    // Write the content back to the original file
+    const dir = path.dirname(absPath);
+    if (!fs.existsSync(dir)) {
+        fs.mkdirSync(dir, { recursive: true });
+    }
+    fs.writeFileSync(absPath, checkpoint.content);
+    return checkpoint.content;
+}
+/**
+ * List available checkpoints, optionally filtered by file path.
+ * Returns summaries sorted newest-first.
+ */
+export function listCheckpoints(filePath) {
+    const dir = getCheckpointDir();
+    let files;
+    try {
+        files = fs.readdirSync(dir).filter(f => f.startsWith('checkpoint-') && f.endsWith('.json'));
+    }
+    catch {
+        return [];
+    }
+    const summaries = [];
+    for (const file of files) {
+        try {
+            const raw = fs.readFileSync(path.join(dir, file), 'utf-8');
+            const cp = JSON.parse(raw);
+            // Filter by file path if specified
+            if (filePath) {
+                const absFilter = path.resolve(filePath);
+                if (cp.filePath !== absFilter)
+                    continue;
+            }
+            summaries.push({
+                file,
+                filePath: cp.filePath,
+                timestamp: cp.timestamp,
+                sessionId: cp.sessionId,
+                size: cp.content.length,
+            });
+        }
+        catch {
+            // Skip corrupted checkpoint files
+        }
+    }
+    // Sort newest first
+    summaries.sort((a, b) => b.timestamp.localeCompare(a.timestamp));
+    return summaries;
+}
+/**
+ * Clean up old checkpoints. If olderThanDays is provided, removes checkpoints
+ * older than that many days. If omitted, removes all checkpoints.
+ * Returns the number of checkpoints removed.
+ */
+export function clearCheckpoints(olderThanDays) {
+    const dir = getCheckpointDir();
+    let files;
+    try {
+        files = fs.readdirSync(dir).filter(f => f.startsWith('checkpoint-') && f.endsWith('.json'));
+    }
+    catch {
+        return 0;
+    }
+    const cutoff = olderThanDays !== undefined
+        ? new Date(Date.now() - olderThanDays * 24 * 60 * 60 * 1000)
+        : null;
+    let removed = 0;
+    for (const file of files) {
+        const fullPath = path.join(dir, file);
+        try {
+            if (cutoff) {
+                const raw = fs.readFileSync(fullPath, 'utf-8');
+                const cp = JSON.parse(raw);
+                const cpDate = new Date(cp.timestamp);
+                if (cpDate >= cutoff)
+                    continue;
+            }
+            fs.unlinkSync(fullPath);
+            removed++;
+        }
+        catch {
+            // Skip files that can't be read/deleted
+        }
+    }
+    return removed;
+}
+// ============================================================================
+// Internal Helpers
+// ============================================================================
+/**
+ * Get all checkpoints for a specific file path, sorted newest-first.
+ */
+function getCheckpointsForFile(absPath) {
+    const dir = getCheckpointDir();
+    let files;
+    try {
+        files = fs.readdirSync(dir).filter(f => f.startsWith('checkpoint-') && f.endsWith('.json'));
+    }
+    catch {
+        return [];
+    }
+    const checkpoints = [];
+    for (const file of files) {
+        try {
+            const raw = fs.readFileSync(path.join(dir, file), 'utf-8');
+            const cp = JSON.parse(raw);
+            if (cp.filePath === absPath) {
+                checkpoints.push(cp);
+            }
+        }
+        catch {
+            // Skip corrupted files
+        }
+    }
+    // Sort newest first
+    checkpoints.sort((a, b) => b.timestamp.localeCompare(a.timestamp));
+    return checkpoints;
+}
+//# sourceMappingURL=checkpoint.js.map

package/dist/checkpoint.js.map

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

package/dist/circuit-breaker/breaker.d.ts

@@ -0,0 +1,80 @@
+/**
+ * Circuit Breaker
+ *
+ * Framework-agnostic circuit breaker that monitors agent loop iterations
+ * and trips on bad behavior patterns. State machine: closed → open → half-open.
+ *
+ * When tripped (open), the agent loop should pause and notify the user.
+ * User can resume (half-open) which runs at reduced thresholds (50%).
+ */
+import type { BreakerType, BreakerStatus, BreakerCheckResult, CircuitBreakerConfig, IterationData } from './types.js';
+export declare class CircuitBreaker {
+    private config;
+    private states;
+    private tripCounts;
+    private lastTripped;
+    private lastEvents;
+    private consecutiveErrors;
+    private totalTokens;
+    private totalCost;
+    private idleCount;
+    private costWindow;
+    private toolCallHistory;
+    private startTime;
+    private lastIterationStart;
+    constructor(config?: Partial<CircuitBreakerConfig>);
+    /**
+     * Check all breakers against iteration data. Returns the first trip found.
+     */
+    check(data: IterationData): BreakerCheckResult;
+    /**
+     * Resume a tripped breaker (moves to half-open state with 50% thresholds).
+     */
+    resume(type?: BreakerType): void;
+    /**
+     * Reset a specific breaker or all breakers to closed.
+     */
+    reset(type?: BreakerType): void;
+    /**
+     * Update thresholds for a specific breaker at runtime.
+     */
+    adjust(type: BreakerType, thresholds: Record<string, unknown>): void;
+    /**
+     * Get status of all breakers.
+     */
+    getStatus(): BreakerStatus[];
+    /**
+     * Get overall health: 'ok' | 'warning' | 'tripped'
+     */
+    getHealth(): 'ok' | 'warning' | 'tripped';
+    /**
+     * Check if any breaker is currently tripped (open state).
+     */
+    isTripped(): boolean;
+    /**
+     * Get the current config.
+     */
+    getConfig(): CircuitBreakerConfig;
+    /**
+     * Get tracking stats for display.
+     */
+    getTrackingStats(): {
+        consecutiveErrors: number;
+        totalTokens: number;
+        totalCost: number;
+        idleCount: number;
+        recentToolCalls: number;
+    };
+    private updateTracking;
+    private resetTrackingForBreaker;
+    private resetAllTracking;
+    private trip;
+    private getThresholdMultiplier;
+    private checkRepeatedFailure;
+    private checkCostRunaway;
+    private checkInfiniteLoop;
+    private checkTokenBurn;
+    private checkStall;
+    private checkWallClock;
+}
+//# sourceMappingURL=breaker.d.ts.map

package/dist/circuit-breaker/breaker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"breaker.d.ts","sourceRoot":"","sources":["../../src/circuit-breaker/breaker.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EACV,WAAW,EAEX,aAAa,EAEb,kBAAkB,EAClB,oBAAoB,EACpB,aAAa,EACd,MAAM,YAAY,CAAC;AAmBpB,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAuB;IAGrC,OAAO,CAAC,MAAM,CAA6C;IAC3D,OAAO,CAAC,UAAU,CAAuC;IACzD,OAAO,CAAC,WAAW,CAAqC;IACxD,OAAO,CAAC,UAAU,CAA6C;IAG/D,OAAO,CAAC,iBAAiB,CAAK;IAC9B,OAAO,CAAC,WAAW,CAAK;IACxB,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,UAAU,CAAkD;IACpE,OAAO,CAAC,eAAe,CAAgB;IACvC,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,kBAAkB,CAAK;gBAEnB,MAAM,CAAC,EAAE,OAAO,CAAC,oBAAoB,CAAC;IAoClD;;OAEG;IACH,KAAK,CAAC,IAAI,EAAE,aAAa,GAAG,kBAAkB;IA4B9C;;OAEG;IACH,MAAM,CAAC,IAAI,CAAC,EAAE,WAAW,GAAG,IAAI;IAehC;;OAEG;IACH,KAAK,CAAC,IAAI,CAAC,EAAE,WAAW,GAAG,IAAI;IAY/B;;OAEG;IACH,MAAM,CAAC,IAAI,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAKpE;;OAEG;IACH,SAAS,IAAI,aAAa,EAAE;IAW5B;;OAEG;IACH,SAAS,IAAI,IAAI,GAAG,SAAS,GAAG,SAAS;IASzC;;OAEG;IACH,SAAS,IAAI,OAAO;IAOpB;;OAEG;IACH,SAAS,IAAI,oBAAoB;IAIjC;;OAEG;IACH,gBAAgB,IAAI;QAClB,iBAAiB,EAAE,MAAM,CAAC;QAC1B,WAAW,EAAE,MAAM,CAAC;QACpB,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC;QAClB,eAAe,EAAE,MAAM,CAAC;KACzB;IAcD,OAAO,CAAC,cAAc;IAyCtB,OAAO,CAAC,uBAAuB;IAuB/B,OAAO,CAAC,gBAAgB;IAexB,OAAO,CAAC,IAAI;IAWZ,OAAO,CAAC,sBAAsB;IAK9B,OAAO,CAAC,oBAAoB;IAiB5B,OAAO,CAAC,gBAAgB;IA+BxB,OAAO,CAAC,iBAAiB;IA4CzB,OAAO,CAAC,cAAc;IA6BtB,OAAO,CAAC,UAAU;IAiBlB,OAAO,CAAC,cAAc;CAuCvB"}