@llmtune/cli 0.1.9 → 0.2.0

package/dist/utils/rate-limit.js

@@ -0,0 +1,71 @@
+"use strict";
+/**
+ * Simple rate limiter for tool calls.
+ * Prevents runaway agent loops from hammering the system.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RateLimiter = void 0;
+const DEFAULT_CONFIG = {
+    maxCalls: 60,
+    windowMs: 60_000, // 1 minute
+    perTool: {
+        bash: { maxCalls: 30, windowMs: 60_000 },
+        write: { maxCalls: 40, windowMs: 60_000 },
+        edit: { maxCalls: 40, windowMs: 60_000 },
+        web_fetch: { maxCalls: 20, windowMs: 60_000 },
+    },
+};
+class RateLimiter {
+    calls = new Map();
+    config;
+    constructor(config) {
+        this.config = { ...DEFAULT_CONFIG, ...config };
+    }
+    /**
+     * Check if a tool call is allowed. Returns true if allowed, false if rate limited.
+     */
+    isAllowed(toolName) {
+        const now = Date.now();
+        const records = this.getRecords(toolName);
+        // Clean up old records
+        const windowMs = this.getWindowMs(toolName);
+        const cutoff = now - windowMs;
+        const recent = records.filter((r) => r.timestamp > cutoff);
+        const maxCalls = this.getMaxCalls(toolName);
+        if (recent.length >= maxCalls) {
+            return false;
+        }
+        // Record this call
+        recent.push({ timestamp: now });
+        this.calls.set(toolName, recent);
+        return true;
+    }
+    /**
+     * Get the number of remaining calls for a tool in the current window.
+     */
+    remaining(toolName) {
+        const now = Date.now();
+        const records = this.getRecords(toolName);
+        const windowMs = this.getWindowMs(toolName);
+        const cutoff = now - windowMs;
+        const recent = records.filter((r) => r.timestamp > cutoff);
+        return Math.max(0, this.getMaxCalls(toolName) - recent.length);
+    }
+    /**
+     * Reset rate limit state (e.g., on new session).
+     */
+    reset() {
+        this.calls.clear();
+    }
+    getRecords(toolName) {
+        return this.calls.get(toolName) ?? [];
+    }
+    getMaxCalls(toolName) {
+        return this.config.perTool?.[toolName]?.maxCalls ?? this.config.maxCalls;
+    }
+    getWindowMs(toolName) {
+        return this.config.perTool?.[toolName]?.windowMs ?? this.config.windowMs;
+    }
+}
+exports.RateLimiter = RateLimiter;
+//# sourceMappingURL=rate-limit.js.map

package/dist/utils/rate-limit.js.map

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

package/dist/utils/retry.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Retry utility for API calls with exponential backoff.
+ * Handles rate limits (429), server errors (500/502/503), and network issues.
+ */
+export interface RetryOptions {
+    maxRetries?: number;
+    baseDelayMs?: number;
+    maxDelayMs?: number;
+    /** Retry on these error patterns (string match against error message) */
+    retryableErrors?: string[];
+    /** Called before each retry with attempt number and delay */
+    onRetry?: (attempt: number, delay: number, error: Error) => void;
+}
+export declare class RetryableError extends Error {
+    readonly statusCode?: number | undefined;
+    constructor(message: string, statusCode?: number | undefined);
+}
+/**
+ * Determine if an error is retryable (rate limit, server error, network issue).
+ */
+export declare function isRetryableError(err: unknown): boolean;
+/**
+ * Execute a function with retry logic and exponential backoff + jitter.
+ */
+export declare function withRetry<T>(fn: () => Promise<T>, options?: RetryOptions): Promise<T>;
+//# sourceMappingURL=retry.d.ts.map

package/dist/utils/retry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../../src/utils/retry.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,MAAM,WAAW,YAAY;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,yEAAyE;IACzE,eAAe,CAAC,EAAE,MAAM,EAAE,CAAA;IAC1B,6DAA6D;IAC7D,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,KAAK,IAAI,CAAA;CACjE;AAED,qBAAa,cAAe,SAAQ,KAAK;aACM,UAAU,CAAC,EAAE,MAAM;gBAApD,OAAO,EAAE,MAAM,EAAkB,UAAU,CAAC,EAAE,MAAM,YAAA;CAIjE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAyBtD;AAED;;GAEG;AACH,wBAAsB,SAAS,CAAC,CAAC,EAC/B,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,OAAO,GAAE,YAAiB,GACzB,OAAO,CAAC,CAAC,CAAC,CAyCZ"}

package/dist/utils/retry.js

@@ -0,0 +1,96 @@
+"use strict";
+/**
+ * Retry utility for API calls with exponential backoff.
+ * Handles rate limits (429), server errors (500/502/503), and network issues.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RetryableError = void 0;
+exports.isRetryableError = isRetryableError;
+exports.withRetry = withRetry;
+const DEFAULT_MAX_RETRIES = 3;
+const DEFAULT_BASE_DELAY_MS = 1000;
+const DEFAULT_MAX_DELAY_MS = 30_000;
+class RetryableError extends Error {
+    statusCode;
+    constructor(message, statusCode) {
+        super(message);
+        this.statusCode = statusCode;
+        this.name = "RetryableError";
+    }
+}
+exports.RetryableError = RetryableError;
+/**
+ * Determine if an error is retryable (rate limit, server error, network issue).
+ */
+function isRetryableError(err) {
+    if (err instanceof RetryableError)
+        return true;
+    if (err && typeof err === "object") {
+        const e = err;
+        // OpenAI API error structure
+        if (e.status === 429)
+            return true; // Rate limit
+        if (e.status === 500)
+            return true; // Internal server error
+        if (e.status === 502)
+            return true; // Bad gateway
+        if (e.status === 503)
+            return true; // Service unavailable
+        if (e.status === 529)
+            return true; // Overloaded
+        // Network errors
+        const msg = String(e.message ?? "");
+        if (msg.includes("ECONNRESET"))
+            return true;
+        if (msg.includes("ECONNREFUSED"))
+            return true;
+        if (msg.includes("ETIMEDOUT"))
+            return true;
+        if (msg.includes("socket hang up"))
+            return true;
+        if (msg.includes("network"))
+            return true;
+        if (msg.includes("fetch failed"))
+            return true;
+        if (msg.includes("abort"))
+            return true;
+    }
+    return false;
+}
+/**
+ * Execute a function with retry logic and exponential backoff + jitter.
+ */
+async function withRetry(fn, options = {}) {
+    const { maxRetries = DEFAULT_MAX_RETRIES, baseDelayMs = DEFAULT_BASE_DELAY_MS, maxDelayMs = DEFAULT_MAX_DELAY_MS, onRetry, } = options;
+    let lastError;
+    for (let attempt = 0; attempt <= maxRetries; attempt++) {
+        try {
+            return await fn();
+        }
+        catch (err) {
+            const error = err instanceof Error ? err : new Error(String(err));
+            lastError = error;
+            // Don't retry non-retryable errors
+            if (!isRetryableError(err)) {
+                throw error;
+            }
+            // Don't retry if we've exhausted attempts
+            if (attempt >= maxRetries) {
+                throw error;
+            }
+            // Calculate delay with exponential backoff + jitter
+            const exponentialDelay = baseDelayMs * Math.pow(2, attempt);
+            const jitter = Math.random() * baseDelayMs;
+            const delay = Math.min(exponentialDelay + jitter, maxDelayMs);
+            if (onRetry) {
+                onRetry(attempt + 1, delay, error);
+            }
+            await sleep(delay);
+        }
+    }
+    throw lastError ?? new Error("Retry failed with unknown error");
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=retry.js.map

package/dist/utils/retry.js.map

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

package/dist/utils/spinner.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Lightweight "thinking" spinner shown while waiting for LLM responses.
+ * Uses only ASCII characters for maximum terminal compatibility.
+ */
+export interface Spinner {
+    start(label?: string): void;
+    update(label: string): void;
+    stop(): void;
+    isSpinning(): boolean;
+}
+export declare function createSpinner(): Spinner;
+//# sourceMappingURL=spinner.d.ts.map

package/dist/utils/spinner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spinner.d.ts","sourceRoot":"","sources":["../../src/utils/spinner.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,MAAM,WAAW,OAAO;IACtB,KAAK,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,IAAI,IAAI,IAAI,CAAA;IACZ,UAAU,IAAI,OAAO,CAAA;CACtB;AAED,wBAAgB,aAAa,IAAI,OAAO,CA4CvC"}

package/dist/utils/spinner.js

@@ -0,0 +1,51 @@
+"use strict";
+/**
+ * Lightweight "thinking" spinner shown while waiting for LLM responses.
+ * Uses only ASCII characters for maximum terminal compatibility.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createSpinner = createSpinner;
+const SPINNER_FRAMES = ["⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⦶", "⠧", "⠇", "⠏"];
+const INTERVAL_MS = 80;
+function createSpinner() {
+    let frameIndex = 0;
+    let timer = null;
+    let active = false;
+    let currentLabel = "Thinking";
+    return {
+        start(label) {
+            if (active)
+                return;
+            active = true;
+            currentLabel = label ?? "Thinking";
+            frameIndex = 0;
+            // Hide cursor for cleaner look
+            process.stdout.write("\x1B[?25l");
+            timer = setInterval(() => {
+                const frame = SPINNER_FRAMES[frameIndex % SPINNER_FRAMES.length];
+                process.stdout.write(`\r  ${frame} ${currentLabel}...`);
+                frameIndex++;
+            }, INTERVAL_MS);
+        },
+        update(label) {
+            currentLabel = label;
+        },
+        stop() {
+            if (!active)
+                return;
+            active = false;
+            if (timer) {
+                clearInterval(timer);
+                timer = null;
+            }
+            // Clear the spinner line
+            process.stdout.write("\r" + " ".repeat(currentLabel.length + 20) + "\r");
+            // Show cursor again
+            process.stdout.write("\x1B[?25h");
+        },
+        isSpinning() {
+            return active;
+        },
+    };
+}
+//# sourceMappingURL=spinner.js.map

package/dist/utils/spinner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spinner.js","sourceRoot":"","sources":["../../src/utils/spinner.ts"],"names":[],"mappings":";AAAA;;;GAGG;;AAYH,sCA4CC;AAtDD,MAAM,cAAc,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAA;AACzE,MAAM,WAAW,GAAG,EAAE,CAAA;AAStB,SAAgB,aAAa;IAC3B,IAAI,UAAU,GAAG,CAAC,CAAA;IAClB,IAAI,KAAK,GAA0C,IAAI,CAAA;IACvD,IAAI,MAAM,GAAG,KAAK,CAAA;IAClB,IAAI,YAAY,GAAG,UAAU,CAAA;IAE7B,OAAO;QACL,KAAK,CAAC,KAAc;YAClB,IAAI,MAAM;gBAAE,OAAM;YAClB,MAAM,GAAG,IAAI,CAAA;YACb,YAAY,GAAG,KAAK,IAAI,UAAU,CAAA;YAClC,UAAU,GAAG,CAAC,CAAA;YAEd,+BAA+B;YAC/B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,CAAA;YAEjC,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE;gBACvB,MAAM,KAAK,GAAG,cAAc,CAAC,UAAU,GAAG,cAAc,CAAC,MAAM,CAAC,CAAA;gBAChE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,KAAK,IAAI,YAAY,KAAK,CAAC,CAAA;gBACvD,UAAU,EAAE,CAAA;YACd,CAAC,EAAE,WAAW,CAAC,CAAA;QACjB,CAAC;QAED,MAAM,CAAC,KAAa;YAClB,YAAY,GAAG,KAAK,CAAA;QACtB,CAAC;QAED,IAAI;YACF,IAAI,CAAC,MAAM;gBAAE,OAAM;YACnB,MAAM,GAAG,KAAK,CAAA;YACd,IAAI,KAAK,EAAE,CAAC;gBACV,aAAa,CAAC,KAAK,CAAC,CAAA;gBACpB,KAAK,GAAG,IAAI,CAAA;YACd,CAAC;YACD,yBAAyB;YACzB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,YAAY,CAAC,MAAM,GAAG,EAAE,CAAC,GAAG,IAAI,CAAC,CAAA;YACxE,oBAAoB;YACpB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,CAAA;QACnC,CAAC;QAED,UAAU;YACR,OAAO,MAAM,CAAA;QACf,CAAC;KACF,CAAA;AACH,CAAC"}

package/dist/utils/stats.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Session statistics tracker.
+ * Tracks token usage, tool calls, timing, and costs for the current session.
+ */
+export interface SessionStats {
+    startTime: number;
+    totalInputTokens: number;
+    totalOutputTokens: number;
+    totalToolCalls: number;
+    toolCallCounts: Record<string, number>;
+    llmCalls: number;
+    compactCount: number;
+    tokensSavedByCompact: number;
+    errors: number;
+}
+export declare class StatsTracker {
+    private stats;
+    constructor();
+    recordLLMCall(inputTokens: number, outputTokens: number): void;
+    recordToolCall(toolName: string): void;
+    recordCompact(tokensSaved: number): void;
+    recordError(): void;
+    getStats(): Readonly<SessionStats>;
+    getElapsedTime(): string;
+    getEstimatedCost(): number;
+    getSummary(): string;
+    reset(): void;
+}
+//# sourceMappingURL=stats.d.ts.map

package/dist/utils/stats.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stats.d.ts","sourceRoot":"","sources":["../../src/utils/stats.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,MAAM,CAAA;IACjB,gBAAgB,EAAE,MAAM,CAAA;IACxB,iBAAiB,EAAE,MAAM,CAAA;IACzB,cAAc,EAAE,MAAM,CAAA;IACtB,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACtC,QAAQ,EAAE,MAAM,CAAA;IAChB,YAAY,EAAE,MAAM,CAAA;IACpB,oBAAoB,EAAE,MAAM,CAAA;IAC5B,MAAM,EAAE,MAAM,CAAA;CACf;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,KAAK,CAAc;;IAgB3B,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,IAAI;IAM9D,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAKtC,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAKxC,WAAW,IAAI,IAAI;IAInB,QAAQ,IAAI,QAAQ,CAAC,YAAY,CAAC;IAIlC,cAAc,IAAI,MAAM;IAWxB,gBAAgB,IAAI,MAAM;IAO1B,UAAU,IAAI,MAAM;IA6BpB,KAAK,IAAI,IAAI;CAad"}

package/dist/utils/stats.js

@@ -0,0 +1,95 @@
+"use strict";
+/**
+ * Session statistics tracker.
+ * Tracks token usage, tool calls, timing, and costs for the current session.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StatsTracker = void 0;
+class StatsTracker {
+    stats;
+    constructor() {
+        this.stats = {
+            startTime: Date.now(),
+            totalInputTokens: 0,
+            totalOutputTokens: 0,
+            totalToolCalls: 0,
+            toolCallCounts: {},
+            llmCalls: 0,
+            compactCount: 0,
+            tokensSavedByCompact: 0,
+            errors: 0,
+        };
+    }
+    recordLLMCall(inputTokens, outputTokens) {
+        this.stats.llmCalls++;
+        this.stats.totalInputTokens += inputTokens;
+        this.stats.totalOutputTokens += outputTokens;
+    }
+    recordToolCall(toolName) {
+        this.stats.totalToolCalls++;
+        this.stats.toolCallCounts[toolName] = (this.stats.toolCallCounts[toolName] ?? 0) + 1;
+    }
+    recordCompact(tokensSaved) {
+        this.stats.compactCount++;
+        this.stats.tokensSavedByCompact += tokensSaved;
+    }
+    recordError() {
+        this.stats.errors++;
+    }
+    getStats() {
+        return this.stats;
+    }
+    getElapsedTime() {
+        const elapsed = Date.now() - this.stats.startTime;
+        const seconds = Math.floor(elapsed / 1000);
+        const minutes = Math.floor(seconds / 60);
+        const hours = Math.floor(minutes / 60);
+        if (hours > 0)
+            return `${hours}h ${minutes % 60}m`;
+        if (minutes > 0)
+            return `${minutes}m ${seconds % 60}s`;
+        return `${seconds}s`;
+    }
+    getEstimatedCost() {
+        // Approximate pricing per 1M tokens
+        return ((this.stats.totalInputTokens * 3 + this.stats.totalOutputTokens * 15) / 1_000_000);
+    }
+    getSummary() {
+        const lines = [];
+        lines.push(`  Duration:      ${this.getElapsedTime()}`);
+        lines.push(`  LLM calls:     ${this.stats.llmCalls}`);
+        lines.push(`  Input tokens:  ${this.stats.totalInputTokens.toLocaleString()}`);
+        lines.push(`  Output tokens: ${this.stats.totalOutputTokens.toLocaleString()}`);
+        lines.push(`  Tool calls:    ${this.stats.totalToolCalls}`);
+        // Top tools
+        const topTools = Object.entries(this.stats.toolCallCounts)
+            .sort((a, b) => b[1] - a[1])
+            .slice(0, 5);
+        if (topTools.length > 0) {
+            lines.push(`  Top tools:     ${topTools.map(([name, count]) => `${name}(${count})`).join(", ")}`);
+        }
+        if (this.stats.compactCount > 0) {
+            lines.push(`  Compactions:   ${this.stats.compactCount} (${this.stats.tokensSavedByCompact.toLocaleString()} tokens saved)`);
+        }
+        if (this.stats.errors > 0) {
+            lines.push(`  Errors:        ${this.stats.errors}`);
+        }
+        lines.push(`  Est. cost:     $${this.getEstimatedCost().toFixed(4)}`);
+        return lines.join("\n");
+    }
+    reset() {
+        this.stats = {
+            startTime: Date.now(),
+            totalInputTokens: 0,
+            totalOutputTokens: 0,
+            totalToolCalls: 0,
+            toolCallCounts: {},
+            llmCalls: 0,
+            compactCount: 0,
+            tokensSavedByCompact: 0,
+            errors: 0,
+        };
+    }
+}
+exports.StatsTracker = StatsTracker;
+//# sourceMappingURL=stats.js.map

package/dist/utils/stats.js.map

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

package/dist/utils/streaming.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"streaming.d.ts","sourceRoot":"","sources":["../../src/utils/streaming.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,wBAAgB,sBAAsB;mBAMnB,MAAM,GAAG,IAAI;IAU5B,mEAAmE;aAC1D,IAAI;iBAOA,MAAM;EAItB;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAejF;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,MAAM,CAKtE"}

package/dist/utils/streaming.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"streaming.js","sourceRoot":"","sources":["../../src/utils/streaming.ts"],"names":[],"mappings":";AAAA;;;GAGG;;AAEH,wDA4BC;AAED,oCAeC;AAED,4CAKC;AApDD,SAAgB,sBAAsB;IACpC,IAAI,MAAM,GAAG,EAAE,CAAA;IACf,IAAI,cAAc,GAAG,CAAC,CAAA;IACtB,MAAM,kBAAkB,GAAG,EAAE,CAAA;IAE7B,OAAO;QACL,OAAO,CAAC,KAAa;YACnB,MAAM,IAAI,KAAK,CAAA;YACf,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;YACtB,IAAI,GAAG,GAAG,cAAc,IAAI,kBAAkB,EAAE,CAAC;gBAC/C,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;gBAC5B,MAAM,GAAG,EAAE,CAAA;gBACX,cAAc,GAAG,GAAG,CAAA;YACtB,CAAC;QACH,CAAC;QAED,mEAAmE;QACnE,KAAK;YACH,IAAI,MAAM,EAAE,CAAC;gBACX,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;gBAC5B,MAAM,GAAG,EAAE,CAAA;YACb,CAAC;QACH,CAAC;QAED,SAAS;YACP,OAAO,MAAM,CAAA;QACf,CAAC;KACF,CAAA;AACH,CAAC;AAED,SAAgB,YAAY,CAAC,IAAY,EAAE,KAA8B;IACvE,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,MAAM;YACT,OAAO,MAAM,CAAC,KAAK,CAAC,OAAO,IAAI,EAAE,CAAC,CAAA;QACpC,KAAK,MAAM,CAAC;QACZ,KAAK,OAAO,CAAC;QACb,KAAK,MAAM;YACT,OAAO,MAAM,CAAC,KAAK,CAAC,SAAS,IAAI,KAAK,CAAC,IAAI,IAAI,EAAE,CAAC,CAAA;QACpD,KAAK,MAAM;YACT,OAAO,MAAM,CAAC,KAAK,CAAC,OAAO,IAAI,EAAE,CAAC,CAAA;QACpC,KAAK,MAAM;YACT,OAAO,MAAM,CAAC,KAAK,CAAC,OAAO,IAAI,EAAE,CAAC,CAAA;QACpC;YACE,OAAO,EAAE,CAAA;IACb,CAAC;AACH,CAAC;AAED,SAAgB,gBAAgB,CAAC,IAAY,EAAE,MAAe;IAC5D,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC/B,OAAO,MAAM,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,MAAM,CAAA;IACpE,CAAC;IACD,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAA;AAC7C,CAAC"}

package/dist/utils/tokens.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokens.d.ts","sourceRoot":"","sources":["../../src/utils/tokens.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGnD;AAED,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAAC,GAClD,MAAM,CAYR;AAED,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,MAAM,CAQxF;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAIvD"}

package/dist/utils/tokens.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokens.js","sourceRoot":"","sources":["../../src/utils/tokens.ts"],"names":[],"mappings":";AAAA;;;GAGG;;AAEH,wCAGC;AAED,wDAcC;AAED,4DAQC;AAED,4CAIC;AAnCD,SAAgB,cAAc,CAAC,IAAY;IACzC,IAAI,CAAC,IAAI;QAAE,OAAO,CAAC,CAAA;IACnB,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA;AACnC,CAAC;AAED,SAAgB,sBAAsB,CACpC,QAAmD;IAEnD,IAAI,KAAK,GAAG,CAAC,CAAA;IACb,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;QAC3B,MAAM,OAAO,GACX,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ;YAC7B,CAAC,CAAC,GAAG,CAAC,OAAO;YACb,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,OAAO,IAAI,EAAE,CAAC,CAAA;QACvC,KAAK,IAAI,cAAc,CAAC,OAAO,CAAC,CAAA;QAChC,wDAAwD;QACxD,KAAK,IAAI,CAAC,CAAA;IACZ,CAAC;IACD,OAAO,KAAK,CAAA;AACd,CAAC;AAED,SAAgB,wBAAwB,CAAC,OAAuC;IAC9E,IAAI,KAAK,GAAG,CAAC,CAAA;IACb,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,KAAK,IAAI,cAAc,CAAC,MAAM,CAAC,MAAM,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC,CAAA;QACzD,KAAK,IAAI,cAAc,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,CAAA;QAClD,KAAK,IAAI,cAAc,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC,CAAA;IACpE,CAAC;IACD,OAAO,KAAK,CAAA;AACd,CAAC;AAED,SAAgB,gBAAgB,CAAC,MAAc;IAC7C,IAAI,MAAM,IAAI,SAAS;QAAE,OAAO,GAAG,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAA;IACrE,IAAI,MAAM,IAAI,KAAK;QAAE,OAAO,GAAG,CAAC,MAAM,GAAG,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAA;IAC7D,OAAO,MAAM,CAAC,MAAM,CAAC,CAAA;AACvB,CAAC"}

package/dist/utils/undo-tracker.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Undo tracker — keeps a stack of file snapshots before destructive edits.
+ * Enables /undo command to revert the last file change.
+ */
+export interface FileSnapshot {
+    filePath: string;
+    content: string | null;
+    timestamp: number;
+    operation: "write" | "edit";
+}
+export declare class UndoTracker {
+    private stack;
+    /**
+     * Save a snapshot of the file before it gets modified.
+     * Call this BEFORE performing the write/edit.
+     */
+    push(filePath: string, operation: "write" | "edit"): void;
+    /**
+     * Undo the most recent file change. Returns info about what was undone,
+     * or null if there's nothing to undo.
+     */
+    undo(): FileSnapshot | null;
+    /**
+     * Peek at the most recent snapshot without popping it.
+     */
+    peek(): FileSnapshot | null;
+    /**
+     * Get the full undo history.
+     */
+    getHistory(): readonly FileSnapshot[];
+    /**
+     * Clear the undo stack.
+     */
+    clear(): void;
+    get size(): number;
+}
+//# sourceMappingURL=undo-tracker.d.ts.map

package/dist/utils/undo-tracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"undo-tracker.d.ts","sourceRoot":"","sources":["../../src/utils/undo-tracker.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAA;IAChB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,OAAO,GAAG,MAAM,CAAA;CAC5B;AAID,qBAAa,WAAW;IACtB,OAAO,CAAC,KAAK,CAAqB;IAElC;;;OAGG;IACH,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI;IAuBzD;;;OAGG;IACH,IAAI,IAAI,YAAY,GAAG,IAAI;IAoB3B;;OAEG;IACH,IAAI,IAAI,YAAY,GAAG,IAAI;IAI3B;;OAEG;IACH,UAAU,IAAI,SAAS,YAAY,EAAE;IAIrC;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb,IAAI,IAAI,IAAI,MAAM,CAEjB;CACF"}

package/dist/utils/undo-tracker.js

@@ -0,0 +1,118 @@
+"use strict";
+/**
+ * Undo tracker — keeps a stack of file snapshots before destructive edits.
+ * Enables /undo command to revert the last file change.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UndoTracker = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const MAX_UNDO_STACK = 50;
+class UndoTracker {
+    stack = [];
+    /**
+     * Save a snapshot of the file before it gets modified.
+     * Call this BEFORE performing the write/edit.
+     */
+    push(filePath, operation) {
+        const resolved = path.resolve(filePath);
+        let content = null;
+        try {
+            content = fs.readFileSync(resolved, "utf-8");
+        }
+        catch {
+            // File doesn't exist yet — that's fine
+        }
+        this.stack.push({
+            filePath: resolved,
+            content,
+            timestamp: Date.now(),
+            operation,
+        });
+        // Trim old entries
+        if (this.stack.length > MAX_UNDO_STACK) {
+            this.stack = this.stack.slice(-MAX_UNDO_STACK);
+        }
+    }
+    /**
+     * Undo the most recent file change. Returns info about what was undone,
+     * or null if there's nothing to undo.
+     */
+    undo() {
+        const snapshot = this.stack.pop();
+        if (!snapshot)
+            return null;
+        try {
+            if (snapshot.content === null) {
+                // File was created — delete it
+                fs.unlinkSync(snapshot.filePath);
+            }
+            else {
+                // File was modified — restore previous content
+                fs.writeFileSync(snapshot.filePath, snapshot.content, "utf-8");
+            }
+            return snapshot;
+        }
+        catch (err) {
+            // Put it back on the stack if undo failed
+            this.stack.push(snapshot);
+            throw err;
+        }
+    }
+    /**
+     * Peek at the most recent snapshot without popping it.
+     */
+    peek() {
+        return this.stack.length > 0 ? this.stack[this.stack.length - 1] : null;
+    }
+    /**
+     * Get the full undo history.
+     */
+    getHistory() {
+        return this.stack;
+    }
+    /**
+     * Clear the undo stack.
+     */
+    clear() {
+        this.stack = [];
+    }
+    get size() {
+        return this.stack.length;
+    }
+}
+exports.UndoTracker = UndoTracker;
+//# sourceMappingURL=undo-tracker.js.map

package/dist/utils/undo-tracker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"undo-tracker.js","sourceRoot":"","sources":["../../src/utils/undo-tracker.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEH,uCAAwB;AACxB,2CAA4B;AAU5B,MAAM,cAAc,GAAG,EAAE,CAAA;AAEzB,MAAa,WAAW;IACd,KAAK,GAAmB,EAAE,CAAA;IAElC;;;OAGG;IACH,IAAI,CAAC,QAAgB,EAAE,SAA2B;QAChD,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAA;QACvC,IAAI,OAAO,GAAkB,IAAI,CAAA;QAEjC,IAAI,CAAC;YACH,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAA;QAC9C,CAAC;QAAC,MAAM,CAAC;YACP,uCAAuC;QACzC,CAAC;QAED,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;YACd,QAAQ,EAAE,QAAQ;YAClB,OAAO;YACP,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;YACrB,SAAS;SACV,CAAC,CAAA;QAEF,mBAAmB;QACnB,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,cAAc,EAAE,CAAC;YACvC,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,cAAc,CAAC,CAAA;QAChD,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,IAAI;QACF,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAA;QACjC,IAAI,CAAC,QAAQ;YAAE,OAAO,IAAI,CAAA;QAE1B,IAAI,CAAC;YACH,IAAI,QAAQ,CAAC,OAAO,KAAK,IAAI,EAAE,CAAC;gBAC9B,+BAA+B;gBAC/B,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAA;YAClC,CAAC;iBAAM,CAAC;gBACN,+CAA+C;gBAC/C,EAAE,CAAC,aAAa,CAAC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;YAChE,CAAC;YACD,OAAO,QAAQ,CAAA;QACjB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,0CAA0C;YAC1C,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;YACzB,MAAM,GAAG,CAAA;QACX,CAAC;IACH,CAAC;IAED;;OAEG;IACH,IAAI;QACF,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;IACzE,CAAC;IAED;;OAEG;IACH,UAAU;QACR,OAAO,IAAI,CAAC,KAAK,CAAA;IACnB,CAAC;IAED;;OAEG;IACH,KAAK;QACH,IAAI,CAAC,KAAK,GAAG,EAAE,CAAA;IACjB,CAAC;IAED,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAA;IAC1B,CAAC;CACF;AA9ED,kCA8EC"}

package/dist/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,WAAW,QAAsB,CAAA"}

package/dist/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":";;;;;;AAAA,mEAAyC;AAE5B,QAAA,WAAW,GAAG,sBAAW,CAAC,OAAO,CAAA"}